创建单图片广告
本文介绍了在 Pangle 或全球化应用组合版位上创建单图片广告的具体步骤。
简介
单图片是一种广告样式,它允许您使用单张图片展示您的产品、服务或品牌。在单图片样式中使用有视觉吸引力的图片,可以捕捉受众注意力,促进受众转化。
您可以使用推广系列 API 创建单图片广告。这将帮助您简化广告创建流程,提高推广系列的运营效率和管理规模。
前提条件
- 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤 。
- 若要创建单图片广告,您需要获取相关的权限。参阅API参考了解使用相关接口(包括“步骤”部分列出的接口)所需的权限。参阅更新应用权限范围了解如何设置权限。
- 使用分辨率为 640 x 100 像素,600 x 500 像素,或 640 x 200 像素的图片创建单图片 Pangle 广告目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。
步骤
创建 Pangle 版位的单图片广告
- 使用/campaign/create/接口创建一个推广系列。需确保满足以下要求:
| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广目标 | 使用以下目标之一: <ul><li>应用推广 </li><li>网站转化量</li><li>访问量</li><li> 线索收集</li><li>商品销量</li></ul><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>若您选择了线索收集,您需在广告组层级将优化位置设置为落地页。若想了解如何创建单图片线索广告,请查看[创建优化位置为落地页的线索广告](1774482976097281.html)。</li></ul>| `objective_type` | 使用以下任意值:<ul><li>`APP_PROMOTION`</li><li>`WEB_CONVERSIONS`</li><li> `TRAFFIC` </li><li> `LEAD_GENERATION`</li><li>`PRODUCT_SALES`</li></ul><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>若您将本字段设置为 `LEAD_GENERATION`,您需在广告组层级将 `promotion_target_type` 设置为 `EXTERNAL_WEBSITE` 。若想了解如何创建单图片线索广告,请查看[创建优化位置为落地页的线索广告](1774482976097281.html)。</li></ul> |
注意
单图片推广系列不可同时启用 Smart+ 推广系列设置。若您想查看推广系列是否启用了 Smart+ 推广系列设置,可使用/campaign/get/返回的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": "TRAFFIC",
"campaign_name": "{{campaign_name}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"create_time": "{{create_time}}",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"is_smart_performance_campaign": false,
"advertiser_id": "{{advertiser_id}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}},
"is_new_structure": true,
"campaign_id": "{{campaign_id}}",
"modify_time": "{{modify_time}}",
"campaign_name": "{{campaign_name}}",
"operation_status": "ENABLE",
"campaign_type": "REGULAR_CAMPAIGN",
"deep_bid_type": null,
"objective_type": "TRAFFIC",
"roas_bid": 0,
"objective": "LANDING_PAGE"
}
}
(/code)
- 使用/adgroup/create/接口创建一个广告组。需确保满足以下要求:
| 设置 | 要求 | 参数 | 如何设置该参数 |
|---|---|---|---|
| 版位 |
编辑版位 ,选择 Pangle 版位 | placement_type |
PLACEMENT_TYPE_NORMAL |
placements |
["PLACEMENT_PANGLE"] |
||
| 受众定向 - 地域 | Pangle 版位支持的单个或多个地域 | location_ids |
将location_ids设置为 Pangle 版位支持的单个或多个地域的 ID。若想了解在 Pangle 版位下您的广告账号的注册地对应的可用地域,请查看商务帮助中心文章广告位及可用地域。 若想获取您的广告账号在 Pangle 版位下可用的地域 ID,可使用/tool/region/,将 placements 设置为 ["PLACEMENT_PANGLE"]。 |
示例
请求
(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": "WEBSITE",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": [
"PLACEMENT_PANGLE"
],
"video_download_disabled": true,
"location_ids": ["102358"],
"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": {
"rf_estimated_frequency": null,
"promotion_type": "WEBSITE",
"feed_type": null,
"is_new_structure": true,
"optimization_event": null,
"conversion_bid_price": 0,
"bid_display_mode": "CPMV",
"placements": [
"PLACEMENT_PANGLE"
],
"rf_estimated_cpr": null,
"ios14_quota_type": "UNOCCUPIED",
"statistic_type": null,
"secondary_status": "ADGROUP_STATUS_CREATE",
"app_download_url": null,
"creative_material_mode": "CUSTOM",
"app_type": null,
"campaign_id": "{{campaign_id}}",
"bid_price": 0,
"campaign_name": "{{campaign_name}}",
"schedule_start_time": "{{schedule_start_time}}",
"adgroup_id": "{{adgroup_id}}",
"category_id": "0",
"purchased_impression": null,
"actions": [],
"schedule_type": "SCHEDULE_START_END",
"interest_category_ids": [],
"operation_status": "ENABLE",
"frequency_schedule": null,
"video_download_disabled": true,
"bid_type": "BID_TYPE_NO_BID",
"audience_ids": [],
"adgroup_name": "{{adgroup_name}}",
"schedule_infos": null,
"skip_learning_phase": false,
"operating_systems": [],
"schedule_end_time": "{{schedule_end_time}}",
"app_id": null,
"optimization_goal": "CLICK",
"conversion_window": null,
"advertiser_id": "{{advertiser_id}}",
"network_types": [],
"brand_safety_type": "NO_BRAND_SAFETY",
"brand_safety_partner": null,
"delivery_mode": null,
"scheduled_budget": 0,
"comment_disabled": false,
"search_result_enabled": false,
"languages": [],
"share_disabled": false,
"isp_ids": [],
"auto_targeting_enabled": false,
"secondary_optimization_event": null,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"next_day_retention": null,
"location_ids": [
"102358"
],
"pixel_id": null,
"billing_event": "CPC",
"rf_purchased_type": null,
"frequency": null,
"keywords": null,
"budget_mode": "BUDGET_MODE_TOTAL",
"inventory_filter_enabled": false,
"purchased_reach": null,
"deep_bid_type": null,
"interest_keyword_ids": [],
"pacing": "PACING_MODE_SMOOTH",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"age_groups": null,
"modify_time": "{{modify_time}}",
"deep_cpa_bid": 0,
"budget": {{}},
"gender": "GENDER_UNLIMITED",
"create_time": "{{create_time}}",
"excluded_audience_ids": [],
"device_price_ranges": null,
"is_hfss": false,
"adgroup_app_profile_page_state": null,
"category_exclusion_ids": []
}
}
(/code)
- 使用/ad/create/接口创建一个广告。需确保满足以下要求:
| 设置 {15%}| 要求{25%} | 参数{25%} | 如何设置该参数{35%} |
|---|---|---|---|
| 广告样式 | 单图片 | `ad_format` | `SINGE_IMAGE` |
| 图片 | 单图片 Pangle 广告中支持的一张图片 | `image_ids` | 传入一个满足规格要求的图片的 ID。 <br>单图片 Pangle 广告中的图片需满足以下规格要求: <ul><li>文件类型: JPG,JPEG,或PNG</li><li>图片分辨率:<ul><li>720 x 280 像素</li><li>1200 x 628 像素</li><li>640 x 640 像素</li><li>640 x 100 像素</li><li>600 x 500 像素或 </li><li>640 x 200 像素</li></ul></li><li>文件大小:小于100 MB</li></ul><br>若想获取图片 ID,可使用[/file/image/ad/upload/](1739067433456642.html)和[/file/image/ad/search/](1740052016789506.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_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"ad_format": "SINGLE_IMAGE",
"image_ids":["{{image_id}}"],
"ad_text": "{{ad_text}}",
"call_to_action": "SHOP_NOW",
"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": [
{
"tracking_pixel_id": 0,
"ad_name": "{{ad_name}}",
"creative_type": null,
"ad_text": "{{ad_text}}",
"campaign_id": "{{campaign_id}}",
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}"
],
"music_id": null,
"page_id": null,
"video_id": null,
"create_time": "{{create_time}}",
"is_aco": false,
"identity_id": "{{identity_id}}",
"click_tracking_url": null,
"landing_page_urls": null,
"adgroup_id": "{{adgroup_id}}",
"ad_format": "SINGLE_IMAGE",
"campaign_name": "{{campaign_name}}",
"vast_moat_enabled": false,
"deeplink": "",
"impression_tracking_url": null,
"is_new_structure": true,
"app_name": "",
"display_name": "{{display_name}}",
"modify_time": "{{modify_time}}",
"ad_id": "{{ad_id}}",
"optimization_event": null,
"playable_url": "",
"advertiser_id": "{{advertiser_id}}",
"adgroup_name": "{{adgroup_name}}",
"fallback_type": "UNSET",
"brand_safety_postbid_partner": "UNSET",
"viewability_vast_url": null,
"operation_status": "ENABLE",
"call_to_action": "SHOP_NOW",
"identity_type": "CUSTOMIZED_USER",
"landing_page_url": "{{landing_page_url}}",
"image_ids": [
"{{image_id}}"
],
"brand_safety_vast_url": null,
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"ad_texts": null,
"profile_image_url": "{{profile_image_url}}",
"card_id": null,
"call_to_action_id": null,
"deeplink_type": "NORMAL",
"viewability_postbid_partner": "UNSET",
"creative_authorized": false
}
]
}
}
(/code)
- 使用/creative/ads_preview/create/接口预览广告。
我们支持的预览类型包括:AD和ADS_CREATION,使您可以预览计划创建的或现有的单图片 Pangle 广告。
创建全球化应用组合版位的单图片广告
- 使用/campaign/create/接口创建一个推广系列。需确保满足以下要求:
| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广目标 | 使用以下目标之一: <ul><li>应用推广 </li><li>网站转化量</li><li>访问量</li></ul>| `objective_type` | 使用以下任意值:<ul><li>`APP_PROMOTION`</li><li>`WEB_CONVERSIONS`</li><li> `TRAFFIC` </li></ul> |
| 应用推广类型 <br>(推广目标设置为应用推广时) | 应用安装 | `app_promotion_type` | `APP_INSTALL` |
| iOS 14 专属推广系列 | 未启用 | `campaign_type` | `REGULAR_CAMPAIGN` |
注意
单图片推广系列不可同时启用 Smart+ 推广系列设置。若您想查看推广系列是否启用了 Smart+ 推广系列设置,可使用/campaign/get/返回的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": "TRAFFIC",
"campaign_name": "{{campaign_name}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"create_time": "{{create_time}}",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"is_smart_performance_campaign": false,
"advertiser_id": "{{advertiser_id}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}},
"is_new_structure": true,
"campaign_id": "{{campaign_id}}",
"modify_time": "{{modify_time}}",
"campaign_name": "{{campaign_name}}",
"operation_status": "ENABLE",
"campaign_type": "REGULAR_CAMPAIGN",
"deep_bid_type": null,
"objective_type": "TRAFFIC",
"roas_bid": 0,
"objective": "LANDING_PAGE"
}
}
(/code)
- 使用/adgroup/create/接口创建一个广告组。需确保满足以下要求:
| 设置 | 要求 | 参数 | 如何设置该参数 |
|---|---|---|---|
| 版位 | 编辑版位,选择全球化应用组合版位 | placement_type |
PLACEMENT_TYPE_NORMAL |
placements |
["PLACEMENT_GLOBAL_APP_BUNDLE"] |
||
| 受众定向 - 自动定向 | 未启用 | auto_targeting_enabled |
不传入 |
| 受众定向 - 地域 | 全球化应用组合版位支持的单个或多个地域 | location_ids |
将location_ids设置为全球化应用组合版位支持的单个或多个地域的 ID。全球化应用组合版位支持的定向地域有:
若想获取您的广告账号在全球化应用组合版位下可用的地域 ID,可使用/tool/region/,将 placements设置为 ["PLACEMENT_GLOBAL_APP_BUNDLE"]。 |
| 受众定向 - 消费能力 | 未启用 | spending_power |
不传入 |
| 受众定向 - 受众 - 包含 和排除 |
|
audience_idsexcluded_audience_ids |
|
| 受众定向 - 兴趣与行为 | 未启用 | interest_category_ids interest_keyword_idspurchase_intention_keyword_idsactionsaction_period video_user_actionsaction_category_ids action_scene |
不传入 |
| 受众定向 - 定向扩量 | 未启用 | targeting_expansion |
不传入 |
| 优化目标 |
|
optimization_goal |
|
| 计费点(计费事件) |
|
billing_event |
|
示例
请求
(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": "WEBSITE",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": [
"PLACEMENT_GLOBAL_APP_BUNDLE"
],
"video_download_disabled": true,
"location_ids": ["102358"],
"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": {
"skip_learning_phase": false,
"adgroup_app_profile_page_state": null,
"rf_purchased_type": null,
"schedule_end_time": "{{schedule_end_time}}",
"frequency": null,
"create_time": "{{create_time}}",
"advertiser_id": "{{advertiser_id}}",
"placements": [
"PLACEMENT_GLOBAL_APP_BUNDLE"
],
"budget": {{budget}},
"schedule_infos": null,
"keywords": null,
"purchased_reach": null,
"promotion_type": "WEBSITE",
"bid_price": 0.0,
"app_download_url": null,
"statistic_type": null,
"share_disabled": false,
"conversion_window": null,
"is_hfss": false,
"app_id": null,
"delivery_mode": null,
"interest_keyword_ids": [],
"operating_systems": [],
"adgroup_name": "{{adgroup_name}}",
"excluded_audience_ids": [],
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"deep_bid_type": null,
"secondary_optimization_event": null,
"pixel_id": null,
"frequency_schedule": null,
"ios14_quota_type": "UNOCCUPIED",
"budget_mode": "BUDGET_MODE_TOTAL",
"campaign_name": "{{campaign_name}}",
"bid_type": "BID_TYPE_NO_BID",
"comment_disabled": false,
"rf_estimated_cpr": null,
"brand_safety_partner": null,
"deep_cpa_bid": 0.0,
"optimization_goal": "CLICK",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"audience_ids": [],
"category_id": "0",
"inventory_filter_enabled": false,
"video_download_disabled": true,
"schedule_type": "SCHEDULE_START_END",
"creative_material_mode": "CUSTOM",
"conversion_bid_price": 0.0,
"location_ids": [
"102358"
],
"network_types": [],
"schedule_start_time": "{{schedule_start_time}}",
"brand_safety_type": "NO_BRAND_SAFETY",
"interest_category_ids": [],
"device_price_ranges": null,
"rf_estimated_frequency": null,
"next_day_retention": null,
"secondary_status": "ADGROUP_STATUS_CREATE",
"age_groups": null,
"pacing": "PACING_MODE_SMOOTH",
"campaign_id": "{{campaign_id}}",
"scheduled_budget": 0.0,
"feed_type": null,
"modify_time": "{{modify_time}}",
"languages": [],
"purchased_impression": null,
"billing_event": "CPC",
"gender": "GENDER_UNLIMITED",
"auto_targeting_enabled": false,
"app_type": null,
"isp_ids": [],
"optimization_event": null,
"search_result_enabled": false,
"actions": [],
"operation_status": "ENABLE",
"is_new_structure": true,
"adgroup_id": "{{adgroup_id}}",
"bid_display_mode": "CPMV",
"category_exclusion_ids": []
}
}
(/code)
- 使用/ad/create/接口创建一个广告。需确保满足以下要求:
| 设置 {15%}| 要求{27%} | 参数{25%} | 如何设置该参数{33%} |
|---|---|---|---|
| 广告样式 | 单图片 | `ad_format` | `SINGE_IMAGE` |
| 图片 | 单图片全球化应用组合广告中支持的一张图片 | `image_ids` | 传入一个满足规格要求的图片的 ID。 <br>单图片全球化应用组合广告中的图片需满足以下规格要求: <ul><li>文件类型: JPG,JPEG,或PNG</li><li>图片分辨率:<ul><li>720 x 280 像素</li><li>1200 x 628 像素或</li><li>640 x 640 像素</li></ul></li><li>文件大小:小于100 MB</li></ul><br>若想获取图片 ID,可使用[/file/image/ad/upload/](1739067433456642.html)和[/file/image/ad/search/](1740052016789506.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_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",
"ad_format": "SINGLE_IMAGE",
"image_ids":["{{image_id}}"],
"ad_text": "{{ad_text}}",
"call_to_action": "SHOP_NOW",
"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": [
{
"is_aco": false,
"click_tracking_url": null,
"video_id": null,
"call_to_action_id": null,
"adgroup_id": "{{adgroup_id}}",
"deeplink_type": "NORMAL",
"create_time": "{{create_time}}",
"ad_id": "{{ad_id}}",
"app_name": "",
"identity_id": "{{identity_id}}",
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}"
],
"brand_safety_postbid_partner": "UNSET",
"viewability_postbid_partner": "UNSET",
"page_id": null,
"card_id": null,
"call_to_action": "SHOP_NOW",
"brand_safety_vast_url": null,
"deeplink": "",
"identity_type": "CUSTOMIZED_USER",
"creative_authorized": false,
"creative_type": null,
"ad_text": "{{ad_text}}",
"adgroup_name": "{{adgroup_name}}",
"ad_name": "{{ad_name}}",
"campaign_name": "{{campaign_name}}",
"campaign_id": "{{campaign_id}}",
"display_name": "{{display_name}}",
"ad_texts": null,
"fallback_type": "UNSET",
"image_ids": [
"{{image_id}}"
],
"music_id": null,
"landing_page_url": "{{landing_page_url}}",
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"tracking_pixel_id": 0,
"playable_url": "",
"is_new_structure": true,
"viewability_vast_url": null,
"ad_format": "SINGLE_IMAGE",
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"impression_tracking_url": null,
"landing_page_urls": null,
"advertiser_id": "{{advertiser_id}}",
"profile_image_url": "{{profile_image_url}}",
"vast_moat_enabled": false,
"optimization_event": null
}
]
}
}
(/code)