隆重推出 Facebook Graph API v19.0 和推廣 API v19.0

2024年1月23日發佈者：Mohamed Amr Abouelhassan

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

如需查看所有變更的完整清單及有關詳情，請瀏覽我們的變更記錄。

一般更新

為所有宣傳活動目標和優化設定啟用高效速成詳細目標設定

為了持續協助廣告客戶提升成效，我們將「高效速成詳細目標設定」產品的適用範圍擴展至所有宣傳活動目標和優化設定。

「高效速成詳細目標設定」是我們高效速成產品套件的一部分，能夠利用先進的自動化和機器學習技術，以助廣告客戶提升宣傳活動成效。具體而言，啟用「高效速成詳細目標設定」功能後，當我們的系統預測有機會提升成效時，便會接觸廣告客戶初始詳細目標設定選項範圍以外的用戶，從而擴大廣告受眾規模並改善宣傳活動的表現。

2024 年 1 月 23 日，我們會針對使用推廣 API 的廣告客戶和合作夥伴推出以下變更：

以「展示次數」、「影片觀看次數」、「接觸人數」、「互動」或「廣告回想提升」作為優化目標的宣傳活動現可選擇啟用「高效速成詳細目標設定」。
以「開發潛在顧客」作為優化目標的宣傳活動將自動套用「高效速成詳細目標設定」，但可選擇停用此功能。
- 備註：對於全新和複製的宣傳活動／廣告組合，系統會預設將此選項設為開啟，但您可視乎需要，使用此切換按鈕來停用此功能。
以「連結點擊次數」或「連結頁面瀏覽次數」作為優化目標的宣傳活動將自動套用「高效速成詳細目標設定」，且不設停用此功能的選項。

對於使用推廣 API 的廣告客戶和合作夥伴，這些變更意義重大。由 2024 年 1 月 23 起，開發人員可以開始執行相關程式碼變更，且須於 2024 年 4 月 22 日前完成更新。這項變更會於最新 API V19 版本中推出。

<Impacted endpoints>

要求類型	端點	變更
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	若是以「連結點擊次數」或「連結頁面瀏覽次數」作為優化目標的宣傳活動，欄位「targeting_optimization」將不獲接受。此項限制同樣適用於「高效速成詳細目標設定」所包含且不設停用選項的舊優化設定，包括「轉換次數」、「消費金額」、「應用程式安裝」、「應用程式事件」和「對話次數」。若是以「展示次數」、「影片觀看次數」、「接觸人數」、「互動」、「廣告回想提升」或「開發潛在顧客」作為優化目標的宣傳活動，欄位「targeting_as_signal」應設為「null」或「0」，否則會出現錯誤。
POST	/act_{ad_account_id}/{adsets} /{adset-id}	若是以「連結點擊次數」或「連結頁面瀏覽次數」作為優化目標的宣傳活動，欄位「targeting_optimization」將不獲接受。此項限制同樣適用於「高效速成詳細目標設定」所包含且不設停用選項的舊優化設定，包括「轉換次數」、「消費金額」、「應用程式安裝」、「應用程式事件」和「對話次數」。對於所有選擇啟用「高效速成詳細目標設定」且不設停用選項的優化設定，我們會根據目標和優化設定之組合，自動將「targeting_as_signal 」欄位設為「1」或「3」。

要求類型

端點

變更

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

若是以「連結點擊次數」或「連結頁面瀏覽次數」作為優化目標的宣傳活動，欄位「targeting_optimization」將不獲接受。此項限制同樣適用於「高效速成詳細目標設定」所包含且不設停用選項的舊優化設定，包括「轉換次數」、「消費金額」、「應用程式安裝」、「應用程式事件」和「對話次數」。
若是以「展示次數」、「影片觀看次數」、「接觸人數」、「互動」、「廣告回想提升」或「開發潛在顧客」作為優化目標的宣傳活動，欄位「targeting_as_signal」應設為「null」或「0」，否則會出現錯誤。

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

若是以「連結點擊次數」或「連結頁面瀏覽次數」作為優化目標的宣傳活動，欄位「targeting_optimization」將不獲接受。此項限制同樣適用於「高效速成詳細目標設定」所包含且不設停用選項的舊優化設定，包括「轉換次數」、「消費金額」、「應用程式安裝」、「應用程式事件」和「對話次數」。
對於所有選擇啟用「高效速成詳細目標設定」且不設停用選項的優化設定，我們會根據目標和優化設定之組合，自動將「targeting_as_signal 」欄位設為「1」或「3」。

推廣 API：使用原有目標的全新廣告、廣告組合和宣傳活動

從推廣 API v19.0 開始，您無法再透過廣告複製功能來建立採用下列原有目標的全新廣告、廣告組合和宣傳活動。您將需要更新廣告目標，以反映我們的經簡化目標。

由推廣 API v20 版本起，我們不再支援在採用原有目標的宣傳活動中建立廣告和廣告組合。不過，v20 之前的所有 API 版本（如 v19、v18）仍將支援此功能。您無需立即為採用原有目標的現有廣告採取任何行動。

受影響的原有目標

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

受影響的 POST 端點

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

此處載列了一篇過去發佈的開發人員網誌文章，當中闡述了採用原有目標的宣傳活動建立流程之 API 變更，以供參考。

常見問題

問：此項變更需要更新程式碼嗎？

答：需要，因為 V18 的多個 API 呼叫無法在 V19 運作。例如，您無法透過廣告複製功能來建立使用原有目標的全新廣告、廣告組合和宣傳活動。

問：變更前後會出現哪些預期行為？

答：變更生效之前，使用原有目標來複製廣告、廣告組合或宣傳活動的 API 呼叫會成功；變更生效後，此類呼叫會失敗。

問：執行程式碼變更的截止期限為何？

答：您可在 v18.0 停用之前完成此操作，而停用日期暫定為 2024 年 9 月。

其他開發人員文件

幫助文章

PPCA（專頁公開內容存取權限）

使用 PPCA（專頁公開內容存取權限）蒐集的資料之使用案例有所變動。詳情請參閱下方連結。

推出進階高效速成廣告受眾 API

去年 10 月，我們推出了「進階高效速成廣告受眾」；這是一項經簡化的全新廣告受眾建立體驗，可擴大廣告有可能接觸到的廣告受眾範圍，同時仍向廣告客戶最希望接觸的用戶刊登廣告，從而提高宣傳活動成效。

我們現正在推廣 API 上推出進階高效速成廣告受眾。

若要啟用此功能，請將「advantage_audience」中的「targeting_automation」參數設為「1」。
若要停用此功能，請將「advantage_audience」中的「targeting_automation」參數設為「0」。

停用項目及重大變更

停用 Facebook 群組 API

Facebook 群組 API 已於 v19 中停用，並會於 90 天內從所有版本中移除。此停用項目包括與 Facebook 群組 API 相關的所有權限（publish_to_groups、groups_access_member_info），以及各項可審查功能（群組 API）。

群組 API 的一大使用案例就是群組中的「秘密回覆」功能。我們還會於 v19 中推出另一項變更，屆時開發人員完全無需使用群組 API，便可實現此使用案例。大多數「秘密回覆」功能的開發人員無需在 v19 中作任何變更。對於需要透過群組 API 呼叫「群組帖子」端點的開發人員，他們現在收到「秘密回覆」Webhook 後，需要確保對此類要求使用「專頁存取憑證」。

開發人員若不確定自己端點所用的權限是否已停用，可以在版本 19.0 中測試相關端點來加以驗證。

專頁洞察報告 API 變更：衡量數據停用

隨著 Facebook 經典版專頁體驗轉移至新版專頁體驗，我們會停用多項專頁洞察報告 API 衡量數據。詳情請參閱此連結。

API 版本停用資訊：

根據 Facebook 的 Graph API 和推廣 API 版本控制時間表，接下來的停用項目如下：

Graph API

2024 年 2 月 8 日：Graph API v12.0 會被停用並從平台移除
2024 年 5 月 28 日：Graph API v13.0 會被停用並從平台移除
2024 年 9 月 17 日：Graph API v14.0 會被停用並從平台移除

推廣 API

2024 年 2 月 6 日：推廣 API v16.0 會被停用並從平台移除
2024 年 5 月 14 日：推廣 API v17.0 會被停用並從平台移除

為免導致您的業務中斷，我們建議您立即將所有呼叫轉移至今天發佈的最新 API 版本。

Meta Business SDK

Meta Business SDK v19 版本

Meta Business SDK v19 版本將緊隨 Graph API v19 版本之後發佈。此版本將包含錯誤修正、相依項目升級、全新功能；最重要的是，此版本亦包括經更新的 API 介面，以與 Graph API v19 保持一致。我們計劃未來更頻密地發佈 SDK 版本，以跟上 API 的更新步伐，讓開發人員時刻可用最新的 API 和功能。

根據我們平台 SDK 的兩年停用計劃，接下來的停用和棄用項目如下：