Facebook 圖形 API 第 19.0 版和行銷 API 第 19.0 版隆重登場

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

今天我們將推出 Facebook 圖形 API 第 19.0 版和行銷 API 第 19.0 版。以下將重點介紹我們認為此版本對部分開發人員社群較為重要的變更。這些變更包括與我們的開放平台整合的相關應用程式有關的公告、產品更新，以及停用通知。

如需所有變更及細節的完整清單，請瀏覽我們的變更紀錄。

一般更新

為所有行銷活動目標和最佳化項目提供高效速成詳細目標設定

為持續協助廣告主提高成效，我們正在將高效速成詳細目標設定產品的可用範圍擴大到所有行銷活動目標和最佳化項目。

「高效速成詳細目標設定」是我們的高效速成產品套組的一部分，它利用先進的自動化和機器學習技術來協助提升廣告主的行銷活動成效。具體來說，如果我們的系統預測可能有機會提升成效，高效速成詳細目標設定不只可讓系統觸及廣告主最初「詳細目標設定」選擇中所定義的受眾，還能觸及更廣泛的受眾，以協助提升行銷活動成效。

2024 年 1 月 23 日，我們將為使用行銷 API 的廣告主和合作夥伴推出以下變更：

針對曝光次數、影片觀看次數、觸及人數、互動次數或廣告回想提升進行最佳化的行銷活動，現在可以選擇啟用高效速成詳細目標設定。
針對開發潛在顧客進行最佳化的行銷活動，將自動套用高效速成詳細目標設定，並提供選擇停用選項。
- 請注意：針對新的和重複的行銷活動／廣告組合，系統將會開啟選擇使用選項，而且您可以視需求使用此切換開關選擇停用。
針對連結點擊次數或連結頁面瀏覽次數進行最佳化的行銷活動將自動套用高效速成詳細目標設定，但不提供選擇停用選項。

對於使用行銷 API 的廣告主和合作夥伴來說，這些變更將帶來重大改變。從 2024 年 1 月 23 日開始，開發人員可以開始實作程式碼變更，並且必須在 2024 年 4 月 22 日之前更新。此變更將會在新的 API 第 19 版中發佈。

<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 第 19.0 版開始，無法再透過廣告文案建立使用原始目標（如下所列-）的新廣告、廣告組合和行銷活動。廣告目標需要更新，以反映我們的簡化目標。

從行銷 API 第 20 版開始，將不再支援在原始目標行銷活動下建立廣告和廣告組合。但是，第 20 版之前的任何版本的 API（即第 19 版、第 18 版）仍允許此功能。對於使用原始目標的現有廣告，無需立即採取行動。

受影響的原始目標

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 變更。

常見問題

問：本次變更是否需要更新程式碼？

答：是，第 18 版中的多個 API 呼叫不適用於第 19 版（即無法透過廣告文案建立使用原始目標的新廣告、廣告組合和行銷活動）。

問：變更前後各有哪些可預期的行為？

答：先前，使用原始目標複製廣告、廣告組合或行銷活動的 API 呼叫可以成功地呼叫，但現在會失敗。

問：何時會實作程式碼變更？

答：直到第 18.0 版停用（暫定於 2024 年 9 月）之前。

其他開發人員文件

說明文章

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

使用 PPCA（粉絲專頁公開內容存取權限）蒐集的資料使用案例已變更。如需詳情，請參閱此連結。

隆重推出高效速成+ 廣告受眾 API

去年 10 月，我們推出了全新簡化的廣告受眾建立體驗「高效速成+ 廣告受眾」，透過擴大廣告的潛在受眾觸及範圍，同時向廣告主最想觸及的受眾顯示廣告，進而提高行銷活動成效。

現在，我們在行銷 API 上推出高效速成+ 廣告受眾。

若要選擇啟用，請將 advantage_audience 內的 targeting_automation 參數設為 1。
若要選擇停用，請將 advantage_audience 內的 targeting_automation 參數設為 0。

淘汰項目與重大變更

停用 Facebook 社團 API

Facebook 社團 API 已在第 19 版中停用，並將在 90 天內從所有版本中移除。這次停用包含與 Facebook 社團 API 相關聯的所有權限（publish_to_groups、groups_access_member_info）和可審查功能（社團 API）。

社團 API 的主要使用案例是社團中的私密回覆功能。我們會在第 19 版中推出另一項變更，讓開發人員無需使用社團 API 即可實現該使用案例。對於大多數私密回覆功能開發人員而言，第 19 版中不會有任何變更。對於在收到私密回覆 Webhook 之後，依賴透過社團 API 呼叫 Groups Post 端點的開發人員，現在需要確保他們使用粉絲專頁存取權杖來處理這些要求。

不確定端點是否使用廢棄權限的開發人員，可以透過測試第 19.0 版中的端點進行驗證

粉絲專頁洞察報告 API 變更：衡量指標停用

隨著我們從 Facebook 的經典版粉絲專頁移轉到新版粉絲專頁體驗，一些粉絲專頁洞察報告 API 衡量指標也將停用。如需詳細資訊，請參閱此連結。

API 版本淘汰項目：

Facebook 的圖形 API 和行銷 API 版本修訂時間表已訂出即將淘汰項目，請留意：

圖形 API

2024 年 2 月 8 日：圖形 API 第 12.0 版將淘汰並從開放平台移除
2024 年 5 月 28 日：圖形 API 第 13.0 版將淘汰並從開放平台移除
2024 年 9 月 17 日：圖形 API 第 14.0 版將淘汰並從開放平台移除

行銷 API

2024 年 2 月 6 日：行銷 API 第 16.0 版將淘汰並從開放平台移除
2024 年 5 月 14 日：行銷 API 第 17.0 版將淘汰並從開放平台移除

為避免干擾您的業務，我們建議將所有呼叫移轉至今天推出的最新 API 版本。

Meta Business SDK

Meta Business SDK 第 19 版

Meta Business SDK 第 19 版將在圖形 API 第 19 版發佈後不久發佈。此版本將包括錯誤修復、相依性升級、新功能，以及最重要的更新 API 介面以配合圖形 API 第 19 版。未來，我們計劃會更頻繁地發佈 SDK，以配合 API 更新節奏。如此一來，開發人員將能夠隨時掌握最新 API、功能和特性。

請注意我們開放平台 SDK 為期 2 年的淘汰時間表中，即將到來的淘汰和停用項目：