全新推出 Facebook Graph API v15.0 和推廣 API v15.0

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

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

一般公告及更新

簡化自訂轉換事件建立條件

為了讓廣告客戶建立宣傳活動的程序更加簡單，新建立的自訂轉換事件最少需要遵循一項與 Graph API v15.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 用戶，本專案對其用作訊號的詳細目標設定（高效速成詳細目標設定）保持一致。我們之前對以轉換為目標和以轉換／價值為優化目標的廣告組合（VO／OC 廣告組合）推出了 API 專用高效速成詳細目標設定。

目前，當廣告客戶透過 API 建立以訊息或應用程式安裝為目標的廣告組合時，他們會傳遞兩項事物作為目標設定條件（L2）的一部分。他們會傳遞一個詳細目標設定輸入清單（如板球、足球、狗等），以及一個表明是否希望擴展這些輸入內容的標記（稱為高效速成詳細目標設定）。如果啟用此標記，我們的系統就會在有可能提高廣告成效的情況下，刊登超出其詳細目標設定選擇範圍的內容。如果停用此標記，我們的系統只會刊登廣告客戶所提供的選擇範圍清單。

日後（廣告管理員發佈後），當廣告客戶建立以訊息或流動應用程式安裝為目標的新宣傳活動時，其詳細目標設定包含條件只會用作指導廣告刊登的一個輸入項目，而非限制項目。因此，我們會為這些目標停用 DTE 標記，並使目標設定擴充成為詳細目標設定選擇範圍的預設行為。在此期間，我們會在有可能提高廣告成效的情況下，刊登超出其詳細目標設定包含條件的內容。所有其他目標設定選擇範圍和排除條件均不會受影響。此變更不適用於特殊類別。

運作方式：

以前，廣告客戶會傳遞 targeting_optimization 標記，而該標記的值可為 expansion_all 或 none，分別表示啟用或停用詳細目標設定擴充。鑒於這些廣告組合的詳細目標設定操作方式在語義上的變更，廣告客戶在建立以訊息或應用程式安裝為目標的廣告組合時無需傳遞此標記，因為此標記不會對他們新建立的廣告組合帶來影響。所有這些新建立的廣告組合會一律使用詳細目標設定包含條件作為傳遞給我們後端系統的訊號。後端系統可能會決定向這些選擇範圍以外的廣告受眾刊登廣告，但前提是這種刊登方式可為廣告客戶帶來更好的廣告成效。

鑒於 targeting_optimization 標記不會對新建立的廣告組合帶來任何影響，我們計劃日後在以訊息和／或應用程式安裝為目標的新宣傳活動中停用此欄位。

• 因此，如果廣告客戶在建立新 MAI／訊息廣告組合時或在查詢這些新建立廣告組合的刊登狀況預計時傳遞了 targeting_optimization 標記，我們就會傳回錯誤訊息，要求他們不再傳送此參數。
• 在建立新應用程式安裝／訊息廣告組合期間，後端會設定一個名為 targeting_as_signal 的新欄位。此欄位可在 GET 指令上使用，唯一目的是協助廣告客戶驗證他們的廣告組合是否超出詳細目標設定包含條件。

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

範圍內的 API 端點：

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

專頁分頁停用資訊

我們宣佈，專頁自訂分頁 API 功能不再透過 Graph API 提供。由於我們推出新版專頁體驗，部分專頁 API 功能會隨著我們的發展步伐而被停用。新版專頁體驗不再提供專頁自訂分頁功能，因此我們會停用對這些功能的 API 支援。我們現在分享這些更新，是為了讓開發人員及其客戶有充足時間透過他們的專頁傳達功能停用事宜，並對他們的專頁作出必要的變更。此功能會在 2022 年 12 月 14 日完全停用。

API 版本停用資訊：

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

Graph API

• 2022 年 11 月 1 日：Graph API v8.0 版會被停用並從平台移除
• 2023 年 2 月 23 日：Graph API v9.0 版會被停用並從平台移除
• 2023 年 6 月 8 日：Graph API v10.0 版會被停用並從平台移除

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

Facebook 平台 SDK

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

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