创建优化位置为落地页的线索广告
本文介绍了如何创建优化位置为落地页的线索广告，引导受众在您的网站中进行与线索收集相关的行为。
步骤
1. 创建推广系列
使用/campaign/create/接口创建一个推广系列。需确保满足以下要求：
| 设置 {20%}| 要求{30%} | 参数{20%} | 如何设置该参数{30%} |
|---|---|---|---|
| 推广目标 | 线索收集| `objective_type` | `LEAD_GENERATION` |
| Smart+ 推广系列 | 未启用 <br><br>若想了解如何创建优化位置为落地页的 Smart+ 线索收集推广系列，可查看[创建 Smart+ 线索收集推广系列](https://business-api.tiktok.com/portal/docs?id=1827645480080385#item-link-%E5%88%9B%E5%BB%BA%E4%BC%98%E5%8C%96%E4%BD%8D%E7%BD%AE%E4%B8%BA%E8%90%BD%E5%9C%B0%E9%A1%B5%E7%9A%84%20Smart+%20%E7%BA%BF%E7%B4%A2%E6%94%B6%E9%9B%86%E6%8E%A8%E5%B9%BF%E7%B3%BB%E5%88%97)。| / | / |
示例
请求
(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/接口创建一个广告组。需确保满足以下要求：
| 设置 {18%}| 要求{23%} | 参数 {26%}| 如何设置该参数 {33%}|
|---|---|---|---|
| 优化位置 <br>（推广对象类型） | 落地页 | `promotion_type`<br> `promotion_target_type` <br>`pixel_id` <br>`optimization_event` | <ul><li>将 `promotion_type` 设置为 `LEAD_GENERATION`</li><li>将 `promotion_target_type` 设置为`EXTERNAL_WEBSITE`</li><li> 若`optimization_goal`设置为 `CONVERT`，需同时传入 `pixel_id` 和 `optimization_event`。</li><li>若`optimization_goal`设置为 `CLICK`，无需同时传入 `pixel_id` 和 `optimization_event`。</li></ul><br>若想获取 Pixel（ `pixel_id` ）和与其关联的优化事件（ `optimization_event` ），可使用[/pixel/list/](1740858697598978.html)。 |
|（可选）深层漏斗优化 | 启用或不启用 <br> <br>通过深层漏斗优化，您可以在主要优化事件之外再选择一个次要事件，这有助于提升推广系列的效果。 | `deep_funnel_optimization_status`<br>`deep_funnel_event_source`<br>`deep_funnel_event_source_id` <br>`deep_funnel_optimization_event` | <ul><li>若想启用深层漏斗优化，需将 `deep_funnel_optimization_status` 设置为 `ON` 且传入`deep_funnel_event_source`、`deep_funnel_event_source_id` 和 `deep_funnel_optimization_event`。</li><li>若不想启用深层漏斗优化，需将 `deep_funnel_optimization_status`设置为 `OFF` 或不传入`deep_funnel_optimization_status`。无需传入`deep_funnel_event_source`、`deep_funnel_event_source_id` 和`deep_funnel_optimization_event`。 </li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>使用 CRM 事件组的深层漏斗优化目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>使用 Pixel 或线下事件组的深层漏斗优化已全量发布。</li></ul> |
|版位<br>（广告位） | 以下任一选项：<ul><li><strong>自动版位</strong></li><li><strong>编辑版位</strong>（版位需选择 TikTok，或 Pangle，或 TikTok 和 Pangle） </li></ul> | `placement_type`<br>`placements` | 以下任一设置：<ul><li>`placement_type`设置为`PLACEMENT_TYPE_AUTOMATIC`</li><li>`placement_type`设置为`PLACEMENT_TYPE_NORMAL`，且`placements`设置为 `["PLACEMENT_TIKTOK"]`， `["PLACEMENT_PANGLE"]`，或`["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"]`。</li></ul> |
| 优化目标 | 使用以下目标之一：<ul><li>转化</li><li>点击 </li></ul> | `optimization_goal`| 使用以下任意值：<ul><li>`CONVERT` </li><li> `CLICK`</li></ul> |
| 计费事件 |<ul><li>若优化目标设置为转化，则计费事件需设置为oCPM。</li><li> 若优化目标设置为点击，则计费事件需设置为CPC。</li></ul> | `billing_event` | <ul><li>若 `optimization_goal` 设置为`CONVERT`，则 `billing_event` 需设置为 `OCPM`。</li><li>若 `optimization_goal` 设置为 `CLICK`，则 `billing_event` 需设置为 `CPC`。</li></ul> |
| 竞价策略 & 投放速度 | <ul><li>若竞价策略设置为成本上限，则投放速度可设置为标准或加速。</li><li> 若竞价策略设置为最大投放量，则投放速度仅可设置为标准。 </li></ul> | `bid_type` <br>`pacing`| <ul><li>若`bid_type`设置为`BID_TYPE_CUSTOM`，则`pacing`支持设置为`PACING_MODE_SMOOTH`或`PACING_MODE_FAST`。</li><li>若`bid_type`设置为 `BID_TYPE_NO_BID`，则`pacing` 仅支持设置为`PACING_MODE_SMOOTH`。</li></ul> |
示例
请求
(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_GENERATION",
"promotion_target_type":"EXTERNAL_WEBSITE",
"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_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": {
"scheduled_budget": 0,
"secondary_optimization_event": null,
"frequency_schedule": null,
"schedule_infos": null,
"billing_event": "CPC",
"app_type": null,
"schedule_end_time": "{{schedule_end_time}}",
"modify_time": "{{modify_time}}",
"actions": [],
"advertiser_id": "{{advertiser_id}}",
"delivery_mode": null,
"gender": "GENDER_UNLIMITED",
"optimization_goal": "CLICK",
"keywords": null,
"optimization_event": null,
"pixel_id": null,
"bid_type": "BID_TYPE_NO_BID",
"rf_estimated_frequency": null,
"secondary_status": "ADGROUP_STATUS_CREATE",
"placements": [
"PLACEMENT_TIKTOK"
],
"location_ids": [
"{{location_id}}"
],
"promotion_type": "LEAD_GENERATION",
"budget_mode": "BUDGET_MODE_TOTAL",
"operating_systems": [],
"purchased_impression": null,
"share_disabled": false,
"brand_safety_partner": null,
"category_id": "0",
"bid_price": 0,
"operation_status": "ENABLE",
"budget": {{budget}},
"excluded_audience_ids": [],
"schedule_start_time": "{{schedule_start_time}}",
"campaign_id": "{{campaign_id}}",
"network_types": [],
"app_id": null,
"brand_safety_type": "NO_BRAND_SAFETY",
"conversion_window": null,
"languages": [],
"schedule_type": "SCHEDULE_START_END",
"category_exclusion_ids": [],
"ios14_quota_type": "UNOCCUPIED",
"purchased_reach": null,
"auto_targeting_enabled": false,
"isp_ids": [],
"conversion_bid_price": 0,
"campaign_name": "{{campaign_name}}",
"comment_disabled": false,
"age_groups": null,
"promotion_target_type": "EXTERNAL_WEBSITE",
"search_result_enabled": true,
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"interest_category_ids": [],
"frequency": null,
"adgroup_app_profile_page_state": null,
"feed_type": null,
"audience_ids": [],
"pacing": "PACING_MODE_SMOOTH",
"bid_display_mode": "CPMV",
"deep_bid_type": null,
"is_hfss": false,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"device_price_ranges": null,
"video_download_disabled": false,
"next_day_retention": null,
"rf_purchased_type": null,
"interest_keyword_ids": [],
"deep_cpa_bid": 0,
"inventory_filter_enabled": false,
"create_time": "{{create_time}}",
"adgroup_id": "{{adgroup_id}}",
"statistic_type": null,
"skip_learning_phase": false,
"is_new_structure": true,
"app_download_url": null,
"creative_material_mode": "CUSTOM",
"adgroup_name": "{{adgroup_name}}",
"rf_estimated_cpr": null
}
}
(/code)
3. 创建广告
使用/ad/create/接口创建一个广告。需确保满足以下要求：
| 设置 {20%}| 要求{26%} | 参数 {20%}| 如何设置该参数 {35%}|
|---|---|---|---|
| 广告样式 | 使用以下任一样式：<ul><li>单视频</li><li>单图片 </li><li>轮播图片</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若要将广告样式设置为单图片，您需在广告组层级将版位设置为仅包含 Pangle 的<b>编辑版位</b>。</li><li>若要将广告样式设置为轮播图片，您需在广告组层级将版位设置为<b>自动版位</b>或包含 TikTok 的<b>编辑版位</b>。</li></ul> | `ad_format` | 使用以下任一值：<ul><li>`SINGLE_VIDEO`</li><li>`SINGLE_IMAGE`</li><li>`CAROUSEL_ADS`</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若要将 `ad_format` 设置为 `SINGLE_IMAGE`，需在广告组层级将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 设置为 `["PLACEMENT_PANGLE"]` 。<ul><li>若想了解如何创建创建单图片广告，请查看[创建单图片广告](1777633230937090.html)。</li></ul> </li><li>若要将 `ad_format` 设置为 `CAROUSEL_ADS`，需在广告组层级将 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC`，或将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且在 `placements` 的值中包含 `PLACEMENT_TIKTOK`。<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>（对于单视频广告可选） | <ul><li>广告样式为单视频且版位包含TikTok 时, 仅支持图片卡片、礼品码贴纸和倒计时贴纸。</li><li>广告样式为轮播图片时，不支持创新互动样式。</li></ul>| `card_id` | <ul><li>`ad_format` 为 `SINGLE_VIDEO` 且广告组层级 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC` 或 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 的值中包含 `PLACEMENT_TIKTOK` 时，可指定图片卡片、礼品码贴纸或倒计时贴纸素材包的 ID。 <ul><li>若想了解如何使用图片卡片，请查看[卡片](1749019652141058.html)。</li><li>若想了解如何创建倒计时贴纸和礼品码贴纸素材包，请查看[贴纸](1749019667506177.html)。</li></ul></li><li>`ad_format` 为 `CAROUSEL_ADS` 时，不支持 `card_id` 。</li></ul> |
| 目标页面 | 使用以下任一设置：<ul><li>URL</li><li>自定义页面</li></ul> | `landing_page_url`<br> `page_id` |<ul><li>若想将目标页面设置为 URL，需通过`landing_page_url`传入包含第三方网站表单的网站落地页URL</li><li>若想将目标页面设置为自定义页面，需通过`page_id`传入可以重定向至包含第三方网站表单的网站的 TikTok 即时体验页面。<ul><li>若想创建自定义页面，可使用[即时体验页面编辑器](1740307202170881.html)并将 `businessType`设置为 `6`。 </li><li>创建自定义页面后，可使用[/page/get/](1820826387779586.html)获取页面 ID。</li></ul></li></ul> |
示例
请求
(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_to_action}}",
"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": [
{
"landing_page_urls": null,
"ad_texts": null,
"optimization_event": "FORM",
"ad_format": "SINGLE_VIDEO",
"page_id": null,
"campaign_id": "{{campaign_id}}",
"identity_id": "{{identity_id}}",
"display_name": "{{display_name}}",
"call_to_action_id": null,
"brand_safety_postbid_partner": "UNSET",
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}",
"{{tracking_offline_event_set_id}}"
],
"brand_safety_vast_url": null,
"creative_type": null,
"is_aco": false,
"create_time": "{{create_time}}",
"image_ids": [
"{{image_id}}"
],
"app_name": "",
"adgroup_name": "{{adgroup_name}}",
"ad_ref_pixel_id": {{ad_ref_pixel_id}},
"deeplink": null,
"operation_status": "ENABLE",
"vast_moat_enabled": false,
"advertiser_id": "{{advertiser_id}}",
"ad_text": "{{ad_text}}",
"ad_name": "{{ad_name}}",
"tracking_pixel_id": {{tracking_pixel_id}},
"playable_url": "",
"viewability_postbid_partner": "UNSET",
"identity_type": "CUSTOMIZED_USER",
"campaign_name": "{{campaign_name}}",
"profile_image_url": "{{profile_image_url}}",
"viewability_vast_url": null,
"is_new_structure": true,
"music_id": null,
"impression_tracking_url": null,
"adgroup_id": "{{adgroup_id}}",
"ad_id": "{{ad_id}}",
"call_to_action": "{{call_to_action}}",
"landing_page_url": "{{landing_page_url}}",
"click_tracking_url": null,
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"video_id": "{{video_id}}",
"modify_time": "{{modify_time}}",
"creative_authorized": false,
"card_id": null
}
]
}
}
(/code)