创建启用网站和应用优化的手动商品库广告

本文介绍创建启用网站和应用优化的手动商品库广告的步骤。

步骤

1. 创建推广系列

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

示例

请求

(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}}",
    "virtual_objective_type": "SALES",
    "objective_type": "PRODUCT_SALES",
    "sales_destination": "WEB_AND_APP",
    "catalog_enabled": true,
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "rta_product_selection_enabled": false,
        "roas_bid": 0,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "rta_bid_enabled": false,
        "campaign_automation_type": "MANUAL",
        "campaign_app_profile_page_state": "UNSET",
        "is_smart_performance_campaign": false,
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "objective_type": "PRODUCT_SALES",
        "virtual_objective_type": "SALES",
        "sales_destination": "WEB_AND_APP",
        "rta_id": null,
        "is_new_structure": true,
        "operation_status": "ENABLE",
        "is_advanced_dedicated_campaign": false,
        "campaign_id": "{{campaign_id}}",
        "budget": {{budget}},
        "disable_skan_campaign": null,
        "deep_bid_type": null,
        "campaign_name": "{{campaign_name}}",
        "campaign_product_source": "CATALOG",
        "create_time": "{{create_time}}",
        "advertiser_id": "{{advertiser_id}}",
        "is_search_campaign": false,
        "catalog_enabled": true,
        "objective": "LANDING_PAGE",
        "modify_time": "{{modify_time}}",
        "campaign_type": "REGULAR_CAMPAIGN"
    }
}
(/code)

2. 创建广告组

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

手动商品库广告的 optimization_event 值列表

下表列出了启用网站和应用优化的手动商品库广告的可用事件。

| 事件名称{20%} | <code>optimization_event</code> 值{25%} | 对应的 Pixel 事件<br>(<code>optimization_event</code>){20%} | 对应的应用事件<br>（<code>optimization_event</code> 或 <code>secondary_optimization_event</code>）{35%} |
|---|---|---|---|
| 添加支付信息 | `ADD_BILLING` | `ADD_BILLING` | `ADD_PAYMENT_INFO` |
| 加入购物车 | `ON_WEB_CART` | `ON_WEB_CART` | `IN_APP_CART` |
| 加入心愿单 | `ON_WEB_ADD_TO_WISHLIST` | `ON_WEB_ADD_TO_WISHLIST` | `ADD_TO_WISHLIST` |
| 开始结账/结账 | `INITIATE_ORDER` | `INITIATE_ORDER` | `IN_APP_ORDER` |
| 付费 | `SHOPPING` | `SHOPPING` | `ACTIVE_PAY` |
| 搜索 | `ON_WEB_SEARCH` | `ON_WEB_SEARCH` | `SEARCH` |
| 订阅 | `ON_WEB_SUBSCRIBE` | `ON_WEB_SUBSCRIBE` | `SUBSCRIBE` |
| 查看内容 | `ON_WEB_DETAIL` | `ON_WEB_DETAIL` | `IN_APP_DETAIL_UV` |

示例

寻找潜在顾客

请求

(code curl http)
url --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}}",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "pixel_id": "{{pixel_id}}",
    "promotion_type": "WEBSITE",
    "app_config": [
        {
            "app_id": "{{app_id}}"
        },
        {
            "app_id": "{{app_id}}"
        }
    ],
    "optimization_event": "ADD_BILLING",
    "placement_type": "PLACEMENT_TYPE_AUTOMATIC",
    "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",
    "location_ids": [
        "6252001"
    ],
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM"
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "age_groups": null,
        "vbo_window": null,
        "keywords": null,
        "statistic_type": null,
        "skip_learning_phase": true,
        "interest_keyword_ids": [],
        "excluded_audience_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "pacing": "PACING_MODE_FAST",
        "ios14_quota_type": "UNOCCUPIED",
        "deep_funnel_event_source_id": null,
        "campaign_name": "{{campaign_name}}",
        "languages": [],
        "budget": {{budget}},
        "adgroup_name": "{{adgroup_name}}",
        "adgroup_app_profile_page_state": null,
        "next_day_retention": null,
        "isp_ids": [],
        "network_types": [],
        "actions": [],
        "modify_time": "{{modify_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "billing_event": "OCPM",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "rf_estimated_cpr": null,
        "deep_funnel_optimization_status": null,
        "purchased_reach": null,
        "rf_estimated_frequency": null,
        "click_attribution_window": "SEVEN_DAYS",
        "shopping_ads_retargeting_type": "OFF",
        "audience_ids": [],
        "adgroup_id": "{{adgroup_id}}",
        "app_config": [
            {
                "app_id": "{{app_id}}"
            },
            {
                "app_id": "{{app_id}}"
            }
        ],
        "conversion_window": null,
        "gender": "GENDER_UNLIMITED",
        "deep_funnel_optimization_event": null,
        "purchased_impression": null,
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "category_exclusion_ids": [],
        "schedule_end_time": "{{schedule_end_time}}",
        "deep_cpa_bid": 0,
        "is_hfss": false,
        "location_ids": [
            "6252001"
        ],
        "promotion_type": "WEBSITE",
        "search_result_enabled": false,
        "device_price_ranges": null,
        "operation_status": "ENABLE",
        "inventory_filter_enabled": false,
        "operating_systems": [],
        "view_attribution_window": "ONE_DAY",
        "create_time": "{{create_time}}",
        "optimization_event": "ADD_BILLING",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "auto_targeting_enabled": false,
        "catalog_id": "{{catalog_id}}",
        "smart_interest_behavior_enabled": null,
        "bid_display_mode": "CPMV",
        "delivery_mode": null,
        "product_source": "CATALOG",
        "attribution_event_count": "EVERY",
        "conversion_bid_price": 11,
        "smart_audience_enabled": null,
        "pixel_id": "{{pixel_id}}",
        "creative_material_mode": "CATALOG_SALES",
        "app_download_url": null,
        "category_id": "0",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "app_id": null,
        "brand_safety_partner": null,
        "share_disabled": false,
        "campaign_automation_type": "MANUAL",
        "interest_category_ids": [],
        "app_type": null,
        "video_download_disabled": false,
        "schedule_start_time": "{{schedule_start_time}}",
        "feed_type": null,
        "scheduled_budget": 0,
        "schedule_infos": null,
        "frequency": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "is_smart_performance_campaign": false,
        "shopping_ads_type": "VIDEO",
        "is_new_structure": true,
        "campaign_id": "{{campaign_id}}",
        "bid_price": 0,
        "secondary_optimization_event": null,
        "deep_bid_type": null,
        "rf_purchased_type": null,
        "frequency_schedule": null,
        "placement_type": "PLACEMENT_TYPE_AUTOMATIC",
        "optimization_goal": "CONVERT",
        "comment_disabled": false,
        "bid_type": "BID_TYPE_CUSTOM",
        "advertiser_id": "{{advertiser_id}}",
        "deep_funnel_event_source": null,
        "automated_keywords_enabled": null,
        "engaged_view_attribution_window": "ONE_DAY"
    }
}
(/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}}",
    "product_source": "CATALOG",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "pixel_id": "{{pixel_id}}",
    "promotion_type": "WEBSITE",
    "app_config": [
        {
            "app_id": "{{app_id}}"
        },
        {
            "app_id": "{{app_id}}"
        }
    ],
    "optimization_event": "ADD_BILLING",
    "placement_type": "PLACEMENT_TYPE_AUTOMATIC",
    "shopping_ads_retargeting_type": "LAB1",
    "shopping_ads_retargeting_actions_days": 30,
    "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",
    "location_ids": [
        "1861060"
    ],
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM"
}'
(/code)

返回

(code curl http)
 {
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "age_groups": null,
        "vbo_window": null,
        "keywords": null,
        "statistic_type": null,
        "skip_learning_phase": true,
        "interest_keyword_ids": [],
        "excluded_audience_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "pacing": "PACING_MODE_FAST",
        "ios14_quota_type": "UNOCCUPIED",
        "deep_funnel_event_source_id": null,
        "campaign_name": "{{campaign_name}}",
        "languages": [],
        "budget": {{budget}},
        "adgroup_name": "{{adgroup_name}}",
        "adgroup_app_profile_page_state": null,
        "next_day_retention": null,
        "isp_ids": [],
        "network_types": [],
        "actions": [],
        "modify_time": "{{modify_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "billing_event": "OCPM",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "rf_estimated_cpr": null,
        "deep_funnel_optimization_status": null,
        "purchased_reach": null,
        "rf_estimated_frequency": null,
        "click_attribution_window": "SEVEN_DAYS",
        "shopping_ads_retargeting_type": "LAB1",
        "audience_ids": [],
        "adgroup_id": "{{adgroup_id}}",
        "app_config": [
            {
                "app_id": "{{app_id}}"
            },
            {
                "app_id": "{{app_id}}"
            }
        ],
        "conversion_window": null,
        "gender": "GENDER_UNLIMITED",
        "deep_funnel_optimization_event": null,
        "purchased_impression": null,
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "category_exclusion_ids": [],
        "schedule_end_time": "{{schedule_end_time}}",
        "deep_cpa_bid": 0,
        "is_hfss": false,
        "location_ids": [
            "1861060"
        ],
        "promotion_type": "WEBSITE",
        "search_result_enabled": false,
        "device_price_ranges": null,
        "operation_status": "ENABLE",
        "inventory_filter_enabled": false,
        "operating_systems": [],
        "view_attribution_window": "ONE_DAY",
        "create_time": "{{create_time}}",
        "optimization_event": "ADD_BILLING",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "auto_targeting_enabled": false,
        "catalog_id": "{{catalog_id}}",
        "smart_interest_behavior_enabled": null,
        "bid_display_mode": "CPMV",
        "delivery_mode": null,
        "product_source": "CATALOG",
        "attribution_event_count": "EVERY",
        "conversion_bid_price": 11,
        "smart_audience_enabled": null,
        "pixel_id": "{{pixel_id}}",
        "creative_material_mode": "CUSTOM",
        "app_download_url": null,
        "category_id": "0",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "app_id": null,
        "brand_safety_partner": null,
        "share_disabled": false,
        "campaign_automation_type": "MANUAL",
        "interest_category_ids": [],
        "app_type": null,
        "video_download_disabled": true,
        "schedule_start_time": "{{schedule_start_time}}",
        "feed_type": null,
        "scheduled_budget": 0,
        "schedule_infos": null,
        "frequency": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "is_smart_performance_campaign": false,
        "shopping_ads_type": "VIDEO",
        "is_new_structure": true,
        "campaign_id": "{{campaign_id}}",
        "bid_price": 0,
        "secondary_optimization_event": null,
        "deep_bid_type": null,
        "rf_purchased_type": null,
        "frequency_schedule": null,
        "placement_type": "PLACEMENT_TYPE_AUTOMATIC",
        "optimization_goal": "CONVERT",
        "comment_disabled": false,
        "bid_type": "BID_TYPE_CUSTOM",
        "advertiser_id": "{{advertiser_id}}",
        "deep_funnel_event_source": null,
        "automated_keywords_enabled": null,
        "engaged_view_attribution_window": "ONE_DAY"
    }
}
(/code)

3. 创建广告

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

采用单视频广告样式

示例

Spark Ads 提取

请求

(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": "TT_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id": "{{catalog_id}}",
            "product_specific_type": "ALL",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "SINGLE_VIDEO",
            "tiktok_item_id": "{{tiktok_item_id}}",
            "card_id": "{{card_id}}",
            "shopping_ads_deeplink_type": "CUSTOM",
            "deeplink_type": "NORMAL",
            "deeplink": "{{deeplink}}",
            "shopping_ads_fallback_type": "CUSTOM",
            "landing_page_url": "{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

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

Spark Ads 推送

请求

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

返回

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

采用商品库视频广告样式

示例

使用视频模板

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{AccessToken}}' \
--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",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_VIDEOS",
            "ad_text": "{{ad_text}}",
            "card_id": "{{card_id}}",
            "shopping_ads_deeplink_type": "CUSTOM",
            "deeplink_type": "NORMAL",
            "deeplink": "{{deeplink}}",
            "shopping_ads_fallback_type": "CUSTOM",
            "landing_page_url": "{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

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

使用已上传的商品库视频

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{AccessToken}}' \
--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",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "CATALOG_UPLOADED_VIDEOS",
            "ad_text": "{{ad_text}}",
            "card_id": "{{card_id}}",
            "shopping_ads_deeplink_type": "CUSTOM",
            "deeplink_type": "NORMAL",
            "deeplink": "{{deeplink}}",
            "shopping_ads_fallback_type": "CUSTOM",
            "landing_page_url": "{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

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

采用商品库轮播广告样式

示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{AccessToken}}' \
--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",
            "ad_format": "CATALOG_CAROUSEL",
            "music_id": "{{music_id}}",
            "ad_text": "{{ad_text}}",
            "shopping_ads_deeplink_type": "CUSTOM",
            "deeplink_type": "NORMAL",
            "deeplink": "{{deeplink}}",
            "shopping_ads_fallback_type": "CUSTOM",
            "landing_page_url": "{{landing_page_url}}",
            "call_to_action": "LEARN_MORE"
        }
    ]
}'
(/code)

返回

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