创建已保存受众
本文介绍了如何创建已保存受众。
已保存受众
您可以使用已保存受众存储您的定向设置，并复用已保存受众创建广告组。已保存受众可以省去用于构建目标受众的重复步骤，节省时间并改善您运行推广系列的体验。
目前，已保存受众支持指定的设置包括：人口统计信息、受众、兴趣、行为和设备。欲了解选项详情，请参阅/dmp/saved_audience/create/ API接口文章。但是，不支持与家庭收入（household_income）、消费能力（spending_power）、特殊行业（special_industries）和Pangle受众包（included_pangle_audience_package_ids和 excluded_pangle_audience_package_ids）相关的选项。
注意
- 使用已保存受众前，请确保您的推广系列和广告组设置满足以下条件：
- 您的推广系列未选择房地产，就业，信贷行业类型（
specical_industries）。- 且您的推广系列的推广目标(objective_type) 不为商品销量(
PRODUCT_SALES)。- 且您的广告组选择TikTok广告位（即
placement_type设置为PLACEMENT_TYPE_AUTOMATIC；或placement_type设置为PLACEMENT_TYPE_NORMAL且placements包含PLACEMENT_TIKTOK）且您的广告组未使用自动定向(即auto_targeting_enabled未设置为true)。- 此外，Smart+ 推广系列和覆盖和频次广告不能使用已保存受众。
创建已保存受众
使用/dmp/saved_audience/create/ 创建已保存受众。若调用成功，将返回saved_audience_id，可用于创建或更新广告组。
若想获取已保存受众详情，请使用/dmp/saved_audience/list/接口。若想删除现有受众，使用/dmp/saved_audience/delete/接口。
注意
目前，暂不支持更新已保存受众。
将已保存受众应用到广告组
- 通过/campaign/create/接口创建一个推广系列。
- 通过 /adgroup/create/接口创建一个广告组。
通过传入saved_audience_id字段，您可以将已保存受众应用到广告组。与您的已保存受众关联的广告主ID须与广告组中的广告主ID相同。
注意
通过/dmp/saved_audience/create/创建已保存受众时，您可以指定gender等定向选项。但是，如果您使用已保存受众创建广告组，则必须避免同时设置saved_audience_id和已保存受众中已有的定向选项（如gender）。否则，将会出现错误。
在返回中，将返回已保存受众ID和包含在已保存受众中的定向选项。
注意
如果您的API请求引发与已保存受众配置和广告组配置之间冲突相关的错误，则当前错误消息将指示问题涉及您的受众定向选项。为解决此问题，建议使用/dmp/saved_audience/list/检查相应定向选项的详细信息，以确定问题的来源，必要时创建新的已保存受众。
请求示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/dmp/saved_audience/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_AUTOMATIC",
"app_id": "{{app_id}}",
"app_name": "{{app_name}}",
"optimization_goal": "INSTALL",
"optimization_event": "ACTIVE",
"billing_event": "OCPM",
"bid_type": "BID_TYPE_CUSTOM",
"bid_price": 1,
"conversion_bid_price": 1.0,
"budget_mode": "BUDGET_MODE_TOTAL",
"budget": 50,
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "2024-01-01 00:00:00",
"schedule_end_time": "2024-01-02 23:59:59",
"saved_audience_id": "{{saved_audience_id}}"
}'
(/code)
返回示例
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"app_id": "{{app_id}}",
"comment_disabled": false,
"saved_audience_id": "{{saved_audience_id}}",
"inventory_filter_enabled": false,
"statistic_type": "NONE",
"next_day_retention": null,
"pixel_id": null,
"carrier_ids": [
"{{carrier_ids}}"
],
"category_id": "0",
"interest_category_ids": [
"14",
"16"
],
"campaign_name": "{{campaign_name}}",
"adgroup_name": "{{adgroup_name}}",
"is_hfss": false,
"package": "{{package}}",
"campaign_id": "{{campaign_id}}",
"rf_purchased_type": null,
"app_type": "APP_ANDROID",
"scheduled_budget": 0.0,
"age_groups": [
"AGE_18_24"
],
"promotion_type": "APP_ANDROID",
"video_download_disabled": false,
"purchased_impression": null,
"deep_cpa_bid": 0.0,
"rf_estimated_cpr": null,
"keywords": null,
"conversion_bid_price": 1.0,
"schedule_type": "SCHEDULE_START_END",
"is_new_structure": true,
"audience_ids": [
"{{audience_id}}",
"{{audience_id}}"
],
"operation_status": "ENABLE",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"device_price_ranges": [
0,
50,
100,
150,
200,
250,
300,
350,
400,
450,
500,
550,
600,
650,
700,
750,
800,
850,
900,
950,
1000
],
"min_android_version": "10.0",
"schedule_infos": null,
"secondary_optimization_event": null,
"feed_type": null,
"operating_systems": [
"ANDROID"
],
"gender": "GENDER_UNLIMITED",
"adgroup_id": "{{adgroup_id}}",
"rf_estimated_frequency": null,
"creative_material_mode": "CUSTOM",
"bid_price": 0.0,
"network_types": [
"WIFI"
],
"optimization_event": "ACTIVE",
"brand_safety_type": "NO_BRAND_SAFETY",
"conversion_window": null,
"secondary_status": "ADGROUP_STATUS_CREATE",
"adgroup_app_profile_page_state": null,
"deep_bid_type": "DEFAULT",
"click_attribution_window": "SEVEN_DAYS",
"frequency_schedule": null,
"placement_type": "PLACEMENT_TYPE_AUTOMATIC",
"budget_mode": "BUDGET_MODE_TOTAL",
"placements": [
"PLACEMENT_TIKTOK",
"PLACEMENT_GLOBAL_APP_BUNDLE",
"PLACEMENT_PANGLE"
],
"ios14_quota_type": "UNOCCUPIED",
"languages": [
"en"
],
"isp_ids": [],
"schedule_start_time": "2024-01-01 00:00:00",
"schedule_end_time": "2024-01-02 23:59:59",
"modify_time": "2023-10-17 03:39:26",
"actions": [
{
"action_period": 0,
"action_category_ids": [
"2"
],
"video_user_actions": [
"FOLLOWING"
],
"action_scene": "CREATOR_RELATED"
}
],
"skip_learning_phase": true,
"bid_type": "BID_TYPE_CUSTOM",
"interest_keyword_ids": [
"{{interest_keyword_ids}}"
],
"bid_display_mode": "CPMV",
"create_time": "2023-10-17 03:39:26",
"delivery_mode": null,
"billing_event": "OCPM",
"excluded_audience_ids": [
"{{excluded_audience_ids}}",
"{{excluded_audience_ids}}"
],
"location_ids": [
"{{location_ids}}",
"{{location_ids}}"
],
"attribution_event_count": "ONCE",
"pacing": "PACING_MODE_FAST",
"budget": 50.0,
"purchased_reach": null,
"view_attribution_window": "ONE_DAY",
"frequency": null,
"share_disabled": false,
"auto_targeting_enabled": false,
"search_result_enabled": true,
"app_download_url": "{{app_download_url}}",
"category_exclusion_ids": [],
"brand_safety_partner": null,
"optimization_goal": "INSTALL",
"advertiser_id": "{{advertiser_id}}"
}
}
(/code)
- 通过/ad/create/创建广告。