自定产品页面
自定产品页面是一种定制化的产品页面，支持根据您的广告策略自定义截图、推广文字和应用预览。通过自定产品页面，您可以突出介绍所推广应用的特定内容或功能，针对特定受众群体进行推广，或展示季节性内容。
如何在广告中使用自定产品页面
前提条件
- 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤 。
- 若要创建轮播广告，您需要获取相关的权限。参阅API参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限。参阅更新应用权限范围了解如何设置权限。
- 在广告中使用自定产品页面目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。
- 若想了解如何在 Apple App Store 中创建自定产品页面并获取对应的自定产品页面 URL，请查看 App Store 上的自定产品页面。
步骤
1. 创建推广系列
使用/campaign/create/接口创建一个推广系列。需确保满足以下要求：
| 设置 {17%}| 要求{23%} | 参数{25%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广目标 | 应用推广 | `objective_type` | `APP_PROMOTION` |
| 应用推广类型 | 以下任意类型：<ul><li>应用安装</li><li>应用再营销 </li><li> 应用预注册 </li></ul>| `app_promotion_type` | 以下任意值：<ul><li>`APP_INSTALL`</li><li>`APP_RETARGETING` </li><li>`APP_PREREGISTRATION`</li></ul> |
|iOS 14 专属推广系列| <ul><li>若应用推广类型为应用安装：<ul><li>启用 </li></ul></li><li>若应用推广类型为应用再营销或应用预注册： <ul><li>未启用</li></ul></li></ul>| `campaign_type` <br>`app_id` <br>`campaign_app_profile_page_state`| <ul><li>若 `app_promotion_type` 为 `APP_INSTALL`：<ul><li> 将 `campaign_type` 设置为 `IOS14_CAMPAIGN`。</li><li> 将 `app_id` 设置为 iOS 应用的 ID。若想获取您的广告账户下的 iOS 应用 ID，可使用[/app/list/](1740859313270786.html)。 iOS 应用的 `platform` 将显示为`IOS`。</li><li>将 `campaign_app_profile_page_state` 设置为 `ON` 或 `OFF` （或不传入此字段）。</li></ul></li><li>若 `app_promotion_type` 为 `APP_RETARGETING` 或 `APP_PREREGISTRATION`：<ul><li>将 `campaign_type` 设置为 `REGULAR_CAMPAIGN`，或不传入此字段。</li><li>不传入 `app_id`。</li><li>将 `campaign_app_profile_page_state` 设置为 `OFF`，或不传入此字段。</li></ul></li></ul>|
|Smart+ 推广系列| 未启用 | / | / |
示例
创建启用应用介绍页的应用安装推广系列
请求
(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": "APP_PROMOTION",
"app_promotion_type": "APP_INSTALL",
"campaign_type": "IOS14_CAMPAIGN",
"app_id": "{{app_id}}",
"campaign_name": "{{campaign_name}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"budget": {{budget}},
"objective_type": "APP_PROMOTION",
"campaign_type": "IOS14_CAMPAIGN",
"campaign_app_profile_page_state": "OFF",
"is_new_structure": true,
"budget_mode": "BUDGET_MODE_TOTAL",
"app_id": "{{app_id}}",
"operation_status": "ENABLE",
"roas_bid": 0,
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"is_search_campaign": false,
"is_advanced_dedicated_campaign": false,
"campaign_name": "{{campaign_name}}",
"is_smart_performance_campaign": false,
"create_time": "{{create_time}}",
"campaign_id": "{{campaign_id}}",
"deep_bid_type": null,
"modify_time": "{{modify_time}}",
"objective": "APP",
"app_promotion_type": "APP_INSTALL",
"advertiser_id": "{{advertiser_id}}"
}
}
(/code)
创建启用应用介绍页的应用安装推广系列
请求
(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": "APP_PROMOTION",
"app_promotion_type": "APP_INSTALL",
"campaign_type": "IOS14_CAMPAIGN",
"app_id": "{{app_id}}",
"campaign_app_profile_page_state":"ON",
"campaign_name": "{{campaign_name}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"is_search_campaign": false,
"is_new_structure": true,
"app_promotion_type": "APP_INSTALL",
"campaign_name": "{{campaign_name}}",
"app_id": "{{app_id}}",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"objective_type": "APP_PROMOTION",
"create_time": "{{create_time}}",
"campaign_type": "IOS14_CAMPAIGN",
"roas_bid": 0,
"is_smart_performance_campaign": false,
"budget": {{budget}},
"operation_status": "ENABLE",
"objective": "APP",
"budget_mode": "BUDGET_MODE_TOTAL",
"modify_time": "{{modify_time}}",
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"deep_bid_type": null,
"campaign_app_profile_page_state": "ON"
}
}
(/code)
创建应用再营销推广系列
请求
(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": "APP_PROMOTION",
"app_promotion_type": "APP_RETARGETING",
"campaign_type": "REGULAR_CAMPAIGN",
"campaign_name": "{{campaign_name}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"is_search_campaign": false,
"is_new_structure": true,
"app_promotion_type": "APP_RETARGETING",
"campaign_name": "{{campaign_name}}",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"objective_type": "APP_PROMOTION",
"create_time": "{{create_time}}",
"campaign_type": "REGULAR_CAMPAIGN",
"roas_bid": 0,
"is_smart_performance_campaign": false,
"budget": {{budget}},
"operation_status": "ENABLE",
"objective": "APP",
"budget_mode": "BUDGET_MODE_TOTAL",
"modify_time": "{{modify_time}}",
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"deep_bid_type": null,
"campaign_app_profile_page_state": "UNSET"
}
}
(/code)
创建应用预注册推广系列
请求
(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": "APP_PROMOTION",
"app_promotion_type": "APP_PREREGISTRATION",
"campaign_type": "REGULAR_CAMPAIGN",
"campaign_name": "{{campaign_name}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"is_advanced_dedicated_campaign": false,
"operation_status": "ENABLE",
"deep_bid_type": null,
"modify_time": "{{modify_time}}",
"is_search_campaign": false,
"advertiser_id": "{{advertiser_id}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": {{budget}},
"campaign_id": "{{campaign_id}}",
"is_smart_performance_campaign": false,
"roas_bid": 0,
"app_promotion_type": "APP_PREREGISTRATION",
"campaign_app_profile_page_state": "UNSET",
"objective_type": "APP_PROMOTION",
"objective": "LANDING_PAGE",
"campaign_type": "REGULAR_CAMPAIGN",
"is_new_structure": true,
"create_time": "{{create_time}}",
"secondary_status": "CAMPAIGN_STATUS_ENABLE",
"campaign_name": "{{campaign_name}}"
}
}
(/code)
2. 创建广告组
使用 /adgroup/create/ 接口创建一个广告组。需确保满足以下要求：
| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广对象<br>（优化位置） | <ul><li>若应用推广类型为应用安装或应用再营销： <ul><li>应用</li></ul></li><li>若应用推广类型为应用预注册：<ul><li>TikTok 即时体验页面</li></ul></li></ul>| `promotion_type` <br>`promotion_website_type` | <ul><li>若 `app_promotion_type` 为 `APP_INSTALL` 或 `APP_RETARGETING`： <ul><li>将 `promotion_type` 设置为 `APP_IOS`。</li><li>将 `promotion_website_type` 设置为 `UNSET` 或不传入本字段。</li></ul></li><li>若 `app_promotion_type` 为 `APP_PREREGISTRATION`：<ul><li>将 `promotion_type` 设置为 `WEBSITE`。</li><li>将 `promotion_website_type` 设置为 `TIKTOK_NATIVE_PAGE`。</li></ul></li></ul>|
|推广的应用 |<ul><li>若应用推广类型为应用安装：<ul><li>无需指定应用，因为已在推广系列层级指定了应用</li></ul></li><li>若应用推广类型为应用再营销或应用预注册：<ul><li>指定一个 iOS 应用</li></ul></li></ul> | `app_id` | <ul><li>若 `app_promotion_type` 为 `APP_INSTALL`： <ul><li>无需传入本字段。</li></ul></li><li> 若 `app_promotion_type` 为 `APP_RETARGETING` 或 `APP_PREREGISTRATION`： <ul><li>将本字段设置为 iOS 应用的 ID。若想获取您的广告账户下的 iOS 应用 ID，可使用 [/app/list/](1740859313270786.html)。 iOS 应用的`platform`将显示为`IOS`。</li></ul></li></ul>|
|版位 | 以下任意类型：<ul><li><b>自动版位</b></li><li><b>编辑版位</b>，且版位为仅 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>|
| 受众定向 <br>· 设备 - 系统版本| <ul><li>若应用推广类型为应用安装或应用再营销： <ul><li>iOS 15.0 及以上版本，因为自定产品页面仅支持在 iOS 15.0 及以上版本的设备上打开</li></ul></li><li> 若应用推广类型为应用预注册： <ul><li>所有版本，包括 iOS 15.0 及以上版本<br><p><span style="color: darkred"><b>注意</b></span>：在应用预注册广告组中不支持仅定向 iOS 15.0 及以上版本</li></ul></li></ul>| `operating_systems`<br> `min_ios_version`<br> `ios14_targeting` <br>`audience_type` |<ul><li> 若 `app_promotion_type` 为 `APP_INSTALL`： <ul><li>将 `operating_systems` 设置为 `["IOS"]`。</li><li>将 `ios14_targeting` 设置为 `IOS14_PLUS`。</li><li>将 `min_ios_version` 设置为 `15.0` 或以上版本。</li><li>无需传入 `audience_type`。</li></ul></li><li>若 `app_promotion_type` 为 `APP_RETARGETING`：<ul><li>将 `operating_systems` 设置为 `["IOS"]`。</li><li>将 `ios14_targeting` 设置为 `ALL`。</li><li> 将 `min_ios_version` 设置为 `15.0` 或以上版本。</li><li> 将 `audience_type` 设置为 `NEW_CUSTOM_AUDIENCE`。</li></ul></li><li>若 `app_promotion_type` 为 `APP_PREREGISTRATION`：<ul><li>将 `operating_systems` 设置为 `["IOS"]`。</li><li>无需传入 `ios14_targeting`，`min_ios_version` 和 `audience_type`。</li></ul></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}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
"location_ids": ["6252001"],
"operating_systems":["IOS"],
"ios14_targeting": "IOS14_PLUS",
"min_ios_version": "15.0",
"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": "INSTALL",
"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": {
"app_download_url": "{{app_download_url}}",
"keywords": null,
"pacing": "PACING_MODE_SMOOTH",
"auto_targeting_enabled": false,
"engaged_view_attribution_window": "SEVEN_DAYS",
"category_exclusion_ids": [],
"schedule_type": "SCHEDULE_START_END",
"share_disabled": false,
"network_types": [],
"create_time": "{{create_time}}",
"skip_learning_phase": true,
"operating_systems": [
"IOS"
],
"age_groups": null,
"campaign_id": "{{campaign_id}}",
"view_attribution_window": "ONE_DAY",
"smart_interest_behavior_enabled": null,
"gender": "GENDER_UNLIMITED",
"modify_time": "{{modify_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"excluded_audience_ids": [],
"advertiser_id": "{{advertiser_id}}",
"app_type": "APP_IOS",
"adgroup_id": "{{adgroup_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"creative_material_mode": "CUSTOM",
"optimization_event": "ACTIVE",
"is_new_structure": true,
"secondary_status": "ADGROUP_STATUS_CREATE",
"delivery_mode": null,
"adgroup_app_profile_page_type": "OFF",
"conversion_window": null,
"schedule_end_time": "{{schedule_end_time}}",
"bid_display_mode": "CPMV",
"category_id": "0",
"app_id": "{{app_id}}",
"bid_type": "BID_TYPE_NO_BID",
"isp_ids": [],
"purchased_reach": null,
"promotion_type": "APP_IOS",
"pixel_id": null,
"rf_estimated_frequency": null,
"interest_category_ids": [],
"smart_audience_enabled": null,
"conversion_bid_price": 0,
"bid_price": 0,
"purchased_impression": null,
"frequency": null,
"adgroup_name": "{{adgroup_name}}",
"scheduled_budget": 0,
"click_attribution_window": "SEVEN_DAYS",
"is_smart_performance_campaign": false,
"placements": [
"PLACEMENT_TIKTOK"
],
"statistic_type": "NONE",
"feed_type": null,
"next_day_retention": null,
"budget": {{budget}},
"adgroup_app_profile_page_state": "OFF",
"ios14_quota_type": "OCCUPIED",
"rf_purchased_type": null,
"search_result_enabled": true,
"deep_cpa_bid": 0,
"billing_event": "OCPM",
"frequency_schedule": null,
"ios14_targeting": "IOS14_PLUS",
"rf_estimated_cpr": null,
"inventory_filter_enabled": false,
"location_ids": [
"6252001"
],
"optimization_goal": "INSTALL",
"interest_keyword_ids": [],
"operation_status": "ENABLE",
"brand_safety_type": "NO_BRAND_SAFETY",
"is_hfss": false,
"languages": [],
"secondary_optimization_event": null,
"package": "{{package}}",
"schedule_infos": null,
"attribution_event_count": "ONCE",
"comment_disabled": false,
"actions": [],
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"campaign_name": "{{campaign_name}}",
"audience_ids": [],
"min_ios_version": "15.0",
"brand_safety_partner": null,
"device_price_ranges": null,
"deep_bid_type": "DEFAULT",
"video_download_disabled": false
}
}
(/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}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
"location_ids": ["6252001"],
"operating_systems":["IOS"],
"ios14_targeting": "IOS14_PLUS",
"min_ios_version": "15.0",
"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": "INSTALL",
"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": {
"app_download_url": "{{app_download_url}}",
"keywords": null,
"pacing": "PACING_MODE_SMOOTH",
"auto_targeting_enabled": false,
"engaged_view_attribution_window": "SEVEN_DAYS",
"category_exclusion_ids": [],
"schedule_type": "SCHEDULE_START_END",
"share_disabled": false,
"network_types": [],
"create_time": "{{create_time}}",
"skip_learning_phase": true,
"operating_systems": [
"IOS"
],
"age_groups": null,
"campaign_id": "{{campaign_id}}",
"view_attribution_window": "ONE_DAY",
"smart_interest_behavior_enabled": null,
"gender": "GENDER_UNLIMITED",
"modify_time": "{{modify_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"excluded_audience_ids": [],
"advertiser_id": "{{advertiser_id}}",
"app_type": "APP_IOS",
"adgroup_id": "{{adgroup_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"creative_material_mode": "CUSTOM",
"optimization_event": "ACTIVE",
"is_new_structure": true,
"secondary_status": "ADGROUP_STATUS_CREATE",
"delivery_mode": null,
"adgroup_app_profile_page_type": "ON",
"conversion_window": null,
"schedule_end_time": "{{schedule_end_time}}",
"bid_display_mode": "CPMV",
"category_id": "0",
"app_id": "{{app_id}}",
"bid_type": "BID_TYPE_NO_BID",
"isp_ids": [],
"purchased_reach": null,
"promotion_type": "APP_IOS",
"pixel_id": null,
"rf_estimated_frequency": null,
"interest_category_ids": [],
"smart_audience_enabled": null,
"conversion_bid_price": 0,
"bid_price": 0,
"purchased_impression": null,
"frequency": null,
"adgroup_name": "{{adgroup_name}}",
"scheduled_budget": 0,
"click_attribution_window": "SEVEN_DAYS",
"is_smart_performance_campaign": false,
"placements": [
"PLACEMENT_TIKTOK"
],
"statistic_type": "NONE",
"feed_type": null,
"next_day_retention": null,
"budget": {{budget}},
"adgroup_app_profile_page_state": "ON",
"ios14_quota_type": "OCCUPIED",
"rf_purchased_type": null,
"search_result_enabled": true,
"deep_cpa_bid": 0,
"billing_event": "OCPM",
"frequency_schedule": null,
"ios14_targeting": "IOS14_PLUS",
"rf_estimated_cpr": null,
"inventory_filter_enabled": false,
"location_ids": [
"6252001"
],
"optimization_goal": "INSTALL",
"interest_keyword_ids": [],
"operation_status": "ENABLE",
"brand_safety_type": "NO_BRAND_SAFETY",
"is_hfss": false,
"languages": [],
"secondary_optimization_event": null,
"package": "{{package}}",
"schedule_infos": null,
"attribution_event_count": "ONCE",
"comment_disabled": false,
"actions": [],
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"campaign_name": "{{campaign_name}}",
"audience_ids": [],
"min_ios_version": "15.0",
"brand_safety_partner": null,
"device_price_ranges": null,
"deep_bid_type": "DEFAULT",
"video_download_disabled": false
}
}
(/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}}",
"promotion_type": "APP_IOS",
"app_id": "{{app_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
"location_ids": ["6252001"],
"operating_systems": ["IOS"],
"ios14_targeting": "ALL",
"min_ios_version": "15.0",
"audience_type": "NEW_CUSTOM_AUDIENCE",
"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": "IN_APP_EVENT",
"optimization_event": "LAUNCH_APP",
"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": {
"app_download_url": "{{app_download_url}}",
"keywords": null,
"pacing": "PACING_MODE_SMOOTH",
"auto_targeting_enabled": false,
"engaged_view_attribution_window": "SEVEN_DAYS",
"category_exclusion_ids": [],
"schedule_type": "SCHEDULE_START_END",
"share_disabled": false,
"network_types": [],
"create_time": "{{create_time}}",
"skip_learning_phase": true,
"operating_systems": [
"IOS"
],
"age_groups": null,
"campaign_id": "{{campaign_id}}",
"view_attribution_window": "ONE_DAY",
"smart_interest_behavior_enabled": null,
"gender": "GENDER_UNLIMITED",
"modify_time": "{{modify_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"budget_mode": "BUDGET_MODE_TOTAL",
"excluded_audience_ids": [],
"advertiser_id": "{{advertiser_id}}",
"app_type": "APP_IOS",
"adgroup_id": "{{adgroup_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"creative_material_mode": "CUSTOM",
"optimization_event": "LAUNCH_APP",
"is_new_structure": true,
"secondary_status": "ADGROUP_STATUS_CREATE",
"delivery_mode": null,
"adgroup_app_profile_page_type": "UNSET",
"conversion_window": null,
"schedule_end_time": "{{schedule_end_time}}",
"bid_display_mode": "CPMV",
"category_id": "0",
"audience_type": "NEW_CUSTOM_AUDIENCE",
"app_id": "{{app_id}}",
"bid_type": "BID_TYPE_NO_BID",
"isp_ids": [],
"purchased_reach": null,
"promotion_type": "APP_IOS",
"pixel_id": null,
"rf_estimated_frequency": null,
"interest_category_ids": [],
"smart_audience_enabled": null,
"conversion_bid_price": 0,
"bid_price": 0,
"purchased_impression": null,
"frequency": null,
"adgroup_name": "{{adgroup_name}}",
"scheduled_budget": 0,
"click_attribution_window": "SEVEN_DAYS",
"is_smart_performance_campaign": false,
"placements": [
"PLACEMENT_TIKTOK"
],
"statistic_type": "NONE",
"feed_type": null,
"next_day_retention": null,
"budget": {{budget}},
"adgroup_app_profile_page_state": "UNSET",
"ios14_quota_type": "UNOCCUPIED",
"rf_purchased_type": null,
"search_result_enabled": true,
"deep_cpa_bid": 0,
"billing_event": "OCPM",
"frequency_schedule": null,
"ios14_targeting": "ALL",
"rf_estimated_cpr": null,
"inventory_filter_enabled": false,
"location_ids": [
"6252001"
],
"optimization_goal": "IN_APP_EVENT",
"interest_keyword_ids": [],
"operation_status": "ENABLE",
"brand_safety_type": "NO_BRAND_SAFETY",
"is_hfss": false,
"languages": [],
"secondary_optimization_event": null,
"package": "{{package}}",
"schedule_infos": null,
"attribution_event_count": "ONCE",
"comment_disabled": false,
"actions": [],
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"campaign_name": "{{campaign_name}}",
"audience_ids": [],
"min_ios_version": "15.0",
"brand_safety_partner": null,
"device_price_ranges": null,
"deep_bid_type": "AEO",
"video_download_disabled": false
}
}
(/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}}",
"promotion_type": "WEBSITE",
"promotion_website_type": "TIKTOK_NATIVE_PAGE",
"app_id": "{{app_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
"location_ids": ["6252001"],
"operating_systems": ["IOS"],
"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",
"optimization_event": "BUTTON",
"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": {
"smart_audience_enabled": null,
"placements": [
"PLACEMENT_TIKTOK"
],
"category_exclusion_ids": [],
"advertiser_id": "{{advertiser_id}}",
"bid_display_mode": "CPMV",
"inventory_filter_enabled": false,
"attribution_event_count": "ONCE",
"budget": {{budget}},
"network_types": [],
"campaign_name": "{{campaign_name}}",
"purchased_impression": null,
"delivery_mode": null,
"conversion_bid_price": 0,
"pixel_id": null,
"location_ids": [
"6252001"
],
"adgroup_app_profile_page_state": null,
"search_result_enabled": true,
"is_new_structure": true,
"optimization_event": "BUTTON",
"actions": [],
"schedule_type": "SCHEDULE_START_END",
"secondary_status": "ADGROUP_STATUS_CREATE",
"adgroup_name": "{{adgroup_name}}",
"operation_status": "ENABLE",
"age_groups": null,
"gender": "GENDER_UNLIMITED",
"smart_interest_behavior_enabled": null,
"deep_bid_type": null,
"schedule_end_time": "{{schedule_end_time}}",
"feed_type": null,
"video_download_disabled": false,
"creative_material_mode": "CUSTOM",
"ios14_quota_type": "UNOCCUPIED",
"budget_mode": "BUDGET_MODE_TOTAL",
"secondary_optimization_event": null,
"purchased_reach": null,
"brand_safety_type": "NO_BRAND_SAFETY",
"audience_ids": [],
"placement_type": "PLACEMENT_TYPE_NORMAL",
"app_download_url": "{{app_download_url}}",
"app_id": "{{app_id}}",
"promotion_website_type": "TIKTOK_NATIVE_PAGE",
"view_attribution_window": "ONE_DAY",
"adgroup_id": "{{adgroup_id}}",
"billing_event": "OCPM",
"bid_price": 0,
"skip_learning_phase": true,
"is_hfss": false,
"create_time": "{{create_time}}",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"frequency": null,
"statistic_type": null,
"interest_category_ids": [],
"optimization_goal": "CONVERT",
"device_price_ranges": null,
"comment_disabled": false,
"schedule_infos": null,
"keywords": null,
"ios14_targeting": "UNSET",
"category_id": "0",
"deep_cpa_bid": 0,
"app_type": "APP_IOS",
"rf_estimated_frequency": null,
"campaign_id": "{{campaign_id}}",
"rf_estimated_cpr": null,
"schedule_start_time": "{{schedule_start_time}}",
"brand_safety_partner": null,
"bid_type": "BID_TYPE_NO_BID",
"modify_time": "{{modify_time}}",
"package": "{{package}}",
"isp_ids": [],
"pacing": "PACING_MODE_SMOOTH",
"languages": [],
"next_day_retention": null,
"promotion_type": "WEBSITE",
"interest_keyword_ids": [],
"conversion_window": null,
"frequency_schedule": null,
"excluded_audience_ids": [],
"is_smart_performance_campaign": false,
"auto_targeting_enabled": false,
"rf_purchased_type": null,
"operating_systems": [
"IOS"
],
"scheduled_budget": 0,
"share_disabled": false,
"click_attribution_window": "SEVEN_DAYS"
}
}
(/code)
3. 创建广告
使用/ad/create/接口创建一个广告。需确保满足以下要求：
| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 目标页面 | <ul><li>若应用推广类型为应用安装：<ul><li>当推广系列层级未启用应用介绍页时，目标页面为 App Store 特定的自定产品页面。</li><li>当推广系列层级启用应用介绍页时，目标页面为应用介绍页及自定产品页面。</li></ul></li><li>若应用推广类型为应用再营销，目标页面为 App Store 特定的自定产品页面。</li><li>若应用推广类型为应用安注册，目标页面为包含自定产品页面 URL 的 TikTok 即时体验页面。</li></ul> | `page_id`<br>`cpp_url` | <ul><li>若 `app_promotion_type` 为 `APP_INSTALL`：<ul><li>当推广系列层级 `campaign_app_profile_page_state` 设置为 `OFF` 或未传入时： <ul><li>无需传入 `page_id`。</li><li>需为`cpp_url`指定合法值。</li></ul></li><li>当推广系列层级 `campaign_app_profile_page_state` 设置为 `ON` 时：<ul><li>将 `page_id` 设置为应用介绍页的 ID。<ul><li>需确保应用介绍页中的应用和所推广的应用相同。否则，将出现报错。若想获取您的广告账户下的应用介绍页的 ID，可使用[/page/get/](1820826387779586.html)，将 `business_type` 设置为 `APP_PROFILE_PAGE`。您可通过 `/page/get/` 返回的 `app_id` 获取应用介绍页中指定的应用。</li><li>目前，仅支持在[ TikTok 广告管理平台](https://ads.tiktok.com/i18n/home)创建应用介绍页。</li></ul></li><li>需为`cpp_url`指定合法值。</li></ul></li></ul></li><li> 若 `app_promotion_type` 为 `APP_RETARGETING`：<ul><li>无需传入 `page_id`。</li><li>需为 `cpp_url` 指定合法值。</li></ul></li><li>若 `app_promotion_type` 为 `APP_PREREGISTRATION`：<ul><li>将 `page_id` 设置为包含自定产品页面 URL 的 TikTok 即时体验页面的 ID。<ul><li>若想获取您的广告账户下的TikTok 即时体验页面的 ID，可使用[/page/get/](1820826387779586.html)，将`business_type`设置为`TIKTOK_INSTANT_PAGE`。对于包含自定产品页面 URL 的 TikTok 即时体验页面，`/page/get/` 返回的 `has_cpp` 字段值将为 `true`。</li><li>目前，仅支持在 [TikTok 广告管理平台](https://ads.tiktok.com/i18n/home)创建包含自定产品页面 URL 的 TikTok 即时体验页面。</li></ul></li></ul></li></ul> <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>自定产品页面 URL（`cpp_url`）需与所推广的应用（`app_id`）保持一致。</li><li>若想了解如何在 Apple App Store 中创建自定产品页面并获取对应的自定产品页面 URL，请查看[ App Store 上的自定产品页面](https://developer.apple.com/app-store/custom-product-pages/)。</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": "LEARN_MORE",
"cpp_url":"{{cpp_url}}"
}]
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"ad_ids": [
"{{ad_id}}"
],
"need_audit": false,
"creatives": [
{
"ad_name": "{{ad_name}}",
"impression_tracking_url": null,
"page_id": null,
"create_time": "{{create_time}}",
"ad_text": "{{ad_text}}",
"cpp_url": "{{cpp_url}}",
"campaign_id": "{{campaign_id}}",
"video_id": "{{video_id}}",
"modify_time": "{{modify_time}}",
"viewability_postbid_partner": "UNSET",
"advertiser_id": "{{advertiser_id}}",
"ad_id": "{{ad_id}}",
"deeplink_type": "NORMAL",
"optimization_event": "ACTIVE",
"is_new_structure": true,
"click_tracking_url": null,
"call_to_action": "LEARN_MORE",
"image_ids": [
"{{image_id}}"
],
"card_id": null,
"deeplink": "",
"tracking_app_id": "{{tracking_app_id}}",
"creative_type": null,
"vast_moat_enabled": false,
"brand_safety_vast_url": null,
"viewability_vast_url": null,
"display_name": "",
"adgroup_name": "{{adgroup_name}}",
"ad_texts": null,
"landing_page_url": "",
"app_name": "{{app_name}}",
"adgroup_id": "{{adgroup_id}}",
"call_to_action_id": null,
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}",
"{{tracking_offline_event_set_id}}"
],
"playable_url": "",
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"ad_format": "SINGLE_VIDEO",
"operation_status": "ENABLE",
"carousel_image_labels": null,
"tracking_pixel_id": 0,
"identity_type": "CUSTOMIZED_USER",
"landing_page_urls": null,
"campaign_name": "{{campaign_name}}",
"music_id": null,
"creative_authorized": false,
"profile_image_url": "{{profile_image_url}}",
"identity_id": "{{identity_id}}",
"is_aco": false
}
]
}
}
(/code)
创建启用应用介绍页的应用安装广告
请求
(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": "LEARN_MORE",
"page_id": {{page_id}},
"cpp_url":"{{cpp_url}}"
}]
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"ad_ids": [
"{{ad_id}}"
],
"need_audit": false,
"creatives": [
{
"ad_name": "{{ad_name}}",
"impression_tracking_url": null,
"page_id": {{page_id}},
"create_time": "{{create_time}}",
"ad_text": "{{ad_text}}",
"cpp_url": "{{cpp_url}}",
"campaign_id": "{{campaign_id}}",
"video_id": "{{video_id}}",
"modify_time": "{{modify_time}}",
"viewability_postbid_partner": "UNSET",
"advertiser_id": "{{advertiser_id}}",
"ad_id": "{{ad_id}}",
"deeplink_type": "NORMAL",
"optimization_event": "ACTIVE",
"is_new_structure": true,
"click_tracking_url": null,
"call_to_action": "LEARN_MORE",
"image_ids": [
"{{image_id}}"
],
"card_id": null,
"deeplink": "",
"tracking_app_id": "{{tracking_app_id}}",
"creative_type": "APP_PROMOTION",
"vast_moat_enabled": false,
"brand_safety_vast_url": null,
"viewability_vast_url": null,
"display_name": "",
"adgroup_name": "{{adgroup_name}}",
"ad_texts": null,
"landing_page_url": "",
"app_name": "{{app_name}}",
"adgroup_id": "{{adgroup_id}}",
"call_to_action_id": null,
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}",
"{{tracking_offline_event_set_id}}"
],
"playable_url": "",
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"ad_format": "SINGLE_VIDEO",
"operation_status": "ENABLE",
"carousel_image_labels": null,
"tracking_pixel_id": 0,
"identity_type": "CUSTOMIZED_USER",
"landing_page_urls": null,
"campaign_name": "{{campaign_name}}",
"music_id": null,
"creative_authorized": false,
"profile_image_url": "{{profile_image_url}}",
"identity_id": "{{identity_id}}",
"is_aco": false
}
]
}
}
(/code)
创建应用再营销广告
请求
(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": "LEARN_MORE",
"cpp_url":"{{cpp_url}}"
}]
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"ad_ids": [
"{{ad_id}}"
],
"need_audit": false,
"creatives": [
{
"ad_name": "{{ad_name}}",
"impression_tracking_url": null,
"page_id": null,
"create_time": "{{create_time}}",
"ad_text": "{{ad_text}}",
"cpp_url": "{{cpp_url}}",
"campaign_id": "{{campaign_id}}",
"video_id": "{{video_id}}",
"modify_time": "{{modify_time}}",
"viewability_postbid_partner": "UNSET",
"advertiser_id": "{{advertiser_id}}",
"ad_id": "{{ad_id}}",
"deeplink_type": "NORMAL",
"optimization_event": "LAUNCH_APP",
"is_new_structure": true,
"click_tracking_url": "{{click_tracking_url}}",
"call_to_action": "LEARN_MORE",
"image_ids": [
"{{image_id}}"
],
"card_id": null,
"deeplink": "",
"tracking_app_id": "{{tracking_app_id}}",
"creative_type": null,
"vast_moat_enabled": false,
"brand_safety_vast_url": null,
"viewability_vast_url": null,
"display_name": "",
"adgroup_name": "{{adgroup_name}}",
"ad_texts": null,
"landing_page_url": "",
"app_name": "{{app_name}}",
"adgroup_id": "{{adgroup_id}}",
"call_to_action_id": null,
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}",
"{{tracking_offline_event_set_id}}"
],
"playable_url": "",
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"ad_format": "SINGLE_VIDEO",
"operation_status": "ENABLE",
"carousel_image_labels": null,
"tracking_pixel_id": 0,
"identity_type": "CUSTOMIZED_USER",
"landing_page_urls": null,
"campaign_name": "{{campaign_name}}",
"music_id": null,
"creative_authorized": false,
"profile_image_url": "{{profile_image_url}}",
"identity_id": "{{identity_id}}",
"is_aco": false
}
]
}
}
(/code)
创建应用预注册广告
请求
(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": "LEARN_MORE",
"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": [
{
"click_tracking_url": "{{click_tracking_url}}",
"carousel_image_labels": null,
"advertiser_id": "{{advertiser_id}}",
"ad_ref_pixel_id": {{ad_ref_pixel_id}},
"campaign_name": "{{campaign_name}}",
"card_id": null,
"creative_authorized": false,
"viewability_vast_url": null,
"page_id": {{page_id}},
"landing_page_urls": null,
"is_new_structure": true,
"optimization_event": "BUTTON",
"display_name": "{{display_name}}",
"operation_status": "ENABLE",
"ad_text": "{{ad_text}}",
"adgroup_id": "{{adgroup_id}}",
"vast_moat_enabled": false,
"call_to_action": "LEARN_MORE",
"impression_tracking_url": null,
"landing_page_url": "",
"identity_type": "CUSTOMIZED_USER",
"viewability_postbid_partner": "UNSET",
"tracking_offline_event_set_ids": [
"{{tracking_offline_event_set_id}}",
"{{tracking_offline_event_set_id}}"
],
"ad_id": "{{ad_id}}",
"image_ids": [
"{{image_id}}"
],
"profile_image_url": "{{profile_image_url}}",
"is_aco": false,
"ad_texts": null,
"create_time": "{{create_time}}",
"call_to_action_id": null,
"tracking_pixel_id": 0,
"ad_format": "SINGLE_VIDEO",
"playable_url": "",
"campaign_id": "{{campaign_id}}",
"brand_safety_vast_url": null,
"creative_type": "CUSTOM_INSTANT_PAGE",
"modify_time": "{{modify_time}}",
"ad_name": "{{ad_name}}",
"adgroup_name": "{{adgroup_name}}",
"deeplink": null,
"identity_id": "{{identity_id}}",
"avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
"app_name": "",
"tracking_app_id": "{{tracking_app_id}}",
"video_id": "{{video_id}}",
"music_id": null
}
]
}
}
(/code)