支持的维度

维度是数据的一项属性，用于进行数据组合。受众分析报表支持以下维度。请注意，我们尚未支持TikTok广告管理平台上的全部维度。

支持的维度

全部支持的维度枚举如下：

| 维度名称 {30%} | 描述 {70%} |
| ---| --- |
| advertiser_id | 按广告主 ID 分组。<br><br><p><span style="color:darkred"><b>注意</b></span>：[品牌任务](https://ads.tiktok.com/help/article/about-branded-mission)广告的报表数据仅支持在使用 `advertiser_id` 维度查询广告主层级数据时获取。使用 `campaign_id`、`adgroup_id` 或 `ad_id` 维度请求报表数据时，将不会返回品牌任务广告的数据。 |
| campaign_id | 按推广系列 ID 分组。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>同步受众分析报表中默认使用`campaign_status`为`STATUS_NOT_DELETE`的筛选条件。若您想通过同步受众分析报表获取包括已删除推广系列的推广系列细分数据，需将`campaign_status`设置为`STATUS_ALL`。</li><li>[品牌任务](https://ads.tiktok.com/help/article/about-branded-mission)广告的报表数据仅支持在使用 `advertiser_id` 维度查询广告主层级数据时获取。使用 `campaign_id`、`adgroup_id` 或 `ad_id` 维度请求报表数据时，将不会返回品牌任务广告的数据。</li></ul> |
| adgroup_id | 按广告组 ID 分组。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>同步受众分析报表中默认使用`adgroup_status`为`STATUS_NOT_DELETE`的筛选条件。若您想通过同步受众分析报表获取包括已删除广告组的广告组细分数据，需将`adgroup_status`设置为`STATUS_ALL`。</li><li>[品牌任务](https://ads.tiktok.com/help/article/about-branded-mission)广告的报表数据仅支持在使用 `advertiser_id` 维度查询广告主层级数据时获取。使用 `campaign_id`、`adgroup_id` 或 `ad_id` 维度请求报表数据时，将不会返回品牌任务广告的数据。</li></ul>|
| ad_id_v2 | 按广告 ID 分组。<br><br>可以获取的数据类型包括：<ul><li>手动广告的广告层级数据</li><li>Smart+ 推广系列的广告层级数据</li><li>升级版 Smart+ 广告的<b>广告（素材组）</b>层级数据</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不能将此维度与 `ad_id`维度、筛选条件 `ad_ids` 或属性指标 `ad_id` 一起使用。</li></ul> |
| ad_id | 按广告 ID 分组。<br><br>可以获取的数据类型包括：<ul><li>手动广告的广告层级数据</li><li>Smart+ 推广系列的广告层级数据</li><li>升级版 Smart+ 广告的<b>素材</b>层级数据</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>同步受众分析报表中默认使用`ad_status`为`STATUS_NOT_DELETE`的筛选条件。若您想通过同步受众分析报表获取包括已删除广告的广告细分数据，需将`ad_status`设置为`STATUS_ALL`。</li><li>[品牌任务](https://ads.tiktok.com/help/article/about-branded-mission)广告的报表数据仅支持在使用 `advertiser_id` 维度查询广告主层级数据时获取。使用 `campaign_id`、`adgroup_id` 或 `ad_id` 维度请求报表数据时，将不会返回品牌任务广告的数据。</li></ul> |
| stat_time_day | 按天分组。 |
| stat_time_hour | 按小时分组。 |
| country_code | 按地区代码分组。<br>请查看[受众分析报表中维度所支持指标](https://ads.tiktok.com/marketing_api/docs?id=1762404685488130)，了解本维度所支持的指标。 <br><p><span style="color:darkred"><b>注意</b></span>：在同步受众报表中，`country_code`的值为`None`代表"Unknown"（未知）。|
| province_id | 按地域ID分组。 获取详细信息，参阅[附录-地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)。 <br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>若您在请求的 `dimensions` 字段中使用了 `province_id` 维度，推荐您缩小查询范围，从而避免请求超时。例如，您可以使用较少的ID作为筛选条件。</li><li>在同步受众报表中，`province_id`的值为`-1`代表"Unknown"（未知）。</li></ul> |
| dma_id | 按指定市场区域分度。<br>该划分只在美国可用。<br>获取详细信息，参阅[附录-地域定向](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)。 <br><p><span style="color:darkred"><b>注意</b></span>：在同步受众报表中，`dma_id`的值为`0`代表"Unknown"（未知）。|
| ac | 按受众网络分组 |
| language | 按受众语言分组。 |
| platform | 按受众操作系统分组。 |
| interest_category |按一级兴趣定向分组。 |
| interest_category_tier2 |按二级兴趣定向分组。 |
| interest_category_tier3 | 按三级兴趣定向分组。 |
| interest_category_tier4 | 按四级兴趣定向分组。 |
| behavior_id |按行为分组。 |
| placement | 按投放版位分组。<br><p><span style="color:darkred"><b>注意</b></span>：若您想通过属性指标`placement_type`区分使用全球化应用组合版位（`PLACEMENT_GLOBAL_APP_BUNDLE` ）的广告和使用BuzzVideo/Babe版位（`PLACEMENT_TOPBUZZ`）的广告，您需要在请求中的 `dimensions`的字段中将 `placement` 与`adgroup_id` 或`ad_id`同时传入。 |
| ad_type |按广告类型分组。请查看[受众分析报表中维度所支持指标](1762404685488130.html)，了解本维度所支持的指标。  |
| device_brand_id | 按设备品牌分组。使用该维度时，`lifetime`不能为`true`。|
| contextual_tag | 按内容相关定向标签分组。 `contextual_tag` 仅支持竞价广告。您可使用[/tool/contextual_tag/get/](https://ads.tiktok.com/marketing_api/docs?id=1747747118654465)接口获取可用的内容相关定向标签列表。|
|hashtag|按话题分组。若想了解此维度支持的指标，请查看[受众分析报表中维度所支持指标-`hashtag`支持的指标](https://business-api.tiktok.com/portal/docs?id=1762404685488130#item-link-ad_type/hashtag/audience_tags/purchase_intention/支持的指标)。|
|audience_tags|按受众标签分组。若想了解此维度支持的指标，请查看[受众分析报表中维度所支持指标-`audience_tags`支持的指标](https://business-api.tiktok.com/portal/docs?id=1762404685488130#item-link-ad_type/hashtag/audience_tags/purchase_intention/支持的指标)。|
|additional_interests|按其他兴趣分组。|
|purchase_intention|按购买意向分组。若想了解此维度支持的指标，请查看[受众分析报表中维度所支持指标-`purchase_intention`支持的指标](https://business-api.tiktok.com/portal/docs?id=1762404685488130#item-link-ad_type/hashtag/audience_tags/purchase_intention/支持的指标)。<br><p><span style="color:darkred"><b>注意</b></span>：该维度仅能在异步报表中使用。|
| bucket_id | 按 RTA (实时 API) 分桶 ID 分组。RTA 分桶 ID 是一个整数，用于标识数据的流量段分组 (分桶)。Pangle 将流量划分为这些组以进行测试和优化，使您能够根据这些不同分桶的用户特征通过 RTA 调整实时出价策略，并在各种流量段上评估不同的策略。 <br><br>此维度支持的指标包括： <ul><li> `cost`</li><li>`impressions`</li><li>`clicks` </li><li>`real_time_conversion`</li></ul><br>此维度支持的维度组合为：`bucket_id` + (可选) `advertiser_id`/`campaign_id`+ (可选) `placement`/`country_code` + (可选) `stat_time_day`/`stat_time_hour`。 <br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>此维度仅可在同步报告中使用。</li><li>`bucket_id` 维度目前为白名单功能。如需使用此功能，请联系您的 TikTok 代表。</li></ul>|

维度组合

可用维度类别

ID维度 * advertiser_id * campaign_id * adgroup_id * ad_id

时间维度 * stat_time_day - stat_time_hour

受众维度

gender
age
country_code
ac
language
platform
interest_category
placement
contextual_tag （不支持与其他受众维度同时使用）
province_id
dma_id
interest_category
interest_category_tier2
interest_category_tier3
interest_category_tier4
device_brand_id
behavior_id
ad_type
hashtag
audience_tags
additional_interests
purchase_intention
bucket_id

注意
异步报表不支持查询UV类指标在受众维度下的数据。请在异步报表中仅查询UV类指标在非受众维度下的数据，或受众维度下非UV类指标的数据。

UV类指标包括："average_video_play_per_user"， "frequency"， "cost_per_1000_reached"， "real_time_result"， "real_time_result_rate"， "real_time_cost_per_result"， "result"， "result_rate"， "cost_per_result"， "reach"， "live_play_count"。

维度组合规则

允许的维度组合为一个受众维度（必填），一个ID维度（选填），和一个时间维度（选填）。单个请求中每个类型的维度仅能传入一个，唯一的例外是受众维度支持同时传入age和gender。 - 特殊情况： - 若您通过/report/task/create/ （POST方法）传入advertiser_ids，允许的维度组合为一个受众维度（必填），一个或两个ID维度（选填），和一个时间维度（选填）。当同时传入两个ID 维度时，其中之一需为advertiser_id。例如，["advertiser_id", "campaign_id", "stat_time_day", "gender"]。 - 如果您要使用地域维度作为分组条件，请在请求中的 dimensions 字段传入以下任一个维度组合： - 仅 country_code/province_id - country_code/province_id + 一个 ID 维度 - country_code/province_id + one ID dimension + stat_time_day - country_code/province_id + 一个 ID 维度 + stat_time_day - country_code + bucket_id + (可选) advertiser_id/campaign_id + (可选) stat_time_day / stat_time_hour - 维度 bucket_id 支持的维度分组是：bucket_id+ (可选) advertiser_id/campaign_id+ (可选) placement/country_code + (可选) stat_time_day/ stat_time_hour

其他维度组合规则

以下维度无法与时间维度同时使用：
interest_category
interest_category_tier2
interest_category_tier3
interest_category_tier4
device_brand_id
在同步受众分析报表中，behavior_id 可和 stat_time_day 维度同时使用，此时支持获取最多5,000个广告的报表数据，其他同步报表中支持获取最多20,000个广告的报表数据。
在受众维度中，可以同时选择年龄和性别。例如：["stat_time_day", "age", "gender"]
ad_type无法与advertiser_id在维度组合中使用。