TOOL API
gmv_
Gets the recommended ROI target and daily budget for a Product GMV Max or LIVE GMV Max campaign for a specific TikTok Shop. Before calling this endpoint, use /gmv_max/store/list/ to find a TikTok Shop eligible for GMV Max and confirm `is_gmv_max_available=true`.
Call information
- Tool slug
- tiktok-ads.gmv_max_bid_recommend_get
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
advertiser_idrequiredAdvertiser ID.
identity_idRequired and valid only when `shopping_ads_type` is `LIVE`. The LIVE source identity to use in a LIVE GMV Max campaign. To obtain valid identities, use /gmv_max/identity/get/ and select identities where `live_gmv_max_available` is `true`.
item_group_idsValid only when `shopping_ads_type` is `PRODUCT`. List of SPU (standard product unit) IDs for specific products to promote in a Product GMV Max campaign. If omitted, all products from the TikTok Shop are promoted. If you want to promote only specific products, pass them in this field. Maximum 50 items. To obtain eligible SPU IDs, use /store/product/get/, set `ad_creation_eligible` to `GMV_MAX`, and use `item_group_id` values where `status` is `AVAILABLE` and `gmv_max_ads_status` is `UNOCCUPIED`.
optimization_goalrequiredOptimization goal. Only `VALUE` is supported, meaning gross revenue.
shopping_ads_typerequiredType of GMV Max campaign. `PRODUCT` is for Product GMV Max campaigns. `LIVE` is for LIVE GMV Max campaigns and requires `identity_id`.
store_idrequiredTikTok Shop ID. To obtain a shop available for GMV Max campaigns, use /gmv_max/store/list/ and confirm the returned `is_gmv_max_available` is `true`.