获取覆盖和频次广告组预估信息

您可以使用本接口查询下单时的预估每日成本和频次分布。若广告组没有关联有效的预估信息，则不返回对应记录。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/adgroup/rf/estimated/info/|/v1.3/adgroup/rf/estimated/info/| |请求参数类型|advertiser_id: number<br>adgroup_ids: number[]|advertiser_id: string<br>adgroup_ids: string[]| |返回参数类型|adgroup_id: number|adgroup_id`: string|

## 请求

**地址**  https://business-api.tiktok.com/open_api/v1.3/adgroup/rf/estimated/info/

**方法**  GET

**Header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌，可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|adgroup_ids {必填}|string[]| 广告组ID。 |

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id=ADVERTISER_ID" \
--data-urlencode "adgroup_ids=[\"ADGROUP_IDS\"]" \
https://business-api.tiktok.com/open_api/v1.3/adgroup/rf/estimated/info/
(/code)

返回

|字段|类型|描述|
|---|---|---|
|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|返回数据。  |
#|estimated_info |object[]| 预估信息。 |
##|adgroup_id |string| 广告组ID。 |
##|base_info | object | 基本信息。|
###|budget | float | 总预算。 |
###|cpm |float |千次展示成本。 |
###|impression |number |总展示量，<b>以1000为单位</b>。 |
###|reach |number |总覆盖人数，<b>以1000为单位</b>。 |
###|average_frequency |float |人均展示频次 = 总展示量/总覆盖人数。 |
##|daily_cost |object| 每日成本。 |
###|cost |float| 当日成本。 |
###|date |string| 日期。 |
##|frequency_per_person |object| 人均展示频次分布。 |
###|frequency |number| 人均展示频次。 |
###|percentage |float| 当前展示频次在所有展示频次中的百分比。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {
        "estimated_info": [
            {
                "adgroup_id": 123,
                "daily_cost": [
                    {
                        "date": "2020-08-07",
                        "cost": 3587.5169107559
                    },
                    {
                        "date": "2020-08-08",
                        "cost": 3565.1767601342
                    }
                ],
                "frequency_per_person": [
                    {
                        "percentage": 0.28,
                        "frequency": 1
                    },
                    {
                        "percentage": 0.72,
                        "frequency": 2
                    }
                ]
            }
        ]
    }
    "request_id": "31C36FC53"
}
(/code);