第 13.0 版

圖形 API

發佈日期：2022 年 2 月 8 日 | 有效期限：待定 | 部落格文章

Instagram 圖形 API

IG 影音素材

第 13 版將會是在 IG 影音素材上允許 video_title 欄位要求，而不會傳回錯誤的最後一個版本。提醒您，2021 年 10 月 5 日部落格文章說明的目前 API 行為如下：

• 所有版本的 media_product_type 欄位都會傳回 FEED
• 所有版本的回應都會省略 video_title 欄位
• 所有版本都支援 Instagram Webhooks comments 和 mentions 欄位

以上行為適用於所有 IG 影音素材，包括以 Instagram TV 應用程式建立的 IG 影音素材，建立日期不拘。

用戶洞察報告

適用於 13.0 以上版本

下列 IG 用戶洞察報告衡量指標不再支援 since 和 until 參數，且回應不會包含 end_time JSON 屬性。

• audience_city
• audience_country
• audience_gender_age
• audience_locale

行銷 API

發佈日期：2022 年 2 月 8 日 | 有效期限：2023 年 1 月 25 日 | 部落格文章

廣告創意

版位素材客製化廣告

適用於 13.0 以上版本。

POST /{ad-account-id}/adcreatives 端點的 asset_feed_spec 節點現在可允許使用版位素材客製化廣告來建立輪播廣告。

廣告檔案庫 API

廣告檔案庫

適用於 13.0 以上版本。

GET /ads_archive 端點上的下列查詢關係連線和欄位已停用並更換：

GET /ads_archive 端點上的下列傳回參數已停用並更換：

廣告組合

類似廣告受眾擴充

適用於 13.0 以上版本，將於 2022 年 5 月 9 日套用至所有版本。

若為針對數值、轉換次數或應用程式事件最佳化的新建廣告組合，預設會啟用類似廣告受眾擴充，且無法停用。當我們收到針對數值、轉換次數或應用程式事件最佳化的廣告組合時，會在 targeting_optimization_types 地圖中傳回新的類似廣告受眾屬性，指出類似廣告受眾擴充已啟用，並且為詳細的目標設定擴充補上現有的 detailed_targeting 屬性。

此變更會影響下列端點：

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

轉換 API

顧客資訊參數

適用於 13.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

適用於 13.0 以上版本。

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

目錄

摘要 API

適用於 13.0 以上版本。

產品摘要上傳錯誤代碼 XML_JUNK_AFTER_DOCUMENT 已重新命名為 DATA_OUTSIDE_XML_TAGS。這只是名稱變更。

下列端點會受到影響：

• GET /{feed_upload_session_id}