受众分析报表

受众分析报表是一种报表类型，您可以通过此类报表获取受众数据，包括年龄、性别、地区或兴趣分类。

注意

• 受众分析报表中的数据不是实时数据。有10-12小时的数据处理延迟。
• 不支持使用CHUNK模式 （query_mode= CHUNK）生成受众分析报表。CHUNK模式仅支持同步基础报表。
• 我们已优化了通过/report/integrated/get/（不带有order_field和enable_total_metrics参数）获取的、具有behavior_id维度的受众报告的报告性能。此优化将增加查询的ID数量至2000。请注意，第一个请求可能需要很长时间才能获取返回。但是，查询参数相同但页数不同的后续请求可以快速返回。
  此优化目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。一旦您进入白名单，就无需添加新的请求参数，我们将在下游自动启用参数。

支持的维度

获取受众分析报表支持的维度，请参阅此处。

支持的指标

获取受众分析报表支持的指标，请参阅此处。

支持的筛选条件

获取受众分析报表支持的筛选条件，请参阅此处。

Lifetime指标支持情况

1.3版本的受众分析报表中暂不支持Lifetime指标。

使用案例

1. 查询一段时间内受众的整体年龄分布，按消费升序排序。

请求参数：

(code json JSON)
{
    "advertiser_id": 66,
    "service_type": "AUCTION",
    "report_type": "AUDIENCE",
    "data_level": "AUCTION_ADVERTISER",
    "dimensions": [
        "age"
    ],
    "metrics": [
        "spend",
        "impressions"
    ],
    "order_field": "spend",
    "order_type": "ASC",
    "start_date": "2020-10-16",
    "end_date": "2020-10-17",
    "page": 1,
    "page_size": 100
}
(/code)

2. 查询一段时间内某些推广系列下所有未删除的广告组的地区分布。

请求参数：

(code json JSON)
{
    "advertiser_id": 66,
    "service_type": "AUCTION",
    "report_type": "AUDIENCE",
    "data_level": "AUCTION_ADGROUP",
    "dimensions": [
        "country_code",
        "adgroup_id"
    ],
    "metrics": [
        "spend",
        "impressions"
    ],
    "start_date": "2020-10-16",
    "end_date": "2020-10-16",
    "filtering": [
        {
            "field_name": "campaign_ids",
            "filter_type": "IN",
            "filter_value": "[1678604630215698,1678604630215698]"
        },
        {
            "field_name": "adgroup_status",
            "filter_type": "IN",
            "filter_value": "[\"STATUS_NOT_DELETE\"]"
        }
    ],
    "page": 1,
    "page_size": 100
}
(/code)