获取升级版 Smart+ 广告
此接口可用于获取广告账号内的升级版 Smart+ 广告。
重要提示
此接口仅返回你主动选择的创意。自动添加的创意不会包含在返回结果中。 排除的创意包括： - TikTok 创作者内容，来自 TikTok One、Content Suite 和授权 TikTok 帖子的创作者内容 - 你的自有内容，你之前使用过的来自关联 TikTok 账号和创意素材库的内容 - 为你生成的内容，例如混剪你的应用商店页面中的图片若想获取推广系列中的所有创意，包括自动添加的创意，需使用 /ad/get/ 接口。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/get/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](1738373164380162.html)接口获取。 |
参数
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|fields|string[]|要获取的字段。<br><br>未指定时，默认返回所有字段。<br><br>参见<a href="#item-link-Response">返回</a>小节中 `list` 和 `ad_configuration` 下的字段（不包含默认返回的 `advertiser_id` 和 `smart_plus_ad_id`），了解允许的字段。|
|filtering|object|筛选条件。<br><br>示例：`filtering={"objective_type":"APP_PROMOTION"}`|
#| campaign_ids|string[]|按推广系列 ID 筛选。<br><br>最大数量：100。<br><br>若想获取推广系列 ID，需使用 [/smart_plus/campaign/get/](1843312818332930.html) 接口。 |
#| adgroup_ids|string[]|广告组 ID 列表。<br><br>最大数量：100。<br><br>若想获取广告组 ID，需使用 [/smart_plus/adgroup/get/](1843314879617026.html) 接口。|
#| smart_plus_ad_ids|string[]|广告 ID 列表。<br><br>最大数量：100。|
#| primary_status|string|一级状态。<br><br>枚举值参见[枚举值 - 一级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Primary%20Status)。|
#| secondary_status|string|按广告二级状态筛选。<br><br>枚举值参见[枚举值 - 广告状态 - 二级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Ad%20status%20-%20secondary%20status)。<br><br>以下为新增的升级版 Smart+ 广告二级状态：<ul><li>`AD_STATUS_DELIVERY_AND_REAUDIT`：正在审核修改内容。</li><li>`AD_STATUS_DELIVERY_AND_TRANSCODING_FAIL`：广告中的一个或多个视频转码失败。</li><li>`AD_STATUS_REVIEW_PARTIALLY_APPROVED`：正在审核部分广告内容，同时广告正在投放。</li><li>`AD_STATUS_COLLECTION_TOGGLED_OFF`：线索收集已结束。</li><li>`AD_STATUS_PRIVACY_POLICY_REJECTED`：广告因违反隐私政策被拒。</li><li>`AD_STATUS_PRIVACY_POLICY_AUDIT`：广告正在进行隐私政策合规性审核。</li></ul>|
#| objective_type|string|按推广目标筛选。<br><br>目前，我们支持 `APP_PROMOTION`、`WEB_CONVERSIONS` 和 `LEAD_GENERATION`。<br><br>如需详细了解枚举值，参见[枚举值 - 推广目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Advertising%20Objective)。|
#| sales_destination | string | 销售目标页面，即你希望提升销量的目标页面。<br><br>枚举值：<ul><li>`WEBSITE`：网站。提升你的网站上的销量。</li><li>`APP`：应用。提升你的应用上的销量（需要商品库）。</li><li>`WEB_AND_APP`：网站和应用。提升你的网站和应用上的销量。</li></ul>|
#| optimization_goal|string|优化目标。<br><br>枚举值参见[枚举值 - 优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Optimization%20Goal)。|
#| creation_filter_start_time|string|最早广告创建时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）。此筛选条件将检索在该时间之后创建的广告。<br><br>示例：`2025-01-01 00:00:01`。<br><br>如果未指定 `creation_filter_start_time` 和 `creation_filter_end_time`，结果将包含在任意时间创建的广告。<br><br><p><span style="color:DarkRed"><b>重要提示</b></span>：为确保任务效率和速度，建议将创建时间筛选条件的范围设置在 6 个月以内。|
#| creation_filter_end_time|string|最近广告创建时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）。此筛选条件将检索在该时间之前创建的广告。<br><br>示例：`2025-02-01 00:00:01`。<br><br>如果未指定 `creation_filter_start_time` 和 `creation_filter_end_time`，结果将包含在任意时间创建的广告。<br><br><p><span style="color:DarkRed"><b>重要提示</b></span>：为确保任务效率和速度，建议将创建时间筛选条件的范围设置在 6 个月以内。|
#| modified_after|string|最近广告修改时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC 时间）。此筛选条件将检索在该时间之后修改的广告。<br><br><p><span style="color:DarkRed"><b>重要提示</b></span>：为确保任务效率和速度，建议将创建时间筛选条件的范围设置在 6 个月以内。|
|page|number|当前页码。<br><br>值范围：≥ 1。<br>默认值：1。|
|page_size|number|分页大小。<br><br>值范围：1-100。<br>默认值：10。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/get/?advertiser_id={{advertiser_id}}&page=1&page_size=100' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|list|object[]|广告列表。返回字段根据请求参数中指定的 `fields` 生成。如果未指定，默认返回所有字段。|
##|advertiser_id|string|广告主 ID。|
##|campaign_id|string|推广系列 ID。|
##|campaign_name|string|推广系列名称。|
##|adgroup_id|string|广告组 ID。|
##|adgroup_name|string|广告组名称。|
##|smart_plus_ad_id|string|广告 ID。|
##|ad_name|string|广告名称。|
##|operation_status|string|操作状态。<br><br>枚举值：<ul><li>`ENABLE`：广告已启用（处于“开启”状态）。</li><li>`DISABLE`：广告未启用（处于“关闭”状态）。</li><li>`FROZEN`：广告已终止，无法启用。</li></ul>|
##|secondary_status|string|广告二级状态。<br><br>枚举值参见[枚举值 - 广告状态 - 二级状态](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Ad%20status%20-%20secondary%20status)。<br><br>以下为新增的升级版 Smart+ 广告二级状态：<ul><li>`AD_STATUS_DELIVERY_AND_REAUDIT`：正在审核修改内容。</li><li>`AD_STATUS_DELIVERY_AND_TRANSCODING_FAIL`：广告中的一个或多个视频转码失败。</li><li>`AD_STATUS_REVIEW_PARTIALLY_APPROVED`：正在审核部分广告内容，同时广告正在投放。</li><li>`AD_STATUS_COLLECTION_TOGGLED_OFF`：线索收集已结束。</li><li>`AD_STATUS_PRIVACY_POLICY_REJECTED`：广告因违反隐私政策被拒。</li><li>`AD_STATUS_PRIVACY_POLICY_AUDIT`：广告正在进行隐私政策合规性审核。</li></ul>|
##|create_time|string|广告创建时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br>示例：`2025-01-01 00:00:01`。|
##|modify_time|string|广告最后修改时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br>示例：`2025-01-01 00:00:01`。|
##|creative_list|object[]|创意列表。<br><br><p><span style="color:darkred"><b>重要提示</b></span>：此字段仅返回你主动选择的创意。自动添加的创意不会包含在返回结果中。排除的创意包括：<ul><li>TikTok 创作者内容，来自 TikTok One、Content Suite 和授权 TikTok 帖子的创作者内容</li><li>你的自有内容，你之前使用过的来自关联 TikTok 账号和创意素材库的内容</li><li>为你生成的内容，例如混剪你的应用商店页面中的图片</li></ul>若想获取推广系列中的所有创意，包括自动添加的创意，需使用 [/ad/get/](https://business-api.tiktok.com/portal/docs/get-ads/v1.3) 接口。</p>|
###|ad_material_id|string|在广告中使用特定创意时生成的广告特定素材 ID。<br><br>此 ID 不同于你将创意素材上传到广告账号的创意素材库时所收到的创意 ID。|
###|material_operation_status|string|创意的状态。<br><br>枚举值： <ul><li>`ENABLE`：创意已启用（处于“开启”状态）。</li><li>`DISABLE`：创意未启用（处于“关闭”状态）。</li></ul>|
###|creative_info|object|创意信息。|
####|ad_format|string|广告样式。<br><br>枚举值： <ul><li>`SINGLE_VIDEO`：单视频广告。</li><li>`CAROUSEL_ADS`：标准轮播。</li><li>`CATALOG_CAROUSEL`：商品库轮播。</li></ul>|
####|material_name|string|素材名称。|
####|video_info|object|视频信息。|
#####|video_id|string|视频 ID。|
#####|file_name|string|视频名称。|
####|image_info|object[]|图片信息。|
#####|web_uri|string|图片 ID。|
####|music_info|object|音乐信息。|
#####|music_id|string|轮播广告中使用的音乐的 ID。|
####|aigc_disclosure_type|string|是否开启 AIGC（人工智能生成内容）自主披露开关，标注广告包含 AI 生成内容。该开关开启后，当广告以完整形式展示时，将显示“广告主标记为 AI 生成”标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：开启开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。</li></ul>|
####|tiktok_item_id|string|作为广告 (Spark Ads) 投放的 TikTok 帖子的 ID。|
####|identity_type|string|当不使用商品库创意创建 Spark Ads 时返回。<br><br>广告发布身份类型。<br><br>枚举值：`AUTH_CODE`、`TT_USER`、`BC_AUTH_TT`。<br><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。|
####|identity_id|string|当不使用商品库创意创建 Spark Ads 时返回。<br><br>广告发布身份 ID。|
####|identity_authorized_bc_id|string|当 `creative_info` 中的 `identity_type` 为 `BC_AUTH_TT` 时返回。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
##|playable_list|object[]|试玩素材列表。|
###|playable_url|string|试玩素材 URL。|
##|ad_text_list|object[]|广告文案列表。<br><br>广告文案作为广告创意的一部分展示给受众，用于传递你希望传达的信息。|
###|ad_text|string|广告文案。|
##|auto_message_list|object[]|仅当广告组层级的 `promotion_type` 为 `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE` 时返回。<br><br>在 TikTok 私信广告中使用的自动消息的详情。|
###|auto_message_id|string|在 TikTok 私信广告中使用的自动消息的 ID。<br><br>目前唯一支持的自动消息类型是欢迎消息。<ul><li>若想获取广告账号中的欢迎消息列表，需使用 [/creative/auto_message/get/](1822106498804738.html) 接口。</li><li>若想在广告账号内创建欢迎消息，需使用 [/creative/auto_message/create/](1822106113771521.html) 接口。</li></ul><br>如需了解如何创建包含欢迎消息的 TikTok 私信广告，参见[创建以 TikTok 私信作为优化位置的升级版 Smart+ 线索收集推广系列](1847302969710913.html)。|
##|call_to_action_list|object[]|行动引导文案列表。|
###|call_to_action|string|行动引导文案。<br><br>枚举值参见[枚举值 - 行动引导文案](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Call-to-action)。|
##|interactive_add_on_list|object[]|创新互动样式（创意素材包）ID 列表。|
###|card_id|string|创新互动样式 ID。|
##|page_list|object[]|页面列表。|
###|page_id|string|页面 ID。|
##|landing_page_url_list|object[]|落地页 URL 列表。|
###|landing_page_url|string|落地页 URL。|
##|custom_product_page_list|object[]|广告中使用的自定产品页面的详细信息。|
###|custom_product_page_url|string|自定义商品页 (CPP) URL。<br><br>CPP 是包含自定义截图、宣传文案和应用预览的产品页面，可用于重点展示所推广应用的特定内容或功能，或触达特定受众。<br><br>示例：`https://apps.apple.com/us/app/tiktok/id835599320?ppid=12345a6b-c789-12d3-e4f5-g6h78i91jk2l`。|
##|deeplink_list|object[]|深度链接列表。|
###|deeplink|string|深度链接，即你希望已安装应用的受众跳转到的具体位置。|
###|deeplink_type|string|深度链接类型。<br><br>枚举值：<ul><li>`NORMAL`：非延迟深度链接。</li><li>`DEFERRED_DEEPLINK`：延迟深度链接。</li></ul>|
##| disclaimer | object | 免责声明信息。 |
###| disclaimer_type | string | 广告中免责声明的类型。<br><br>枚举值： <ul><li>`TEXT_LINK`：文字链免责声明。</li><li>`TEXT_ONLY`：纯文本免责声明。</li></ul> |
###| disclaimer_text | object | 广告中的纯文本免责声明。 |
####| text | string | 免责声明的文本。 |
###| disclaimer_clickable_texts | object[] | 广告中的一个或多个文字链免责声明。 |
####| text | string | 免责声明的文本。 |
####| url | string | 文字链免责声明的 URL。<br>用户点击每个文本后将跳转到相应的 URL，查看免责声明的更多详细信息。 |
##|ad_configuration|object|其他配置。|
###|identity_type|string|在以下任意场景中返回：<ul><li>非 Spark Ads 投放到非 TikTok 广告位。现已不再支持将非 Spark Ads 投放到 TikTok 广告位。</li><li>使用电商商品库中的创意创建 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 电商商品库广告](1847302895272962.html)。</li></ul><br>广告发布身份类型。<ul><li>对于投放到非 TikTok 广告位的非 Spark Ads，广告发布身份类型的枚举值为：`CUSTOMIZED_USER`。</li><li>对于升级版 Smart+ 电商商品库 Spark Ads（`catalog_creative_toggle` 为 `true`），广告发布身份类型的枚举值为：`TT_USER`、`BC_AUTH_TT`。</li></ul><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。|
###|identity_id|string|在以下任意场景中返回：<ul><li>非 Spark Ads 投放到非 TikTok 广告位。现已不再支持将非 Spark Ads 投放到 TikTok 广告位。</li><li>使用电商商品库中的创意创建 Spark Ads。如需详细了解如何创建此类广告，参见[创建升级版 Smart+ 电商商品库广告](1847302895272962.html)。</li></ul><br>广告发布身份 ID。|
###|identity_authorized_bc_id|string|当 `ad_configuration` 中的 `identity_type` 为 `BC_AUTH_TT` 时返回。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
###|dark_post_status|string|关于你的创意是否“只在广告中显示”的状态。<br><br>枚举值：<ul><li>`ON`：启用“只在广告中显示”，你的帖子仅通过付费流量展示。</li><li>`OFF`：禁用“只在广告中显示”。帖子将出现在你的 TikTok 主页上，并可获得自然流量。</li></ul>|
###|product_specific_type|string|选择商品的不同维度。<br><br>枚举值：<ul><li>`ALL`：允许 TikTok 动态选择所有商品。</li><li>`PRODUCT_SET`：传入商品系列。TikTok 将动态选择该商品系列中的商品。</li><li>`CUSTOMIZED_PRODUCTS`：传入自定义数量的商品。</li><li>`UNSET`：未设置。</li></ul>|
###|product_set_id|string|商品系列 ID。|
###|product_ids|string[]|商品库商品的 ID。|
###|catalog_creative_toggle|boolean|是否启用从商品库自动选择创意。<br><br>支持的值：`true`、`false`。|
###|catalog_creative_info|object|在广告中使用的商品库创意的其他设置。|
####|catalog_media_settings|string[]|在广告中使用的电商商品库或娱乐商品库创意的类型。<br><br>对于[升级版 Smart+ 电商商品库广告](1847302895272962.html)，枚举值为：<ul><li>`VIDEO`：视频。</li><li>`IMAGE`：图片。</li><li>`TEMPLATE_VIDEO`：视频模板。</li></ul><br>对于[升级版 Smart+ 流媒体广告](https://business-api.tiktok.com/portal/docs/create-upgraded-smart-streaming-ads/v1.3)，枚举值为： <ul><li>`VIDEO`：视频。</li><li>`TEMPLATE_VIDEO`：视频模板。 </li><li>`MULTI_SHOW`：多影片。多影片体验是一种支持自动播放的视频轮播体验，旨在引导用户探索内容库中契合其兴趣的丰富资源，并与之互动。多影片体验由来自商品库的 4 个视频磁贴组成。每个磁贴片段从左上角开始按顺序播放，你可以为磁贴设置相应的特定影片落地页。</li></ul>|
####|catalog_template_video_id|string|在广告中使用的商品库视频模板的 ID。|
###| creative_auto_add_toggle | boolean | 是否在投放期间自动添加新生成的素材。<br>在推广系列投放期间，系统将根据你现有的推广系列素材和创意素材库生成新的创意素材。通过使用 TikTok 最新热门元素（开场、音乐、文案等），你将获得现成的优质内容，这些内容可与你选择的其他素材一起投放。<br>新素材将自动添加到你的推广系列中，不会显示在你的 TikTok 主页上。你可以随时关闭此功能。<br><br>支持的值：`true`、`false`。 |
###| creative_auto_enhancement_strategy_list | string[] | 应用于你的广告的自动优化策略列表。<br>自动优化功能会在推广系列投放期间对广告进行实时修改。这项功能可以通过打造更具吸引力和冲击力的视觉、声音等元素来提升广告效果。<br><br>枚举值：<ul><li>`TRANSLATE_AND_DUB`：翻译和配音。以超过 50 种语言投放广告，与全球受众建立联系。</li><li>`MUSIC_REFRESH`：音乐焕新。替换为当前 TikTok 上流行的音乐，紧跟潮流趋势。</li><li>`VIDEO_QUALITY`：视频质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_QUALITY`：图片质量。通过提高分辨率和清晰度来提升整体视觉效果。</li><li>`IMAGE_RESIZE`：调整尺寸。调整图片大小，充分利用全屏功能。</li><li>`CALL_TO_ACTION_ENHANCEMENT`：CTA 优化。根据具体使用场景定制并优化行动引导文案，帮助提升广告效果。</li><li>`AIGC_CARD`：生成广告卡片。展示关键信息和视觉元素，增进互动，提升点击量和转化量。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：目前无法调用 API 通过 `creative_auto_enhancement_strategy_list` 启用 `CALL_TO_ACTION_ENHANCEMENT` 和 `AIGC_CARD` 策略。</p>|
###|deeplink_utm_params|object[]|深度链接 URL 参数列表。URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。|
####|key|string|深度链接 URL 参数。<br><br>这类参数可为自定义参数或 UTM 参数。<br><br>支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。</li></ul>|
####|value|string|深度链接 URL 参数的值。<br><br>可为自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`__CAMPAIGN_NAME__`：这将替换为你的推广系列名称。</li><li>`__CAMPAIGN_ID__`：这将替换为你的推广系列 ID。</li><li>`__AID_NAME__`：这将替换为你的广告组名称。</li><li>`__AID__`：这将替换为你的广告组 ID。</li><li>`__CID_NAME__`：这将替换为你的广告名称。</li><li>`__CID__`：这将替换为你的广告 ID。</li><li>`__PLACEMENT__`：这将替换为你的广告位。</li></ul>|
###|end_card_cta|string|[汽车库存轮播广告](1843325008693250.html)、升级版 Smart+ [汽车型号轮播广告](1843325022799873.html)或[适用于升级版 Smart+ TikTok 私信广告的商品库解决方案](https://business-api.tiktok.com/portal/docs?id=1847302969710913#item-link-For%20the%20catalog%20solution)的片尾卡片 (`image_ids`) 行动引导文案。<br><br>枚举值：<ul><li>`SEARCH_INVENTORY`（推荐）：搜索库存。</li><li>`LEARN_MORE`：查看详情。</li><li>`SHOP_NOW`：去逛逛。</li><li>`SIGN_UP`：立即注册。</li><li>`CONTACT_US`：联系我们。</li><li>`BOOK_NOW`：立即预约。</li><li>`READ_MORE`：阅读更多。</li><li>`VIEW_MORE`：立即查看。</li><li>`ORDER_NOW`：立即下单。</li><li>`SEND_MESSAGE`：发消息。<ul><li>此值仅适用于[升级版 Smart+ TikTok 私信广告的商品库解决方案](https://business-api.tiktok.com/portal/docs?id=1847302969710913#item-link-For%20the%20catalog%20solution)。</li></ul></li></ul>|
###|product_display_field_list|string[]|[汽车库存轮播广告](1843325008693250.html)中展示的商品详情的列表。<br><br>枚举值：<ul><li>`DEALER_NAME`：车辆的 `dealer_name` 字段。</li><li>`MAKE`：车辆的 `make` 字段。</li><li>`MODEL`：车辆的 `model` 字段。</li><li>`YEAR`：车辆的 `year` 字段。</li><li>`MILEAGE`：车辆的 `mileage` 字段。</li><li>`PRICE`：车辆的 `price` 字段。</li><li>`SALE_PRICE`：车辆的 `sale_price` 字段。</li><li>`EXTERIOR_COLOR`：车辆的 `exterior_color` 字段。</li><li>`TRIM`：车辆的 `trim` 字段。</li><li>`ADDRESS_CITY`：车辆的 `city` 字段。</li><li>`VEHICLE_STATE`：车辆的 `state_of_vehicle` 字段。</li></ul><br>每辆车的标题将自动显示。例如，如果将此字段设置为 `["MILEAGE","YEAR"]`，广告将展示每辆车的 `mileage`、`price` 和 `title` 字段。<br><br>若想获取汽车库存商品库中车辆的商品详情字段，并检查是否需要更新详情，需使用 [/catalog/product/get/](1740564136678402.html) 接口。|
###|auto_disclaimer_types|string[]|[汽车型号轮播广告](1843325022799873.html)中展示的免责声明类型。<br><br>枚举值：<ul><li>`EMISSION`：排放免责声明。</li><li>`DISCOUNT`：折扣或优惠免责声明。</li></ul>|
###|utm_params|object[]|URL 参数列表。<br><br>URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。|
####|key|string|URL 参数。<br><br>这类参数可为自定义参数或 UTM 参数。<br><br>支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。</li></ul>注意：UTM 参数区分大小写。|
####|value|string|URL 参数的值。<br><br>值可为自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`__CAMPAIGN_NAME__`：这将替换为你的推广系列名称。</li><li>`__CAMPAIGN_ID__`：这将替换为你的推广系列 ID。</li><li>`__AID_NAME__`：这将替换为你的广告组名称。</li><li>`__AID__`：这将替换为你的广告组 ID。</li><li>`__CID_NAME__`：这将替换为你的广告名称。</li><li>`__CID__`：这将替换为你的广告 ID。</li><li>`__PLACEMENT__`：这将替换为你的广告位。</li></ul>|
###|fallback_type|string|失败路径类型。<br><br>用户因未安装应用而无法访问深度链接时跳转到的目标页面。<br><br>枚举值：<ul><li>`WEBSITE`：将推广的网页作为失败路径 URL。同时，你需要通过 `landing_page_url_list` 传入失败路径 URL。</li></ul><br>如需了解如何在 TikTok 即时通讯广告中配置失败路径 URL，参见[创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列](1847302988449921.html)。|
###|product_info|object|商品信息。<br><br>此信息将用于不同广告变体以实现个性化广告投放，从而提升广告效果。过去的数据表明，信息完整的广告通常能获得更高的点击量和转化量。具体效果可能有所不同。|
####| product_titles | string[] | 商品名称列表。 |
####| product_image_list | object[] | 商品图片列表。 |
#####| web_uri | string | 商品图片 ID。 |
####| selling_points | string[] | 卖点列表。 |
####| catalog_tag_list | string[] | 在以下任意场景中返回：<ul><li>场景 1：推广系列层级的 `objective_type` 为 `WEB_CONVERSIONS` 且 `catalog_type` 为 `ECOMMERCE`。</li><li>场景 2： <ul><li>在推广系列层级，`objective_type` 为 `LEAD_GENERATION` 且 `catalog_enabled` 为 `true`。</li><li>在广告组层级通过 `catalog_id` 传入汽车库存商品库。</li></ul></li></ul>商品库广告的商品详细信息。<ul><li>在场景 1 中，将自动显示商品库中的已传入商品信息，以提升成效。枚举值包括：<ul><li>`PRICE`：价格。</li><li>`STRIKETHROUGH_PRICE`：划线价。</li><li>`DISCOUNT`：折扣。</li><li>`FREE_SHIPPING`：包邮。</li></ul></li><li>在场景 2 中，库存卡片上将显示传入商品信息的相应文本。枚举值包括：<ul><li>`DEALER_NAME`：经销商名称。</li><li>`CURRENT_MILEAGE`：当前里程。</li><li>`LEAD_PRICE`：价格。</li><li>`LEAD_SALE_PRICE`：促销价。</li><li>`EXTERIOR_COLOR`：外观颜色。</li><li>`TRIM`：内饰。</li><li>`ADDRESS_CITY`：城市。</li><li>`VEHICLE_STATE`：车辆状况。</li></ul></li></ul> |
####|product_card_type|string[]|商品卡片展示类型。<br><br>枚举值：<ul><li>`PRODUCT_CARD`：商品卡片。</li><li>`PRODUCT_TILE`：商品磁贴。</li><li>`PRODUCT_INFO_CARD`：信息卡片。</li><li>`PRODUCT_SHOWCASE_TILE`：展示磁贴。</li><li>`ANCHOR`：锚点。</li><li>`CAROUSEL_LABEL`：轮播标签。</li></ul>|
####| promo_info_list | object[] | 仅为[常规升级版 Smart+ 网站推广系列](1847302878676994.html)返回。<br><br>促销码和优惠的详细信息。<br><br>你的促销码、优惠或活动的详细信息将突出显示，以提升互动率和广告效果。促销码需要购物者在结账时输入。优惠会自动生效，无需输入代码。 |
#####| discount_type | string | 仅当传入 `promo_info_list` 时返回。<br><br>折扣类型。<br><br>枚举值：<ul><li>`PERCENTAGE`：百分比折扣。</li><li>`CASH`：固定金额折扣。</li></ul> |
#####| discount_value | float | 当传入 `promo_info_list` 时返回。<br><br>折扣值。|
#####| discount_currency | string | 当 `discount_type` 为 `CASH` 时返回。<br><br>折扣币种。<br><br>枚举值参见<a href="#item-link-List of values for discount_currency or minimum_purchase_currency"> `discount_currency` 或 `minimum_purchase_currency` 值列表</a>。 |
#####| promo_code | string | 促销码。 |
#####| minimum_purchase_type | string | 最低购买要求类型。<br><br>枚举值：<ul><li>`QUANTITY`：最低购买数量。</li><li>`SUBTOTAL`：最低小计金额。</li></ul> |
#####| minimum_purchase_value | float | 仅当传入 `minimum_purchase_type` 时返回。<br><br>最低购买要求值。 |
#####| minimum_purchase_currency | string | 仅当 `minimum_purchase_type` 为 `SUBTOTAL` 时返回。<br><br>最低购买要求币种。<br><br>枚举值参见<a href="#item-link-List of values for discount_currency or minimum_purchase_currency"> `discount_currency` 或 `minimum_purchase_currency` 值列表</a>。 |
#####| valid_start_time | string | 促销码或优惠生效的开始时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。 |
#####| valid_end_time | string | 促销码或优惠生效的结束时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。 |
###| product_info_enabled | string | 商品信息模式。<br><br>枚举值：<ul><li>`UNSET`：禁用商品信息模式。</li><li>`NON_CATALOG`：启用非商品库版本的商品信息。</li><li>`CATALOG`：启用商品库版本的商品信息。</li></ul> |
###|call_to_action_id|string|广告中使用的行动引导文案素材包的 ID。|
###|phone_info|object|仅当广告组层级的 `promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL` 时返回。<br><br>广告受众点击广告中的行动引导文案按钮后，用于直接拨打电话联系你（广告主）的电话号码的详细信息。<br><br>了解如何[创建以电话通话为优化位置的升级版 Smart+ 线索收集推广系列](1847302998941697.html)。|
####|phone_region_code|string|受众点击广告后可拨打的电话号码的地区代码。<br><br>示例：`US`。|
####|phone_region_calling_code|string|受众点击广告后可拨打的电话号码的国际区号。<br><br>示例：`+1`。|
####|phone_number|string|受众点击广告后可拨打的电话号码。<br><br>示例：`12638282`。|
###|tracking_info|object|监测信息。|
####|viewability_postbid_partner|string|出价后第三方可见性度量合作伙伴。<br><br>枚举值：`DOUBLE_VERIFY`、`IAS`、`ZEFR`。|
####|viewability_vast_url|string|当 `viewability_postbid_partner` 为 `IAS` 时返回。<br><br>出价后第三方合作伙伴用于度量可见性的包装 VAST URL。你需要从度量合作伙伴 IAS 处获取 URL。|
####|brand_safety_postbid_partner|string|出价后第三方品牌安全度量合作伙伴。<br><br>枚举值：`DOUBLE_VERIFY`、`IAS`、`ZEFR`。|
####|brand_safety_vast_url|string|当 `brand_safety_postbid_partner` 为 `IAS` 时返回。<br><br>出价后第三方合作伙伴用于度量品牌安全的包装 VAST URL。你需要从度量合作伙伴 IAS 处获取 URL。|
####|impression_tracking_url|string|默认展示监测 URL。|
####|click_tracking_url|string|点击监测 URL。|
####|tracking_app_id|string|度量的应用的 ID。|
####| tracking_pixel_id | string | Pixel ID，用于监测用户在你的网站上执行的操作，例如页面浏览、加入购物车、付费等。 |
####| tracking_offline_event_set_ids | string[] | 线下事件组 ID 列表，用于监测线下客户行为，例如实体店购买或参加现场活动。 |
####|tracking_message_event_set_id|string|要在即时通讯广告中度量的通讯事件组的 ID。|
####| app_tracking_info_list | object[] | 第三方监测设置的详细信息。 |
#####| app_type | string | 当传入 `app_tracking_info_list` 时返回。<br><br>应用类型。<br><br>枚举值：<ul><li>`APP_ANDROID`：Android 应用。</li><li>`APP_IOS`：iOS 应用。</li></ul> |
#####| app_id | string | 当传入 `app_tracking_info_list` 时返回。<br><br>应用 ID。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，此字段表示 Android 应用 ID。</li><li>当 `app_type` 为 `APP_IOS` 时，此字段表示 iOS 应用 ID。</li></ul> |
#####| impression_tracking_url | string | 展示监测 URL。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，此字段表示 Android 展示监测 URL。</li><li>当 `app_type` 为 `APP_IOS` 时，此字段表示 iOS 展示监测 URL。</li></ul> |
#####| click_tracking_url | string | 点击监测 URL。<ul><li>当 `app_type` 为 `APP_ANDROID` 时，此字段表示 Android 点击监测 URL。</li><li>当 `app_type` 为 `APP_IOS` 时，此字段表示 iOS 点击监测 URL。</li></ul> |
#|page_info|object|分页信息。|
##|page|number|当前页码。|
##|page_size|number|分页大小。|
##|total_number|number|结果总数。|
##|total_page|number|结果总页数。|
discount_currency 或 minimum_purchase_currency 值列表
下表列出了 discount_currency 或 minimum_purchase_currency 的枚举值。
|discount_currency 或 minimum_purchase_currency 值 {50%}|币种{50%}|
|---|---|
|`AED`|阿联酋迪拉姆|
|`ARS`|阿根廷比索|
|`AUD`|澳元|
|`BDT`|孟加拉塔卡|
|`BHD`|巴林第纳尔|
|`BOB`|玻利维亚诺|
|`BRL`|巴西雷亚尔|
|`BYN`|白俄罗斯卢布|
|`CAD`|加元|
|`CHF`|瑞士法郎|
|`CLP`|智利比索|
|`CNY`|人民币|
|`COP`|哥伦比亚比索|
|`CRC`|哥斯达黎加科朗|
|`CZK`|捷克克朗|
|`DKK`|丹麦克朗|
|`DZD`|阿尔及利亚第纳尔|
|`EGP`|埃及磅|
|`EUR`|欧元|
|`GBP`|英镑|
|`GTQ`|危地马拉格查尔|
|`HKD`|港元|
|`HNL`|洪都拉斯伦皮拉|
|`HUF`|匈牙利福林|
|`IDR`|印尼盾|
|`ILS`|以色列新谢克尔|
|`INR`|印度卢比|
|`IQD`|伊拉克第纳尔|
|`ISK`|冰岛克朗|
|`JOD`|约旦第纳尔|
|`JPY`|日元|
|`KES`|肯尼亚先令|
|`KHR`|柬埔寨里尔|
|`KRW`|韩元|
|`KWD`|科威特第纳尔|
|`KZT`|坚戈|
|`LBP`|黎巴嫩磅|
|`LKR`|斯里兰卡卢比|
|`MAD`|摩洛哥迪拉姆|
|`MOP`|澳门元|
|`MXN`|墨西哥比索|
|`MYR`|马来西亚林吉特|
|`NGN`|尼日利亚奈拉|
|`NIO`|尼加拉瓜科多巴|
|`NOK`|挪威克朗|
|`NZD`|新西兰元|
|`OMR`|阿曼里亚尔|
|`PEN`|秘鲁索尔|
|`PHP`|菲律宾比索|
|`PKR`|巴基斯坦卢比|
|`PLN`|波兰兹罗提|
|`PYG`|巴拉圭瓜拉尼|
|`QAR`|卡塔尔里亚尔|
|`RON`|罗马尼亚列伊|
|`RSD`|塞尔维亚第纳尔|
|`RUB`|俄罗斯卢布|
|`SAR`|沙特里亚尔|
|`SEK`|瑞典克朗|
|`SGD`|新加坡元|
|`THB`|泰铢|
|`TRY`|土耳其里拉|
|`TWD`|新台币|
|`UAH`|格里夫纳|
|`USD`|美元|
|`UYU`|乌拉圭比索|
|`VEF`|委内瑞拉玻利瓦尔|
|`VND`|越南盾|
|`ZAR`|南非兰特|
示例
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"list": [
{
"ad_configuration": {
"call_to_action_id": "{{call_to_action_id}}",
"catalog_creative_toggle": false,
"product_ids": [
"{{product_id}}",
"{{product_id}}",
"{{product_id}}",
"{{product_id}}"
],
"product_specific_type": "CUSTOMIZED_PRODUCTS"
},
"ad_name": "",
"ad_text_list": [],
"adgroup_id": "{{adgroup_id}}",
"adgroup_name": "{{adgroup_name}}",
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"create_time": "{{create_time}}",
"creative_list": [
{
"ad_material_id": "{{ad_material_id}}",
"creative_info": {
"ad_format":"SINGLE_VIDEO",
"identity_authorized_bc_id": "0",
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER",
"tiktok_item_id": "{{tiktok_item_id}}"
},
"material_operation_status": "ENABLE"
}
],
"landing_page_url_list": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"secondary_status": "AD_STATUS_DONE",
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
},
{
"ad_configuration": {
"call_to_action_id": "{{call_to_action_id}}",
"catalog_creative_toggle": false,
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"product_set_id": "{{product_set_id}}",
"product_specific_type": "PRODUCT_SET",
"utm_params": [
{
"field": "{{field}}",
"value": "{{value}}"
}
]
},
"ad_name": "{{ad_name}}",
"ad_text_list": [
{
"ad_text": "{{ad_text}}"
},
{
"ad_text": "{{ad_text}}"
},
{
"ad_text": "{{ad_text}}"
},
{
"ad_text": "{{ad_text}}"
},
{
"ad_text": "{{ad_text}}"
}
],
"adgroup_id": "{{adgroup_id}}",
"adgroup_name": "{{adgroup_name}}",
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"create_time": "{{create_time}}",
"creative_list": [
{
"ad_material_id": "{{ad_material_id}}",
"creative_info": {
"ad_format":"SINGLE_VIDEO",
"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"material_name": "",
"video_info": {
"file_name": "",
"video_id": "{{video_id}}"
}
},
"material_operation_status": "ENABLE"
}
],
"landing_page_url_list": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"secondary_status": "AD_STATUS_AUDIT",
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
},
{
"ad_configuration": {
"call_to_action_id": "{{call_to_action_id}}"
},
"ad_name": "{{ad_name}}",
"ad_text_list": [],
"adgroup_id": "{{adgroup_id}}",
"adgroup_name": "{{adgroup_name}}",
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"create_time": "{{create_time}}",
"creative_list": [
{
"ad_material_id": "{{ad_material_id}}",
"creative_info": {
"ad_format":"SINGLE_VIDEO",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT",
"tiktok_item_id": "{{tiktok_item_id}}"
},
"material_operation_status": "ENABLE"
},
{
"ad_material_id": "{{ad_material_id}}",
"creative_info": {
"ad_format":"SINGLE_VIDEO",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT",
"tiktok_item_id": "{{tiktok_item_id}}"
},
"material_operation_status": "ENABLE"
}
],
"interactive_add_on_list": [
{
"card_id": "{{card_id}}"
}
],
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"page_list": [
{
"page_id": "{{page_id}}"
}
],
"secondary_status": "AD_STATUS_AUDIT",
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
}
],
"page_info": {
"page": 1,
"page_size": 100,
"total_number": 3,
"total_page": 1
}
}
}
(/code)