创建优化位置为即时通讯应用的线索广告

本文介绍了如何创建优化位置为即时通讯应用的线索广告。受众将能够通过点击行动引导文案按钮，根据应用安装状态采取以下两种行动之一： - 若受众已安装对应的即时通讯应用（例如 WhatsApp），将能够在应用内向您（广告主）发送消息。 - 若受众未安装对应的即时通讯应用，将能够浏览您设置的 TikTok 即时体验页面。

注意

• 创建优化位置为即时通讯应用的线索广告对注册地为以下亚太地区的广告主已全量开放：澳大利亚，孟加拉国，柬埔寨，印度尼西亚，日本，马来西亚，新西兰，巴基斯坦，菲律宾，新加坡，韩国，斯里兰卡，中国台湾地区，泰国和越南。
• 对于注册地为其他地域的广告主，此功能目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。

前提条件

• 建议在设置推广系列之前，关联我们集成的消息管理工具（MMT），以深化优化目标、提高广告投放效果。
• 若您已经与 MMT 集成并针对“对话数”进行优化，请确保在 MMT 上设置 TikTok 集成，然后再选择“对话数”和消息事件。
• 若您使用的是 WhatsApp，则需为 WhatsApp Business API 使用唯一的电话号码，该电话号码不能用于任何其他 WhatsApp 个人账号或企业号。你可以直接在 MMT 上注册 WhatsApp Business API。
• Pancake 等一些 MMT 可能会要求您添加电子钱包，然后您才能回复客户消息。MMT 会向您收取使用 WhatsApp Business API 的费用，然后缴付给 Meta。

步骤

1. 创建推广系列

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

| 设置 {20%}| 要求{30%} | 参数{20%} | 如何设置该参数{30%} |
|---|---|---|---|
| 推广目标 | 线索收集| `objective_type` | `LEAD_GENERATION` |
| Smart+ 推广系列 | 未启用 <br><br>若您想查看推广系列是否启用了 Smart+ 推广系列设置，可使用[/campaign/get/](https://ads.tiktok.com/marketing_api/docs?id=1739315828649986)返回的`is_smart_performance_campaign`字段进行确认。| / | / |

示例

请求

(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": "LEAD_GENERATION",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

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

2. 创建广告组

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

示例

即时通讯应用为 Messenger 且优化目标为会话数

请求

(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}}",
    "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
    "messaging_app_type":"MESSENGER",
    "messaging_app_account_id": "{{messaging_app_account_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["1880251"],
    "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": "CONVERSATION",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "message_event_set_id": "{{message_event_set_id}}",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "location_ids": [
            "1880251"
        ],
        "auto_targeting_enabled": false,
        "ios14_quota_type": "UNOCCUPIED",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "is_hfss": false,
        "advertiser_id": "{{advertiser_id}}",
        "languages": [],
        "optimization_goal": "CONVERSATION",
        "rf_purchased_type": null,
        "campaign_id": "{{campaign_id}}",
        "statistic_type": null,
        "modify_time": "{{modify_time}}",
        "pixel_id": null,
        "vbo_window": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "bid_type": "BID_TYPE_NO_BID",
        "rf_estimated_cpr": null,
        "frequency_schedule": null,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "network_types": [],
        "smart_audience_enabled": null,
        "interest_category_ids": [],
        "schedule_end_time": "{{schedule_end_time}}",
        "category_id": "0",
        "bid_price": 0,
        "conversion_bid_price": 0,
        "share_disabled": false,
        "brand_safety_partner": null,
        "actions": [],
        "keywords": null,
        "scheduled_budget": 0,
        "delivery_mode": null,
        "rf_estimated_frequency": null,
        "schedule_type": "SCHEDULE_START_END",
        "operating_systems": [],
        "view_attribution_window": "ONE_DAY",
        "attribution_event_count": "ONCE",
        "frequency": null,
        "creative_material_mode": "CUSTOM",
        "comment_disabled": false,
        "adgroup_id": "{{adgroup_id}}",
        "purchased_impression": null,
        "adgroup_app_profile_page_state": null,
        "interest_keyword_ids": [],
        "purchased_reach": null,
        "create_time": "{{create_time}}",
        "billing_event": "OCPM",
        "smart_interest_behavior_enabled": null,
        "feed_type": null,
        "is_smart_performance_campaign": false,
        "messaging_app_account_id": "{{messaging_app_account_id}}",
        "deep_cpa_bid": 0,
        "inventory_filter_enabled": false,
        "operation_status": "ENABLE",
        "skip_learning_phase": true,
        "pacing": "PACING_MODE_SMOOTH",
        "bid_display_mode": "CPMV",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_infos": null,
        "age_groups": [
            "AGE_18_24",
            "AGE_25_34",
            "AGE_35_44",
            "AGE_45_54",
            "AGE_55_100"
        ],
        "gender": "GENDER_UNLIMITED",
        "message_event_set_id": "{{message_event_set_id}}",
        "next_day_retention": null,
        "audience_ids": [],
        "excluded_audience_ids": [],
        "secondary_optimization_event": null,
        "app_id": null,
        "optimization_event": "MESSAGE",
        "campaign_name": "{{campaign_name}}",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "conversion_window": null,
        "app_download_url": null,
        "isp_ids": [],
        "device_price_ranges": null,
        "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
        "category_exclusion_ids": [],
        "click_attribution_window": "SEVEN_DAYS",
        "budget": {{budget}},
        "deep_bid_type": null,
        "video_download_disabled": false,
        "adgroup_name": "{{adgroup_name}}",
        "search_result_enabled": false,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "is_new_structure": true,
        "messaging_app_type": "MESSENGER",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "app_type": null
    }
}
(/code)

即时通讯应用为 WhatsApp 且优化目标为会话数

请求

(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}}",
    "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
    "messaging_app_type":"WHATSAPP",
    "phone_region_calling_code": "{{phone_region_calling_code}}",
    "phone_region_code": "{{phone_region_code}}",
    "phone_number": "{{phone_number}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["1880251"],
    "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": "CONVERSATION",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "frequency": null,
        "comment_disabled": false,
        "location_ids": [
            "1880251"
        ],
        "rf_estimated_cpr": null,
        "adgroup_id": "{{adgroup_id}}",
        "pacing": "PACING_MODE_SMOOTH",
        "phone_region_code": "{{phone_region_code}}",
        "message_event_set_id": "{{message_event_set_id}}",
        "gender": "GENDER_UNLIMITED",
        "is_hfss": false,
        "category_id": "0",
        "network_types": [],
        "phone_number": "{{phone_number}}",
        "app_id": null,
        "app_type": null,
        "languages": [],
        "purchased_reach": null,
        "secondary_optimization_event": null,
        "advertiser_id": "{{advertiser_id}}",
        "keywords": null,
        "messaging_app_account_id": "{{messaging_app_account_id}}",
        "delivery_mode": null,
        "purchased_impression": null,
        "adgroup_name": "{{adgroup_name}}",
        "auto_targeting_enabled": false,
        "category_exclusion_ids": [],
        "inventory_filter_enabled": false,
        "statistic_type": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "schedule_end_time": "{{schedule_end_time}}",
        "rf_estimated_frequency": null,
        "smart_audience_enabled": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_infos": null,
        "smart_interest_behavior_enabled": null,
        "creative_material_mode": "CUSTOM",
        "conversion_bid_price": 0,
        "rf_purchased_type": null,
        "optimization_event": "MESSAGE",
        "age_groups": [
            "AGE_18_24",
            "AGE_25_34",
            "AGE_35_44",
            "AGE_45_54",
            "AGE_55_100"
        ],
        "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
        "feed_type": null,
        "bid_display_mode": "CPMV",
        "adgroup_app_profile_page_state": null,
        "optimization_goal": "CONVERSATION",
        "click_attribution_window": "SEVEN_DAYS",
        "view_attribution_window": "ONE_DAY",
        "conversion_window": null,
        "is_smart_performance_campaign": false,
        "isp_ids": [],
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "audience_ids": [],
        "share_disabled": false,
        "operation_status": "ENABLE",
        "campaign_name": "{{campaign_name}}",
        "budget": {{budget}},
        "app_download_url": null,
        "bid_price": 0,
        "schedule_type": "SCHEDULE_START_END",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "device_price_ranges": null,
        "actions": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "billing_event": "OCPM",
        "messaging_app_type": "WHATSAPP",
        "interest_category_ids": [],
        "phone_region_calling_code": "+86",
        "excluded_audience_ids": [],
        "next_day_retention": null,
        "pixel_id": null,
        "attribution_event_count": "ONCE",
        "search_result_enabled": false,
        "create_time": "{{create_time}}",
        "campaign_id": "{{campaign_id}}",
        "skip_learning_phase": true,
        "deep_cpa_bid": 0,
        "deep_bid_type": null,
        "scheduled_budget": 0,
        "bid_type": "BID_TYPE_NO_BID",
        "operating_systems": [],
        "budget_mode": "BUDGET_MODE_TOTAL",
        "ios14_quota_type": "UNOCCUPIED",
        "frequency_schedule": null,
        "modify_time": "{{modify_time}}",
        "brand_safety_partner": null,
        "is_new_structure": true,
        "vbo_window": null,
        "video_download_disabled": false,
        "interest_keyword_ids": [],
        "brand_safety_type": "NO_BRAND_SAFETY"
    }
}
(/code)

即时通讯 URL 且优化目标为点击

请求

(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}}",
    "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
    "messaging_app_type":"IM_URL",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["1880251"],
    "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_NO_BID",
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "comment_disabled": false,
        "optimization_goal": "CLICK",
        "secondary_optimization_event": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "rf_estimated_cpr": null,
        "actions": [],
        "operating_systems": [],
        "deep_bid_type": null,
        "messaging_app_type": "IM_URL",
        "interest_category_ids": [],
        "optimization_event": null,
        "creative_material_mode": "CUSTOM",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "audience_ids": [],
        "location_ids": [
            "1880251"
        ],
        "is_hfss": false,
        "frequency_schedule": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "conversion_bid_price": 0,
        "delivery_mode": null,
        "smart_audience_enabled": null,
        "skip_learning_phase": false,
        "deep_cpa_bid": 0,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "scheduled_budget": 0,
        "device_price_ranges": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "ios14_quota_type": "UNOCCUPIED",
        "pixel_id": null,
        "brand_safety_partner": null,
        "rf_purchased_type": null,
        "app_download_url": null,
        "pacing": "PACING_MODE_SMOOTH",
        "gender": "GENDER_UNLIMITED",
        "interest_keyword_ids": [],
        "is_new_structure": true,
        "campaign_id": "{{campaign_id}}",
        "vbo_window": null,
        "inventory_filter_enabled": false,
        "feed_type": null,
        "campaign_name": "{{campaign_name}}",
        "search_result_enabled": false,
        "purchased_impression": null,
        "bid_type": "BID_TYPE_NO_BID",
        "schedule_type": "SCHEDULE_START_END",
        "frequency": null,
        "modify_time": "{{modify_time}}",
        "share_disabled": false,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "app_id": null,
        "next_day_retention": null,
        "rf_estimated_frequency": null,
        "conversion_window": null,
        "operation_status": "ENABLE",
        "schedule_infos": null,
        "create_time": "{{create_time}}",
        "adgroup_name": "{{adgroup_name}}",
        "isp_ids": [],
        "app_type": null,
        "network_types": [],
        "excluded_audience_ids": [],
        "age_groups": [
            "AGE_18_24",
            "AGE_25_34",
            "AGE_35_44",
            "AGE_45_54",
            "AGE_55_100"
        ],
        "purchased_reach": null,
        "billing_event": "CPC",
        "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
        "is_smart_performance_campaign": false,
        "advertiser_id": "{{advertiser_id}}",
        "adgroup_id": "{{adgroup_id}}",
        "smart_interest_behavior_enabled": null,
        "budget": 380,
        "adgroup_app_profile_page_state": null,
        "statistic_type": null,
        "video_download_disabled": false,
        "auto_targeting_enabled": false,
        "bid_display_mode": "CPMV",
        "languages": [],
        "category_exclusion_ids": [],
        "keywords": null,
        "bid_price": 0,
        "category_id": "0",
        "budget_mode": "BUDGET_MODE_TOTAL"
    }
}
(/code)

3. 创建广告

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

| 设置 {20%}| 要求{26%} | 参数 {20%}| 如何设置该参数 {35%}|
|---|---|---|---|
| 智能创意 | 不支持 | `is_smart_creative`<br>（[/ad/aco/create/](1739473063234626.html)中） | 不支持 |
|  广告样式 | 选择以下任一样式：<ul><li>单视频</li><li>轮播图片</li></ul> | `ad_format` | 使用以下任一值：<ul><li>`SINGLE_VIDEO`</li><li>`CAROUSEL_ADS`<ul><li>若想了解如何创建创建标准轮播广告，请查看[创建标准轮播广告的步骤](https://business-api.tiktok.com/portal/docs?id=1766217791987713#item-link-%E5%88%9B%E5%BB%BA%E6%A0%87%E5%87%86%E8%BD%AE%E6%92%AD%E5%B9%BF%E5%91%8A%E7%9A%84%E6%AD%A5%E9%AA%A4)。</li></ul></li></ul>|
| 标准行动引导文案 | 指定合法的标准行动引导文案。<br><br>推荐的行动引导文案为“发消息”。 | `call_to_action` | 指定一个非`CALL_NOW`的值。<br><br>推荐值为`SEND_MESSAGE`。 |
| 动态优选行动引导文案 | 不支持 | `call_to_action_id` | 不支持 |
| 创新互动样式 | 不支持 | `card_id` | 不支持 |
| 目标页面 |若想了解如何配置此设置，请查看<a href="#item-link-不同场景支持的目标页面和监测的消息事件集设置">不同场景支持的目标页面和监测的消息事件集设置</a>。  | `deeplink `<br>`deeplink_type`  <br>`fallback_type` <br>`landing_page_url`<br>`page_id`| 若想了解如何配置相应参数，请查看<a href="#item-link-不同场景支持的目标页面和监测的消息事件集设置">不同场景支持的目标页面和监测的消息事件集设置</a>。|
|（可选）监测 - 消息事件集 |若想了解如何配置此设置，请查看<a href="#item-link-不同场景支持的目标页面和监测的消息事件集设置">不同场景支持的目标页面和监测的消息事件集设置</a>。|`tracking_message_event_set_id`|若想了解如何配置相应参数，请查看<a href="#item-link-不同场景支持的目标页面和监测的消息事件集设置">不同场景支持的目标页面和监测的消息事件集设置</a>。|

不同场景支持的目标页面和监测的消息事件集设置

下表列出了基于您在广告组层级的即时通讯应用（或自定义 URL）和优化目标设置，广告层级支持的目标页面和消息事件集设置以及如何设置对应参数。

示例

目标页面为 TikTok 即时体验页面（使用即时通讯应用 Messenger 且优化目标为点击时）

请求

(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}}",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SEND_MESSAGE",
        "page_id": "{{page_id}}"
        }
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "deeplink": null,
                "profile_image_url": "{{profile_image_url}}",
                "display_name": "{{display_name}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "page_id": {{page_id}},
                "fallback_type": "UNSET",
                "app_name": "",
                "operation_status": "ENABLE",
                "image_ids": [
                    "{{image_id}}"
                ],
                "creative_authorized": false,
                "call_to_action": "SEND_MESSAGE",
                "tracking_pixel_id": 0,
                "adgroup_name": "{{adgroup_name}}",
                "viewability_postbid_partner": "UNSET",
                "ad_format": "SINGLE_VIDEO",
                "landing_page_url": null,
                "modify_time": "{{modify_time}}",
                "create_time": "{{create_time}}",
                "campaign_name": "{{campaign_name}}",
                "identity_type": "CUSTOMIZED_USER",
                "click_tracking_url": null,
                "landing_page_urls": null,
                "impression_tracking_url": null,
                "music_id": null,
                "optimization_event": null,
                "ad_texts": null,
                "viewability_vast_url": null,
                "identity_id": "{{identity_id}}",
                "ad_text": "{{ad_text}}",
                "card_id": null,
                "ad_id": "{{ad_id}}",
                "creative_type": "CUSTOM_INSTANT_PAGE",
                "video_id": "{{video_id}}",
                "campaign_id": "{{campaign_id}}",
                "ad_name": "{{ad_name}}",
                "is_new_structure": true,
                "carousel_image_labels": null,
                "call_to_action_id": null,
                "brand_safety_vast_url": null,
                "playable_url": "",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "adgroup_id": "{{adgroup_id}}",
                "vast_moat_enabled": false,
                "advertiser_id": "{{advertiser_id}}",
                "is_aco": false
            }
        ]
    }
}
(/code)

目标页面为即时通讯应用（使用即时通讯应用 WhatsApp 且优化目标为会话数时）

请求

(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":"{{identity_type}}",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SEND_MESSAGE"
        }
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "phone_number": "{{phone_number}}",
                "is_aco": false,
                "modify_time": "{{modify_time}}",
                "deeplink_type": "NORMAL",
                "campaign_id": "{{campaign_id}}",
                "creative_type": null,
                "display_name": "{{display_name}}",
                "call_to_action_id": null,
                "advertiser_id": "{{advertiser_id}}",
                "tracking_pixel_id": 0,
                "creative_authorized": false,
                "card_id": null,
                "viewability_vast_url": null,
                "playable_url": "",
                "viewability_postbid_partner": "UNSET",
                "image_ids": [
                    "{{image_id}}"
                ],
                "fallback_type": "UNSET",
                "campaign_name": "{{campaign_name}}",
                "ad_text": "{{ad_text}}",
                "ad_name": "{{ad_name}}",
                "adgroup_name": "{{adgroup_name}}",
                "click_tracking_url": null,
                "ad_format": "SINGLE_VIDEO",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "ad_id": "{{ad_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "call_to_action": "SEND_MESSAGE",
                "ad_texts": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "operation_status": "ENABLE",
                "music_id": null,
                "landing_page_url": "{{landing_page_url}}",
                "optimization_event": "MESSAGE",
                "phone_region_calling_code": "{{phone_region_calling_code}}",
                "deeplink": "",
                "page_id": null,
                "is_new_structure": true,
                "brand_safety_vast_url": null,
                "vast_moat_enabled": false,
                "landing_page_urls": null,
                "create_time": "{{create_time}}",
                "adgroup_id": "{{adgroup_id}}",
                "app_name": "",
                "identity_id": "{{identity_id}}",
                "carousel_image_labels": null,
                "impression_tracking_url": null,
                "phone_region_code": "{{phone_region_code}}",
                "profile_image_url": "{{profile_image_url}}",
                "video_id": "{{video_id}}"
            }
        ]
    }
}
(/code)

目标页面为通用链接或应用链接（使用即时通讯 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}}",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SEND_MESSAGE",
        "landing_page_url":"{{landing_page_url}}"
        }
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "ad_id": "{{ad_id}}",
                "display_name": "{{display_name}}",
                "carousel_image_labels": null,
                "app_name": "",
                "image_ids": [
                    "{{image_id}}"
                ],
                "click_tracking_url": null,
                "profile_image_url": "{{profile_image_url}}",
                "deeplink": "",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "tracking_pixel_id": 0,
                "ad_texts": null,
                "optimization_event": null,
                "advertiser_id": "{{advertiser_id}}",
                "deeplink_type": "NORMAL",
                "adgroup_id": "{{adgroup_id}}",
                "create_time": "{{create_time}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "call_to_action_id": null,
                "page_id": null,
                "campaign_id": "{{campaign_id}}",
                "is_new_structure": true,
                "landing_page_url": "{{landing_page_url}}",
                "ad_format": "SINGLE_VIDEO",
                "adgroup_name": "{{adgroup_name}}",
                "call_to_action": "SEND_MESSAGE",
                "viewability_postbid_partner": "UNSET",
                "modify_time": "{{modify_time}}",
                "identity_id": "{{identity_id}}",
                "impression_tracking_url": null,
                "identity_type": "CUSTOMIZED_USER",
                "viewability_vast_url": null,
                "campaign_name": "{{campaign_name}}",
                "music_id": null,
                "landing_page_urls": null,
                "fallback_type": "UNSET",
                "video_id": "{{video_id}}",
                "vast_moat_enabled": false,
                "brand_safety_vast_url": null,
                "ad_name": "{{ad_name}}",
                "operation_status": "ENABLE",
                "playable_url": "",
                "ad_text": "{{ad_text}}",
                "card_id": null,
                "is_aco": false,
                "creative_type": null,
                "creative_authorized": false
            }
        ]
    }
}
(/code)

目标页面为自定义 URL 架构（使用即时通讯 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}}",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SEND_MESSAGE",
        "deeplink":"{{deeplink}}",
        "deeplink_type":"NORMAL",
        "fallback_type":"WEBSITE",
        "landing_page_url":"{{landing_page_url}}"
        }
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "display_name": "{{display_name}}",
                "call_to_action_id": null,
                "ad_text": "{{ad_text}}",
                "landing_page_urls": null,
                "creative_type": null,
                "brand_safety_vast_url": null,
                "create_time": "{{create_time}}",
                "optimization_event": null,
                "adgroup_name": "{{adgroup_name}}",
                "tracking_pixel_id": 0,
                "profile_image_url": "{{profile_image_url}}",
                "viewability_vast_url": null,
                "campaign_id": "{{campaign_id}}",
                "ad_format": "SINGLE_VIDEO",
                "call_to_action": "SEND_MESSAGE",
                "image_ids": [
                    "{{image_id}}"
                ],
                "carousel_image_labels": null,
                "campaign_name": "{{campaign_name}}",
                "app_name": "",
                "page_id": null,
                "is_aco": false,
                "video_id": "{{video_id}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "impression_tracking_url": null,
                "fallback_type": "WEBSITE",
                "music_id": null,
                "ad_name": "{{ad_name}}",
                "card_id": null,
                "ad_id": "{{ad_id}}",
                "viewability_postbid_partner": "UNSET",
                "modify_time": "{{modify_time}}",
                "identity_id": "{{identity_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "deeplink_type": "NORMAL",
                "playable_url": "",
                "creative_authorized": false,
                "adgroup_id": "{{adgroup_id}}",
                "vast_moat_enabled": false,
                "advertiser_id": "{{advertiser_id}}",
                "deeplink": "{{deeplink}}",
                "ad_texts": null,
                "landing_page_url": "{{landing_page_url}}",
                "operation_status": "ENABLE",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "is_new_structure": true,
                "click_tracking_url": null
            }
        ]
    }
}
(/code)