Introducing Graph API v22.0 and Marketing API v22.0
我們今天隆重推出 Graph API v22.0 和推廣 API v22.0。為配合本次的發佈版本，我們於下方重點列出了我們認為與部分開發人員社群相關的變更。這些變更包括公告、產品更新和停用通知，跟您應用程式與我們平台之間的整合息息相關。
如欲了解所有變更及詳情的完整清單，請參閱我們的變更記錄。
一般更新
推廣 API v22：更改能否在住屋、就業及金融商品和服務（包括信貸）宣傳活動中使用顧客名單自訂廣告受眾
適用於 v22.0 及以上版本，並會於 2025 年 3 月推出至所有版本
特定顧客名單自訂廣告受眾將無法再用於住屋、就業及金融商品和服務（包括信貸）宣傳活動。在此進一步了解此更新，看看您是否受相關限制約束。此外，廣告組合級別將新增 is_sac_cfca_terms_certified 欄位，詳情請參閱範例。若您展開住屋、就業及金融商品和服務（包括信貸）宣傳活動，則必須使用此欄位，以確認廣告組合中使用的任何顧客名單自訂廣告受眾均符合 Meta 的 CLCA 認證要求。由 2025 年 4 月初起，現有宣傳活動／廣告組合若有使用不符合要求的顧客名單自訂廣告受眾，便可能會被暫停。若發生此情況，您將在廣告管理員及推廣 API 中看到錯誤及相關指示。
以下端點將受到影響：
自訂廣告受眾 API v22
由 2025 年 1 月 6 日起，您可以使用全新 is_eligible_for_sac_campaigns 欄位，以識別某個自訂廣告受眾是否可用於特殊廣告類別宣傳活動的廣告組合。若您打算在特殊廣告類別宣傳活動中使用該廣告受眾，則須提供所需的 special_ad_categories 和 special_ad_category_countries，以及使用此廣告受眾建立或編輯廣告組合的 ad_account_id。
以下端點將受到影響：
接觸對所選城市和區域感興趣的用戶
很高興能夠宣佈，我們就地點目標設定推出了一項新功能。此功能可協助廣告客戶將接觸範圍擴大到目標城市或區域之外，讓我們的廣告系統能夠靈活地將廣告展示給對特定地點表現出興趣的用戶，進而提升廣告成效。
此功能擴展了我們現有的地點目標設定功能，讓您能接觸有興趣在同一個國家／地區內的目標城市和區域旅行、購物或展現一般興趣之用戶。
測試期間，使用全新地點目標設定功能的客戶發現，其每次成效成本降低了 6.7%。
請點擊此處了解更多資訊。
停用項目及重大變更
以 IG User、IG Media 和 IG Comment 端點，取代 Instagram User、Instagram Media、Instagram Carousel 和 Instagram Comment 端點
我們正在更改 Instagram Graph API 和推廣 API，讓開發人員更輕鬆地為各企業構建解決方案。此等變更生效後，我們將在 Graph API v22 停用 Instagram User、Instagram Media、Instagram Carousel 和 Instagram Comment 物件，以改用現有的 IG User、IG Media（包括 Carousel）和 IG Comment 物件。此外，我們已在這些新版物件中新增功能，使其在大部分使用案例中能提供與舊有物件相同的功能。
開發人員必須在 2026 年 1 月 21 日前更新其使用受影響推廣 API 端點的方式，並在 2025 年 4 月 21 日前更新其使用受影響 Graph API 端點的方式。如果您是在 API 呼叫中自動更新 Graph API 版本，建議您檢視此等變更，因為這些變更會即時影響使用 Graph API v22 的開發人員。
請參閱開發人員網誌，了解上述變更的詳細資訊，包括哪些端點將發生變化、我們不再支援哪些使用案例，以及變更生效時間表。
移除詳細目標設定排除條件
為了持續協助廣告客戶提升成效，我們將移除詳細目標設定排除條件。在此過程中，您仍可在帳戶級別的廣告受眾控制選項內排除自己的僱主。如要進一步了解帳戶控制選項，請瀏覽此處。
我們相信這項變更將有助提升宣傳活動成效。一項廣告客戶測試顯示，不使用詳細目標設定排除條件時，每次轉換成本的中位數比使用詳細目標設定排除條件時降低了 22.6%。
由於這項變更，排除條件欄位將不再支援自訂廣告受眾。不過，您仍然可以改為使用 excluded_custom_audiences 欄位，以繼續使用自訂廣告受眾排除條件。
由 2025 年 1 月 21 起，開發人員可以開始執行相關程式碼變更，且須於 2025 年 4 月 21 日前完成更新。此項變更將在 v22 中推出。請參閱開發人員網誌，取得會受此變更所影響的端點之清單。
停用推廣 API 中的標準強化效果組合
推廣 API v22.0 對進階高效速成廣告創意強化效果的影響
在此全新的推廣 API 版本中，我們將停用進階高效速成廣告創意標準強化效果組合，並以個別廣告創意強化效果選項取而代之。歡迎在此處進一步了解進階高效速成廣告創意。
您可以在此進一步了解與開發人員社群相關的資訊，也可以在此查閱我們的開發人員文件以取得更多詳情。
以下端點將不再支援標準強化效果：
- POST /{ad_account_id}/adcreatives
- POST /{ad_account_id}/ads
- GET /{ad_id}/previews
推出 Instagram「檢視次數」衡量指標，並停用「展示次數」和「播放次數」衡量指標
為了持續統一 Instagram API 與 Instagram 應用程式的功能，我們現於所有 API 版本推出「檢視次數」衡量指標，且這項衡量指標同時適用於影音素材和用戶洞察報告。若是影音素材洞察報告，Feed、Story 和 Reels 物件將傳回檢視次數。若是用戶洞察報告，API 會就追蹤者類型和影音產品類型提供多方面的資料細節，以支援「檢視次數」衡量數據。
此外，以下衡量數據將由 v22 起停用：
- plays（影音素材洞察報告）：在系統計算 1 次展示後，連續短片開始播放的次數。
- clips_replays_count（影音素材洞察報告）：連續短片在初次播放後開始重播的次數；此衡量數據的定義為在同一個連續短片連線階段中，連續短片重播至少 1 毫秒的次數。
- ig_reels_aggregated_all_plays_count（影音素材洞察報告）：在系統計算 1 次展示後，連續短片開始播放或重播的次數。
- impressions（影音素材和用戶洞察報告）：Instagram Media 物件的總觀看次數。
只有在 2024 年 7 月 2 日當天或之後建立的影音素材才會停用影音素材洞察報告「展示次數」衡量數據。如果影音素材是在此日期之前建立，API 會繼續在所有版本如常回傳相關值。
如需進一步了解 Instagram 用戶洞察報告和 Instagram 影音素材洞察報告，請參閱開發人員文件。建議您的開發人員在 2025 年 4 月 21 日之前更新，以免發生問題。
Meta Business SDK
Meta Business SDK v22 版本
Meta Business SDK v22 將緊隨 Graph API v22 版本之後發佈。此版本將包含錯誤修正、相依項目升級、全新功能；最重要的是，此版本亦包括更新版 API 介面，以與 Graph API v22 保持一致。
根據我們平台 SDK 的兩年停用計劃，接下來的停用和棄用項目如��：
- 2025 年 5 月：停用 Facebook 平台 SDK v17.0 或更低版本。
API 版本停用資訊：
根據 Facebook 的 Graph API 和推廣 API 版本控制時間表，接下來的停用項目如下：
Graph API
- 2025 年 5 月 14 日：停用並從平台移除 Graph API v.16
- 2025 年 9 月 12 日：停用並從平台移除 Graph API v.17
推廣 API
- 2025 年 2 月 4 日：停用並從平台移除推廣 API v19.0
- 2025 年 5 月 6 日：停用並從平台移除推廣 API v20.0
為免導致業務中斷，我們建議您立即將所有呼叫轉移至今天發佈的最新 API 版本。
