3.0 版

行銷 API

發佈日期：2018 年 5 月 1 日 | 有效期限：2019 年 2 月 1 日 | 部落格文章

• 新功能
• 重大變更
• 淘汰項目
• 即刻淘汰項目

新功能

最低成本出價策略，bid_strategy 欄位

我們針對 {account-id}/adsets 推出新的 bid_strategy 欄位，可讓您根據業務目標選擇廣告出價策略。每種策略都有優點和權衡。選項包括：

• LOWEST_COST - 根據您的廣告組合預算和透遞 optimization_goal 取得最佳結果。Facebook 會自動進行更多必要的出價來花費您的預算。您可以為出價提供最大值，或使用此選項提供沒有限制的出價。

• TARGET_COST - 在增加廣告組合預算時，為廣告提供穩定的平均成本。

如需詳細資訊，請參閱廣告購買與最佳化：出價策略

精選集廣告：建立

適用於建立精選集廣告的新 API - 以前每次建立精選集廣告時，Facebook 都會在背景建立一個全螢幕互動廣告。這個非正式建立的全螢幕互動廣告不僅在使用上有所限制，也無法用來再次鎖定曾與全螢幕互動廣告有過互動的廣告受眾。現在當您從商品組合建立精選集廣告時，必須一併正式建立具有適當素材的全螢幕互動廣告。當您在精選集廣告中使用此全螢幕互動廣告時，Facebook 會自動產生精選集廣告。如需詳細資訊，請參閱從商品組合建立精選集廣告。

重大變更

廣告管理

• 右側欄位無效 - 我們讓僅鎖定 Facebook 位置的廣告無效，為 {ad_account_id}/adsets 上 right_hand_column 的具有無效目標的 right_hand_column。我們現在僅支援可支援使用以下目標的廣告格式右側（廣告）版位：流量、轉換次數和商品目錄銷售。

• 在 3.0 以上版本中，is_autobid 和 is_average_price_pacing 會同時在 GET 和 POST 中停用。

廣告受眾和廣告目標設定

• 變更自訂廣告受眾的規則語法 - 我們更新了用於建立網站自訂廣告受眾、行動應用程式自訂廣告受眾、粉絲專頁互動自訂廣告受眾、名單型廣告互動廣告受眾、全螢幕互動廣告的互動廣告受眾和離線自訂廣告受眾的規則結構。如此可讓您根據彙總行為建立規則、從不同事件來源建立規則和排除規則。請參閱：

  • 網站的自訂廣告受眾：廣告受眾規則、

  • 行動應用程式的自訂廣告受眾：廣告受眾規則、

  • 粉絲專頁互動自訂廣告受眾、

  • 名單型廣告的互動廣告受眾、

  • 全螢幕互動廣告的互動廣告受眾和

  • 離線轉換的自訂廣告受眾。

動態廣告

• 產品目錄存取 - 若要存取目錄商品，您必須指定正確的目錄產業。如果您的要求無法與正確的目錄產業配對，將發生錯誤。例如，如果您擁有電子商務目錄，應使用對應的 /products 端點（例如 GET {catalog_id}/products、GET {product_feed_id}/products 或 GET {product_set_id}/products）存取它。您不能使用其他產業的端點（例如 GET {catalog_id}/autos、GET {product_feed_id}/hotels 或 GET {product_set_id}/flights）存取目錄。

• 範本標籤中的空字串 - 我們不再允許將空字串作為動態廣告：範本標籤選項的參數。例如，如果您將空字串傳送給 {{trip.checkin_date date_format:}}，將發生錯誤。如需背景資訊，請參閱動態廣告：廣告管理。

廣告洞察報告與成效衡量

• 洞察報告逾時 - 如果我們預期洞察報告 API 要求在完成之前導致逾時，將傳回錯誤代碼 100 和子代碼 1504033 的錯誤。我們根據要求大小和處理相對於逾時限制的進度進行估計。如果發生此錯誤，您應為此資料進行非同步洞察報告 API 要求。請參閱洞察報告 API 非同步工作。

• 事件資料中的負值 - 如果您將含有負值的事件資料發佈至 {data_set_id}/events，將會失敗。這會影響 POST /{data_set_id-id}/events 的 data 欄位。

• 行銷活動預算最佳化的洞察報告 - 當您的廣告行銷活動使用行銷活動預算最佳化時，adset_budget_value 現在會傳回 using campaign budget。這會影響：

  • GET {adaccount-id}/insights、

  • GET {campaign-id}/insights、

  • GET {adset-id}/insights、

  • GET {ad-id}/insights、

  • POST {adaccount-id}/insights、

  • POST {campaign-id}/insights、

  • POST {adset-id}/insights、

  • POST {ad-id}/insights。

• 像素的預設排序 - 如果您在商業帳號或廣告帳號上呼叫 GET {account_id}/adspixel 關係連線，我們傳回的結果預設會依像素名稱而非上次像素觸發時間進行排序。

• 重新命名像素統計資料欄位 - 我們將像素統計資料關係連線上的 timestamp 欄位重新命名為 start_time。這代表我們在像素觸發上開始每小時彙總資料的開始時間。我們現在會以 ISO 8601 格式傳回此欄位資料，並包含時區差距。如此可修復我們傳回無效 Unix 時間戳記的問題。以下端點將受到影響：GET {ads-pixel-id}/stats。

淘汰項目

企業管理平台

已停用 POST {pixel-id}/shared_agencies 端點。請使用企業管理平台用戶介面與代理商分享廣告像素。

廣告管理

• 已停用 /{ad_campaign_id} 和 /ad_account_ID/campaigns 的 kpi_custom_conversion_id、kpi_type 和 kpi_results。

• 已停用下列端點的「redownload」標示以簡化 API：

  • POST {ad-id}/、

  • POST {adset-id}/、

  • POST act_{ad-account-id}、

  • POST act_{ad-account-id}/ads、

  • POST act_{ad-account-id}/adsets

  您仍可使用「fields」參數讀取此資訊。

• 已停用 POST act_{ad-account-id}/adimages 的 zipbytes 欄位，並移除在該關係連線上傳 ZIP 檔案的功能。請使用具有這些副檔名的圖像：jpg、jpeg、gif、bmp、png、tiff 或 tif。

• 已停用目前建立精選集廣告的方法，其使用單一 API 呼叫，需要將所有必要廣告素材都用作參數。現在改為必須先建立全螢幕互動廣告，然後使用全螢幕互動廣告連結來建立精選集廣告。如此可讓您存取非正式建立的全螢幕互動廣告物件以進行相關動作，例如再次鎖定廣告受眾。請參閱精選集廣告。

• 已停用針對具有粉絲專頁貼文互動目標的廣告使用輪播廣告格式，該組合不再有效。請參閱驗證、目標和廣告創意。

廣告購買與出價

• 已停用端點：POST {ad-account-id}/adsets 和 POST {adset-id} 的 is_autobid 和 is_average_price_pacing 欄位，改用新的 bid_strategy 欄位為廣告組合指定特定的出價策略。如需更多資訊，請參閱出價與最佳化。

• 已停用廣告和廣告帳號之 delivery_estimate 下的欄位。其結果不符合廣告商的需求。此外，Facebook 建議的出價金額可能無法充分實現許多廣告商的業務目標。已停用的欄位和參數包括：

  • bid_estimate 欄位、

  • currency 參數、

  • daily_budget 參數、

  • optimize_for 參數

  我們推薦您使用從 Facebook 廣告取得的真實內在商業數值，並在此基礎上出價。如果您還不知道此數值，建議您使用自動出價。如需背景資訊，請參閱廣告使用說明：廣告競價和廣告購買與最佳化。

• 已停用 GET /{rf-prediction-id} 上 curve_budget_reach 欄位的傳回結果。我們現在會傳回對應，並已停用 JSON 序列化字串回傳值。這會影響：GET /{rf-prediction-id}。

• 已停用 GET /{ad-account-id}/ratecard 關係連線。

• 已停用多個與 /ad_accounts 帳單相關的欄位。這些項目包括：

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• 已停用 pixel_id 和 external_event_source 欄位 GET /customaudience。

廣告洞察報告與成效衡量

• 已停用 OFFLINE_EVENT_SET_ID 上的 matched_unique_users，其由 GET /{data-set-id} 和 GET /{data-set-upload-id} 所傳回。請參閱離線轉換 API。

• 已停用 attributed_events 關係連線和 GET /{data_set_id} API 上的 attribute_stats 欄位。使用 GET /{data_set_id}/stats API 取得歸因事件統計資料。

• 已停用 OFFLINE_EVENT_SET_ID 上的 matched_unique_users 欄位，其由 GET /{data-set-id} 和 GET /{data-set-upload-id} 所傳回。

• 已停用 GET {data_set_upload_id} 的預設回傳值。預設將不再傳回以下欄位：first_upload_time、last_upload_time、api_calls、valid_entries、matched_entries、duplicate_entries、event_time_min、event_time_max、event_stats 和 matched_unique_users。

• 已停用 GET {data_set_id}/stats 的預設回傳值。目前預設僅傳回計數統計資料。若要指定應傳回哪些統計資料，請使用 fields 參數或累積統計資料的 summary 參數（例如 average_upload_delay）。

• 已停用 GET {data_set_id} 的預設回傳值。預設將不再傳回以下欄位：attribute_stats、duplicate_entries、event_stats、event_time_max、event_time_min、matched_entries、matched_unique_users、usage、valid_entries。

• 已停用 GET {data-set-upload-id}/stats 關係連線。請改用 GET {data-set-upload-id} 的 valid_entries 或 matched_entries 欄位。

• 已停用洞察報告 API 的 canvas_component_avg_pct_view。