返回開發人員最新消息

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

2023年5月23日發佈者:Ayyad Farah

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

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

淘汰項目與重大變更

淘汰廣告策略

廣告策略測試版產品自 2022 年 10 月 28 日起已淘汰。因此,我們將隨著行銷 API 第 17.0 版的發行,淘汰行銷活動端點上的 ad_strategy_id 和 ad_strategy_group_id 欄位。

淘汰離線轉換 API

自 2023 年 2 月起,轉換 API 完全支援離線事件,確保目前離線轉換 API 端點所提供的相同功能。我們將網頁和離線事件 API 合併成單一 API,希望簡化並改善廣告主使用跨通路行銷資料的方式,以增強廣告最佳化、自訂廣告受眾和成效衡量。

從 2023 年 5 月 23 日發行的圖形 API 第17 版開始,離線轉換 API 將不再支援離線事件。建議具有離線轉換 API 整合的廣告主,將其整合轉換為轉換 API 整合,並且在成功完成此作業之前,不要更新其離線轉換 API。

淘汰舊版目標建立功能

如同 2021 年 12 月宣告的內容,我們重新設計了建立新行銷活動時的目標選擇體驗,以有效地引導廣告主設定行銷活動,協助更順利地達到行銷目標。新的「成果導向廣告體驗」導致行銷 API 有所變更

我們將從行銷 API 第 17.0 版發行開始,啟動淘汰舊版體驗和目標的程序。使用行銷 API 第 17.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 第 17.0 版的發行,我們將淘汰高效速成+ 目錄串流廣告(串流 A+CA)目錄的使用。建議您使用商務目錄廣告來替代串流 A+CA。您可以參閱商務目錄的設定指南。以下端點將被淘汰:

  • 建立串流 A+CA 目錄:使用關係連線 owned_product_catalogs 搭配 vertical media_titles
  • 上傳媒體標題摘要:為串流 A+CA 目錄使用關係連線 product_feeds
  • 建立媒體標題項目:為串流 A+CA 目錄使用關係連線 media_titles
  • 使用串流 A+CA 目錄建立行銷活動:使用關係連線 campaigns 搭配 L3、L2 或 L1 的 DAS 目錄

上述變更將於 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 的圖形 API行銷 API 版本修訂時間表已訂出即將淘汰項目,敬請留意:

圖形 API

  • 2023 年 6 月 8 日:圖形 API 第 10.0 版將淘汰並從平台移除
  • 2023 年 9 月 14 日:圖形 API 第 11.0 版將淘汰並從平台移除
  • 2024 年 2 月 8 日:圖形 API 第 12.0 版將淘汰並從平台移除

行銷 API

  • 2023 年 8 月 15 日:行銷 API 第 14.0 版將淘汰並從平台移除
  • 2023 年 8 月 15 日:行銷 API 第 15.0 版將淘汰並從平台移除

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

Facebook 開放平台 SDK

在開放平台 SDK 為期 2 年的淘汰時間表期間,請注意即將淘汰和列為過時的項目:

  • 2023 年 6 月:Facebook 開放平台 SDK 第 9.0 版或以下版本將列為過時項目
  • 2023 年 10 月:Facebook 開放平台 SDK 第 11.0 版或以下版本將列為過時項目
  • 2024 年 2 月:Facebook 開放平台 SDK 第 12.0 版或以下版本將列為過時項目