v13.0 版

Graph API

發佈日期：2022 年 2 月 8 日 | 停用日期：待定 | 網誌文章

Instagram Graph API

Instagram 媒體

v13 版本將是最後一個允許在 Instagram 媒體上要求 video_title 欄位而不傳回錯誤的版本。提醒您，2021 年 10 月 5 日網誌文章中概述的目前 API 行為如下：

• media_product_type 欄位會傳回 FEED（所有版本適用）
• 回應會省略 video_title 欄位（所有版本適用）
• Instagram Webhooks comments 和 mentions 欄位已受支援（所有版本適用）

上述行為適用於所有 Instagram 媒體，其中包括在任何建立日期使用 Instagram TV 應用程式建立的 Instagram 媒體。

用戶洞察報告

適用於 v13.0 版本及以上版本。

以下 Instagram 用戶洞察報告衡量數據不再支援 since 和 until 參數，回應也不會包含 end_time JSON 屬性。

• audience_city
• audience_country
• audience_gender_age
• audience_locale

推廣 API

發佈日期：2022 年 2 月 8 日 | 停用日期：2023 年 1 月 25 日 | 網誌文章

廣告創意

版位素材自訂廣告

適用於 v13.0 版本及以上版本。

POST /{ad-account-id}/adcreatives 端點的 asset_feed_spec 節點現在支援使用版位素材自訂廣告建立輪播廣告。

廣告檔案庫 API

廣告檔案庫

適用於 v13.0 版本及以上版本。

GET /ads_archive 端點上的部分查詢關係連線和欄位已遭停用且已被取代，詳情如下：

GET /ads_archive 端點上的部分傳回參數已遭停用且已被取代，詳情如下：

廣告組合

類似廣告受眾擴充功能

適用於 v13.0 版本及以上版本。將從 2022 年 5 月 9 日起適用於所有版本。

如為優化價值、轉換或應用程式事件而建立了新的廣告組合，類似廣告受眾擴充功能將會預設啟用，而且無法停用。取得為優化價值、轉換或應用程式事件的廣告組合時，我們會在 targeting_optimization_types 對應中傳回新的類似廣告受眾屬性，該屬性會指明類似廣告受眾擴充功能已啟用，並會補充詳細目標設定擴充的現有 detailed_targeting 屬性。

這會影響以下端點：

• POST /{ad-account-id}/adsets
• GET /{ad-account-id}/adsets

轉換 API

顧客資訊參數

適用於 v13.0 版本及以上版本。

此版本對被視為對事件有效的顧客資訊參數組合加入了新要求。如果某個事件僅包含由以下其中一種組合（或其子集）構成的參數，則將視為無效：

• ct + country + st + zp + ge + client_user_agent
• db + client_user_agent
• fn + ge
• ln + ge

如要確保您的事件不會擲回錯誤，建議您參閱轉換 API 最佳操作實例。

這會影響以下端點：

• POST /{pixel-id}/events
• POST /{offline_dataset_id}/events

商務平台

配送設定 API

適用於 v13.0 版本及以上版本。

GET /{cms-id}/shipping_profiles 端點的 handling_time 欄位已從 shipping_profile 物件移至 address_category 物件。

目錄

動態消息 API

適用於 v13.0 版本及以上版本。

商品動態消息上載錯誤代碼 XML_JUNK_AFTER_DOCUMENT 已重新命名為 DATA_OUTSIDE_XML_TAGS。此項僅為重新命名操作。

以下端點會受到影響：

• GET /{feed_upload_session_id}