← 返回目录
📁 Use Cases › Campaign creation › Create Shopping Ads › Create Video Shopping Ads

创建商品库广告

本文介绍了创建商品库广告(旧称商品来源为商品库的视频购物广告)的步骤。

注意
商品库广告目前对于商业类的移动应用广告主为白名单功能。若您为商业类的移动应用广告主且需使用此功能,请联系您的 TikTok 销售代表。若您是商业类的网络广告主,您已自动拥有该功能的权限。

步骤

1. 创建推广系列

使用/campaign/create/接口创建一个推广系列。需确保满足以下要求:

设置 要求 参数 如何设置该参数
推广目标 商品销量 objective_type PRODUCT_SALES
Smart+ 推广系列 未启用

不支持使用/campaign/spc/create/创建启用 Smart+ 推广系列设置的视频购物推广系列。
/ /
iOS 14 专属推广系列 未启用或启用 campaign_type 以下任意值:
  • REGULAR_CAMPAIGN或不传入
  • IOS14_CAMPAIGN
app_id
  • campaign_type设置为REGULAR_CAMPAIGN或未传入campaign_type时,不传入本字段。
  • campaign_type设置为IOS14_CAMPAIGN时,指定一个 iOS 应用的 ID。
    若想获取广告账户下的应用列表,需使用/app/list/。
campaign_app_profile_page_state 不传入
商品来源
(商品数据源)
商品库 campaign_product_source CATALOG
特殊广告分类(可选) 需申请白名单才可启用 special_industries 传入合法值,或不传入

注意:在推广系列商品来源为商品库的购物广告中使用特殊广告分类目前为白名单功能。如需使用这些功能,请联系您的 TikTok 销售代表。

推广系列预算优化 需申请白名单才可启用 budget_optimize_on 以下任意值:
  • false 或不传入
  • true

注意:在商品来源为商品库的视频购物广告中使用推广系列预算优化目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

推广系列预算类型 以下任意类型:
  • 日预算
  • 动态日预算(需启用推广系列预算优化)
  • 总预算
  • 不限预算
budget_mode 以下任意值:
  • BUDGET_MODE_DAY
  • BUDGET_MODE_DYNAMIC_DAILY_BUDGET (仅支持budget_optimize_on设置为true时使用)
  • BUDGET_MODE_TOTAL
  • BUDGET_MODE_INFINITE

示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "objective_type": "PRODUCT_SALES",
    "campaign_product_source":"CATALOG",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "operation_status": "ENABLE",
        "roas_bid": 0,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "advertiser_id": "{{advertiser_id}}",
        "campaign_app_profile_page_state": "UNSET",
        "objective_type": "PRODUCT_SALES",
        "campaign_type": "REGULAR_CAMPAIGN",
        "modify_time": "{{modify_time}}",
        "campaign_product_source": "CATALOG",
        "is_search_campaign": false,
        "budget": {{budget}},
        "objective": "LANDING_PAGE",
        "campaign_id": "{{campaign_id}}",
        "is_new_structure": true,
        "campaign_name": "{{campaign_name}}",
        "deep_bid_type": null,
        "is_smart_performance_campaign": false,
        "create_time": "{{create_time}}",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE"
    }
}
(/code)

2. 创建和管理商品库

使用商品库接口或 TikTok 商务中心创建、管理商品库。 * 商品库接口: 所有商品库接口,请查看这里。

  1. 使用/catalog/create/接口创建一个电商商品库。
  2. 使用/catalog/product/upload/(JSON 结构)、/catalog/product/file/ (CSV 模版)或 /catalog/feed/create/(在线数据更新源)上传商品至商品库。
  3. 使用/catalog/product/log/ 接口检查商品操作结果。
    传入从步骤 ii. 获取的 feed_log_id。若返回的warn_affected_products的值非空,则需查看问题详情,并返回步骤 ii. 重新上传商品。
  4. (可选步骤)使用 /catalog/set/create/ 接口创建电商商品系列。
    若您想在广告层级从商品系列中选择商品,需创建商品系列。否则,可跳过此步骤。
  5. (可选步骤)使用/bc/member/invite/接口邀请成员加入商务中心,并授予管理员权限。
    您可以同时为受邀成员指定advertiser_role。
  6. (可选步骤)使用/bc/asset/assign/接口将商品库共享给商务中心成员,并授予商品库管理权限。
    请确保将asset_type字段设置为CATALOG,且将catalog_role字段设置为 ADMIN。
  • TikTok 商务中心 1. 在商务中心中创建一个商品库。
    具体指南请查看在TikTok 商务中心管理商品库。 2. 将您的产品上传至商品库。 3. (可选步骤)邀请成员加入商务中心,并授予管理员权限。
    具体指南请查看在 TikTok 商务中心管理用户。 4. (可选步骤)选择要分享的广告主账户,将成员添加至账户并授予管理员权限。 5. (可选步骤)将商品库共享给商务中心成员,并授予商品库管理权限。
    具体指南请查看在TikTok 商务中心管理商品库中的与成员共享商品库部分。

3. 创建广告组

使用 /adgroup/create/ 接口创建一个广告组。需确保满足以下要求:

设置 要求 参数 如何设置该参数
购物广告类型 视频购物广告 shopping_ads_type VIDEO
认证身份
(广告发布身份)
未启用
  • identity_type
  • identity_id
  • identity_authorized_bc_id
不传入
商品来源
(商品数据源)
商品库 product_source CATALOG
  • catalog_id
  • catalog_authorized_bc_id
传入合法值。
若想了解如何获取商品库 ID,需遵循创建和管理商品库中的步骤。
  • store_id
  • store_authorized_bc_id
不传入
推广对象
(优化位置)
落地页或应用 promotion_type 以下任意值:
  • WEBSITE
  • APP_ANDRIOD
  • APP_IOS
推广的网站
  • 优化位置为落地页且优化目标为转化或价值时需指定
  • 优化位置为落地页且优化目标为点击或落地页浏览量,或优化位置为应用时无需指定
  • pixel_id
  • optimization_event
  • promotion_type 设置为 WEBSITE 且 optimization_goal 设置为 CONVERT 或 VALUE时,需传入合法值。
    若想获取广告账号下的 Pixel,需使用/pixel/list/。
  • 以下场景下不传入:
    • promotion_type 设置为 APP_ANDRIOD 或 APP_IOS。
    • promotion_type 设置为 WEBSITE 且 optimization_goal 设置为 CLICK 或 TRAFFIC_LANDING_PAGE_VIEW。
推广的应用
  • 优化位置为应用时需指定
  • 优化位置为落地页时无需指定
app_id
  • promotion_type设置为APP_ANDRIOD 或APP_IOS时传入合法值。
    若想获取广告账户下的应用列表,需使用 /app/list/。
  • promotion_type 设置为 WEBSITE 时不传入。
operating_systems
  • 若您通过app_id指定了安卓应用,需将本字段设置为 ["ANDROID"]。
  • 若您通过app_id指定了 iOS 应用,需将本字段设置为 ["IOS"]。
版位
(广告位)
以下任意选项:
  • 自动广告位
  • 编辑广告位,且版位仅为 TikTok
  • placement_type
  • placements
以下任意设置:
  • placement_type 设置为PLACEMENT_TYPE_AUTOMATIC。
  • placement_type设置为PLACEMENT_TYPE_NORMAL,且placements 设置为 ["PLACEMENT_TIKTOK"]。
包含搜索结果 未启用 search_result_enabled false 或不传入
视频共享 启用 share_disabled false 或不传入
Pangle 媒体屏蔽列表 未启用 blocked_pangle_app_ids 不传入
受众定向
  • 已保存受众
未启用 saved_audience_id 不传入
受众定向
  • 自动定向
未启用 auto_targeting_enabled 不传入
受众定向
  • 受众
以下任意选项:
  • 定向更广泛的受众:定向更广泛的受众,即使他们还没有和商品有过互动。
  • 对受众再营销:将商品推广给已经与之有过互动的人。
    • 若您选择对受众再营销,需确保商品库已绑定事件源。这将帮助你更精确地定向与你的商品互动过的用户。

注意:若推广系列层级启用了iOS 14 专属推广系列,则不支持选择对受众再营销。

  • shopping_ads_retargeting_type
  • shopping_ads_retargeting_actions_days
  • included_custom_actions
  • excluded_custom_actions
  • shopping_ads_retargeting_custom_audience_relation
传入合法值。
  • 若想定向更广泛的受众,需将 shopping_ads_retargeting_type 设置为 OFF。
  • 若想若想对受众再营销,需将shopping_ads_retargeting_type 设置为LAB1,LAB2 或 LAB3,并传入其他相关参数。您需确保商品库(catalog_id)已绑定事件源。否则,将出现报错。

注意:若您在推广系列层级将campaign_type 设置为 IOS14_CAMPAIGN,则不支持将shopping_ads_retargeting_type 设置为 LAB1,LAB2或LAB3。

受众定向
  • 人群属性 - 消费能力
未启用 spending_power 不传入
受众定向
  • 受众
    • 智能受众
未启用 smart_audience_enabled 不传入
受众定向
  • 兴趣与行为
    • 智能型兴趣和行为
未启用 smart_interest_behavior_enabled 不传入
受众定向
  • Pangle 流量包
未启用
  • included_pangle_audience_package_ids
  • excluded_pangle_audience_package_ids
不传入
受众定向
  • 定向扩量
未启用 targeting_expansion 不传入
内容相关定向 未启用 contextual_tag_ids 不传入
内容排除
  • 库存筛选
需申请白名单才可启用,仅支持编辑广告位 ,且广告位仅为 TikTok brand_safety_type 若 placement_type 设置为PLACEMENT_TYPE_NORMAL,且 placements 设置为 ["PLACEMENT_TIKTOK"],您可传入合法值(EXPANDED_INVENTORY,STANDARD_INVENTORY或 LIMITED_INVENTORY),或省略该字段。

注意:在商品来源为商品库的视频购物广告中使用 TikTok 库存筛选目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

brand_safety_partner 不传入
内容排除
  • 类别排除
未启用 category_exclusion_ids 不传入
内容排除
  • 行业敏感内容控制
未启用 vertical_sensitivity_id 不传入
优化目标 优化位置为应用时使用以下任意类型:
  • 点击
  • 安装
  • 应用内事件
  • 目标页面访问(需申请白名单)
  • 价值
optimization_goal promotion_type 设置为 APP_ANDRIOD 或 APP_IOS时,使用以下任意值:

注意:优化目标目标页面访问(DESTINATION_VISIT)目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

优化位置为落地页时使用以下任意类型:
  • 点击
  • 转化
  • 落地页浏览量(需申请白名单)
  • 价值
promotion_type设置为WEBSITE时,使用以下任意值:
  • CLICK
  • CONVERT (需设置 pixel_id 和 optimization_event )
  • TRAFFIC_LANDING_PAGE_VIEW
  • VALUE(需设置pixel_id,且将optimization_event 设置为 SHOPPING)
    • 若想了解如何使用商品销量下的优化目标价值,可查看开启价值优化。

注意:在购物广告中使用优化目标落地页浏览量目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

频次上限 未启用
  • frequency
  • frequency_schedule
不传入
竞价策略
  • 优化目标为点击、安装、应用内事件、目标页面访问、转化或落地页浏览量时,可设置为最大投放量或成本上限。
  • 优化目标为总收入时,可设置为最高总收入或最低 ROAS。
  • bid_type
  • bid_price
  • conversion_bid_price
  • deep_bid_type
  • roas_bid
  • optimization_goal 设置为 CLICK,INSTALL, IN_APP_EVENT,DESTINATION_VISIT, CONVERT 或 TRAFFIC_LANDING_PAGE_VIEW时:
    • 需将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。不可传入deep_bid_type 和 roas_bid。
      • optimization_goal 设置为 INSTALL,IN_APP_EVENT, DESTINATION_VISIT,CONVERT 或TRAFFIC_LANDING_PAGE_VIEW, 且bid_type 设置为BID_TYPE_CUSTOM时,需同时传入conversion_bid_price。
      • optimization_goal 设置为CLICK且 bid_type 设置为 BID_TYPE_CUSTOM时,需同时传入 bid_price。
  • optimization_goal 设置为VALUE时:
    • 需将 deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE,且同时将 bid_type 设置为 BID_TYPE_NO_BID。不可同时传入 conversion_bid_price 和 bid_price。
      • 若 deep_bid_type 设置为 VO_MIN_ROAS,还需同时传入roas_bid。
归因设置 在具体场景中选择对应支持的归因设置
  • click_attribution_window
  • view_attribution_window
  • attribution_event_count
若想了解不同场景下支持的归因设置,请查看归因窗口期和事件统计方式 - 商品销量。
计费事件
(计费点)
  • 若优化目标为点击数,计费事件需为 CPC。
  • 若优化目标为安装、应用内事件、目标页面访问、转化、落地页浏览量或价值,计费事件需为 oCPM。
billing_event
  • optimization_goal 为 CLICK时,本字段需设置为CPC。
  • optimization_goal 为 INSTALL,IN_APP_EVENT,DESTINATION_VISIT, CONVERT ,TRAFFIC_LANDING_PAGE_VIEW或VALUE时,本字段需设置为OCPM。
投放速度
  • 若竞价策略设置为成本上限,支持将投放速度设置为标准或加速。
  • 若竞价策略设置为最大投放量、最高总收入或最低 ROAS,仅支持将投放速度设置为标准。
pacing
  • bid_type 为 BID_TYPE_CUSTOM时,可将 pacing 设置为 PACING_MODE_SMOOTH 或 PACING_MODE_FAST。
  • bid_type 为 BID_TYPE_NO_BID时,仅支持将 pacing 设置为 PACING_MODE_SMOOTH。
程序化创意 未启用 creative_material_mode 不传入
拆分对比测试 未启用

视频购物广告组不支持用于/split_test/create/创建拆分对比测试。
/ /

示例

根据您对优化位置和优化目标的偏好,您可以使用以下任意代码示例,创建商品库广告组。

优化位置设置为应用(且不对受众再营销 )

优化目标设置为点击

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "operating_systems":["ANDROID"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{chedule_end_time}}",
    "optimization_goal": "CLICK",
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_app_profile_page_state": null,
        "ios14_quota_type": "UNOCCUPIED",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "bid_price": {{bid_price}},
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "excluded_audience_ids": [],
        "languages": [],
        "shopping_ads_type": "VIDEO",
        "rf_estimated_frequency": null,
        "optimization_event": "ACTIVE",
        "deep_bid_type": null,
        "interest_keyword_ids": [],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "modify_time": "{{modify_time}}",
        "optimization_goal": "CLICK",
        "is_hfss": false,
        "adgroup_name": "{{adgroup_nam}}",
        "creative_material_mode": "CATALOG_SALES",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "shopping_ads_retargeting_type": "OFF",
        "create_time": "{{create_time}}",
        "actions": [],
        "budget": {{budget}},
        "comment_disabled": false,
        "interest_category_ids": [],
        "scheduled_budget": 0,
        "bid_type": "BID_TYPE_CUSTOM",
        "device_price_ranges": null,
        "audience_ids": [],
        "category_exclusion_ids": [],
        "pacing": "PACING_MODE_SMOOTH",
        "brand_safety_partner": null,
        "app_download_url": "{{app_download_url}}",
        "skip_learning_phase": false,
        "location_ids": [
            "6252001"
        ],
        "smart_audience_enabled": null,
        "pixel_id": null,
        "secondary_optimization_event": null,
        "category_id": "0",
        "operation_status": "ENABLE",
        "rf_purchased_type": null,
        "purchased_impression": null,
        "campaign_name": "{{campaign_name}}",
        "is_new_structure": true,
        "campaign_id": "{{campaign_id}}",
        "schedule_infos": null,
        "operating_systems": [
            "ANDROID"
        ],
        "billing_event": "CPC",
        "video_download_disabled": false,
        "adgroup_id": "{{adgroup_id}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "delivery_mode": null,
        "frequency": null,
        "app_type": "APP_ANDROID",
        "network_types": [],
        "conversion_bid_price": 0,
        "statistic_type": null,
        "app_id": "{{app_id}}",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "conversion_window": null,
        "deep_cpa_bid": 0,
        "feed_type": null,
        "keywords": null,
        "purchased_reach": null,
        "catalog_id": "{{catalog_id}}",
        "package": "{{package}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "age_groups": null,
        "auto_targeting_enabled": false,
        "frequency_schedule": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "schedule_end_time": "{{schedule_end_time}}",
        "product_source": "CATALOG",
        "promotion_type": "APP_ANDROID",
        "share_disabled": false,
        "gender": "GENDER_UNLIMITED",
        "rf_estimated_cpr": null,
        "advertiser_id": "{{advertiser_id}}",
        "next_day_retention": null,
        "inventory_filter_enabled": false,
        "smart_interest_behavior_enabled": null,
        "isp_ids": [],
        "is_smart_performance_campaign": false,
        "bid_display_mode": "CPMV",
        "search_result_enabled": false
    }
}
(/code)
优化目标设置为安装

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{dvertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "operating_systems":["ANDROID"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "INSTALL",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "keywords": null,
        "app_id": "{{app_id}}",
        "actions": [],
        "age_groups": null,
        "operating_systems": [
            "ANDROID"
        ],
        "adgroup_id": "{{adgroup_id}}",
        "delivery_mode": null,
        "share_disabled": false,
        "deep_cpa_bid": 0,
        "location_ids": [
            "6252001"
        ],
        "is_smart_performance_campaign": false,
        "bid_type": "BID_TYPE_CUSTOM",
        "audience_ids": [],
        "smart_audience_enabled": null,
        "brand_safety_partner": null,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "excluded_audience_ids": [],
        "deep_bid_type": null,
        "budget": {{budget}},
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "is_hfss": false,
        "video_download_disabled": false,
        "smart_interest_behavior_enabled": null,
        "pacing": "PACING_MODE_SMOOTH",
        "purchased_impression": null,
        "isp_ids": [],
        "category_id": "0",
        "catalog_id": "{{catalog_id}}",
        "bid_display_mode": "CPMV",
        "conversion_window": null,
        "bid_price": 0,
        "next_day_retention": null,
        "adgroup_name": "{{adgroup_name}}",
        "pixel_id": null,
        "campaign_name": "{{campaign_name}}",
        "frequency_schedule": null,
        "creative_material_mode": "CATALOG_SALES",
        "languages": [],
        "device_price_ranges": null,
        "adgroup_app_profile_page_state": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "schedule_infos": null,
        "feed_type": null,
        "conversion_bid_price": {{conversion_bid_price}}},
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "schedule_type": "SCHEDULE_START_END",
        "optimization_event": "ACTIVE",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "campaign_id": "{{campaign_id}}",
        "category_exclusion_ids": [],
        "network_types": [],
        "attribution_event_count": "ONCE",
        "statistic_type": null,
        "frequency": null,
        "shopping_ads_retargeting_type": "OFF",
        "interest_category_ids": [],
        "app_type": "APP_ANDROID",
        "schedule_end_time": "{{schedule_end_tim}}",
        "rf_estimated_frequency": null,
        "shopping_ads_type": "VIDEO",
        "promotion_type": "APP_ANDROID",
        "advertiser_id": "{{advertiser_id}}",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "auto_targeting_enabled": false,
        "schedule_start_time": "{{schedule_start_time}}",
        "modify_time": "{{modify_time}}",
        "skip_learning_phase": true,
        "product_source": "CATALOG",
        "rf_estimated_cpr": null,
        "secondary_optimization_event": null,
        "package": "{{package}}",
        "scheduled_budget": 0,
        "app_download_url": "{{app_download_url}}",
        "rf_purchased_type": null,
        "is_new_structure": true,
        "click_attribution_window": "SEVEN_DAYS",
        "search_result_enabled": false,
        "purchased_reach": null,
        "gender": "GENDER_UNLIMITED",
        "inventory_filter_enabled": false,
        "create_time": "{{create_time}}",
        "optimization_goal": "INSTALL",
        "operation_status": "ENABLE",
        "ios14_quota_type": "UNOCCUPIED",
        "view_attribution_window": "ONE_DAY",
        "comment_disabled": false,
        "interest_keyword_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "billing_event": "OCPM"
    }
}
(/code)
优化目标设置为应用内事件

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "operating_systems":["ANDROID"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "IN_APP_EVENT",
    "optimization_event": "COMPLETE_TUTORIAL",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "optimization_event": "COMPLETE_TUTORIAL",
        "click_attribution_window": "SEVEN_DAYS",
        "shopping_ads_type": "VIDEO",
        "purchased_impression": null,
        "keywords": null,
        "ios14_quota_type": "UNOCCUPIED",
        "catalog_id": "{{catalog_id}}",
        "brand_safety_partner": null,
        "gender": "GENDER_UNLIMITED",
        "interest_category_ids": [],
        "audience_ids": [],
        "operation_status": "ENABLE",
        "conversion_window": null,
        "rf_estimated_cpr": null,
        "comment_disabled": false,
        "conversion_bid_price": {{conversion_bid_price}},
        "actions": [],
        "search_result_enabled": false,
        "is_new_structure": true,
        "languages": [],
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "schedule_start_time": "{{schedule_start_time}}",
        "operating_systems": [
            "ANDROID"
        ],
        "package": "{{package}}",
        "rf_purchased_type": null,
        "inventory_filter_enabled": false,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "is_hfss": false,
        "purchased_reach": null,
        "attribution_event_count": "ONCE",
        "smart_audience_enabled": null,
        "skip_learning_phase": true,
        "pacing": "PACING_MODE_SMOOTH",
        "create_time": "{{create_time}}",
        "product_source": "CATALOG",
        "rf_estimated_frequency": null,
        "auto_targeting_enabled": false,
        "category_id": "0",
        "schedule_type": "SCHEDULE_START_END",
        "share_disabled": false,
        "video_download_disabled": false,
        "modify_time": "{{modify_time}}",
        "shopping_ads_retargeting_type": "OFF",
        "next_day_retention": null,
        "campaign_name": "{{campaign_name}}",
        "bid_price": 0,
        "promotion_type": "APP_ANDROID",
        "location_ids": [
            "6252001"
        ],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "interest_keyword_ids": [],
        "creative_material_mode": "CATALOG_SALES",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "network_types": [],
        "bid_display_mode": "CPMV",
        "device_price_ranges": null,
        "campaign_id": "{{campaign_id}}",
        "is_smart_performance_campaign": false,
        "adgroup_id": "{{adgroup_id}}",
        "feed_type": null,
        "adgroup_name": "{{adgroup_name}}",
        "bid_type": "BID_TYPE_CUSTOM",
        "optimization_goal": "IN_APP_EVENT",
        "age_groups": null,
        "scheduled_budget": 0,
        "statistic_type": null,
        "adgroup_app_profile_page_state": null,
        "delivery_mode": null,
        "view_attribution_window": "ONE_DAY",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "smart_interest_behavior_enabled": null,
        "excluded_audience_ids": [],
        "isp_ids": [],
        "pixel_id": null,
        "app_id": "{{app_id}}",
        "frequency_schedule": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "billing_event": "OCPM",
        "secondary_optimization_event": null,
        "app_download_url": "{{app_download_url}}",
        "advertiser_id": "{{advertiser_id}}",
        "schedule_infos": null,
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "budget": {{budget}},
        "brand_safety_type": "NO_BRAND_SAFETY",
        "frequency": null,
        "category_exclusion_ids": [],
        "app_type": "APP_ANDROID",
        "deep_bid_type": "AEO",
        "deep_cpa_bid": 0
    }
}
(/code)
优化目标设置为目标页面访问

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "operating_systems":["ANDROID"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "DESTINATION_VISIT",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "deep_cpa_bid": 0,
        "interest_category_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "shopping_ads_retargeting_type": "OFF",
        "audience_ids": [],
        "network_types": [],
        "app_type": "APP_ANDROID",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "shopping_ads_type": "VIDEO",
        "create_time": "{{create_time}}",
        "search_result_enabled": false,
        "auto_targeting_enabled": false,
        "isp_ids": [],
        "frequency_schedule": null,
        "secondary_optimization_event": null,
        "bid_price": 0,
        "purchased_impression": null,
        "bid_type": "BID_TYPE_CUSTOM",
        "optimization_event": "DESTINATION_VISIT",
        "share_disabled": false,
        "device_price_ranges": null,
        "frequency": null,
        "video_download_disabled": false,
        "schedule_type": "SCHEDULE_START_END",
        "app_download_url": "{{app_download_url}}",
        "actions": [],
        "campaign_name": "{{campaign_name}}",
        "pacing": "PACING_MODE_SMOOTH",
        "bid_display_mode": "CPMV",
        "comment_disabled": false,
        "delivery_mode": null,
        "operating_systems": [
            "ANDROID"
        ],
        "modify_time": "{{modify_time}}",
        "product_source": "CATALOG",
        "catalog_id": "{{catalog_id}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "campaign_id": "{{campaign_id}}",
        "excluded_audience_ids": [],
        "adgroup_name": "{{adgroup_name}}",
        "next_day_retention": null,
        "smart_audience_enabled": null,
        "brand_safety_partner": null,
        "adgroup_id": "{{adgroup_id}}",
        "age_groups": null,
        "inventory_filter_enabled": false,
        "purchased_reach": null,
        "deep_bid_type": null,
        "rf_purchased_type": null,
        "click_attribution_window": "SEVEN_DAYS",
        "rf_estimated_cpr": null,
        "conversion_window": null,
        "location_ids": [
            "6252001"
        ],
        "statistic_type": null,
        "keywords": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "is_hfss": false,
        "ios14_quota_type": "UNOCCUPIED",
        "is_smart_performance_campaign": false,
        "is_new_structure": true,
        "optimization_goal": "DESTINATION_VISIT",
        "rf_estimated_frequency": null,
        "budget": {{budget}},
        "conversion_bid_price": {{conversion_bid_price}},
        "gender": "GENDER_UNLIMITED",
        "languages": [],
        "advertiser_id": "{{advertiser_id}}",
        "smart_interest_behavior_enabled": null,
        "view_attribution_window": "ONE_DAY",
        "billing_event": "OCPM",
        "interest_keyword_ids": [],
        "app_id": "{{app_id}}",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "attribution_event_count": "ONCE",
        "skip_learning_phase": true,
        "category_exclusion_ids": [],
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "adgroup_app_profile_page_state": null,
        "pixel_id": null,
        "schedule_infos": null,
        "feed_type": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "scheduled_budget": 0,
        "operation_status": "ENABLE",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "category_id": "0",
        "promotion_type": "APP_ANDROID",
        "package": "{{package}}",
        "creative_material_mode": "CATALOG_SALES"
    }
}
(/code)
将优化目标设置为价值

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "operating_systems":["ANDROID"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "VALUE",
    "optimization_event": "ACTIVE_PAY",
    "secondary_optimization_event":"PURCHASE_ROI",
    "deep_bid_type": "VO_MIN_ROAS",
    "bid_type": "BID_TYPE_NO_BID",
    "roas_bid": {{roas_bid}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "view_attribution_window": "ONE_DAY",
        "actions": [],
        "age_groups": null,
        "click_attribution_window": "SEVEN_DAYS",
        "campaign_name": "{{campaign_name}}",
        "audience_ids": [],
        "create_time": "{{create_time}}",
        "skip_learning_phase": true,
        "brand_safety_partner": null,
        "optimization_goal": "VALUE",
        "inventory_filter_enabled": false,
        "schedule_infos": null,
        "device_price_ranges": null,
        "comment_disabled": false,
        "feed_type": null,
        "modify_time": "{{modify_time}}",
        "category_id": "0",
        "interest_keyword_ids": [],
        "deep_bid_type": "VO_MIN_ROAS",
        "billing_event": "OCPM",
        "is_smart_performance_campaign": false,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "secondary_optimization_event": "PURCHASE_ROI",
        "budget": {{budget}},
        "adgroup_app_profile_page_state": null,
        "app_type": "APP_ANDROID",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "conversion_bid_price": 0,
        "roas_bid": {{roas_bid}},
        "scheduled_budget": 0,
        "is_new_structure": true,
        "bid_price": 0,
        "pixel_id": null,
        "rf_purchased_type": null,
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "location_ids": [
            "6252001"
        ],
        "schedule_start_time": "{{schedule_start_time}}",
        "smart_audience_enabled": null,
        "product_source": "CATALOG",
        "bid_display_mode": "CPMV",
        "optimization_event": "ACTIVE_PAY",
        "next_day_retention": null,
        "keywords": null,
        "shopping_ads_retargeting_type": "OFF",
        "frequency_schedule": null,
        "ios14_quota_type": "UNOCCUPIED",
        "category_exclusion_ids": [],
        "deep_cpa_bid": 0,
        "catalog_id": "{{catalog_id}}",
        "conversion_window": null,
        "network_types": [],
        "purchased_impression": null,
        "creative_material_mode": "CATALOG_SALES",
        "delivery_mode": null,
        "gender": "GENDER_UNLIMITED",
        "promotion_type": "APP_ANDROID",
        "smart_interest_behavior_enabled": null,
        "app_id": "{{app_id}}",
        "rf_estimated_frequency": null,
        "excluded_audience_ids": [],
        "frequency": null,
        "is_hfss": false,
        "app_download_url": "{{app_download_url}}",
        "shopping_ads_type": "VIDEO",
        "pacing": "PACING_MODE_SMOOTH",
        "isp_ids": [],
        "budget_mode": "BUDGET_MODE_TOTAL",
        "video_download_disabled": false,
        "auto_targeting_enabled": false,
        "attribution_event_count": "EVERY",
        "adgroup_name": "{{adgroup_name}}",
        "schedule_type": "SCHEDULE_START_END",
        "campaign_id": "{{campaign_id}}",
        "operating_systems": [
            "ANDROID"
        ],
        "statistic_type": null,
        "package": "{{package}}",
        "schedule_end_time": "{{schedule_end_time}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "interest_category_ids": [],
        "purchased_reach": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "adgroup_id": "{{adgroup_id}}",
        "operation_status": "ENABLE",
        "languages": [],
        "search_result_enabled": false,
        "advertiser_id": "{{advertiser_id}}",
        "share_disabled": false,
        "bid_type": "BID_TYPE_NO_BID",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "rf_estimated_cpr": null
    }
}
(/code)

优化位置设置为落地页(且不对受众再营销 )

优化目标设置为点击

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "WEBSITE",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "CLICK",
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "keywords": null,
        "app_id": null,
        "actions": [],
        "age_groups": null,
        "operating_systems": [],
        "adgroup_id": "{{adgroup_id}}",
        "delivery_mode": null,
        "share_disabled": false,
        "deep_cpa_bid": 0,
        "location_ids": [
            "6252001"
        ],
        "is_smart_performance_campaign": false,
        "bid_type": "BID_TYPE_CUSTOM",
        "audience_ids": [],
        "smart_audience_enabled": null,
        "brand_safety_partner": null,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "excluded_audience_ids": [],
        "deep_bid_type": null,
        "budget": {{budget}},
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "is_hfss": false,
        "video_download_disabled": false,
        "smart_interest_behavior_enabled": null,
        "pacing": "PACING_MODE_SMOOTH",
        "purchased_impression": null,
        "isp_ids": [],
        "category_id": "0",
        "catalog_id": "{{catalog_id}}",
        "bid_display_mode": "CPMV",
        "conversion_window": null,
        "bid_price": {{bid_price}},
        "next_day_retention": null,
        "adgroup_name": "{{adgroup_name}}",
        "pixel_id": null,
        "campaign_name": "{{campaign_name}}",
        "frequency_schedule": null,
        "creative_material_mode": "CATALOG_SALES",
        "languages": [],
        "device_price_ranges": null,
        "adgroup_app_profile_page_state": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "schedule_infos": null,
        "feed_type": null,
        "conversion_bid_price": 0,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "schedule_type": "SCHEDULE_START_END",
        "optimization_event": null,
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "campaign_id": "{{campaign_id}}",
        "category_exclusion_ids": [],
        "network_types": [],
        "statistic_type": null,
        "frequency": null,
        "shopping_ads_retargeting_type": "OFF",
        "interest_category_ids": [],
        "app_type": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "rf_estimated_frequency": null,
        "shopping_ads_type": "VIDEO",
        "promotion_type": "WEBSITE",
        "advertiser_id": "{{advertiser_id}}",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "auto_targeting_enabled": false,
        "schedule_start_time": "{{schedule_start_time}}",
        "modify_time": "{{modify_time}}",
        "skip_learning_phase": false,
        "product_source": "CATALOG",
        "rf_estimated_cpr": null,
        "secondary_optimization_event": null,
        "scheduled_budget": 0,
        "app_download_url": null,
        "rf_purchased_type": null,
        "is_new_structure": true,
        "search_result_enabled": false,
        "purchased_reach": null,
        "gender": "GENDER_UNLIMITED",
        "inventory_filter_enabled": false,
        "create_time": "{{create_time}}",
        "optimization_goal": "CLICK",
        "operation_status": "ENABLE",
        "ios14_quota_type": "UNOCCUPIED",
        "comment_disabled": false,
        "interest_keyword_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "billing_event": "CPC"
    }
}
(/code)
优化目标设置为转化

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "WEBSITE",
    "pixel_id":"{{pixel_id}}",
    "optimization_event":"ADD_BILLING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "CONVERT",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK

{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "scheduled_budget": 0,
        "delivery_mode": null,
        "conversion_window": null,
        "audience_ids": [],
        "device_price_ranges": null,
        "excluded_audience_ids": [],
        "catalog_id": "{{catalog_id}}",
        "network_types": [],
        "actions": [],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "brand_safety_partner": null,
        "isp_ids": [],
        "product_source": "CATALOG",
        "optimization_event": "ADD_BILLING",
        "app_type": null,
        "feed_type": null,
        "shopping_ads_retargeting_type": "OFF",
        "shopping_ads_type": "VIDEO",
        "gender": "GENDER_UNLIMITED",
        "app_id": null,
        "category_id": "0",
        "interest_category_ids": [],
        "optimization_goal": "CONVERT",
        "budget": {{budget}},
        "purchased_reach": null,
        "location_ids": [
            "6252001"
        ],
        "deep_bid_type": null,
        "click_attribution_window": "SEVEN_DAYS",
        "video_download_disabled": false,
        "ios14_quota_type": "UNOCCUPIED",
        "conversion_bid_price": {{conversion_bid_price}},
        "adgroup_id": "{{adgroup_id}}",
        "bid_type": "BID_TYPE_CUSTOM",
        "promotion_type": "WEBSITE",
        "frequency": null,
        "is_smart_performance_campaign": false,
        "pixel_id": "{{pixel_id}}",
        "share_disabled": false,
        "schedule_type": "SCHEDULE_START_END",
        "rf_estimated_cpr": null,
        "smart_audience_enabled": null,
        "bid_price": 0,
        "schedule_infos": null,
        "operating_systems": [],
        "budget_mode": "BUDGET_MODE_TOTAL",
        "rf_purchased_type": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "operation_status": "ENABLE",
        "schedule_end_time": "{{schedule_end_time}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "create_time": "{{create_time}}",
        "campaign_name": "{{campaign_name}}",
        "purchased_impression": null,
        "advertiser_id": "{{advertiser_id}}",
        "keywords": null,
        "comment_disabled": false,
        "auto_targeting_enabled": false,
        "adgroup_name": "{{adgroup_name}}",
        "secondary_optimization_event": null,
        "app_download_url": null,
        "is_hfss": false,
        "statistic_type": null,
        "rf_estimated_frequency": null,
        "category_exclusion_ids": [],
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "campaign_id": "{{campaign_id}}",
        "billing_event": "OCPM",
        "interest_keyword_ids": [],
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "pacing": "PACING_MODE_SMOOTH",
        "inventory_filter_enabled": false,
        "adgroup_app_profile_page_state": null,
        "view_attribution_window": "ONE_DAY",
        "schedule_start_time": "{{schedule_start_time}}",
        "is_new_structure": true,
        "bid_display_mode": "CPMV",
        "deep_cpa_bid": 0,
        "frequency_schedule": null,
        "smart_interest_behavior_enabled": null,
        "attribution_event_count": "EVERY",
        "next_day_retention": null,
        "age_groups": null,
        "languages": [],
        "creative_material_mode": "CATALOG_SALES",
        "skip_learning_phase": true,
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "search_result_enabled": false,
        "modify_time": "{{modify_time}}"
    }
}
(/code)
优化目标设置为落地页浏览量

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "WEBSITE",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "TRAFFIC_LANDING_PAGE_VIEW",
    "optimization_event": "LANDING_PAGE_VIEW",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "schedule_type": "SCHEDULE_START_END",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "pacing": "PACING_MODE_SMOOTH",
        "comment_disabled": false,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "campaign_id": "{{campaign_id}}",
        "shopping_ads_retargeting_type": "OFF",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "audience_ids": [],
        "scheduled_budget": 0,
        "secondary_optimization_event": null,
        "billing_event": "OCPM",
        "device_price_ranges": null,
        "view_attribution_window": "ONE_DAY",
        "skip_learning_phase": true,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "search_result_enabled": false,
        "is_smart_performance_campaign": false,
        "optimization_event": "LANDING_PAGE_VIEW",
        "modify_time": "{{modify_time}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "schedule_end_time": "{{schedule_end_time}}",
        "promotion_type": "WEBSITE",
        "purchased_reach": null,
        "rf_estimated_cpr": null,
        "deep_bid_type": null,
        "budget": {{budget}},
        "adgroup_name": "{{adgroup_name}}",
        "app_download_url": null,
        "smart_audience_enabled": null,
        "deep_cpa_bid": 0,
        "frequency": null,
        "location_ids": [
            "6252001"
        ],
        "excluded_audience_ids": [],
        "bid_display_mode": "CPMV",
        "purchased_impression": null,
        "shopping_ads_type": "VIDEO",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "attribution_event_count": "ONCE",
        "interest_category_ids": [],
        "gender": "GENDER_UNLIMITED",
        "conversion_bid_price": {{conversion_bid_price}},
        "schedule_start_time": "{{schedule_start_time}}",
        "campaign_name": "{{campaign_name}}",
        "actions": [],
        "conversion_window": null,
        "rf_estimated_frequency": null,
        "brand_safety_partner": null,
        "advertiser_id": "{{advertiser_id}}",
        "statistic_type": null,
        "adgroup_id": "{{adgroup_id}}",
        "interest_keyword_ids": [],
        "feed_type": null,
        "click_attribution_window": "SEVEN_DAYS",
        "catalog_id": "{{catalog_id}}",
        "smart_interest_behavior_enabled": null,
        "product_source": "CATALOG",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "share_disabled": false,
        "frequency_schedule": null,
        "languages": [],
        "category_id": "0",
        "app_type": null,
        "is_hfss": false,
        "age_groups": null,
        "operation_status": "ENABLE",
        "keywords": null,
        "bid_price": 0,
        "is_new_structure": true,
        "optimization_goal": "TRAFFIC_LANDING_PAGE_VIEW",
        "adgroup_app_profile_page_state": null,
        "auto_targeting_enabled": false,
        "category_exclusion_ids": [],
        "isp_ids": [],
        "network_types": [],
        "bid_type": "BID_TYPE_CUSTOM",
        "operating_systems": [],
        "delivery_mode": null,
        "schedule_infos": null,
        "creative_material_mode": "CATALOG_SALES",
        "create_time": "{{create_time}}",
        "inventory_filter_enabled": false,
        "video_download_disabled": false,
        "next_day_retention": null,
        "ios14_quota_type": "UNOCCUPIED",
        "rf_purchased_type": null,
        "pixel_id": null,
        "app_id": null
    }
}
(/code)
优化目标设置为价值

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "WEBSITE",
    "pixel_id":"{{pixel_id}}",
    "optimization_event":"SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"OFF",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "VALUE",
    "deep_bid_type": "VO_MIN_ROAS",
    "bid_type": "BID_TYPE_NO_BID",
    "roas_bid": {{roas_bid}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "shopping_ads_type": "VIDEO",
        "network_types": [],
        "is_smart_performance_campaign": false,
        "interest_category_ids": [],
        "pacing": "PACING_MODE_SMOOTH",
        "schedule_infos": null,
        "app_id": null,
        "age_groups": null,
        "app_download_url": null,
        "actions": [],
        "secondary_optimization_event": null,
        "optimization_goal": "VALUE",
        "promotion_type": "WEBSITE",
        "isp_ids": [],
        "skip_learning_phase": true,
        "device_price_ranges": null,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "interest_keyword_ids": [],
        "keywords": null,
        "app_type": null,
        "campaign_id": "{{campaign_id}}",
        "shopping_ads_retargeting_type": "OFF",
        "comment_disabled": false,
        "product_source": "CATALOG",
        "catalog_id": "{{catalog_id}}",
        "inventory_filter_enabled": false,
        "campaign_name": "{{campaign_name}}",
        "conversion_bid_price": 0,
        "auto_targeting_enabled": false,
        "rf_estimated_cpr": null,
        "adgroup_id": "{{adgroup_id}}",
        "is_hfss": false,
        "frequency": null,
        "deep_bid_type": "VO_MIN_ROAS",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "roas_bid": {{roas_bid}},
        "budget_mode": "BUDGET_MODE_TOTAL",
        "optimization_event": "SHOPPING",
        "delivery_mode": null,
        "modify_time": "{{modify_time}}",
        "languages": [],
        "video_download_disabled": false,
        "conversion_window": null,
        "excluded_audience_ids": [],
        "gender": "GENDER_UNLIMITED",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "bid_price": 0,
        "category_exclusion_ids": [],
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "is_new_structure": true,
        "pixel_id": "{{pixel_id}}",
        "billing_event": "OCPM",
        "bid_type": "BID_TYPE_NO_BID",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "rf_estimated_frequency": null,
        "audience_ids": [],
        "frequency_schedule": null,
        "statistic_type": null,
        "scheduled_budget": 0,
        "operating_systems": [],
        "view_attribution_window": "ONE_DAY",
        "smart_audience_enabled": null,
        "adgroup_app_profile_page_state": null,
        "advertiser_id": "{{advertiser_id}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "smart_interest_behavior_enabled": null,
        "share_disabled": false,
        "attribution_event_count": "EVERY",
        "creative_material_mode": "CATALOG_SALES",
        "category_id": "0",
        "feed_type": null,
        "brand_safety_partner": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "rf_purchased_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "operation_status": "ENABLE",
        "adgroup_name": "{{adgroup_name}",
        "bid_display_mode": "CPMV",
        "ios14_quota_type": "UNOCCUPIED",
        "purchased_reach": null,
        "next_day_retention": null,
        "search_result_enabled": false,
        "purchased_impression": null,
        "deep_cpa_bid": 0,
        "budget": {{budget}},
        "click_attribution_window": "SEVEN_DAYS",
        "create_time": "{{create_time}}",
        "location_ids": [
            "6252001"
        ]
    }
}
(/code)

对受众再营销(且优化位置设置为落地页,优化目标设置为点击)

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "shopping_ads_type": "VIDEO",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "promotion_type": "WEBSITE",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "shopping_ads_retargeting_type":"LAB1",
    "shopping_ads_retargeting_actions_days":180,
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "CLICK",
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "is_smart_performance_campaign": false,
        "conversion_window": null,
        "auto_targeting_enabled": false,
        "network_types": [],
        "audience_ids": [],
        "category_id": "0",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "skip_learning_phase": false,
        "advertiser_id": "{{advertiser_id}}",
        "catalog_id": "{{catalog_id}}",
        "create_time": "{{create_time}}",
        "operation_status": "ENABLE",
        "deep_bid_type": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "excluded_custom_actions": [
            {
                "code": "PURCHASE",
                "days": 180
            }
        ],
        "smart_audience_enabled": null,
        "bid_type": "BID_TYPE_CUSTOM",
        "device_price_ranges": null,
        "inventory_filter_enabled": false,
        "conversion_bid_price": 0,
        "secondary_optimization_event": null,
        "adgroup_name": "{{}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "smart_interest_behavior_enabled": null,
        "is_new_structure": true,
        "video_download_disabled": false,
        "actions": [],
        "age_groups": null,
        "adgroup_id": "{{adgroup_id}}",
        "shopping_ads_type": "VIDEO",
        "location_ids": [
            "6252001"
        ],
        "ios14_quota_type": "UNOCCUPIED",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "schedule_end_time": "{{schedule_end_time}}",
        "bid_price": {{bid_price}},
        "schedule_type": "SCHEDULE_START_END",
        "catalog_authorized_bc_id": "{{atalog_authorized_bc_id}}",
        "search_result_enabled": false,
        "deep_cpa_bid": 0,
        "schedule_infos": null,
        "delivery_mode": null,
        "product_source": "CATALOG",
        "rf_purchased_type": null,
        "creative_material_mode": "CUSTOM",
        "gender": "GENDER_UNLIMITED",
        "pacing": "PACING_MODE_SMOOTH",
        "languages": [],
        "app_download_url": null,
        "app_id": null,
        "excluded_audience_ids": [],
        "adgroup_app_profile_page_state": null,
        "included_custom_actions": [
            {
                "code": "VIEW_PRODUCT",
                "days": 180
            },
            {
                "code": "ADD_TO_CART",
                "days": 180
            }
        ],
        "next_day_retention": null,
        "purchased_reach": null,
        "frequency": null,
        "statistic_type": null,
        "campaign_name": "{{campaign_name}}",
        "scheduled_budget": 0,
        "comment_disabled": false,
        "is_hfss": false,
        "billing_event": "CPC",
        "interest_category_ids": [],
        "brand_safety_partner": null,
        "isp_ids": [],
        "share_disabled": false,
        "promotion_type": "WEBSITE",
        "shopping_ads_retargeting_type": "LAB1",
        "category_exclusion_ids": [],
        "rf_estimated_frequency": null,
        "optimization_goal": "CLICK",
        "pixel_id": null,
        "keywords": null,
        "operating_systems": [],
        "rf_estimated_cpr": null,
        "bid_display_mode": "CPMV",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "budget": {{budget}},
        "frequency_schedule": null,
        "interest_keyword_ids": [],
        "campaign_id": "{{campaign_id}}",
        "app_type": null,
        "purchased_impression": null,
        "feed_type": null,
        "optimization_event": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "modify_time": "{{modify_time}}"
    }
}
(/code)

4. 创建广告

使用/ad/create/接口创建一个广告。需确保满足以下要求:

广告样式为动态样式

设置 要求 参数 如何设置该参数
智能创意 未启用

不支持将is_smart_creative 传入 /ad/aco/create/ 创建开启智能创意的视频购物广告。
/ /
认证身份
(广告发布身份)
自定义用户(自定义身份) identity_type CUSTOMIZED_USER
identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
identity_authorized_bc_id 不传入
商品 以下任意选项:
  • 所有商品
  • 商品系列
  • 特定商品,最多选择20个商品
  • catalog_id
  • product_specific_type
  • item_group_ids
  • product_set_id
  • sku_ids
  • 将 catalog_id 设置为广告组层级指定的商品库 ID。
  • 将 product_specific_type 设置为 ALL,PRODUCT_SET 或 CUSTOMIZED_PRODUCTS。
    • 若 product_specific_type 设置为 ALL,无需传入 sku_ids,item_group_ids 和product_set_id。
    • 若 product_specific_type 设置为 PRODUCT_SET,您需传入 item_group_ids 或 product_set_id。无需传入 sku_ids。
    • 若 product_specific_type 设置为 CUSTOMIZED_PRODUCTS,您需通过sku_ids指定最多 20 个商品。无需传入item_group_ids 和 product_set_id。

注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的ad_creation_eligible为AVAILABLE,则该商品可用于广告中。

创意详情 - 动态样式 启用:向每位用户展示不同的视频和目标页面。 TikTok 会针对每位用户自动生成和组合各种特定广告样式,包括互动样式和落地页等。 为了优化用户体验和广告转化效果,建议启用此样式。
若要使用此样式,您必须同时提供常规视频和商品库视频。

注意:若您在广告组层级启用了对受众再营销,则不支持使用动态样式。

dynamic_format DYNAMIC_CREATIVE

注意:若广告组层级的shopping_ads_retargeting_type 设置为LAB1,LAB2或 LAB3,不支持将本字段设置为 DYNAMIC_CREATIVE。

ad_format SINGLE_VIDEO
vertical_video_strategy UNSET 或不传入
创意素材 同时指定以下内容:
  • 常规视频及其封面
  • 商品库视频选项:
    • 若您选择了一个与商品库绑定的视频模版,则该视频模版将用于为每个商品库商品自动生成动态商品库视频。
    • 若您未选择一个与商品库绑定的视频模版,系统将自动为每个商品选择一个视频模板,视频模版将用于为每个商品库商品自动生成动态商品库视频。若商品有对应的视频 URL,将使用视频 URL 中的视频。
  • video_id
  • image_ids
通过 video_id 指定常规视频,同时通过 image_ids指定视频封面。
shopping_ads_video_package_id 传入合法值或不传入。
  • 若传入本字段,则指定的视频模版将用于为每个商品库商品自动生成动态商品库视频。
  • 若不传入本字段,系统将自动为每个商品选择一个视频模板,视频模版将用于为每个商品库商品自动生成动态商品库视频。若商品有对应的视频 URL,将使用视频 URL 中的视频。

若想获取与商品库绑定的视频模版(视频包),可使用/catalog/video_package/get/。
若想了解如何在 TikTok 广告管理平台中创建视频模版,请查看如何在商品库中创建视频包。
  • tiktok_item_id
  • dark_post_status
不传入
music_id 不传入
广告文案 设置对应文案 ad_text 传入合法值
创新互动样式 未启用 card_id 不传入
目标页面
  • 若优化对象为落地页且优化目标为点击或落地页浏览量,目标页面仅支持落地页。不支持使用动态目标页面。
  • 若优化对象为落地页且优化目标为转化或价值,目标页面仅支持动态目标页面。
    • 如果启用动态目标页面,您的受众将跳转到你的落地页或自动创建的 TikTok 即时体验页面,具体取决于哪种页面最有可能为你的业务产生最佳效果。
  • 若优化对象为应用,目标页面仅支持应用。不支持使用动态目标页面。

无论优化对象为落地页还是应用,均不支持使用即时体验商品页面。
  • instant_product_page_used
  • page_image_index
不传入
  • landing_page_url
  • utm_params
  • deeplink
  • deeplink_type
  • shopping_ads_deeplink_type
  • deeplink_utm_params
  • shopping_ads_fallback_type
  • fallback_type
根据您的业务需要配置相关参数。
dynamic_destination
  • 若 promotion_type 设置为 WEBSITE 且 optimization_goal 设置为 CLICK 或TRAFFIC_LANDING_PAGE_VIEW,可省略本字段或将本字段设置为UNSET。
  • 若 promotion_type 设置为 WEBSITE 且optimization_goal 设置为CONVERT 或 VALUE,将本字段设置为 DLP。
  • 若 promotion_type 设置为 APP_ANDRIOD 或 APP_IOS,可省略本字段或将本字段设置为UNSET。
  • page_id
  • tiktok_page_category
  • phone_region_code
  • phone_region_calling_code
  • phone_number
不传入
行动引导文案 设置对应文案 call_to_action 传入合法值。
若想了解枚举值,请查看 枚举值 - 行动引导文案
免责声明 未启用
  • disclaimer_type
  • disclaimer_text
  • disclaimer_clickable_texts
不传入
试玩素材 未启用 playable_url 不传入

示例

目标页面为应用,指定视频模版,且不启用动态目标页面

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"DYNAMIC_CREATIVE",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "UNSET",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "shopping_ads_video_package_id":"{{shopping_ads_video_package_id}}",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "identity_type": "CUSTOMIZED_USER",
                "image_ids": [
                    "{{image_id}}"
                ],
                "viewability_postbid_partner": "UNSET",
                "modify_time": "{{modify_time}}",
                "creative_authorized": false,
                "shopping_ads_fallback_type": "DEFAULT",
                "ad_name": "{{ad_name}}",
                "click_tracking_url": "{{click_tracking_url}}",
                "ad_id": "{{ad_id}}",
                "dynamic_destination": "UNSET",
                "optimization_event": "ACTIVE",
                "tracking_app_id": "{{tracking_app_id}}",
                "call_to_action_id": null,
                "vertical_video_strategy": "UNSET",
                "impression_tracking_url": "{{impression_tracking_url}}",
                "app_name": "{{app_name}}",
                "shopping_ads_deeplink_type": "NONE",
                "card_id": "{{card_id}}",
                "is_aco": false,
                "adgroup_id": "{{adgroup_id}}",
                "campaign_id": "{{campaign_id}}",
                "ad_text": "{{ad_text}}",
                "tracking_pixel_id": 0,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "dynamic_format": "DYNAMIC_CREATIVE",
                "brand_safety_vast_url": null,
                "call_to_action": "LEARN_MORE",
                "deeplink_type": "NORMAL",
                "profile_image_url": "{{profile_image_url}}",
                "adgroup_name": "{{adgroup_name}}",
                "ad_format": "SINGLE_VIDEO",
                "display_name": "",
                "product_specific_type": "ALL",
                "operation_status": "ENABLE",
                "catalog_id": "{{catalog_id}}",
                "page_id": null,
                "creative_type": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "viewability_vast_url": null,
                "landing_page_urls": null,
                "shopping_ads_video_package_id": "{{shopping_ads_video_package_id}}",
                "identity_id": "{{identity_id}}",
                "music_id": null,
                "is_new_structure": true,
                "create_time": "{{create_time}}",
                "vast_moat_enabled": false,
                "deeplink": "",
                "landing_page_url": "",
                "ad_texts": null,
                "campaign_name": "{{campaign_name}}",
                "playable_url": "",
                "video_id": "{{video_id}}",
                "advertiser_id": "{{}advertiser_id}"
            }
        ]
    }
}
(/code)
目标页面为动态目标页面,且指定视频模版(广告组的优化目标为转化)

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"DYNAMIC_CREATIVE",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "UNSET",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "shopping_ads_video_package_id":"{{shopping_ads_video_package_id}}",
            "ad_text": "{{ad_text}}",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "dynamic_destination":"DLP",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "display_name": "{{display_name}}",
                "shopping_ads_fallback_type": "CUSTOM",
                "shopping_ads_video_package_id": "{{shopping_ads_video_package_id}}",
                "creative_authorized": false,
                "ad_id": "{{ad_id}}",
                "playable_url": "",
                "shopping_ads_deeplink_type": "NONE",
                "page_id": {{page_id}},
                "is_aco": false,
                "advertiser_id": "{{advertiser_id}}",
                "video_id": "{{video_id}}",
                "vertical_video_strategy": "UNSET",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "deeplink": null,
                "product_specific_type": "ALL",
                "ad_texts": null,
                "click_tracking_url": null,
                "ad_name": "{{ad_name}}",
                "music_id": null,
                "optimization_event": "ADD_BILLING",
                "modify_time": "{{modify_time}}",
                "viewability_postbid_partner": "UNSET",
                "viewability_vast_url": null,
                "campaign_id": "{{campaign_id}}",
                "landing_page_urls": null,
                "landing_page_url": "{{landing_page_url}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "app_name": "",
                "call_to_action": "LEARN_MORE",
                "dynamic_format": "DYNAMIC_CREATIVE",
                "adgroup_id": "{{adgroup_id}}",
                "identity_id": "{{identity_id}}",
                "dynamic_destination": "DLP",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "vast_moat_enabled": false,
                "impression_tracking_url": null,
                "ad_text": "{{ad_text}}",
                "operation_status": "ENABLE",
                "is_new_structure": true,
                "ad_format": "SINGLE_VIDEO",
                "catalog_id": "{{catalog_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "card_id": "{{card_id}}",
                "create_time": "{{create_time}}",
                "profile_image_url": "{{profile_image_url}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "call_to_action_id": null,
                "creative_type": "SHOPPING_CATALOG_PAGE",
                "tracking_pixel_id": {{tracking_pixel_id}},
                "brand_safety_vast_url": null,
                "campaign_name": "{{campaign_name}}",
                "adgroup_name": "{{adgroup_name}}"
            }
        ]
    }
}
(/code)
目标页面为落地页,不指定视频模版,且不启用动态目标页面(广告组的优化目标为点击)

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"DYNAMIC_CREATIVE",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "UNSET",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "ad_text": "{{ad_text}}",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK

{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "brand_safety_vast_url": null,
                "product_specific_type": "ALL",
                "campaign_id": "{{campaign_id}}",
                "dynamic_destination": "UNSET",
                "shopping_ads_deeplink_type": "NONE",
                "landing_page_urls": null,
                "tracking_pixel_id": 0,
                "shopping_ads_video_package_id": "",
                "is_aco": false,
                "click_tracking_url": null,
                "music_id": null,
                "image_ids": [
                    "{{image_id}}"
                ],
                "dynamic_format": "DYNAMIC_CREATIVE",
                "ad_name": "{{ad_name}}",
                "optimization_event": null,
                "playable_url": "",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "landing_page_url": "{{landing_page_url}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "campaign_name": "{{campaign_name}}",
                "app_name": "",
                "call_to_action_id": null,
                "page_id": null,
                "profile_image_url": "{{profile_image_url}}",
                "card_id": "{{card_id}}",
                "advertiser_id": "{{advertiser_id}}",
                "vast_moat_enabled": false,
                "ad_text": "{{ad_text}}",
                "modify_time": "{{modify_time}}",
                "display_name": "{{display_name}}",
                "ad_id": "{{ad_id}}",
                "catalog_id": "{{catalog_id}}",
                "is_new_structure": true,
                "viewability_vast_url": null,
                "deeplink": "",
                "create_time": "{{create_time}}",
                "creative_authorized": false,
                "shopping_ads_fallback_type": "CUSTOM",
                "ad_texts": null,
                "vertical_video_strategy": "UNSET",
                "creative_type": null,
                "operation_status": "ENABLE",
                "identity_id": "{{identity_id}}",
                "ad_format": "SINGLE_VIDEO",
                "adgroup_name": "{{adgroup_name}}",
                "viewability_postbid_partner": "UNSET",
                "identity_type": "CUSTOMIZED_USER",
                "video_id": "{{video_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "deeplink_type": "NORMAL",
                "call_to_action": "LEARN_MORE",
                "impression_tracking_url": null
            }
        ]
    }
}
(/code)
目标页面为落地页,指定视频模版,且不启用动态目标页面(广告组的优化目标为点击)

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"DYNAMIC_CREATIVE",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "UNSET",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "shopping_ads_video_package_id":"{{shopping_ads_video_package_id}}",
            "ad_text": "{{ad_text}}",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "click_tracking_url": null,
                "app_name": "",
                "catalog_id": "{{catalog_id}}",
                "vast_moat_enabled": false,
                "tracking_pixel_id": 0,
                "music_id": null,
                "create_time": "{{create_time}}",
                "product_specific_type": "ALL",
                "landing_page_url": "{{landing_page_url}}",
                "identity_type": "CUSTOMIZED_USER",
                "page_id": null,
                "card_id": "{{card_id}}",
                "impression_tracking_url": null,
                "landing_page_urls": null,
                "ad_text": "{{ad_text}}",
                "creative_authorized": false,
                "deeplink_type": "NORMAL",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "playable_url": "",
                "is_new_structure": true,
                "campaign_id": "{{campaign_id}}",
                "display_name": "{{display_name}}",
                "ad_format": "SINGLE_VIDEO",
                "ad_name": "{{ad_name}}",
                "dynamic_format": "DYNAMIC_CREATIVE",
                "operation_status": "ENABLE",
                "is_aco": false,
                "adgroup_name": "{{adgroup_name}}",
                "modify_time": "{{modify_time}}",
                "shopping_ads_fallback_type": "CUSTOM",
                "call_to_action_id": null,
                "shopping_ads_video_package_id": "{{shopping_ads_video_package_id}}",
                "deeplink": "",
                "optimization_event": null,
                "profile_image_url": "{{profile_image_url}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "brand_safety_vast_url": null,
                "dynamic_destination": "UNSET",
                "campaign_name": "{{campaign_name}}",
                "video_id": "{{video_id}}",
                "ad_id": "{{ad_id}}",
                "ad_texts": null,
                "creative_type": null,
                "viewability_postbid_partner": "UNSET",
                "advertiser_id": "{{advertiser_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "identity_id": "{{identity_id}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "vertical_video_strategy": "UNSET",
                "call_to_action": "LEARN_MORE",
                "shopping_ads_deeplink_type": "NONE",
                "viewability_vast_url": null
            }
        ]
    }
}
(/code)

广告样式为单视频

设置 要求 参数 如何设置该参数
智能创意 未启用

不支持将is_smart_creative 传入 /ad/aco/create/ 创建开启智能创意的视频购物广告。
/ /
认证身份
(广告发布身份)
以下任意选项:
  • 自定义用户(自定义身份)
  • 授权用户
  • TikTok 用户
  • 添加到商务中心的 TikTok 用户
identity_type 以下任意值:
  • CUSTOMIZED_USER
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT
identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
identity_authorized_bc_id 若 identity_type 设置为 BC_AUTH_TT,需传入合法值。
商品 以下任意选项:
  • 所有商品
  • 商品系列
  • 特定商品,最多选择20个商品
  • catalog_id
  • product_specific_type
  • item_group_ids
  • product_set_id
  • sku_ids
  • 将 catalog_id 设置为广告组层级指定的商品库 ID。
  • 将 product_specific_type 设置为 ALL,PRODUCT_SET 或 CUSTOMIZED_PRODUCTS。
    • 若 product_specific_type 设置为 ALL,无需传入 sku_ids,item_group_ids 和product_set_id。
    • 若 product_specific_type 设置为 PRODUCT_SET,您需传入 item_group_ids 或 product_set_id。无需传入 sku_ids。
    • 若 product_specific_type 设置为 CUSTOMIZED_PRODUCTS,您需通过sku_ids指定最多 20 个商品。无需传入item_group_ids 和 product_set_id。

注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的ad_creation_eligible为AVAILABLE,则该商品可用于广告中。

创意详情 - 动态样式 未启用 dynamic_format UNSET 或不传入
广告样式 单视频:利用视频创意推广您的商品。 ad_format SINGLE_VIDEO
vertical_video_strategy SINGLE_VIDEO
创意素材
  • 使用 TikTok 用户身份推送帖子创建 Spark Ads 或使用自定义用户身份时,需指定视频和视频封面。
  • 使用 TikTok 用户身份提取帖子创建 Spark Ads 或使用授权用户身份或添加到商务中心的 TikTok 用户身份时,需指定 TikTok 帖子。
  • video_id
  • image_ids
  • ad_text
  • tiktok_item_id
  • dark_post_status
  • 若 identity_type 设置为 CUSTOMIZED_USER,需指定视频(video_id),视频封面(image_ids),和广告文案 (ad_text)。 无需传入 tiktok_item_id。
  • 若 identity_type 设置为 TT_USER,您可通过推送帖子或提取帖子创建 Spark Ads :
    • 推送帖子创建 Spark Ads :需指定视频(video_id),视频封面(image_ids),和广告文案 (ad_text)。 无需传入 tiktok_item_id。您可以把 dark_post_status 设置为 ON,从而确保视频仅发布为广告,而不会作为原生视频发布到 TikTok 账号中。
    • 提取帖子创建 Spark Ads:需通过tiktok_item_id指定 TikTok 帖子。 无需传入 video_id,image_ids,ad_text 和 dark_post_status。
    若想了解 Spark Ads 详情,请查看创建 Spark Ads。
  • 若 identity_type 设置为 AUTH_CODE 或 BC_AUTH_TT,需通过 tiktok_item_id 指定 TikTok 帖子。 无需传入video_id,image_ids及ad_text。
shopping_ads_video_package_id 不传入
music_id 不传入
创新互动样式(可选) 未启用,或使用以下任意类型:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片(又称图片卡片)
  • 商品卡片
  • 商品磁贴(需申请白名单)
card_id 不传入或指定任意类型的创意素材包的 ID:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片
  • 商品卡片
  • 商品磁贴

若想创建创意素材包,可使用 /creative/portfolio/create/。
  • 欲了解如何获取展示卡片、商品卡片或商品磁贴素材包的 ID,请参考卡片。
  • 欲了解如何获取倒计时贴纸或礼品码贴纸素材包的 ID,请参考贴纸。

注意:使用商品磁贴素材包创建广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

目标页面
  • 若优化对象为落地页,目标页面支持以下选项:
    • 动态目标页面
      • 如果启用动态目标页面,您的受众将跳转到你的落地页或自动创建的 TikTok 即时体验页面,具体取决于哪种页面最有可能为你的业务产生最佳效果。
    • 落地页
    • 即时体验商品页面
      • 通过即时体验商品页面,客户会跳转到原生的 TikTok 落地页。您可以在这个页面展示一系列商品并加强意向信号的收集,从而帮助您提升广告效果。
  • 若优化对象为应用,目标页面仅支持应用。

动态目标页面不支持在以下场景中使用:
  • 优化对象为应用时。
  • 优化对象为落地页且优化目标为点击或落地页浏览量时。
  • dynamic_destination
  • instant_product_page_used
  • page_image_index
  • promotion_type 设置为 WEBSITE时:
    • 若想将目标页面设置为动态目标页面,需将 dynamic_destination 设置为 DLP,同时省略即时体验商品页面参数(instant_product_page_used 和 page_image_index)。
    • 若想将目标页面设置为落地页,需省略动态目标页面和即时体验商品页面参数(dynamic_destination, instant_product_page_used 和 page_image_index)。
    • 若想将目标页面设置为即时体验商品页面,需将 instant_product_page_used 设置为 true,可同时传入可选参数 utm_params 和 page_image_index。无需传入动态目标页面参数 dynamic_destination。
  • promotion_type 设置为 APP_ANDRIOD 或 APP_IOS时,需省略动态目标页面和即时体验商品页面参数(dynamic_destination,instant_product_page_used和 page_image_index)。

注意:在以下场景中不允许将 dynamic_destination 设置为 DLP:

  • promotion_type 设置为 APP_ANDRIOD 或 APP_IOS时。
  • promotion_type 设置为 WEBSITE 且 optimization_goal 设置为 CLICK 或 TRAFFIC_LANDING_PAGE_VIEW时。
  • landing_page_url
  • utm_params
  • deeplink
  • deeplink_type
  • shopping_ads_deeplink_type
  • deeplink_utm_params
  • shopping_ads_fallback_type
  • fallback_type
根据您的业务需要配置相关参数。
  • 需注意,根据所选的优化目标,可用的深度链接设置可能不同。若想了解深度链接的详情,请查看深度链接。
  • 若想了解优化目标点击支持的目标页面和深度链接设置,请查看在推广网站的视频购物广告中指定目标页面和深度链接设置。

  • 注意:此时不允许使用商品库深度链接和商品库链接,因此,shopping_ads_deeplink_type 和 shopping_ads_fallback_type 不允许设置为 SHOPPING_ADS。

  • page_id
  • tiktok_page_category
  • phone_region_code
  • phone_region_calling_code
  • phone_number
不传入
行动引导文案 设置对应文案 call_to_action 传入合法值。
若想了解枚举值,请查看 枚举值 - 行动引导文案。
免责声明 未启用
  • disclaimer_type
  • disclaimer_text
  • disclaimer_clickable_texts
不传入
试玩素材 未启用 playable_url 不传入

示例

目标页面为应用

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "SINGLE_VIDEO",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "product_specific_type": "ALL",
                "ad_format": "SINGLE_VIDEO",
                "is_new_structure": true,
                "card_id": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "video_id": "{{video_id}}",
                "dynamic_format": "UNSET",
                "deeplink": "",
                "shopping_ads_deeplink_type": "NONE",
                "tracking_pixel_id": 0,
                "campaign_id": "{{campaign_id}}",
                "impression_tracking_url": "{{impression_tracking_url}}",
                "brand_safety_vast_url": null,
                "page_id": null,
                "modify_time": "{{modify_time}}",
                "ad_name": "{{ad_name}}",
                "call_to_action_id": null,
                "ad_id": "{{ad_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "landing_page_urls": null,
                "operation_status": "ENABLE",
                "advertiser_id": "{{advertiser_id}}",
                "campaign_name": "{{campaign_name}}",
                "click_tracking_url": "{{click_tracking_url}}",
                "app_name": "{{app_name}}",
                "create_time": "{{create_time}}",
                "catalog_id": "{{catalog_id}}",
                "identity_id": "{{identity_id}}",
                "landing_page_url": "",
                "tracking_app_id": "{{tracking_app_id}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "creative_type": null,
                "viewability_vast_url": null,
                "music_id": null,
                "ad_text": "{{ad_text}}",
                "shopping_ads_fallback_type": "DEFAULT",
                "call_to_action": "LEARN_MORE",
                "shopping_ads_video_package_id": "",
                "deeplink_type": "NORMAL",
                "playable_url": "",
                "vast_moat_enabled": false,
                "vertical_video_strategy": "SINGLE_VIDEO",
                "ad_texts": null,
                "display_name": "",
                "optimization_event": "ACTIVE",
                "viewability_postbid_partner": "UNSET",
                "adgroup_id": "{{adgroup_id}}",
                "creative_authorized": false,
                "profile_image_url": "{{profile_image_url}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "is_aco": false,
                "adgroup_name": "{{adgroup_name}}",
                "dynamic_destination": "UNSET"
            }
        ]
    }
}
(/code)
目标页面为动态目标页面

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "SINGLE_VIDEO",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"DLP",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "adgroup_name": "{{adgroup_name}}",
                "page_id": {{page_id}},
                "ad_id": "{{ad_id}}",
                "create_time": "{{create_time}}",
                "call_to_action": "LEARN_MORE",
                "operation_status": "ENABLE",
                "creative_authorized": false,
                "impression_tracking_url": null,
                "image_ids": [
                    "{{image_id}}"
                ],
                "catalog_id": "{{catalog_id}}",
                "ad_text": "{{ad_text}}",
                "identity_type": "CUSTOMIZED_USER",
                "ad_name": "{{ad_name}}",
                "landing_page_urls": null,
                "call_to_action_id": null,
                "deeplink": null,
                "optimization_event": "ADD_BILLING",
                "ad_texts": null,
                "creative_type": "SHOPPING_CATALOG_PAGE",
                "adgroup_id": "{{adgroup_id}}",
                "shopping_ads_fallback_type": "CUSTOM",
                "modify_time": "{{modify_time}}",
                "dynamic_format": "UNSET",
                "viewability_vast_url": null,
                "ad_format": "SINGLE_VIDEO",
                "brand_safety_vast_url": null,
                "click_tracking_url": null,
                "playable_url": "",
                "identity_id": "{{identity_id}}",
                "vast_moat_enabled": false,
                "profile_image_url": "{{profile_image_url}}",
                "music_id": null,
                "is_new_structure": true,
                "shopping_ads_deeplink_type": "NONE",
                "advertiser_id": "{{advertiser_id}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "shopping_ads_video_package_id": "",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "card_id": null,
                "video_id": "{{video_id}}",
                "landing_page_url": "{{landing_page_url}}",
                "viewability_postbid_partner": "UNSET",
                "app_name": "",
                "is_aco": false,
                "product_specific_type": "ALL",
                "tracking_pixel_id": {{tracking_pixel_id}},
                "display_name": "{{display_name}}",
                "campaign_id": "{{campaign_id}}",
                "campaign_name": "{{campaign_name}}",
                "vertical_video_strategy": "SINGLE_VIDEO",
                "dynamic_destination": "DLP"
            }
        ]
    }
}
(/code)
目标页面为落地页

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "SINGLE_VIDEO",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "video_id": "{{video_id}}",
                "brand_safety_vast_url": null,
                "adgroup_id": "{{adgroup_id}}",
                "call_to_action_id": null,
                "deeplink_type": "NORMAL",
                "app_name": "",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "advertiser_id": "{{advertiser_id}}",
                "identity_id": "{{identity_id}}",
                "is_aco": false,
                "identity_type": "CUSTOMIZED_USER",
                "vertical_video_strategy": "SINGLE_VIDEO",
                "playable_url": "",
                "ad_name": "{{ad_name}}",
                "ad_id": "{{ad_id}}",
                "tracking_pixel_id": {{tracking_pixel_id}},
                "shopping_ads_fallback_type": "CUSTOM",
                "card_id": null,
                "vast_moat_enabled": false,
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "call_to_action": "LEARN_MORE",
                "creative_authorized": false,
                "display_name": "{{display_name}}",
                "viewability_vast_url": null,
                "profile_image_url": "{{profile_image_url}}",
                "deeplink": "",
                "ad_texts": null,
                "create_time": "{{create_time}}",
                "creative_type": null,
                "landing_page_url": "{{landing_page_url}}",
                "click_tracking_url": null,
                "product_specific_type": "ALL",
                "page_id": null,
                "adgroup_name": "{{adgroup_name}}",
                "ad_text": "{{ad_text}}",
                "shopping_ads_deeplink_type": "NONE",
                "campaign_name": "{{campaign_name}}",
                "shopping_ads_video_package_id": "",
                "is_new_structure": true,
                "landing_page_urls": null,
                "catalog_id": "{{catalog_id}}",
                "viewability_postbid_partner": "UNSET",
                "impression_tracking_url": null,
                "dynamic_destination": "UNSET",
                "image_ids": [
                    "{{image_id}}"
                ],
                "modify_time": "{{modify_time}}",
                "dynamic_format": "UNSET",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "music_id": null,
                "optimization_event": "ADD_BILLING",
                "campaign_id": "{{campaign_id}}",
                "ad_format": "SINGLE_VIDEO",
                "operation_status": "ENABLE"
            }
        ]
    }
}
(/code)
目标页面为即时体验商品页面

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "SINGLE_VIDEO",
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "instant_product_page_used":true,
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "advertiser_id": "{{advertiser_id}}",
                "campaign_id": "{{campaign_id}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "shopping_ads_fallback_type": "CUSTOM",
                "click_tracking_url": null,
                "is_aco": false,
                "call_to_action": "LEARN_MORE",
                "identity_id": "{{identity_id}}",
                "landing_page_urls": null,
                "ad_name": "{{ad_name}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "shopping_ads_video_package_id": "",
                "ad_id": "{{ad_id}}",
                "optimization_event": "ADD_BILLING",
                "ad_texts": null,
                "ad_text": "{{ad_text}}",
                "identity_type": "CUSTOMIZED_USER",
                "landing_page_url": "{{landing_page_url}}",
                "card_id": null,
                "shopping_ads_deeplink_type": "NONE",
                "profile_image_url": "{{profile_image_url}}",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "product_specific_type": "ALL",
                "adgroup_name": "{{adgroup_name}}",
                "display_name": "{{display_name}}",
                "playable_url": "",
                "call_to_action_id": null,
                "viewability_postbid_partner": "UNSET",
                "ad_format": "SINGLE_VIDEO",
                "campaign_name": "{{campaign_name}}",
                "vast_moat_enabled": false,
                "vertical_video_strategy": "SINGLE_VIDEO",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "creative_type": "SHOPPING_CATALOG_PAGE",
                "tracking_pixel_id": {{tracking_pixel_id}},
                "dynamic_format": "UNSET",
                "page_id": {{page_id}},
                "is_new_structure": true,
                "catalog_id": "{{catalog_id}}",
                "dynamic_destination": "UNSET",
                "viewability_vast_url": null,
                "create_time": "{{create_time}}",
                "modify_time": "{{modify_time}}",
                "deeplink": "",
                "app_name": "",
                "brand_safety_vast_url": null,
                "music_id": null,
                "video_id": "{{video_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "impression_tracking_url": null,
                "creative_authorized": false,
                "operation_status": "ENABLE"
            }
        ]
    }
}
(/code)

广告样式为商品库视频

设置 要求 参数 如何设置该参数
智能创意 未启用

不支持将is_smart_creative 传入 /ad/aco/create/ 创建开启智能创意的视频购物广告。
/ /
认证身份
(广告发布身份)
自定义用户(自定义身份) identity_type CUSTOMIZED_USER
identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
identity_authorized_bc_id 不传入
商品 以下任意选项:
  • 所有商品
  • 商品系列
  • 特定商品,最多选择20个商品
  • catalog_id
  • product_specific_type
  • item_group_ids
  • product_set_id
  • sku_ids
  • 将 catalog_id 设置为广告组层级指定的商品库 ID。
  • 将 product_specific_type 设置为 ALL,PRODUCT_SET 或 CUSTOMIZED_PRODUCTS。
    • 若 product_specific_type 设置为 ALL,无需传入 sku_ids,item_group_ids 和product_set_id。
    • 若 product_specific_type 设置为 PRODUCT_SET,您需传入 item_group_ids 或 product_set_id。无需传入 sku_ids。
    • 若 product_specific_type 设置为 CUSTOMIZED_PRODUCTS,您需通过sku_ids指定最多 20 个商品。无需传入item_group_ids 和 product_set_id。

注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的ad_creation_eligible为AVAILABLE,则该商品可用于广告中。

创意详情 - 动态样式 未启用 dynamic_format UNSET 或不传入
广告样式 商品库视频 :基于商品目录中的信息生成动态视频。

注意:若您想要使用已上传的商品库视频创建商品库视频广告,需确保已在广告组层级将优化位置设置为落地页。

ad_format SINGLE_VIDEO
vertical_video_strategy 以下任意值:
  • CATALOG_UPLOADED_VIDEOS:使用已上传的商品库视频的商品库视频样式。
    若想了解如何管理已上传的商品库视频,请查看上传商品库视频并与商品绑定。
  • CATALOG_VIDEOS:使用视频模板的商品库视频样式。

注意:

  • 使用已上传的商品库视频创建广告样式为商品库视频、商品来源为商品库的视频购物广告(即vertical_video_strategy 设置为 CATALOG_UPLOADED_VIDEOS)目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。
  • 若要将 vertical_video_strategy 设置为 CATALOG_UPLOADED_VIDEOS,您需先在广告组层级将 promotion_type 设置为 WEBSITE。
创意素材 商品库视频。
您需确保商品库至少存在一个已上传的商品库视频,绑定了一个视频模版,或每个商品都设置了对应的视频 URL。
  • 若您选择了“您的视频”(即已上传的商品库视频),系统将自动选择已上传的商品库视频来展示商品。
  • 若您选择了一个与商品库绑定的视频模版,则该视频模版将用于为每个商品库商品自动生成动态商品库视频。
  • 若您未选择一个与商品库绑定的视频模版,系统将自动为每个商品选择一个视频模板,视频模版将用于为每个商品库商品自动生成动态商品库视频。若商品有对应的视频 URL,将使用视频 URL 中的视频。
shopping_ads_video_package_id 传入合法值或不传入。
  • 若不传入本字段且 vertical_video_strategy 设置为CATALOG_UPLOADED_VIDEOS,系统将自动选择已上传的商品库视频来展示商品。
  • 若传入本字段且 vertical_video_strategy 设置为 CATALOG_VIDEOS,则指定的视频模版将用于为每个商品库商品自动生成动态商品库视频。
  • 若不传入本字段且 vertical_video_strategy 设置为 CATALOG_VIDEOS,系统将自动为每个商品选择一个视频模板,视频模版将用于为每个商品库商品自动生成动态商品库视频。若商品有对应的视频 URL,将使用视频 URL 中的视频。

若想获取与商品库绑定的视频模版(视频包),可使用/catalog/video_package/get/。
若想了解如何在 TikTok 广告管理平台中创建视频模版,请查看创建视频包。
  • video_id
  • image_ids
  • tiktok_item_id
  • dark_post_status
  • music_id
不传入
广告文案 设置对应文案 ad_text 传入合法值
创新互动样式(可选) 未启用,或使用以下任意类型:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片(又称图片卡片)
  • 商品卡片
  • 商品磁贴(需申请白名单)

注意:仅当使用上传的商品库视频时支持使用商品磁贴素材包。

card_id 不传入或指定任意类型的创意素材包的 ID:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片
  • 商品卡片
  • 商品磁贴
    • 若要在商品来源为商品库、广告样式为商品库视频的视频购物广告中使用商品磁贴素材包,您需将vertical_video_strategy 设置为 CATALOG_UPLOADED_VIDEOS。

若想创建创意素材包,可使用 /creative/portfolio/create/。
  • 欲了解如何获取展示卡片、商品卡片或商品磁贴素材包的 ID,请参考卡片。
  • 欲了解如何获取倒计时贴纸或礼品码贴纸素材包的 ID,请参考贴纸。

注意: 使用商品磁贴素材包创建广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

目标页面
  • 若优化对象为落地页,目标页面支持以下选项:
    • 动态目标页面
      • 如果启用动态目标页面,您的受众将跳转到你的落地页或自动创建的 TikTok 即时体验页面,具体取决于哪种页面最有可能为你的业务产生最佳效果。
    • 落地页
    • 即时体验商品页面
      • 通过即时体验商品页面,客户会跳转到原生的 TikTok 落地页。您可以在这个页面展示一系列商品并加强意向信号的收集,从而帮助您提升广告效果。
  • 若优化对象为应用,目标页面仅支持应用。

动态目标页面不支持在以下场景中使用:
  • 优化对象为应用时。
  • 优化对象为落地页且优化目标为点击或落地页浏览量时。
  • dynamic_destination
  • instant_product_page_used
  • page_image_index
  • promotion_type 设置为 WEBSITE时:
    • 若想将目标页面设置为动态目标页面,需将 dynamic_destination 设置为 DLP,同时省略即时体验商品页面参数(instant_product_page_used 和 page_image_index)。
    • 若想将目标页面设置为落地页,需省略动态目标页面和即时体验商品页面参数(dynamic_destination, instant_product_page_used 和 page_image_index)。
    • 若想将目标页面设置为即时体验商品页面,需将 instant_product_page_used 设置为 true,可同时传入可选参数 utm_params 和 page_image_index。无需传入动态目标页面参数 dynamic_destination。
  • promotion_type 设置为 APP_ANDRIOD 或 APP_IOS时,需省略动态目标页面和即时体验商品页面参数(dynamic_destination,instant_product_page_used和 page_image_index)。

注意:在以下场景中不允许将 dynamic_destination 设置为 DLP:

  • promotion_type 设置为 APP_ANDRIOD 或 APP_IOS时。
  • promotion_type 设置为 WEBSITE 且 optimization_goal 设置为 CLICK 或 TRAFFIC_LANDING_PAGE_VIEW时。
  • landing_page_url
  • utm_params
  • deeplink
  • deeplink_type
  • shopping_ads_deeplink_type
  • deeplink_utm_params
  • shopping_ads_fallback_type
  • fallback_type
根据您的业务需要配置相关参数。
  • page_id
  • tiktok_page_category
  • phone_region_code
  • phone_region_calling_code
  • phone_number
不传入
行动引导文案 设置对应文案 call_to_action 传入合法值。
若想了解枚举值,请查看 枚举值 - 行动引导文案。
免责声明 未启用
  • disclaimer_type
  • disclaimer_text
  • disclaimer_clickable_texts
不传入
试玩素材 未启用 playable_url 不传入

示例

目标页面为应用且不指定视频模版

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_VIDEOS",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK

{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "advertiser_id": "{{advertiser_id}}",
                "campaign_id": "{{campaign_id}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "shopping_ads_fallback_type": "DEFAULT",
                "click_tracking_url": "{{click_tracking_url}}",
                "is_aco": false,
                "call_to_action": "LEARN_MORE",
                "identity_id": "{{identity_id}}",
                "landing_page_urls": null,
                "ad_name": "{{ad_name}}",
                "image_ids": [],
                "shopping_ads_video_package_id": "",
                "ad_id": "{{ad_id}}",
                "optimization_event": "ACTIVE",
                "ad_texts": null,
                "ad_text": "{{ad_text}}",
                "identity_type": "CUSTOMIZED_USER",
                "landing_page_url": "",
                "card_id": null,
                "shopping_ads_deeplink_type": "NONE",
                "profile_image_url": "{{profile_image_url}}",
                "deeplink_type": "NORMAL",
                "product_specific_type": "ALL",
                "tracking_app_id": "{{tracking_app_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "display_name": "",
                "playable_url": "",
                "call_to_action_id": null,
                "viewability_postbid_partner": "UNSET",
                "ad_format": "SINGLE_VIDEO",
                "campaign_name": "{{campaign_name}}",
                "vast_moat_enabled": false,
                "vertical_video_strategy": "CATALOG_VIDEOS",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "creative_type": null,
                "tracking_pixel_id": 0,
                "dynamic_format": "UNSET",
                "page_id": null,
                "is_new_structure": true,
                "catalog_id": "{{catalog_id}}",
                "dynamic_destination": "UNSET",
                "viewability_vast_url": null,
                "create_time": "{{create_time}}",
                "modify_time": "{{modify_time}}",
                "deeplink": "",
                "app_name": "{{app_name}}",
                "brand_safety_vast_url": null,
                "music_id": null,
                "video_id": null,
                "adgroup_id": "{{adgroup_id}}",
                "impression_tracking_url": "{{impression_tracking_url}}",
                "creative_authorized": false,
                "operation_status": "ENABLE"
            }
        ]
    }
}
(/code)
目标页面为应用且指定视频模版

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_VIDEOS",
            "shopping_ads_video_package_id":"{{shopping_ads_video_package_id}}",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "identity_id": "{{identity_id}}",
                "optimization_event": "ACTIVE",
                "music_id": null,
                "identity_type": "CUSTOMIZED_USER",
                "call_to_action": "LEARN_MORE",
                "creative_authorized": false,
                "vast_moat_enabled": false,
                "campaign_name": "{{campaign_name}}",
                "display_name": "",
                "product_specific_type": "ALL",
                "viewability_vast_url": null,
                "ad_texts": null,
                "vertical_video_strategy": "CATALOG_VIDEOS",
                "modify_time": "{{modify_time}}",
                "page_id": null,
                "viewability_postbid_partner": "UNSET",
                "catalog_id": "{{catalog_id}}",
                "advertiser_id": "{{advertiser_id}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "brand_safety_vast_url": null,
                "is_new_structure": true,
                "ad_name": "{{ad_name}}",
                "adgroup_name": "{{adgroup_name}}",
                "tracking_app_id": "{{tracking_app_id}}",
                "ad_format": "SINGLE_VIDEO",
                "profile_image_url": "{{profile_image_url}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "dynamic_format": "UNSET",
                "click_tracking_url": "{{click_tracking_url}}",
                "creative_type": null,
                "app_name": "{{app_name}}",
                "campaign_id": "{{campaign_id}}",
                "operation_status": "ENABLE",
                "image_ids": [],
                "landing_page_url": "",
                "shopping_ads_video_package_id": "{{shopping_ads_video_package_id}}",
                "deeplink": "",
                "tracking_pixel_id": 0,
                "call_to_action_id": null,
                "shopping_ads_fallback_type": "DEFAULT",
                "deeplink_type": "NORMAL",
                "create_time": "{{create_time}}",
                "playable_url": "",
                "impression_tracking_url": "{{impression_tracking_url}}",
                "adgroup_id": "{{adgroup_id}}",
                "shopping_ads_deeplink_type": "NONE",
                "ad_id": "{{ad_id}}",
                "video_id": null,
                "landing_page_urls": null,
                "is_aco": false,
                "card_id": null,
                "ad_text": "{{ad_text}}",
                "dynamic_destination": "UNSET"
            }
        ]
    }
}
(/code)
目标页面为动态目标页面且不指定视频模版

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_VIDEOS",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"DLP",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "shopping_ads_deeplink_type": "NONE",
                "ad_texts": null,
                "brand_safety_vast_url": null,
                "is_aco": false,
                "tracking_pixel_id": {{tracking_pixel_id}},
                "ad_format": "SINGLE_VIDEO",
                "ad_name": "{{ad_name}}",
                "adgroup_id": "{{adgroup_id}}",
                "product_specific_type": "ALL",
                "landing_page_url": "{{landing_page_url}}",
                "call_to_action_id": null,
                "click_tracking_url": null,
                "operation_status": "ENABLE",
                "adgroup_name": "{{adgroup_name}}",
                "identity_type": "CUSTOMIZED_USER",
                "profile_image_url": "{{profile_image_url}}",
                "ad_text": "{{ad_text}}",
                "vast_moat_enabled": false,
                "shopping_ads_fallback_type": "CUSTOM",
                "creative_type": "SHOPPING_CATALOG_PAGE",
                "dynamic_format": "UNSET",
                "identity_id": "{{identity_id}}",
                "display_name": "{{display_name"}}",
                "video_id": null,
                "advertiser_id": "{{advertiser_id}}",
                "catalog_id": "{{catalog_id}}",
                "impression_tracking_url": null,
                "page_id": {{page_id}},
                "tracking_offline_event_set_ids": [
                    "{{racking_offline_event_set_id}}"
                ],
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "viewability_postbid_partner": "UNSET",
                "campaign_id": "{{campaign_id"}}",
                "dynamic_destination": "DLP",
                "playable_url": "",
                "optimization_event": "ADD_BILLING",
                "image_ids": [],
                "modify_time": "{{modify_time}}",
                "card_id": null,
                "ad_id": "{{ad_id}}",
                "vertical_video_strategy": "CATALOG_VIDEOS",
                "deeplink": null,
                "create_time": "{{create_time}}",
                "viewability_vast_url": null,
                "music_id": null,
                "shopping_ads_video_package_id": "",
                "call_to_action": "LEARN_MORE",
                "creative_authorized": false,
                "campaign_name": "{{campaign_name}}",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "landing_page_urls": null,
                "is_new_structure": true,
                "app_name": ""
            }
        ]
    }
}
(/code)
目标页面为落地页且不指定视频模版

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_VIDEOS",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "ad_texts": null,
                "creative_authorized": false,
                "tracking_pixel_id": {{tracking_pixel_id}},
                "deeplink_type": "NORMAL",
                "ad_text": "{{ad_text}}",
                "impression_tracking_url": null,
                "optimization_event": "ADD_BILLING",
                "app_name": "",
                "landing_page_urls": null,
                "ad_id": "{{ad_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "playable_url": "",
                "music_id": null,
                "adgroup_id": "{{adgroup_id}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "call_to_action": "LEARN_MORE",
                "vertical_video_strategy": "CATALOG_VIDEOS",
                "viewability_vast_url": null,
                "adgroup_name": "{{adgroup_name}}",
                "campaign_id": "{{campaign_id}}",
                "landing_page_url": "{{landing_page_url}}",
                "viewability_postbid_partner": "UNSET",
                "advertiser_id": "{{advertiser_id}}",
                "product_specific_type": "ALL",
                "operation_status": "ENABLE",
                "catalog_id": "{{catalog_id}}",
                "dynamic_format": "UNSET",
                "page_id": null,
                "shopping_ads_deeplink_type": "NONE",
                "image_ids": [],
                "ad_name": "{{ad_name}}",
                "display_name": "{{display_name}}",
                "shopping_ads_video_package_id": "",
                "create_time": "{{create_time}}",
                "brand_safety_vast_url": null,
                "shopping_ads_fallback_type": "CUSTOM",
                "campaign_name": "{{campaign_name}}",
                "is_new_structure": true,
                "profile_image_url": "{{profile_image_url}}",
                "video_id": null,
                "ad_format": "SINGLE_VIDEO",
                "dynamic_destination": "UNSET",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "modify_time": "{{modify_time}}",
                "is_aco": false,
                "identity_id": "{{identity_id"}}",
                "card_id": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "deeplink": "",
                "vast_moat_enabled": false,
                "click_tracking_url": null,
                "call_to_action_id": null,
                "creative_type": null
            }
        ]
    }
}
(/code)
目标页面为即时体验商品页面且不指定视频模版

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_VIDEOS",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "instant_product_page_used":true,
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "catalog_id": "{{catalog_id}}",
                "image_ids": [],
                "ad_id": "{{ad_id}}",
                "creative_type": "SHOPPING_CATALOG_PAGE",
                "campaign_name": "{{campaign_name}}",
                "video_id": null,
                "advertiser_id": "{{advertiser_id}}",
                "page_id": {{page_id}},
                "playable_url": "",
                "shopping_ads_fallback_type": "CUSTOM",
                "call_to_action": "LEARN_MORE",
                "modify_time": "{{modify_time}}",
                "is_new_structure": true,
                "operation_status": "ENABLE",
                "viewability_postbid_partner": "UNSET",
                "click_tracking_url": null,
                "app_name": "",
                "brand_safety_vast_url": null,
                "identity_id": "{{identity_id}}",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "shopping_ads_video_package_id": "",
                "tracking_pixel_id": {{tracking_pixel_id}},
                "vast_moat_enabled": false,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "ad_text": "{{ad_text}}",
                "landing_page_urls": null,
                "dynamic_destination": "UNSET",
                "card_id": null,
                "shopping_ads_deeplink_type": "NONE",
                "deeplink": "",
                "dynamic_format": "UNSET",
                "adgroup_name": "{{adgroup_name}}",
                "viewability_vast_url": null,
                "display_name": "{{display_name}}",
                "call_to_action_id": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "product_specific_type": "ALL",
                "music_id": null,
                "adgroup_id": "{{adgroup_id}}",
                "profile_image_url": "{{profile_image_url}}",
                "ad_name": "{{ad_name}}",
                "creative_authorized": false,
                "identity_type": "CUSTOMIZED_USER",
                "create_time": "{{create_time}}",
                "ad_texts": null,
                "impression_tracking_url": null,
                "optimization_event": "ADD_BILLING",
                "campaign_id": "{{campaign_id}}",
                "ad_format": "SINGLE_VIDEO",
                "is_aco": false,
                "vertical_video_strategy": "CATALOG_VIDEOS",
                "landing_page_url": "{{landing_page_url}}"
            }
        ]
    }
}
(/code)

广告样式为商品库轮播

若想使用商品库轮播(目录轮播)这一广告样式,需确保广告组层级 placement_type 设置为 PLACEMENT_TYPE_AUTOMATIC,或 placement_type 设置为 PLACEMENT_TYPE_NORMAL,且placements 的值中包含PLACEMENT_TIKTOK。

设置 要求 参数 如何设置该参数
智能创意 未启用

不支持将is_smart_creative 传入 /ad/aco/create/ 创建开启智能创意的视频购物广告。
/ /
认证身份
(广告发布身份)
自定义用户(自定义身份) identity_type CUSTOMIZED_USER
identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
identity_authorized_bc_id 不传入
创意详情 - 动态样式 未启用 dynamic_format UNSET 或不传入
广告样式 商品库轮播:创建包含 2–20 件商品的广告,以幻灯片样式展示。 系统会进行安排,每次最多展示 20 件商品。 ad_format CATALOG_CAROUSEL
vertical_video_strategy 不传入
商品 以下任意选项:
  • 所有商品
  • 商品系列
  • 特定商品,最多选择20个商品
  • catalog_id
  • product_specific_type
  • item_group_ids
  • product_set_id
  • sku_ids
  • carousel_image_index
  • 将catalog_id设置为广告组层级指定的商品库 ID。
  • 轮播图片选择范围:投放中的轮播广告将从商品库(catalog_id)中商品的对应图片中动态选取轮播图片。您可以通过product_specific_type参数指定商品图片的选取范围:
    • 若想设置从商品库的所有商品中动态选取轮播图片,可将product_specific_type设置为ALL,同时不传入item_group_ids,product_set_id和sku_ids。所指定的商品库(catalog_id)需包含至少两个商品。
    • 若想设置从商品系列的商品中动态选取轮播图片,可将product_specific_type设置为PRODUCT_SET,同时传入item_group_ids 或 product_set_id。所指定的item_group_ids或product_set_id 需包含至少两个商品。
    • 若想设置从自定义的商品范围(最多20个商品)中动态选取轮播图片,可将product_specific_type设置为 CUSTOMIZED_PRODUCTS,同时传入sku_ids。所指定的sku_ids 需包含至少两个商品。

      注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的ad_creation_eligible为AVAILABLE,则该商品可用于广告中。

  • 轮播图片类型:
    • 使用商品主图:轮播图片默认使用动态选取的商品库商品的主图 URL。
    • 使用商品附图:您可以通过参数carousel_image_index指定附加图片列表(additional_image_urls)中的图片位置,从而使用每个动态选取的商品库商品的对应附加图片作为轮播图片。
创意素材 - 图片 轮播广告中支持的图片,至少 2 张
image_ids 不传入
创意素材 - 视频 未启用
  • video_id
  • tiktok_item_id
  • dark_post_status
  • shopping_ads_video_package_id
不传入
创意素材 - 音乐 轮播广告中支持的 1 首音乐 music_id 传入一个视频购物类型的轮播广告中支持的音乐 ID。
若想获取有效的音乐ID,您可以使用以下任意方法:
  • 通过在 /file/music/get/ 中将 music_scene 设置为 CATALOG_CAROUSEL,筛选广告账号下可用于视频购物类型的轮播广告的音乐。
  • 将可用于视频购物类型的轮播广告的自定义音乐上传至广告账号中,可使用以下任意方法:
    • 在 /file/music/upload/ 中将 music_scene 设置为 CATALOG_CAROUSEL,并同时传入music_file 和 music_signature。
    • 在/file/music/upload/中将music_scene 设置为 CATALOG_CAROUSEL,将upload_type 设置为 UPLOAD_BY_FILE_ID,并同时传入 file_id。
广告文案 设置对应文案 ad_text 传入合法值
创新互动样式 未启用 card_id 不传入
目标页面
  • 若优化位置为落地页,则目标页面仅支持落地页。
  • 若优化位置为应用,则目标页面仅支持应用。

不支持使用即时体验商品页面和动态目标页面。
dynamic_destination UNSET 或不传入
  • instant_product_page_used
  • page_image_index
不传入
  • landing_page_url
  • utm_params
  • deeplink
  • deeplink_type
  • shopping_ads_deeplink_type
  • deeplink_utm_params
  • shopping_ads_fallback_type
  • fallback_type
根据您的业务需要配置相关参数。
  • 需注意,根据所选的优化目标,可用的深度链接设置可能不同。若想了解深度链接的详情,请查看深度链接。
  • 若想了解优化目标点击支持的目标页面和深度链接设置,请查看在推广网站的视频购物广告中指定目标页面和深度链接设置。

  • 注意:此时不允许使用商品库深度链接和商品库链接,因此,shopping_ads_deeplink_type 和 shopping_ads_fallback_type 不允许设置为 SHOPPING_ADS。

  • page_id
  • tiktok_page_category
  • phone_region_code
  • phone_region_calling_code
  • phone_number
不传入
行动引导文案 设置对应文案 call_to_action 传入合法值。
若想了解枚举值,请查看 枚举值 - 行动引导文案。
免责声明 未启用
  • disclaimer_type
  • disclaimer_text
  • disclaimer_clickable_texts
不传入
试玩素材 未启用 playable_url 不传入

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id":"{{catalog_id}}",
            "product_specific_type":"ALL",
            "dynamic_format":"UNSET",
            "ad_format": "CATALOG_CAROUSEL",
            "music_id":"{{music_id}}",
            "ad_text": "{{ad_text}}",
            "dynamic_destination":"UNSET",
            "shopping_ads_fallback_type":"CUSTOM",
            "landing_page_url":"{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "vast_moat_enabled": false,
                "ad_name": "{{ad_name}}",
                "call_to_action": "LEARN_MORE",
                "call_to_action_id": null,
                "is_new_structure": true,
                "adgroup_id": "{{adgroup_id}}",
                "ad_id": "{{ad_id}}",
                "is_aco": false,
                "card_id": null,
                "vertical_video_strategy": null,
                "app_name": "",
                "ad_text": "{{ad_text}}",
                "identity_type": "CUSTOMIZED_USER",
                "landing_page_urls": null,
                "campaign_name": "{{campaign_name}}",
                "product_specific_type": "ALL",
                "music_id": "{{music_id}}",
                "shopping_ads_video_package_id": "",
                "viewability_postbid_partner": "UNSET",
                "ad_format": "CATALOG_CAROUSEL",
                "ad_texts": null,
                "video_id": null,
                "campaign_id": "{{campaign_id}}",
                "shopping_ads_fallback_type": "CUSTOM",
                "adgroup_name": "{{adgroup_name}}",
                "deeplink": "",
                "create_time": "{{create_time}}",
                "tracking_pixel_id": {{tracking_pixel_i}},
                "catalog_id": "{{catalog_id}}",
                "identity_id": "{{identity_id}}",
                "brand_safety_vast_url": null,
                "dynamic_destination": "UNSET",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "profile_image_url": "{{profile_image_url}}",
                "deeplink_type": "NORMAL",
                "modify_time": "{{modify_time}}",
                "creative_type": null,
                "page_id": null,
                "display_name": "{{display_name}}",
                "impression_tracking_url": null,
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "playable_url": "",
                "click_tracking_url": null,
                "advertiser_id": "{{advertiser_id}}",
                "landing_page_url": "{{landing_page_url}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "image_ids": [],
                "creative_authorized": false,
                "dynamic_format": "UNSET",
                "shopping_ads_deeplink_type": "NONE",
                "viewability_vast_url": null,
                "optimization_event": "ADD_BILLING",
                "operation_status": "ENABLE"
            }
        ]
    }
}
(/code)

5. 预览广告

您可以使用/creative/ads_preview/create/接口预览广告。
我们支持的预览类型包括:AD 和 ADS_CREATION,使您可以预览已有广告或计划创建的广告。

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →