13.0 版本

图谱 API

发布日期：2022 年 2 月 8 日 | 停用日期：待定 | 博文

Instagram 图谱 API

Instagram 媒体

版本 13 将是最后一个允许在 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}