campaign_create

Advertiser ID.

Required when `campaign_type=IOS14_CAMPAIGN` and either `objective_type=PRODUCT_SALES`, or `objective_type=APP_PROMOTION` with `app_promotion_type=APP_INSTALL`. Application ID of the promoted app. You cannot use an app that has not activated the SAN module on your MMP to create iOS Dedicated Campaigns.

Required when `objective_type` is `APP_PROMOTION`. App promotion type. `APP_INSTALL` gets new users to install your app and can be used in an iOS14 Dedicated Campaign. `APP_RETARGETING` re-engages existing users and cannot be used in an iOS14 Dedicated Campaign. `APP_PREREGISTRATION` gets new users to pre-register before launch and also cannot be used in an iOS14 Dedicated Campaign. App Pre-Registration is allowlist-only.

Required when `budget_mode` is `BUDGET_MODE_DAY`, `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`, or `BUDGET_MODE_TOTAL`. Campaign budget.

Required when `objective_type` is not `RF_REACH`. When `objective_type=RF_REACH`, only `BUDGET_MODE_INFINITE` is supported. If `budget_optimize_on=true`, supported values are `BUDGET_MODE_TOTAL`, `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`, and `BUDGET_MODE_DAY`. `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` is the average daily budget over a week; daily costs do not exceed 125% of the average daily budget and weekly costs do not exceed average daily budget × 7. When `objective_type` is `TRAFFIC`, `APP_PROMOTION`, `WEB_CONVERSIONS`, `LEAD_GENERATION`, `PRODUCT_SALES` (Video Shopping Ads only), `REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT`, use `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` for a non-lifetime budget. Dynamic daily budget for `REACH`, `VIDEO_VIEWS`, and `ENGAGEMENT` is allowlist-only. If `budget_optimize_on` is not enabled, supported values are `BUDGET_MODE_INFINITE`, `BUDGET_MODE_TOTAL`, and `BUDGET_MODE_DAY`; for non-CBO campaigns, `BUDGET_MODE_DAY` is deprecated for `REACH`, `VIDEO_VIEWS`, and `ENGAGEMENT`.

Whether to enable Campaign Budget Optimization (CBO). Supported value: `true`. CBO for Video Shopping Ads with product source `CATALOG` is allowlist-only.

Whether to use App Profile Page to optimize delivery. Valid only when `objective_type=APP_PROMOTION` and the campaign is an iOS14 Dedicated Campaign; otherwise an error occurs. Default: `OFF`.

Campaign name. Maximum 512 characters. Emoji is not supported. Each Chinese or Japanese word counts as two characters; each English letter counts as one character.

Required when `objective_type=PRODUCT_SALES`. Product source of the campaign. `CATALOG` uses catalog. `STORE` uses TikTok Shop or TikTok Showcase. Product Sales is allowlist-only. For Video Shopping Ads, this setting determines allowed ad-group `product_source`: if `CATALOG`, ad groups must use `CATALOG`; if `STORE`, ad groups must use `STORE` or `SHOWCASE`.

Campaign type. `IOS14_CAMPAIGN` supports `objective_type=PRODUCT_SALES` and `objective_type=APP_PROMOTION` only when `app_promotion_type=APP_INSTALL`. If `app_promotion_type` is `APP_RETARGETING` or `APP_PREREGISTRATION`, `campaign_type` can only be `REGULAR_CAMPAIGN`. For iOS Dedicated Campaigns with other objectives, use `REGULAR_CAMPAIGN`.

Whether to use your catalog to automatically advertise relevant products or services. Supported values: `true`, `false`. Default: `false`. Set to `true` only for Automotive Ads for Inventory or Automotive Ads for Models. If `objective_type=PRODUCT_SALES` and `campaign_product_source=CATALOG`, this field is overwritten to `true`. Once set, this field cannot be updated.

Valid only when all of the following are true: `objective_type=APP_PROMOTION`, `app_promotion_type=APP_INSTALL`, `campaign_type=IOS14_CAMPAIGN`, and `app_id` is an eligible iOS app whose `/app/list/` result has `advanced_dedicated_campaign_allowed`. `true` disables SKAN attribution, removes Dedicated Campaign quota limits, and enables SAN metrics but not SKAN reporting metrics; for an app eligible for Advanced Dedicated Campaigns, you must enable SKAN attribution or Advanced Dedicated Campaign or both, so you cannot disable SKAN attribution and Advanced Dedicated Campaign simultaneously. `false` enables SKAN attribution, applies Dedicated Campaign quota limits, and enables SKAN metrics; if `is_advanced_dedicated_campaign=true` at the same time, both SAN and SKAN reporting metrics are available. Disabling SKAN attribution for Dedicated Campaigns is allowlist-only. If you are allowlisted for disabling SKAN attribution for Dedicated Campaigns, you cannot set ad-group-level `bid_type` to `BID_TYPE_CUSTOM` when `is_advanced_dedicated_campaign=false`, `disable_skan_campaign=false`, and ad-group-level `optimization_goal` is `INSTALL` or `IN_APP_EVENT`. Once set, this field cannot be updated.

Whether the campaign is an Advanced Dedicated Campaign. Supported values: `true`, `false`. Default: `false`. Once set, this field cannot be updated.

Whether to create a Search Ads Campaign. Supported values: `true`, `false`. Search Ads Campaigns are allowlist-only. Once set, this field cannot be updated.

Advertising objective.

Status of the campaign when created. Default: `ENABLE`. For Reach & Frequency campaigns, set `operation_status` to `ENABLE` or omit it; do not set `DISABLE`. To update campaign status after creation, use `/campaign/status/update/`.

PO number for invoice tracking and reconciliation.

Valid only when `campaign_type=IOS14_CAMPAIGN` and `operation_status=DISABLE`. You can set this when creating a disabled campaign or when disabling an existing campaign through `/campaign/status/update/`; the recommended practice is to set it when disabling an existing campaign. `POSTBACK_WINDOW_MODE1` secures the first SKAN 4.0 postback (0-2 day attribution window) and releases quota after up to 4 days. `POSTBACK_WINDOW_MODE2` secures the first two postbacks (3-7 day attribution window) and releases quota after up to 13 days. `POSTBACK_WINDOW_MODE3` secures all three postbacks (8-35 day attribution window) and releases quota after up to 41 days. Once set, this field cannot be updated. If `operation_status=ENABLE` or is omitted, this field is ignored. If passed when SKAN 4.0 is not enabled for the app in `app_id`, an error occurs. If omitted while `campaign_type=IOS14_CAMPAIGN`, `operation_status=DISABLE`, and SKAN 4.0 is enabled for the app, it defaults to `POSTBACK_WINDOW_MODE1`. If SKAN 4.0 is enabled for your app, target iOS 16.1+ devices at the ad group level by setting `min_ios_version` to `16.1` to receive SKAN 4.0 postbacks.

Request ID that lets you create campaigns with duplicate names and provides idempotency. To create campaigns with the same `campaign_name`, send different `request_id` values. If you retry the same request with the same `request_id` within 10 seconds, only one request succeeds. This is different from the response `request_id`, which uniquely identifies an HTTP request. Must be a string representation of a 64-bit integer, for example `123456789`.

Use only when `objective_type=RF_REACH`; do not pass this field otherwise. `STANDARD` creates a standard Reach & Frequency campaign. `PULSE` creates a TikTok Pulse campaign and is allowlist-only. This field cannot be updated after creation. If `rf_campaign_type=PULSE`, then `/adgroup/rf/create/` must use `contextual_tag_ids` of `PREMIUM` type, ad group CPM is fixed, `feed_type` in `/adgroup/rf/create/` cannot be `TOP_FEED`, and targeting locations cannot be updated in `/adgroup/rf/update/`.

Whether to use RTA bid. Supported values: `true`, `false`. Default: `false`. You can set this to `true` only when `objective_type` is `APP_PROMOTION`, `WEB_CONVERSIONS`, or `PRODUCT_SALES`, and `rta_id` is passed. This feature is allowlist-only.

Realtime API (RTA) ID, the RTA strategy identifier. This feature is allowlist-only and requires onboarding before your system can receive and respond to RTA requests.

Whether to use RTA to automatically select products. Supported values: `true`, `false`. Default: `false`. You can set this to `true` only when `objective_type=PRODUCT_SALES`, `campaign_product_source=CATALOG`, and `rta_id` is passed.

Required and valid only when `virtual_objective_type` is specified. Sales destination. `TIKTOK_SHOP` drives sales on TikTok Shop. `WEBSITE` drives sales on your website. `APP` drives sales in your app and requires a product catalog. `WEB_AND_APP` drives sales on both website and app; this Website and App Optimization option is allowlist-only.

Special ad categories. Selecting one certifies compliance with TikTok's special ad category policy and limits ad-group-level targeting options for anti-discrimination compliance. `HOUSING` is for housing-related opportunities. `EMPLOYMENT` is for jobs and related opportunities. `CREDIT` is for credit and financing opportunities. Using special ad categories in Shopping Ads with catalog product source and with non-catalog product source are separate allowlist-only features. This field is generally available to advertisers registered in America or Canada; advertisers not registered there but targeting those countries need an additional allowlist. Once selected for a campaign, special ad categories can be removed, but you cannot change them, and you cannot enable them for an existing campaign if they are currently disabled.

New objective type. Use `SALES` to create a campaign with the Sales objective, which combines Website Conversions and Product Sales objectives.