创建商品库广告
本文介绍了创建商品库广告(旧称商品来源为商品库的视频购物广告)的步骤。
注意
商品库广告目前对于商业类的移动应用广告主为白名单功能。若您为商业类的移动应用广告主且需使用此功能,请联系您的 TikTok 销售代表。若您是商业类的网络广告主,您已自动拥有该功能的权限。
步骤
1. 创建推广系列
使用/campaign/create/接口创建一个推广系列。需确保满足以下要求:
| 设置 | 要求 | 参数 | 如何设置该参数 |
|---|---|---|---|
| 推广目标 | 商品销量 | objective_type |
PRODUCT_SALES |
| Smart+ 推广系列 | 未启用 不支持使用/campaign/spc/create/创建启用 Smart+ 推广系列设置的视频购物推广系列。 |
/ | / |
| iOS 14 专属推广系列 | 未启用或启用 | campaign_type |
以下任意值:
|
app_id |
|
||
campaign_app_profile_page_state |
不传入 | ||
| 商品来源 (商品数据源) |
商品库 | campaign_product_source |
CATALOG |
| 特殊广告分类(可选) | 需申请白名单才可启用 | special_industries |
传入合法值,或不传入 注意:在推广系列商品来源为商品库的购物广告中使用特殊广告分类目前为白名单功能。如需使用这些功能,请联系您的 TikTok 销售代表。 |
| 推广系列预算优化 | 需申请白名单才可启用 | budget_optimize_on |
以下任意值:
注意:在商品来源为商品库的视频购物广告中使用推广系列预算优化目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
| 推广系列预算类型 | 以下任意类型:
|
budget_mode |
以下任意值:
|
示例
请求
(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 商务中心创建、管理商品库。 * 商品库接口: 所有商品库接口,请查看这里。
- 使用/catalog/create/接口创建一个电商商品库。
- 使用/catalog/product/upload/(JSON 结构)、/catalog/product/file/ (CSV 模版)或 /catalog/feed/create/(在线数据更新源)上传商品至商品库。
- 使用/catalog/product/log/ 接口检查商品操作结果。
传入从步骤 ii. 获取的feed_log_id。若返回的warn_affected_products的值非空,则需查看问题详情,并返回步骤 ii. 重新上传商品。 - (可选步骤)使用 /catalog/set/create/ 接口创建电商商品系列。
若您想在广告层级从商品系列中选择商品,需创建商品系列。否则,可跳过此步骤。 - (可选步骤)使用/bc/member/invite/接口邀请成员加入商务中心,并授予管理员权限。
您可以同时为受邀成员指定advertiser_role。 - (可选步骤)使用/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 |
| 认证身份 (广告发布身份) |
未启用 |
|
不传入 |
| 商品来源 (商品数据源) |
商品库 | product_source |
CATALOG |
|
传入合法值。 若想了解如何获取商品库 ID,需遵循创建和管理商品库中的步骤。 |
||
|
不传入 | ||
| 推广对象 (优化位置) |
落地页或应用 | promotion_type |
以下任意值:
|
| 推广的网站 |
|
|
|
| 推广的应用 |
|
app_id |
|
operating_systems |
|
||
| 版位 (广告位) |
以下任意选项:
|
|
以下任意设置:
|
| 包含搜索结果 | 未启用 | search_result_enabled |
false 或不传入 |
| 视频共享 | 启用 | share_disabled |
false 或不传入 |
| Pangle 媒体屏蔽列表 | 未启用 | blocked_pangle_app_ids |
不传入 |
受众定向
|
未启用 | saved_audience_id |
不传入 |
受众定向
|
未启用 | auto_targeting_enabled |
不传入 |
受众定向
|
以下任意选项:
注意:若推广系列层级启用了iOS 14 专属推广系列,则不支持选择对受众再营销。 |
|
传入合法值。
注意:若您在推广系列层级将 |
受众定向
|
未启用 | spending_power |
不传入 |
受众定向
|
未启用 | smart_audience_enabled |
不传入 |
受众定向
|
未启用 | smart_interest_behavior_enabled |
不传入 |
受众定向
|
未启用 |
|
不传入 |
受众定向
|
未启用 | 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时,使用以下任意值:
注意:优化目标目标页面访问( |
优化位置为落地页时使用以下任意类型:
|
promotion_type设置为WEBSITE时,使用以下任意值:
注意:在购物广告中使用优化目标落地页浏览量目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
||
| 频次上限 | 未启用 |
|
不传入 |
| 竞价策略 |
|
|
|
| 归因设置 | 在具体场景中选择对应支持的归因设置 |
|
若想了解不同场景下支持的归因设置,请查看归因窗口期和事件统计方式 - 商品销量。 |
| 计费事件 (计费点) |
|
billing_event |
|
| 投放速度 |
|
pacing |
|
| 程序化创意 | 未启用 | 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 |
不传入 | ||
| 商品 | 以下任意选项:
|
|
注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的 |
| 创意详情 - 动态样式 | 启用:向每位用户展示不同的视频和目标页面。 TikTok 会针对每位用户自动生成和组合各种特定广告样式,包括互动样式和落地页等。 为了优化用户体验和广告转化效果,建议启用此样式。 若要使用此样式,您必须同时提供常规视频和商品库视频。 注意:若您在广告组层级启用了对受众再营销,则不支持使用动态样式。 |
dynamic_format |
DYNAMIC_CREATIVE注意:若广告组层级的 |
ad_format |
SINGLE_VIDEO |
||
vertical_video_strategy |
UNSET 或不传入 |
||
| 创意素材 | 同时指定以下内容:
|
|
通过 video_id 指定常规视频,同时通过 image_ids指定视频封面。 |
shopping_ads_video_package_id |
传入合法值或不传入。
若想获取与商品库绑定的视频模版(视频包),可使用/catalog/video_package/get/。 若想了解如何在 TikTok 广告管理平台中创建视频模版,请查看如何在商品库中创建视频包。 |
||
|
不传入 | ||
music_id |
不传入 | ||
| 广告文案 | 设置对应文案 | ad_text |
传入合法值 |
| 创新互动样式 | 未启用 | card_id |
不传入 |
| 目标页面 |
无论优化对象为落地页还是应用,均不支持使用即时体验商品页面。 |
|
不传入 |
|
根据您的业务需要配置相关参数。
|
||
dynamic_destination |
|
||
|
不传入 | ||
| 行动引导文案 | 设置对应文案 | call_to_action |
传入合法值。 若想了解枚举值,请查看 枚举值 - 行动引导文案 |
| 免责声明 | 未启用 |
|
不传入 |
| 试玩素材 | 未启用 | 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/ 创建开启智能创意的视频购物广告。 |
/ | / |
| 认证身份 (广告发布身份) |
以下任意选项:
|
identity_type |
以下任意值:
|
identity_id |
传入合法值 若想获取广告账号下的认证身份,可使用/identity/get/。 |
||
identity_authorized_bc_id |
若 identity_type 设置为 BC_AUTH_TT,需传入合法值。 |
||
| 商品 | 以下任意选项:
|
|
注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的 |
| 创意详情 - 动态样式 | 未启用 | dynamic_format |
UNSET 或不传入 |
| 广告样式 | 单视频:利用视频创意推广您的商品。 | ad_format |
SINGLE_VIDEO |
vertical_video_strategy |
SINGLE_VIDEO |
||
| 创意素材 |
|
|
|
shopping_ads_video_package_id |
不传入 | ||
music_id |
不传入 | ||
| 创新互动样式(可选) | 未启用,或使用以下任意类型:
|
card_id |
不传入或指定任意类型的创意素材包的 ID:
若想创建创意素材包,可使用 /creative/portfolio/create/。 注意:使用商品磁贴素材包创建广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
| 目标页面 |
动态目标页面不支持在以下场景中使用:
|
|
注意:在以下场景中不允许将
|
|
根据您的业务需要配置相关参数。
注意:此时不允许使用商品库深度链接和商品库链接,因此, |
||
|
不传入 | ||
| 行动引导文案 | 设置对应文案 | call_to_action |
传入合法值。 若想了解枚举值,请查看 枚举值 - 行动引导文案。 |
| 免责声明 | 未启用 |
|
不传入 |
| 试玩素材 | 未启用 | 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 |
不传入 | ||
| 商品 | 以下任意选项:
|
|
注意:若想确认电商商品库商品能否用于广告中,可使用/catalog/product/get/。若该商品返回的 |
| 创意详情 - 动态样式 | 未启用 | dynamic_format |
UNSET 或不传入 |
| 广告样式 | 商品库视频 :基于商品目录中的信息生成动态视频。 注意:若您想要使用已上传的商品库视频创建商品库视频广告,需确保已在广告组层级将优化位置设置为落地页。 |
ad_format |
SINGLE_VIDEO |
vertical_video_strategy |
以下任意值:
注意:
|
||
| 创意素材 | 商品库视频。 您需确保商品库至少存在一个已上传的商品库视频,绑定了一个视频模版,或每个商品都设置了对应的视频 URL。
|
shopping_ads_video_package_id |
传入合法值或不传入。
若想获取与商品库绑定的视频模版(视频包),可使用/catalog/video_package/get/。 若想了解如何在 TikTok 广告管理平台中创建视频模版,请查看创建视频包。 |
|
不传入 |
||
| 广告文案 | 设置对应文案 | ad_text |
传入合法值 |
| 创新互动样式(可选) | 未启用,或使用以下任意类型:
注意:仅当使用上传的商品库视频时支持使用商品磁贴素材包。 |
card_id |
不传入或指定任意类型的创意素材包的 ID:
若想创建创意素材包,可使用 /creative/portfolio/create/。 注意: 使用商品磁贴素材包创建广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
| 目标页面 |
动态目标页面不支持在以下场景中使用:
|
|
注意:在以下场景中不允许将
|
|
根据您的业务需要配置相关参数。
|
|
不传入 | ||
| 行动引导文案 | 设置对应文案 | call_to_action |
传入合法值。 若想了解枚举值,请查看 枚举值 - 行动引导文案。 |
| 免责声明 | 未启用 |
|
不传入 |
| 试玩素材 | 未启用 | 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 |
不传入 | ||
| 商品 | 以下任意选项:
|
|
|
| 创意素材 - 图片 | 轮播广告中支持的图片,至少 2 张 | ||
image_ids |
不传入 | ||
| 创意素材 - 视频 | 未启用 |
|
不传入 |
| 创意素材 - 音乐 | 轮播广告中支持的 1 首音乐 | music_id |
传入一个视频购物类型的轮播广告中支持的音乐 ID。 若想获取有效的音乐ID,您可以使用以下任意方法:
|
| 广告文案 | 设置对应文案 | ad_text |
传入合法值 |
| 创新互动样式 | 未启用 | card_id |
不传入 |
| 目标页面 |
不支持使用即时体验商品页面和动态目标页面。 |
dynamic_destination |
UNSET 或不传入 |
|
不传入 | ||
|
根据您的业务需要配置相关参数。
注意:此时不允许使用商品库深度链接和商品库链接,因此, |
||
|
不传入 | ||
| 行动引导文案 | 设置对应文案 | call_to_action |
传入合法值。 若想了解枚举值,请查看 枚举值 - 行动引导文案。 |
| 免责声明 | 未启用 |
|
不传入 |
| 试玩素材 | 未启用 | 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,使您可以预览已有广告或计划创建的广告。