← 返回目录
📁 Use Cases › Campaign creation › Create Lead Generation ads

创建优化位置为电话通话的线索广告

本文介绍了如何创建优化位置为电话通话的线索广告。受众将能够通过点击行动引导文案按钮直接向您(广告主)发起电话通话,或浏览您设置的 TikTok 即时体验页面。

注意
创建优化位置为电话通话的线索广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

步骤

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/接口创建一个广告组。需确保满足以下要求:

| 设置 {20%}| 要求{22%} | 参数 {30%}| 如何设置该参数 {28%}|
|---|---|---|---|
| 推广对象类型 <br>(优化位置) | 电话通话| `promotion_type`<br> `promotion_target_type`   | <ul><li>`promotion_type` 设置为 `LEAD_GEN_CLICK_TO_CALL`,</li><li>同时不传入 `promotion_target_type`  。</li></ul> |
|版位 | <strong>编辑版位</strong>,且将版位设置为 TikTok </li></ul> | `placement_type`<br>`placements` | <ul><li>`placement_type`设置为`PLACEMENT_TYPE_NORMAL`,</li><li>同时`placements`设置为 `["PLACEMENT_TIKTOK"]`。</li></ul> |
| 年龄定向 | 不支持定向18岁以下受众 | `age_groups` | 不支持传入`AGE_13_17`的值 |
| 人群属性 - 地域定向 | 可定位的地域包括:<ul><li>亚太地区:澳大利亚、柬埔寨、印度尼西亚、日本、马来西亚、新西兰、菲律宾、新加坡、韩国、泰国、越南</li><li>拉美地区:巴西、智利、哥伦比亚、厄瓜多尔、墨西哥、秘鲁</li></ul> 请注意,注册地域为中国大陆(`CN`)的广告主无法定向澳大利亚和印度尼西亚。 | `location_ids` | 传入在以下地区内的地域 ID:<ul><li>亚太地区:澳大利亚、柬埔寨、印度尼西亚、日本、马来西亚、新西兰、菲律宾、新加坡、韩国、泰国、越南</li><li>拉美地区:巴西、智利、哥伦比亚、厄瓜多尔、墨西哥、秘鲁</li></ul> 请注意,注册地域为中国大陆(`CN`)的广告主无法定向澳大利亚和印度尼西亚。<br><br> 若想获取可定向的具体地域,请使用[/tool/targeting/search/](1761236883355649.html)或[/tool/region/](1737189539571713.html)接口。 |
| Pangle 流量包 | 不支持 | `included_pangle_audience_package_ids`<br>`excluded_pangle_audience_package_ids`  | 不支持 |
| 优化目标 | 点击 | `optimization_goal`|  `CLICK` |
| 计费事件 |CPC | `billing_event` | `CPC`|
| 搜索广告| 不支持| `search_result_enabled`| 仅可设置为 `false`或不传入|
| 程序化创意(ACO) | 不支持 | `creative_material_mode`| `CUSTOM` 或不传入 |

示例

请求

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

3. 创建广告

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

| 设置 {20%}| 要求{26%} | 参数 {20%}| 如何设置该参数 {35%}|
|---|---|---|---|
|  广告样式 | 选择以下任一样式:<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` | 指定一个合法值。<br><br>推荐值为`CALL_NOW`。 |
| 动态优选行动引导文案 | 不支持 | `call_to_action_id` | 不支持 |
| 创新互动样式 | 不支持 | `card_id` | 不支持 |
| 目标页面 | 使用以下任一设置:<ul><li>电话号码</li><li>TikTok 即时体验页面</li></ul> | `phone_region_code` <br>`phone_number`<br> `phone_region_calling_code`<br>`page_id` | <ul><li>若要将目标页面设置为电话号码,您需传入 `phone_region_code` , `phone_region_calling_code` 和 `phone_number` 。 <br><p><span style="color:darkred"><b>注意</b></span>:若想获取电话号码的地区对应的地区代码( `phone_region_code` )和区号( `phone_region_calling_code` ),可用[/tool/phone_region_code/](1774488637039618.html)。</li><li>若要将目标页面设置为 TikTok 即时体验页面,需将 `page_id` 设置为自定义 TikTok 即时体验页面的ID。</li></ul>|
| 智能创意 | 不支持 | `is_smart_creative`<br>([/ad/aco/create/](1739473063234626.html)中) | 不支持 |

示例

请求

(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": "CALL_NOW",
        "phone_region_code":"US",
        "phone_region_calling_code":"+1",
        "phone_number":"{{phone_number}}"
    }]
}'
(/code)

返回

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

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

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