（即将废弃）获取推荐预算
重要提示
下个 API 版本中将废弃本接口。推荐您迁移至 /tool/diagnosis/get/ 接口，通过budget_edr_info获取预算预估成效结果。
您可以使用本接口获取 15 组推荐预算及对应的预估转化数据，预估数据为当日采用推荐预算后，当天的转化提升数据。
注意
- 预算预估成效结果基于您的广告组设置。若您使用本接口评估相同设置的多个广告组，仅会获取创建时间最早的广告组的预估结果。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/delivery/budget/recommend/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
| advertiser_id {必填} |string| 广告主 ID。 |
| adgroup_ids {必填} | string[] | 广告组 ID列表，ID数量最大为20。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/delivery/budget/recommend/?advertiser_id={{advertiser_id}}&adgroup_ids=["{{adgroup_id}}"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{35%}|类型{10%}|描述{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| 返回数据。 |
#| results |object[] | 广告组ID及对应的预算推荐结果列表。|
##| adgroup_id | string |广告组ID。 |
##| recommendations | object[] | 15 组推荐预算及预估成效数据，推荐预算涨幅从-20%逐步增加5%，最高推荐增加50%预算。 |
###| recommended_budget |float | 推荐预算。若需更新合适的预算，请使用 [/adgroup/budget/update/](https://ads.tiktok.com/marketing_api/docs?id=1739591133130817)接口在当天（广告主账户时区）更新。|
###| budget_increase_ratio | float | 预算增加的预估比例。 |
###| estimated_conversion | integer | 预估转化量。|
###| conversion_uplift | integer | 预估转化提升量。 |
###| conversion_uplift_ratio | float | 预估转化提升比例。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"results": [
{
"recommendations": [
{
"budget_increase_ratio": -0.2,
"conversion_uplift": 0,
"recommended_budget": 80.0,
"estimated_conversion": 39,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": -0.15,
"conversion_uplift": 0,
"recommended_budget": 85.0,
"estimated_conversion": 40,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": -0.1,
"conversion_uplift": 0,
"recommended_budget": 90.0,
"estimated_conversion": 41,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": -0.05,
"conversion_uplift": 0,
"recommended_budget": 95.0,
"estimated_conversion": 41,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.0,
"conversion_uplift": 0,
"recommended_budget": 100.0,
"estimated_conversion": 41,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.05,
"conversion_uplift": 0,
"recommended_budget": 105.0,
"estimated_conversion": 43,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.1,
"conversion_uplift": 0,
"recommended_budget": 110.0,
"estimated_conversion": 45,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.15,
"conversion_uplift": 0,
"recommended_budget": 115.0,
"estimated_conversion": 46,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.2,
"conversion_uplift": 0,
"recommended_budget": 120.0,
"estimated_conversion": 48,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.25,
"conversion_uplift": 0,
"recommended_budget": 125.0,
"estimated_conversion": 49,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.3,
"conversion_uplift": 0,
"recommended_budget": 130.0,
"estimated_conversion": 51,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.35,
"conversion_uplift": 0,
"recommended_budget": 135.0,
"estimated_conversion": 52,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.4,
"conversion_uplift": 0,
"recommended_budget": 140.0,
"estimated_conversion": 53,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.45,
"conversion_uplift": 0,
"recommended_budget": 145.0,
"estimated_conversion": 54,
"conversion_uplift_ratio": 0.0
},
{
"budget_increase_ratio": 0.5,
"conversion_uplift": 0,
"recommended_budget": 150.0,
"estimated_conversion": 55,
"conversion_uplift_ratio": 0.0
}
],
"adgroup_id": "{{adgroup_id}}"
}
]
}
}
(/code)