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 版位 right_hand_column 並且在 {ad_account_id}/adsets 上 right_hand_column 目標無效的廣告設為無效。現在，我們只為具有以下目標的支援廣告格式支援右側版位：流量、轉換次數和商品目錄銷售

• 在 3.0 版及更新版本中，GET 和 POST 已停用 is_autobid 和 is_average_price_pacing。

廣告受眾和廣告目標設定

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

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

  • 流動應用程式自訂廣告受眾，廣告受眾規則、

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

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

  • 全螢幕展示廣告的互動廣告受眾及

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

動態廣告

• 產品目錄存取：如要存取目錄產品，您必須指定正確的目錄行業。如果您的要求與目錄的正確行業不符，則會收到錯誤訊息。例如，如果您有電子商務目錄，則應該使用相應的 /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 中由 GET /{data-set-id} 和 GET /{data-set-upload-id} 傳回的 matched_unique_users。請參閱離線轉換 API。

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

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

• 已停用 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 的預設傳回值。預設情況下，此項現在僅傳回次數統計資料。如要指定應傳回的統計資料，請對 average_upload_delay 等累積統計資料使用 fields 參數或 summary 參數。

• 已停用 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。