返回開發人員最新消息

隆重介紹 Facebook 圖形 API 第 15.0 版與行銷 API 第 15.0 版

2022年9月15日發佈者:Achyuth Venkatesh

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

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

一般公告與更新

簡化自訂轉換建立條件

為了簡化廣告主的行銷活動建立流程,新建立的自訂轉換將需要至少一個與圖形 API 第 15.0 版相關的規則。不需要規則的自訂轉換應運用自訂事件最佳化,如此便能直接針對自訂事件最佳化廣告行銷活動。我們正在努力將現有的自訂轉換從單一的一體化產品轉換為具有特定價值的多樣產品,以更有效地滿足廣告主的需求和使用案例。此變動將推動廣告主從以自訂事件為基礎的自訂轉換,轉為使用最佳化的自訂事件。

開放平台使用條款更新

我們即將更新《開放平台使用條款》,關於您的應用程式如經一定時間未使用或存取特定平台 API、權限或功能,我們何時可以將其對這類對象的存取權限移除。自 2022 年 12 月 15 日起,《開放平台使用條款》要求 28 天內有活動記錄才會被視為活躍。

若您收到通知,表示您的應用程式處於非活躍狀態,且若您希望予以恢復,則可切換為應用程式的管理員角色來執行恢復。

您可以到此處查看《開放平台使用條款》,以查看這些變更的完整預覽。

淘汰項目與重大變更

高效速成自訂廣告受眾介紹

從 2022 年 9 月 19 日開始,我們將開始推出高效速成自訂廣告受眾。高效速成自訂廣告受眾使用廣告主的自訂受眾,來引導投遞並幫助找到更多可能實現其明確最佳化目標的用戶。這代表著,如果能改善成效,我們將會對自訂廣告受眾以外的目標投遞廣告。高效速成自訂廣告受眾是我們高效速成目標設定產品套件的一部分,其中包含高效速成詳細目標設定和高效速成類似廣告受眾。我們的高效速成目標設定產品運用先進的自動化和機器學習技術,幫助提高廣告主的行銷活動成效,減少所需人力。

使用自訂廣告受眾的廣告主,將能選擇高效速成自訂廣告受眾。透過高效速成自訂廣告受眾,廣告主將繼續建立自訂廣告受眾(網站、應用程式活動、顧客名單或參與度)並套用相關的包含/排除,同時受益於我們先進的自動化和機器學習技術,使用您的自訂廣告受眾作為指導投遞的來源,以觸及更多能幫助您實現明確的最佳化目標的用戶。

當您建立含有網站、行動或互動自訂廣告受眾的全新行銷活動時,系統會自動啟用高效速成自訂廣告受眾。您可以取消勾選我們廣告建立工具的自訂廣告受眾區塊中的「高效速成自訂廣告受眾」核取方塊,來選擇不使用此產品。

特殊廣告受眾淘汰

作為我們與美國住宅暨都市發展部(HUD)的協議,我們將停用特殊廣告受眾,這是一種讓廣告主可以針對與住房、就業和信貸相關的廣告組合擴大廣告受眾的工具。從 2022 年 9 月 15 日開始,我們將取消透過行銷 API 建立特殊廣告受眾的功能。

對廣告主和合作夥伴來說,2022 年 9 月 15 日起無法再建立新的特殊廣告受眾將帶來重大變化,此非版本控制變更將使先前的值遭淘汰。在 2019 年,除了取消住房、就業和信貸廣告的特定目標設定選項之外,我們也引進了特殊廣告受眾作為類似廣告受眾的替代方案。公平性在機器學習中是一個不斷變化且發展的領域,而特殊廣告受眾是早期用於解決問題的方法。現在,我們的重點將轉向可改善公平性的新方法,包括先前宣佈的方法。

請參閱以下與此淘汰項目相關的受影響端點清單:

對於閱讀廣告受眾:

  • endpoint gr:get:AdAccount/customaudiences
  • field operation_status

對於廣告組合的建立:

  • endpoint gr:post:AdAccount/adsets
  • field subtype

對於廣告組合的編輯:

  • endpoint gr:post:AdCampaign
  • field subtype

對於自訂廣告受眾的建立:

  • endpoint gr:post:AdAccount/customaudiences
  • field subtype

對於自訂廣告受眾的編輯:

  • endpoint gr:post:CustomAudience

請參閱先前的部落格文章開發人員文件,以取得支援代碼實作的更多詳細資訊。

高效速成詳細目標設定/高效速成類似廣告受眾同等

此專案為使用以訊息/應用程式安裝為目標(廣告管理員發佈後)的廣告組合的 API 用戶提供了詳細目標設定作為訊號(高效速成詳細目標設定)的平等地位。我們先前推出了 API 對廣告集的高效速成詳細目標設定,以轉換次數為目標,以轉換次數/價值為最佳化目標(VO/OC 廣告組合)。

廣告主目前透過 API 建立以訊息或應用程式安裝為目標的廣告組合時,會傳遞兩件事作為定位標準(L2)的一部分。他們會傳遞詳細目標設定輸入清單(例如:板球、足球、狗等)和一個標記,表明他們是否希望擴展到這些輸入之外(稱為高效速成詳細目標設定)。如果啟用標記,且有可能改善成效,那麼我們的系統將向超出其詳細目標設定的選擇範圍投遞。如果停用標記,則我們的系統會將投遞範圍限制在廣告主提供的選擇清單。

往後(廣告管理員發佈後),廣告主建立以訊息或行動應用程式安裝為目標的新行銷廣告時,其詳細目標設定包含項目將用作輸入(而非限制),以引導廣告的投遞。因此,我們將淘汰這些目標的 DTE 標記,並使目標擴展成為詳細目標設定選擇的預設行為。如果這樣做有可能改善成效,我們可能會向超出其詳細目標設定的範圍投遞。所有其他的目標設定選擇和排除將不受影響。此變更不適用於特殊廣告類別。

運作方式:

以往廣告主會透過值為 expansion_all 或 none 的 targeting_optimization 標記來啟用或停用詳細目標設定擴展。由於這些廣告組合的詳細目標設定操作的語義發生了變化,廣告主在建立以訊息或應用程式安裝為目標的廣告組合時不需要傳遞此標記,因為這不會影響他們新建立的廣告組合。這些新建的廣告組合將一律使用詳細目標設定作為向我們的後端系統發出的訊號,如果這能為廣告主帶來更好的成效,後端系統便可能決定投遞超出這些選擇的廣告。

由於 targeting_optimization 標記不會對新建的廣告組合產生任何影響,我們預計在未來以訊息和/或應用程式安裝為目標的新行銷活動中淘汰此欄位。

  • 為此,如果廣告主在建立新的 MAI/訊息廣告組合或查詢這些新建的廣告組合的投遞估計時傳遞了 targeting_optimization 標記,我們將擲回一則錯誤訊息,要求他們不再傳送此參數。
  • 在新的應用程式安裝/訊息廣告組合建立期間,將在後端設定一個名為 targeting_as_signal 的新欄位。此欄位在 GET 指令上可用,僅用於幫助廣告主驗證其廣告組合是否超出了詳細目標設定涵蓋範圍。

注意:這些對詳細目標設定作為訊號的變更僅適用於以訊息和/或應用程式安裝為目標的新建的廣告組合。

範圍內的 API 端點:

  • gr:post:/act_XXXX/ adsets
  • gr:get:/<adset_id>/delivery_estimate

粉絲專頁頁籤淘汰項目

我們宣佈將不再透過圖形 API 提供粉絲專頁頁籤 API 功能。隨著我們推出新的粉絲專頁體驗,部分粉絲專頁 API 功能將在我們繼續前進的過程中遭淘汰。粉絲專頁自訂頁籤功能在新粉絲專頁體驗中將無法使用,因此我們將淘汰對這些功能的 API 支援。我們現在正在分享這些更新,讓開發人員和其客戶有足夠的時間在粉絲專頁上傳達這些功能的淘汰訊息,並對粉絲專頁進行必要的變更。此功能將於 2022 年 12 月 14 日完全淘汰。

API 版本淘汰項目:

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

圖形 API

  • 2022 年 11 月 1 日:圖形 API 第 8.0 版將淘汰並從開放平台移除
  • 2023 年 2 月 23 日:圖形 API 第 9.0 版將淘汰並從開放平台移除
  • 2023 年 6 月 8 日:圖形 API 第 10.0 版將淘汰並從開放平台移除

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

Facebook 開放平台 SDK

作為我們開放平台 SDK 為期 2 年的淘汰時間表的一部分,請注意即將到來的淘汰和停用項目:

  • 2023 年 1 月:Facebook 開放平台 SDK 第 8.0 版或以下版本將停用
  • 2023 年 6 月:Facebook 開放平台 SDK 第 9. 0 版或以下版本將停用
  • 2023 年 10 月:Facebook 開放平台 SDK 第 11.0 版或以下版本將停用