支持的维度

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

普通推广系列

普通推广系列（非 iOS 14 专属推广系列）支持以下维度：

xtable | 维度名称 {30%} | 描述 {70%} | | ---| ---- | | advertiser_id | 按广告主 ID 分组。 注意：<ul><li>若您调用[/report/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1740302766489602) （POST方法）时传入`advertiser_ids`，每个请求中可将`advertiser_id` 维度与一个 ID 维度和（或）一个时间维度组合使用。例如：`["advertiser_id", "campaign_id", "stat_time_day"]`。</li><li>[品牌任务](https://ads.tiktok.com/help/article/about-branded-mission)广告的报表数据仅支持在使用 `advertiser_id` 维度查询广告主层级数据时获取。使用 `campaign_id`、`adgroup_id` 或 `ad_id` 维度请求报表数据时，将不会返回品牌任务广告的数据。</li></ul> | | campaign_id | 按推广系列 ID 分组。 注意：<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 分组。 注意：<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 分组。 可以获取的数据类型包括：<ul><li>手动广告的广告层级数据</li><li>Smart+ 推广系列的广告层级数据</li><li>升级版 Smart+ 广告的广告（素材组）层级数据</li></ul> 注意：<ul><li>不能将此维度与 `ad_id`维度、筛选条件 `ad_ids` 或属性指标 `ad_id` 一起使用。</li></ul> | | ad_id | 按广告 ID 分组。 可以获取的数据类型包括：<ul><li>手动广告的广告层级数据</li><li>Smart+ 推广系列的广告层级数据</li><li>升级版 Smart+ 广告的素材层级数据</li></ul> 注意：<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 | 按地区代码分组。 请查看[基础报表中维度所支持指标](https://ads.tiktok.com/marketing_api/docs?id=1759239462689793)，了解本维度所支持的指标。 | | ad_type |按广告类型分组。 您可以使用本维度区分搜索广告和非搜索广告。若为搜索广告，值显示为`Search`，本维度的值非`Search`则代表广告不是搜索广告。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持所有数据层级（`data_level`= `AUCTION_CAMPAIGN` ， `AUCTION_ADGROUP`，`AUCTION_AD` 或`AUCTION_ADVERTISER`）。</li><li>请查看[基础报表中维度所支持指标 - `ad_type`支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1759239462689793#item-link-ad_type支持的指标)，了解本维度所支持的指标。</li><li>在同步基础报表中，我们支持拉取的数据最早至2022年2月22日；在异步基础报表中，我们支持拉取的数据最早至2022年3月1日。</li></ul>| | custom_event_type | 按自定义事件类型分组。 本维度支持以下指标：<ul><li>基础数据指标`clicks`</li><li>全部自定义app事件指标（具体指标详见[支持的指标 - 应用内事件数据指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)）</li><li>全部自定义页面事件指标（具体指标详见[支持的指标 - 网页事件数据指标](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553)）</li></ul>| | event_source_id | 按事件源 ID 分组。 注意：您可以查看下文的维度组合小节了解允许的组合。<ul><li>本维度支持的指标：<ul><li>全部网页事件数据指标（具体指标详见[支持的指标 - 网页事件数据指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-网页事件数据指标)）</li><li>全部应用内事件数据指标（具体指标详见[支持的指标 - 全部应用内事件数据指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-应用内事件数据指标)）</li></ul></li></ul>| | page_id| 按页面 ID 分组。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持的指标详见[基础报表中维度所支持指标 - `page_id`支持的指标](https://business-api.tiktok.com/portal/docs?id=1759239462689793#item-link-page_id支持的指标)。</li></ul>| | component_name|按 TikTok 即时表单组件名称分组。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持的指标详见[基础报表中维度所支持指标 - `component_name`支持的指标](https://business-api.tiktok.com/portal/docs?id=1759239462689793#item-link-component_name支持的指标)。</li></ul> | | room_id | 按直播间 ID 分组。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持的指标详见[基础报表中维度所支持指标 - `room_id`支持的指标](https://business-api.tiktok.com/portal/docs?id=1759239462689793#item-link-room_id支持的指标)。| | post_id | 按帖子 ID 分组。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持的指标详见[基础报表中维度所支持指标 - `post_id`支持的指标](https://business-api.tiktok.com/portal/docs?id=1759239462689793#item-link-post_id支持的指标)。| | image_id | 按图片 ID 分组。 本维度支持的指标：<ul><li>`clicks`</li><li>`single_image_impressions`</li><li>`single_image_impression_rate`</li><li>`single_image_ctr`</li></ul>| | video_material_id |按视频素材 ID 分组。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持所有数据层级（`data_level`= `AUCTION_CAMPAIGN` ， `AUCTION_ADGROUP`，`AUCTION_AD` 或`AUCTION_ADVERTISER`）。</li><li>本维度不支持下列指标：<ul><li>独立访客（UV）类指标：`reach`，`cost_per_1000_reached`，`frequency`以及当 `optimization_goal`（优化目标）为`REACH`时的成效指标： <ul><li>`result`，`cost_per_result`，`result_rate`</li><li>`real_time_result`， `real_time_cost_per_result`，`real_time_result_rate`</li><li>`secondary_goal_result`，`cost_per_secondary_goal_result`，`secondary_goal_result_rate`</li><li>`skan_result`，`skan_cost_per_result`，`skan_result_rate`</li></ul></li><li>直播指标：`live_views`，`live_unique_views`，`live_effective_views`，`live_product_clicks`</li><li>`video_views_p100`</li></ul></li></ul>| |minis_id|按 minis ID 分组。 <ul><li>使用此维度时，部分数据将使用 180 天的归因窗口进行计算。若想了解受影响的指标，可查看[使用 `minis_id` 维度时的 180 天归因窗口期指标](https://business-api.tiktok.com/portal/docs/180-day-attribution-window-metrics-together-with-the-dimension-minis_id/v1.3)。</li><li>不使用此维度时，数据将默认使用 32 天的归因窗口进行计算。</li></ul> 注意:<ul><li>只能在同步模式下使用此维度。</li><li>本维度支持所有数据层级（`data_level`= `AUCTION_CAMPAIGN` ， `AUCTION_ADGROUP`，`AUCTION_AD` 或`AUCTION_ADVERTISER`）。</li></ul>| | search_terms |按搜索词分组。 注意：<ul><li>您可以查看下文的维度组合小节了解允许的组合。</li><li>本维度支持推广系列、广告组和广告主数据层级（`data_level`= `AUCTION_CAMPAIGN` ， `AUCTION_ADGROUP`或`AUCTION_ADVERTISER`）。</li><li>请查看[基础报表中维度所支持指标 - `search_terms`支持的指标](https://ads.tiktok.com/marketing_api/docs?id=1759239462689793#item-link-search_terms支持的指标)，了解本维度所支持的指标。</li></ul>| |search_keyword|按搜索关键词分组。 注意: <ul><li>您可以查看下文的“维度组合”小节了解允许的组合。</li><li>本维度支持推广系列、广告组和广告主数据层级 (`data_level` = `AUCTION_CAMPAIGN`，`AUCTION_ADGROUP`或`AUCTION_ADVERTISER`).</li><li>本维度支持的指标为： <ul><li>`spend`</li><li>`cpc`</li><li>`cpm`</li><li>`impressions`（若展示数小于 5，则本指标的值将显示为 `"<5"` ，而非实际值。）</li><li>`clicks`</li><li>`ctr`</li></ul></li><li>在基础报表中，`search_keyword`的值为 `-1` 代表 "Unknown"（未知）。</li></ul>| |match_type|按匹配类型分组。 注意: <ul><li>您可以查看下文的“维度组合”小节了解允许的组合。</li><li>仅支持拉取 2024 年 07 月 30 日后的匹配类型细分数据。</li><li>本维度支持推广系列、广告组和广告主数据层级 (`data_level` = `AUCTION_CAMPAIGN`，`AUCTION_ADGROUP`或`AUCTION_ADVERTISER`).</li><li>本维度支持的指标为： <ul><li>`spend`</li><li>`cpc`</li><li>`cpm`</li><li>`impressions`（若展示数小于 5，则本指标的值将显示为 `"<5"` ，而非实际值。）</li><li>`clicks`</li><li>`ctr`</li></ul></li></ul>|

维度组合

支持的维度被分为 ID、时间、定向、资产和搜索维度。 - ID 维度：advertiser_id，campaign_id，adgroup_id，ad_id，ad_id_v2。 - 时间维度：stat_time_day，stat_time_hour。 - 定向维度：country_code，ad_type。 - 资产维度：custom_event_type，event_source_id，page_id，component_name，room_id，post_id，image_id，video_material_id，minis_id。 - 搜索维度：search_terms, search_keyword， match_type。

请查看下表了解不同维度类型的维度组合规则。

| 维度类别 {30%}| 组合规则 {70%}|
|---|---|
|ID & 时间| 在每个请求中，您只能传入<strong>一个</strong>ID 维度和（或） <strong>一个</strong>时间维度。<br>例如：`&#91;"campaign_id", "stat_time_day"&#93;`。|
| 定向 | 如果您要使用`country_code`维度作为分组条件，请在请求中的`dimensions`字段传入以下任一维度组合：<ul><li>仅`country_code`</li><li> `country_code` + <strong>一个</strong>ID 维度</li><li>`country_code` + <strong>一个</strong>ID 维度 + `stat_time_day`</li><li>`country_code` + `stat_time_day`</li></ul><br>如果您要使用`ad_type`维度，请在请求中的`dimensions`字段传入以下任一维度组合：<ul><li>仅`ad_type` </li><li>`ad_type` + <strong>一个</strong>ID 维度</li><li>`ad_type` + <strong>一个</strong>ID 维度 + <strong>一个</strong>时间维度</li><li>`ad_type` + <strong>一个</strong>时间维度</li></ul>|
| 资产 | <ul><li>如果您要使用`custom_event_type`，`image_id`或 `video_material_id` 作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合：<ul><li>仅`custom_event_type` / `image_id` / `video_material_id`</li><li>`custom_event_type` / `image_id` / `video_material_id`+ <strong>一个</strong>ID 维度</li><li>`custom_event_type` / `image_id` / `video_material_id`+ <strong>一个</strong>ID 维度 + `stat_time_day`</li><li>`custom_event_type` / `image_id` / `video_material_id` + `stat_time_day`</li></ul></li><li>如果您要使用`event_source_id`作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合：<ul><li>仅`event_source_id`</li><li> `event_source_id` + `custom_event_type`</li><li>`event_source_id` + `stat_time_day`</li></ul></li><li>如果您要使用`page_id`作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合：<ul><li>仅`page_id` </li><li>`page_id` + `component_name`</li><li>`page_id` + `stat_time_day`</li><li>`page_id` + `component_name` + `stat_time_day`</li></ul></li><li>如果您要使用`component_name`作为分组条件，请在请求中的`dimensions`字段传入以下任一维度组合：<ul><li>`page_id` + `component_name`</li><li> `page_id` +`component_name` + `stat_time_day`</li></ul></li><li>如果您要使用`room_id`或`post_id`作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合：<ul><li>仅`room_id`/`post_id`</li><li>`room_id`/`post_id` + `stat_time_day`</li></ul></li></ul><ul><li>如果要使用 `minis_id` 作为分组条件，可以在请求的 `dimensions` 字段传入以下任一维度组合：<ul><li>仅 `minis_id`</li><li>`minis_id` + <strong>一个</strong> ID 维度</li><li>`minis_id` + <strong>一个</strong> ID 维度 + `stat_time_day`</li><li>`minis_id` + `stat_time_day`</li></ul></li></ul>|
| 搜索 | 如果您要使用`search_terms`作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合：<ul><li>仅`search_terms`</li><li>`search_terms`+ `advertiser_id` / `campaign_id` / `adgroup_id`</li><li>`search_terms`+ `advertiser_id` / `campaign_id` / `adgroup_id` + <strong>一个</strong>时间维度</li><li>`search_terms` + <strong>一个</strong>时间维度</li></ul><br>如果您要使用 `search_keyword` 作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合： <ul><li>`search_keyword` 仅</li><li>`search_keyword` + `advertiser_id` / `campaign_id` / `adgroup_id`</li><li>`search_keyword` + `advertiser_id` / `campaign_id` / `adgroup_id` + `stat_time_day`</li><li>`search_keyword` + `stat_time_day`</li></ul><br>如果您要使用 `match_type` 作为分组条件，请在请求中的 `dimensions` 字段传入以下任一维度组合： <ul><li>`match_type` 仅</li><li>`match_type` + `advertiser_id` / `campaign_id` / `adgroup_id`</li><li>`match_type` + `advertiser_id` / `campaign_id` / `adgroup_id` + `stat_time_day`</li><li>`match_type` + `stat_time_day`</li></ul>|

正确示例：

["campaign_id"]
["stat_time_day"]
["campaign_id", "stat_time_day"]
["campaign_id", "stat_time_hour"]
["campaign_id", "country_code "]
["ad_id", "stat_time_day","country_code"]

错误示例：

["stat_time_hour" ,"country_code"]

iOS 14 专属推广系列

iOS 14 专属推广系列支持以下维度： xtable | 维度名称 {30%} | 描述 {70%} | | ---| ---- | | advertiser_id | 按广告主 ID 分组。 注意：若您调用[/report/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1740302766489602) （POST方法）时传入`advertiser_ids`，每个请求中可将`advertiser_id` 维度与一个ID维度和（或）一个时间维度组合使用。例如：`["advertiser_id", "campaign_id", "stat_time_day"]`。 | | campaign_id | 按推广系列 ID 分组。 注意：同步基础报表中默认使用`campaign_status`为`STATUS_NOT_DELETE`的筛选条件。若您想通过同步基础报表获取包括已删除推广系列的推广系列细分数据，需将`campaign_status`设置为`STATUS_ALL`。 | | adgroup_id | 按广告组 ID 分组。 注意：同步基础报表中默认使用`adgroup_status`为`STATUS_NOT_DELETE`的筛选条件。若您想通过同步基础报表获取包括已删除广告组的广告组细分数据，需将`adgroup_status`设置为`STATUS_ALL`。 | | ad_id | 按广告 ID 分组。 注意：同步基础报表中默认使用`ad_status`为`STATUS_NOT_DELETE`的筛选条件。若您想通过同步基础报表获取包括已删除广告的广告细分数据，需将`ad_status`设置为`STATUS_ALL`。 | | stat_time_day | 按天分组。 | | skan_postback_sequence | 按 SKAN 回传次序分组。本维度允许您根据 SKAN 4.0 框架中的回传次序对转化事件进行分组。SKAN 4.0框架是由苹果开发的移动归因框架，可帮助广告商衡量其推广系列的有效性。 枚举值：<ul><li>`0`：推广系列非 iOS 14 专属推广系列，因此 SKAN 回传次序不适用。</li><li>`1`：SKAN 4.0框架中的首次回传，可用于衡量从第0天到第2天发生的应用内活动。</li><li>`2`：转化事件在SKAN 4.0框架中的第二次回传中进行归因，可用于衡量从第3天到第7天发生的应用内活动。</li><li>`3`：转化事件在SKAN 4.0框架中的第三次回传中进行归因，可用于衡量从第8天到第35天发生的应用内活动。</li></ul>注意： <ul><li> 若想了解本维度支持的维度组合，请查看下文的“维度组合” 小节。</li><li>本维度支持所有数据层级（ `data_level` = `AUCTION_CAMPAIGN` ， `AUCTION_ADGROUP` ， `AUCTION_AD` 或 `AUCTION_ADVERTISER` ）。</li><li>本维度支持以下指标：<ul><li>全部基础数据指标（SKAN）。具体指标请查看[支持的指标 - 基础数据指标（SKAN）](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553#item-link-基础数据指标（SKAN）)。</li><li>全部应用内事件数据指标（SKAN）。具体指标请查看[支持的指标 - 应用内事件数据指标（SKAN）](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553#item-link-应用内事件数据指标（SKAN）)。</li><li>全部归因数据指标（SKAN）。具体指标请查看[支持的指标 - 归因数据指标 (SKAN)](https://ads.tiktok.com/marketing_api/docs?id=1751443967255553#item-link-归因数据指标（SKAN）)。</li></ul></li></ul>|

## 维度组合支持的维度被分为 ID、时间和资产维度。 - ID 维度：advertiser_id，campaign_id，adgroup_id，ad_id。 - 时间维度：stat_time_day。 - 资产维度：skan_postback_sequence。

请查看下表了解不同维度类型的维度组合规则。

| 维度类别 {30%}| 组合规则 {70%}|
|---|---|
|ID & 时间| 在每个请求中，您只能传入<strong>一个</strong>ID维度和（或） <strong>一个</strong>时间维度。<br>例如：`&#91;"campaign_id", "stat_time_day"&#93;`。|
| 资产 | 如果您要使用`skan_postback_sequence`作为分组条件，请在请求中的`dimensions` 字段传入以下任一维度组合：<ul><li>仅`skan_postback_sequence`</li><li>`skan_postback_sequence`+ <strong>一个</strong>ID 维度</li><li>`skan_postback_sequence`+ <strong>一个</strong>ID 维度 + `stat_time_day`</li><li>`skan_postback_sequence` + `stat_time_day`</li></ul>|

正确示例： - ["advertiser_id"] - ["advertiser_id", "stat_time_day"] - ["campaign_id"] - ["campaign_id", "stat_time_day"] - ["adgroup_id"] - ["adgroup_id", "stat_time_day"] - ["ad_id"] - ["ad_id", "stat_time_day"] - ["advertiser_id", "stat_time_day", "skan_postback_sequence"]