推出 Facebook Graph API v17.0 版和推廣 API v17.0 版

今天，我們隆重推出 Facebook Graph API v17.0 版和推廣 API v17.0 版。為配合這些發佈版本推出，我們於下方重點列出了我們認為與部分開發人員社群相關的變更。這些變更包括公告、產品更新和停用通知，而我們認為這些變更跟您應用程式與我們平台之間的整合息息相關。

有關所有變更及詳情的完整清單，請參閱我們的變更記錄。

停用項目及重大變更

停用廣告策略

廣告策略測試版產品自 2022 年 10 月 28 日起已停用。因此，隨著推廣 API v17.0 推出，我們會停用宣傳活動端點上的 ad_strategy_id 和 ad_strategy_group_id 欄位。

停用離線轉換 API

自 2023 年 2 月起，轉換 API 全面支援離線事件，確保用戶可享受到目前離線轉換 API 端點提供的相若功能。我們希望透過將網站事件和離線事件 API 併入單個 API，以簡化和改善廣告客戶使用其跨渠道營銷資料的方式，從而改善廣告優化、自訂廣告受眾和成效衡量。

由 2023 年 5 月 23 日發佈 Graph API v17 版起，離線轉換 API 不再支援離線事件。我們建議，擁有離線轉換 API 整合工具的廣告客戶將其整合工具轉換為轉換 API 整合工具，並只在轉換成功後才更新其離線轉換 API。

停用舊版目標建立流程

正如 2021 年 12 月的公告所述，我們重新設計了在建立新宣傳活動時的廣告目標選擇體驗，以有效指引廣告客戶設定宣傳活動，幫助廣告客戶更妥善地實現自己的營銷目標。以成果為本的新廣告體驗為推廣 API 帶來變更。

隨著推廣 API v17.0 推出，我們會開始停用舊版體驗和目標。使用推廣 API v17.0 時，建立宣傳活動時只能使用以成果為本的廣告體驗目標，各項舊版目標的 API 將會停用。對此版本，我們仍會支援現有的舊版宣傳活動及其複製版本，有關宣傳活動不會受到影響。詳情請參閱我們近期的開發人員網誌文章。

必須使用進階高效速成廣告創意標準強化效果欄位

今年稍早時候，我們在推廣 API 上推出了進階高效速成廣告創意標準強化效果功能。由 2023 年 5 月 23 日起，推廣 API 用戶需要在「enroll_status」欄位中提供「OPT_IN」或「OPT_OUT」，以指明廣告是否已註冊進階高效速成廣告創意標準強化效果功能。如果留空此欄位，用戶會收到錯誤訊息，而系統會引導用戶填寫欄位。如要進一步了解推廣 API 上的進階高效速成廣告創意標準強化效果功能，請參閱此篇開發人員網誌文章。

以下端點會受到影響：

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

停用串流進階高效速成目錄廣告

隨著推廣 API v17 推出，我們會停用串流（串流 A+CA）目錄用途的進階高效速成目錄廣告。商務目錄廣告是串流 A+CA 的建議替代方案。詳見商務目錄設立指南。以下端點將會停用：

• 建立串流 A+CA 目錄：Edge owned_product_catalogs with vertical media_titles
• 上載媒體標題摘要：Edge product_feeds for a A+CA for Streaming catalog
• 建立媒體標題項目：Edge media_titles for a A+CA for Streaming catalog
• 使用串流 A+CA 目錄建立廣告系列：Edge campaigns with a DAS catalog either on L3, L2, or L1

在 2023 年 8 月 21 日，上述變更會適用於所有推廣 API 版本，而我們會暫停在 L3、L2 或 L1 級別附有串流 A+CA 目錄的所有廣告系列。

停用即時文章 API

即時文章產品已於 2023 年 4 月 20 日停用，我們現在亦會停用支援發佈商管理即時文章的 API。

要求用戶帳戶必須具備企業管理權限

早前，有其他企業管理頁面在不具備 business_management 存取權限的情況下被傳回。自 2023 年 5 月 23 日起，我們要求具備 business_management 權限，才能繼續獲得對企業管理頁面的存取權限。有關此權限的詳情，請參閱 business_management 頁面。

API 版本停用資訊：

根據 Facebook 的 Graph API 和推廣 API 版本控制計劃，請注意以下即將停用的項目：

Graph API

• 2023 年 6 月 8 日：Graph API v10.0 版會被停用並從平台移除
• 2023 年 9 月 14 日：Graph API v11.0 版會被停用並從平台移除
• 2024 年 2 月 8 日：Graph API v12.0 版會被停用並從平台移除

推廣 API

• 2023 年 8 月 15 日：推廣 API v14.0 版會被停用並從平台移除
• 2023 年 8 月 15 日：推廣 API v15.0 版會被停用並從平台移除

為免對您的業務造成干擾，我們建議您立即將所有呼叫轉移至今天發佈的最新 API 版本。

Facebook 平台 SDK

根據我們平台 SDK 的兩年停用計劃，請注意以下即將停用和棄用的項目：

• 2023 年 6 月：Facebook 平台 SDK v9.0 版或以下版本會被棄用
• 2023 年 10 月：Facebook 平台 SDK v11.0 版或以下版本會被棄用
• 2024 年 2 月：Facebook 平台 SDK v12.0 版或以下版本會被棄用