获取推荐 GMV Max ROI 目标和预算

您可以使用本接口获取使用了某一 TikTok Shop 的商品 GMV Max 推广系列或直播 GMV Max 推广系列的推荐 ROI （投资回报率）目标和预算。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/gmv_max/bid/recommend/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |
| store_id {必填} | string |  TikTok Shop ID。<br><br> 若想获取可用于 GMV Max 推广系列的 TikTok Shop，可使用 [/gmv_max/store/list/](1822001044479041.html) 并确认返回的 `is_gmv_max_available` 为 `true`。  |
| shopping_ads_type {必填} | string | GMV Max 推广系列类型。<br><br>枚举值：<ul><li>`PRODUCT`：商品 GMV Max 推广系列。</li><li>`LIVE`：直播 GMV Max 推广系列。 </li></ul> |
| optimization_goal {必填} | string | 优化目标。<br><br>枚举值：<ul><li>`VALUE`：总收入。</li></ul>|
| item_group_ids  | string[] |仅当`shopping_ads_type` 为 `PRODUCT` 时生效。 <br><br>商品 SPU（标准化产品单元）ID 列表。<br><br> <ul><li>若您想在商品 GMV Max 推广系列中推广此 TikTok Shop 的所有商品，无需传入本字段。</li><li>若您想在商品 GMV Max 推广系列中推广此 TikTok Shop 的特定商品，需通过本字段指定这些商品。</li></ul><br> 最大数量：50。<br><br>若想获取某个 TikTok Shop 中商品的 SPU ID 列表，可使用[/store/product/get/](1793482248880130.html)。将 `ad_creation_eligible` 设置为 `GMV_MAX` 并从返回中挑选 `status` 为 `AVAILABLE` 且 `gmv_max_ads_status` 为 `UNOCCUPIED` 的 `item_group_id` 值。 |
|identity_id  {+条件必填} |string|仅当 `shopping_ads_type` 为 `LIVE` 时生效且必填。<br><br>直播 GMV Max 推广系列在要使用的直播来源认证身份。<br><br>若想获取直播 GMV Max 推广系列可用的认证身份，可调用[/gmv_max/identity/get/](1822001101474882.html)并挑选 `live_gmv_max_available` 为 `true` 的认证身份。|

示例

商品 GMV Max 推广系列场景

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/bid/recommend/?advertiser_id={{advertiser_id}}&store_id={{store_id}}&shopping_ads_type=PRODUCT&optimization_goal=VALUE' \
--header 'Access-Token: {{Access_Token}}'
(/code)

直播 GMV Max 推广系列场景

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/bid/recommend/?advertiser_id={{advertiser_id}}&store_id={{store_id}}&shopping_ads_type=LIVE&optimization_goal=VALUE&identity_id={{identity_id}}' \
--header 'Access-Token: {{Access_Token}}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| roas_bid | number |为优化目标总收入推荐的 ROI 目标。<br> 建议的 ROI 目标是根据您的商品类目的平均 ROI 计算得出的。|
#| budget | number | 为优化目标总收入推荐的日预算，对应币种为广告账户的币种。<br>建议的预算是根据过去 14 天您所选商品的平均广告支出或你的商品类别的平均广告支出计算得出的。建议增加预算以确保全天持续投放，因为预算越低，费用消耗得越快，还可能会限制推广系列的效果。 <br><br>若想获取某个广告账户的币种，可使用[/advertiser/info/](1739593083610113.html)并查看返回的`currency`。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "budget": 300,
        "roas_bid": 2
    }
}
(/code)