campaign_gmv_max_create

Advertiser ID for the campaign. Before use, call `/gmv_max/store/list/` and confirm that `exclusive_authorized_advertiser_info.advertiser_id` matches this ad account; if it does not, grant exclusive GMV Max authorization for the shop with `/gmv_max/exclusive_authorization/create/` before creating the campaign.

Valid only when both `shopping_ads_type=PRODUCT` and `product_video_specific_type=AUTO_SELECTION`. In that case, the field defaults to `true`. Whether to enable affiliate posts for the Product GMV Max campaign. Supported values: `true`, `false`.

Automatic budget settings for non-promotion days.

Daily budget. Recommended values can be obtained from `/gmv_max/bid/recommend/`.

Name of the GMV Max campaign.

Bid strategy. Only `VO_MIN_ROAS` is supported, which bids with an ROI target. When `deep_bid_type` is `VO_MIN_ROAS`, `roas_bid` is required.

Required when `shopping_ads_type` is `LIVE`. Optional when `shopping_ads_type` is `PRODUCT` and `product_video_specific_type` is `AUTO_SELECTION`. For Product + `AUTO_SELECTION`, specify 0-20 identities as video-creative sources; obtain eligible identities from `/gmv_max/identity/get/` where `product_gmv_max_available=true`. If you omit `identity_list` in this mode, product images are used as ad creatives. For `shopping_ads_type=LIVE`, specify exactly one identity as the LIVE source; obtain an eligible identity from `/gmv_max/identity/get/` where `live_gmv_max_available=true`.

Required when `shopping_ads_type` is `PRODUCT` and `product_specific_type` is `CUSTOMIZED_PRODUCTS`. Product SPU IDs to promote. Maximum 400 items. Obtain eligible values from `/store/product/get/` by setting `ad_creation_eligible=GMV_MAX` and selecting `item_group_id` values where `status` is `AVAILABLE` and `gmv_max_ads_status` is `UNOCCUPIED`.

Required when `shopping_ads_type` is `PRODUCT` and `product_video_specific_type` is `CUSTOM_SELECTION`. List of authorized TikTok posts or customized TikTok posts to associate with the Product GMV Max campaign. If you want manually selected authorized posts only, provide `item_list` and do not provide `custom_anchor_video_list`. If you want manually selected customized posts, provide `item_list` and `custom_anchor_video_list` together. Maximum 50 items. Obtain eligible TikTok posts from `/gmv_max/video/get/`.

Optimization goal. Only `VALUE` is supported for GMV Max campaign creation.

Valid only when `shopping_ads_type` is `PRODUCT`. Controls how products are selected: `ALL` lets TikTok dynamically choose from all products in the shop, while `CUSTOMIZED_PRODUCTS` requires `item_group_ids`. To verify whether `ALL` is allowed for the shop, call `/gmv_max/store/shop_ad_usage_check/` and check `promote_all_products_allowed`.

Required when `shopping_ads_type` is `PRODUCT`. Video selection mode. `AUTO_SELECTION` lets TikTok auto-select videos; you may provide `identity_list` or omit it, and if `identity_list` is omitted product images are used as ad creatives. `CUSTOM_SELECTION` requires `item_list`.

Promotion-days settings for automatically optimizing for higher GMV during high-intent shopping dates. To customize budget increases during promotion days, use `budget_increase_percentage` and `increase_limit` inside this object.

Idempotency key for the create request. If you retry with the same `request_id` within the 10-second cache window, only one request succeeds; after the cache expires, the same value is treated as a new request. This is different from the response `request_id`, which identifies the HTTP request. Must be a string representation of a 64-bit integer, for example `"123456789"`.

Required when `deep_bid_type` is `VO_MIN_ROAS`. ROI target, with up to one decimal place, for example `3.2` or `3`. Recommended values can be obtained from `/gmv_max/bid/recommend/`.

Required when `schedule_type` is `SCHEDULE_START_END`. Not supported when `schedule_type` is `SCHEDULE_FROM_NOW`. Campaign delivery end time in `YYYY-MM-DD HH:MM:SS` format, UTC+0. The end time cannot be later than `2038-01-01 00:00:00`.

Campaign delivery start time in `YYYY-MM-DD HH:MM:SS` format, UTC+0. The start time can be up to 12 hours earlier than the current time, but cannot be later than `2028-01-01 00:00:00`.

Campaign schedule mode. `SCHEDULE_FROM_NOW` runs continuously after the scheduled start time. `SCHEDULE_START_END` runs between the scheduled start and end times and requires `schedule_end_time`.

GMV Max campaign type. Use `PRODUCT` for Product GMV Max campaigns or `LIVE` for LIVE GMV Max campaigns. This field controls other requirements: `product_specific_type` and `product_video_specific_type` are only used for `PRODUCT`, while `identity_list` is required for `LIVE`.

Business Center ID that is authorized to access the selected `store_id`.

TikTok Shop ID for the campaign. Obtain a shop from `/gmv_max/store/list/` and use one where `is_gmv_max_available` is `true`.