Introducing Graph API v22.0 and Marketing API v22.0

發佈者： Ayyad Farah

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

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

一般更新

行銷 API 第 22 版針對住房、就業及金融商品和服務（包括信貸）行銷活動，變更了顧客名單自訂廣告受眾的使用方式

適用於「v22.0 以上版本」，並且將在 2025 年 3 月向所有版本推出

特定顧客名單自訂廣告受眾將不再符合用於住房、就業及金融商品和服務（包括信貸）行銷活動的資格。請前往此處瞭解有關更新的詳細資訊，以及您是否適用相關限制。此外，廣告組合層級將新增 is_sac_cfca_terms_certified 欄位，請參閱範例。對於包含住房、就業、金融商品和服務（包含信貸）的廣告活動，如果您要在廣告組和中使用任何顧客名單自訂廣告受眾，您將需要使用此欄位，確認該廣告受眾是否符合 Meta 的 CLCA 認證資格。自 2025 年 4 月初起，使用不符合要求的顧客名單自訂廣告受眾的現有行銷活動／廣告組合可能會遭到暫停。若發生此情況，您將會在廣告管理員和行銷 API 中看到錯誤和相關指示。

以下端點將受到影響：

自訂廣告受眾 API 第 22 版

自 2025 年 1 月 6 日起，您就可以使用新的 is_eligible_for_sac_campaigns 欄位，來識別某自訂廣告受眾是否可在特殊廣告類別行銷活動的廣告組合中使用。您必須針對將使用廣告受眾的特殊廣告類別行銷活動提供所需的 special_ad_categories 和 special_ad_category_countries，以及提供將使用廣告受眾來建立或編輯廣告組合的 ad_account_id。

以下端點將受到影響：

GET /custom_audience_id

觸及對所選城市和地區感興趣的用戶

我們很高興分享我們針對地點目標設定推出的新功能，此功能可協助廣告主透過將觸及範圍拓展至目標城市或地區之外來提升成效，也讓我們的系統能夠靈活地向對某地點感興趣的用戶投遞廣告。

這是依據我們現有的地點目標設定功能所擴展的功能，可讓您觸及那些對您所鎖定的城市和地區（在同一國家／地區內）展現出旅行、購物意向或廣泛興趣的用戶。

測試期間，使用新的地點目標設定功能的客戶，每次成果成本降低了 6.7%。

如需更多資訊，請點擊此處。

淘汰項目與重大變更

以 IG 用戶、IG 影音素材和 IG 留言端點取代 Instagram 用戶、Instagram 影音素材、Instagram 輪播和 Instagram 留言端點

我們正在對 Instagram 圖形 API 和行銷 API 進行變更，讓開發人員能夠更容易地為商家打造解決方案。有了這些變更，我們將在圖形 API 第 22 版中停用 Instagram 用戶、Instagram 影音素材、Instagram 輪播和 Instagram 留言物件，改為使用現有的 IG 用戶、IG 影音素材（其中包含輪播）和 IG 留言物件。我們也已經為這些較新的物件新增功能，已針對大部分使用案例提供一致性。

開發人員必須在 2026 年 1 月 21 日之前更新對受影響的行銷 API 端點的使用方式，並且必須在 2025 年 4 月 21 日之前更新對受影響的圖形 API 端點的使用方式。如果您在 API 呼叫中啟用自動更新圖形 API 版本，建議您審查這些變更，因為系統將為使用圖形 API 第 22 版的開發人員立即套用這些變更。

請參閱開發人員部落格以瞭解此變更的更多相關詳細資料，包括將變更的端點、不再支援的使用案例，以及套用的時程。

移除詳細目標設定排除條件

為持續協助廣告主提升成效，我們將移除詳細目標設定排除條件。作為此程序的一部分，我們將繼續支援在帳號層級於廣告受眾控制項內排除您的員工的功能。如需關於帳號控制項的更多資訊，請參閱此處。

我們相信此變更將有助於提升行銷活動成效。一項廣告主測試顯示，與使用詳細目標設定排除條件相比，不使用詳細目標設定排除條件時，每次轉換成本的中位數降低 22.6%。

由於此變更，我們將停用排除條件欄位中的自訂廣告受眾。您仍可以改為使用 excluded_custom_audiences 欄位，以持續使用自訂廣告受眾排除條件。

從 2025 年 1 月 21 日開始，開發人員可以開始實作程式碼變更，並且必須在 2025 年 4 月 21 日之前更新。此變更將於第 22 版中推出。請參閱開發人員部落格，以取得有關此變更的受影響端點的清單。

停用來自行銷 API 的標準強化效果組合包

行銷 API 第 22.0 版對高效速成+ 廣告創意強化效果的影響

在這個新的行銷 API 版本中，我們將停用高效速成+ 廣告創意標準強化效果組合包，並以個別廣告創意強化效果選項取代。您可以在這裡深入瞭解高效速成+ 廣告創意的相關資訊。

您可以在此瞭解有關開發人員社群的更多資訊，也可以在此從我們的開發人員文件找到其他詳細資訊。

以下端點將不再支援標準強化效果：

POST /{ad_account_id}/adcreatives
POST /{ad_account_id}/ads
GET /{ad_id}/previews

推出 Instagram 瀏覽次數衡量指標，以及停用曝光次數和播放次數衡量指標

為持續讓 Instagram API 的功能與 Instagram 應用程式一致，我們在所有 API 版本上推出同時適用於影音素材和用戶洞察報告的「瀏覽次數」衡量指標。在影音素材洞察報告中，動態消息、限時動態和 Reels 物件將傳回瀏覽次數。在用戶洞察報告中，API 將支援針對粉絲類型和媒體產品類型使用多維度資料解析的「瀏覽次數」衡量指標。

此外，以下衡量指標將自第 22 版起停用：