← 返回目录
📁 API Reference › GMV Max › Run a GMV Max Campaign report

GMV Max 推广系列报表指标

本文总结了 GMV Max 推广系列报表支持的指标类型。

GMV Max 推广系列指标概览

下列表格总结了所有可用的属性指标和投放指标。

若想查看每个指标的详细说明，以及针对所有 GMV Max 推广系列、商品 GMV Max 推广系列及直播 GMV Max 推广系列各个指标层级所支持的维度分组和筛选条件，参见对于所有 GMV Max 推广系列、对于商品 GMV Max 推广系列和 对于直播 GMV Max 推广系列。

属性指标

属性指标反映了您的推广系列、商品、创意素材、直播间及时长的核心特征。例如，推广系列 ID、推广系列名称、创意名称等均属于属性指标。

注意
您可在以下任一场景下拉取属性指标数据： - 请求推广系列层级的数据时 - 请求商品、直播间或时长层级的数据时，在筛选字段 campaign_ids 、item_group_ids 或 room_ids 中指定 1 个 ID，且在 dimensions 中仅包含 1 个 ID 维度

以下场景中不支持拉取属性指标数据： - 请求商品、创意素材、直播间或时长层级的数据时，在筛选字段 campaign_ids 、item_group_ids 或 room_ids 中指定多个 ID - 请求商品、创意素材、直播间或时长层级的数据时，在 dimensions 中包含多个 ID 维度

支持的 GMV Max 推广系列类型和指标层级 指标字段 简要描述
商品 GMV Max 推广系列，推广系列层级
 campaign_id 推广系列 ID
operation_status 推广系列开/关状态
campaign_name 推广系列名称
schedule_type 排期类型
schedule_start_time 排期起始时间
schedule_end_time 排期终止时间
target_roi_budget 目标投资回报率 (ROI) 预算
bid_type 优化模式
max_delivery_budget 最大投放量预算
商品 GMV Max 推广系列，商品层级 product_name 商品名称
item_group_id 商品 SPU ID
product_image_url 商品图片 URL
bid_type 优化模式
商品 GMV Max 推广系列，创意层级 title 创意素材名称
item_id TikTok 帖子 ID
tt_account_name TikTok 账号名称
tt_account_profile_image_url TikTok 账号头像图片 URL
tt_account_authorization_type 授权类型
shop_content_type 店铺内容类型
商品 GMV Max 推广系列，时长层级 bid_type 优化模式
直播 GMV Max 推广系列，推广系列层级 campaign_id 推广系列 ID
operation_status 推广系列开/关状态
campaign_name 推广系列名称
tt_account_name TikTok 账号名称
tt_account_profile_image_url TikTok 账号头像图片 URL
identity_id 认证身份 ID （TikTok 账号 ID）
bid_type 优化模式
schedule_type 排期类型
schedule_start_time 排期起始时间
schedule_end_time 排期终止时间
target_roi_budget 目标投资回报率 (ROI) 预算
max_delivery_budget 最大投放量预算
直播 GMV Max 推广系列，直播间层级 live_name 直播名称
live_status 直播状态
live_launched_time 直播开始时间
live_duration 直播时长
直播 GMV Max 推广系列，时长层级 bid_type 优化模式

投放指标

投放指标提供广推广系列、商品、创意、直播及时长的核心表现数据，例如成本和总收入。

支持的 GMV Max 推广系列类型和指标层级 指标字段 简要描述
所有 GMV Max 推广系列，广告账户层级
 cost 成本
orders 订单数（SKU）
cost_per_order 平均下单成本
gross_revenue 总收入
roi ROI
net_cost 净成本
商品 GMV Max 推广系列，推广系列层级 roas_bid 目标 ROI
cost 成本
net_cost 净成本
orders 订单数（SKU）
cost_per_order 平均下单成本
gross_revenue 总收入
roi ROI
商品 GMV Max 推广系列，商品层级 product_status 商品状态
orders 订单数（SKU）
gross_revenue 总收入
商品 GMV Max 推广系列，创意层级 creative_delivery_status N/A
orders 订单数（SKU）
gross_revenue 总收入
product_impressions 商品广告曝光数
product_clicks 商品广告点击数
product_click_rate 商品广告点击率
ad_click_rate 广告点击率
ad_conversion_rate 广告转化率
ad_video_view_rate_2s 2 秒广告视频播放率
ad_video_view_rate_6s 6 秒广告视频播放率
ad_video_view_rate_p25 25% 广告视频播放率
ad_video_view_rate_p50 50% 广告视频播放率
ad_video_view_rate_p75 75% 广告视频播放率
ad_video_view_rate_p100 100% 广告视频播放率
商品 GMV Max 推广系列，时长层级 cost 成本
orders 订单数（SKU）
cost_per_order 平均下单成本
gross_revenue 总收入
roi ROI
roas_bid 目标 ROI
直播 GMV Max 推广系列，推广系列层级 cost 成本
net_cost 净成本
orders 订单数（SKU）
cost_per_order 平均下单成本
gross_revenue 总收入
roi ROI
live_views 直播播放量
cost_per_live_view 直播播放平均成本
10_second_live_views 直播播放达 10 秒播放量
cost_per_10_second_live_view 直播播放达 10 秒平均成本
live_follows 直播关注数
直播 GMV Max 推广系列，直播间层级 cost 成本
net_cost 净成本
orders 订单数（SKU）
cost_per_order 平均下单成本
gross_revenue 总收入
roi ROI
live_views 直播播放量
cost_per_live_view 直播播放平均成本
10_second_live_views 直播播放达 10 秒播放量
cost_per_10_second_live_view 直播播放达 10 秒平均成本
live_follows 直播关注数
直播 GMV Max 推广系列，时长层级 cost 成本
orders 订单数（SKU）
cost_per_order 平均下单成本
gross_revenue 总收入
roi ROI

对于所有 GMV Max 推广系列

与某一 TikTok Shop 绑定的所有 GMV Max 推广系列的报表指标数据，可通过将 gmv_max_promotion_types 设置为 ["PRODUCT", "LIVE"] 或不传入 gmv_max_promotion_types 进行拉取。

概览指标

这类指标显示了与某一 TikTok Shop 绑定的 GMV Max 推广系列的总体表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

支持的维度组合

若想获取这些指标，需通过 dimensions 字段指定以下任一维度组合： - ["advertiser_id"] - ["advertiser_id","stat_time_day"] - ["advertiser_id","stat_time_hour"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| gmv_max_promotion_types | 可选   |  N/A | 指定以下任一值：<br><br><ul><li>`PRODUCT`：商品 GMV Max 推广系列。</li><li>`LIVE`：直播 GMV Max 推广系列。</li></ul>|

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| cost | string | 成本 | 在推广系列排期内您已在广告上花费的预估总金额。 |
| orders | string | 订单数（SKU） | GMV Max 推广系列期间完成的各 SKU 订单的数量，对应币种为广告账户币种。 |
| cost_per_order | string | 平均下单成本 | 每次下单所产生的平均成本，对应币种为广告账户币种。计算方法是广告总消耗（总成本）除以推广系列排期内的订单数。（广告消耗/订单数） |
| gross_revenue | string | 总收入 | 归因于推广系列的 TikTok Shop 订单的总收入，对应币种为广告账户币种。包括用户支付的金额加上 TikTok Shop 平台向用户提供的所有补贴。 |
| roi | string | ROI | 归因于推广系列的所有 TikTok Shop 订单的总投资回报率 （ROI） |
| net_cost | string | 净成本 | 不包含广告赠款和优惠券的广告消耗（总成本），对应币种为广告账户币种。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["advertiser_id", "stat_time_day"]&metrics=["cost", "orders", "cost_per_order", "gross_revenue", "roi", "net_cost"]&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "advertiser_id": "{{advertiser_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "cost": "9387.58",
                    "cost_per_order": "1.41",
                    "gross_revenue": "43117.68",
                    "net_cost": "6550.08",
                    "orders": "6674",
                    "roi": "4.59"
                }
            },
            {
                "dimensions": {
                    "advertiser_id": "{{advertiser_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "cost": "7230.56",
                    "cost_per_order": "1.44",
                    "gross_revenue": "31547.59",
                    "net_cost": "7230.56",
                    "orders": "5036",
                    "roi": "4.36"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

对于商品 GMV Max 推广系列

与某一 TikTok Shop 绑定的商品 GMV Max 推广系列的报表指标数据支持推广系列、商品、创意素材和时长层级。

推广系列层级指标（对于商品 GMV Max）

这类指标显示了商品 GMV Max 推广系列的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

支持的维度组合

若想获取商品 GMV Max 推广系列的推广系列层级指标，需通过 dimensions 字段指定以下任一维度组合：

  • ["campaign_id"]
  • ["campaign_id","stat_time_day"]
  • ["campaign_id","stat_time_hour"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| gmv_max_promotion_types | 必填   |  N/A | `["PRODUCT"]` |
| campaign_ids | 可选  | 100| 指定商品 GMV Max 推广系列的 ID 列表。<br><br>若想获取商品 GMV Max 推广系列的 ID 列表，可使用 [/gmv_max/campaign/get/](1826463372290177.html) 并将 `gmv_max_promotion_types` 设置为 `["PRODUCT_GMV_MAX"]`，同时通过 `store_ids` 指定 TikTok Shop 的 ID。 |
| campaign_name | 可选 |N/A | N/A |
| campaign_statuses | 可选  | N/A | 指定以下任一值：<ul><li>`STATUS_DELIVERY_OK`：投放中。</li><li>`STATUS_DISABLE`：未投放。</li><li>`STATUS_DELETE`：已删除。</li><li>`STATUS_NOT_DELIVERY`：未投放。</li><li>`STATUS_ALL`：全部状态。</li></ul> |

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| campaign_id | string | 推广系列 ID   | N/A |
| operation_status | string | 推广系列开/关状态 | 枚举值： <ul><li>`ENABLE`：开。</li><li>`DISABLE`：关。</li></ul>|
| campaign_name | string | 推广系列名称   | N/A |
| schedule_type | string | 排期类型 | 枚举值： <ul><li>`Continuously`：在排定的开始时间之后持续投放推广系列。</li></ul> |
| schedule_start_time | string | 排期起始时间 | 时区：UTC+0. |
| schedule_end_time | string | 排期终止时间 | 时区：UTC+0. |
| target_roi_budget | string | 目标投资回报率 (ROI) 预算   |N/A |
| bid_type | string | 优化模式 | 枚举值： <ul><li>`CUSTOM`：目标 ROI。</li><li>`NO_BID`：最大投放量。</li></ul>|
| max_delivery_budget | string | 最大投放量预算   | N/A |
| roas_bid | string | 目标 ROI   | N/A |
| cost | string | 成本 | 在推广系列排期内您已在广告上花费的估计总金额，对应币种为广告账户币种。  |
| net_cost | string | 净成本 | 不包含广告赠款和优惠券的广告消耗（广告成本），对应币种为广告账户币种。<br>该指标的数据延迟可达 11 小时，并且从 2023 年 9 月 1 日后起提供。 |
| orders | string | 订单数（SKU） | GMV Max 推广系列排期期间完成的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。<br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| cost_per_order | string | 平均下单成本 | GMV Max 推广系列排期期间的各订单的平均广告费用（不含直播订单），对应币种为广告账户币种。通过用广告总消耗除以推广系列排期内的订单数计算得出。<br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| gross_revenue | string | 总收入 | 商品 GMV Max 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。<br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| roi | string | ROI | 商品 ROI ，通过用所有归因于投放中的 GMV Max 推广系列的付费和自然销售额（不含直播订单）除以总广告费用计算得出。<br>该指标数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["campaign_id", "stat_time_day"]&metrics=["campaign_id", "operation_status", "campaign_name", "schedule_type", "schedule_start_time", "schedule_end_time", "target_roi_budget", "bid_type", "max_delivery_budget", "roas_bid", "cost", "net_cost", "orders", "cost_per_order", "gross_revenue", "roi"]&filtering={"gmv_max_promotion_types": ["PRODUCT"]}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "bid_type": "CUSTOM",
                    "campaign_id": "{{campaign_id}}",
                    "campaign_name": "{{campaign_name}}",
                    "cost": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "max_delivery_budget": "0.00",
                    "net_cost": "0.00",
                    "operation_status": "ENABLE",
                    "orders": "0",
                    "roas_bid": "5.50",
                    "roi": "0.00",
                    "schedule_end_time": "{{schedule_end_time}}",
                    "schedule_start_time": "{{schedule_start_time}}",
                    "schedule_type": "Continuously",
                    "target_roi_budget": "20000.00"
                }
            },
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "bid_type": "CUSTOM",
                    "campaign_id": "{{campaign_id}}",
                    "campaign_name": "{{campaign_name}}",
                    "cost": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "max_delivery_budget": "0.00",
                    "net_cost": "0.00",
                    "operation_status": "DISABLE",
                    "orders": "0",
                    "roas_bid": "4.50",
                    "roi": "0.00",
                    "schedule_end_time": "{{schedule_end_time}}",
                    "schedule_start_time": "{{schedule_start_time}}",
                    "schedule_type": "Continuously",
                    "target_roi_budget": "1500.00"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

商品层级指标

这类指标显示了商品 GMV Max 推广系列中商品的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

支持的维度组合

若想获取商品 GMV Max 推广系列的商品层级指标，需通过 dimensions 字段指定以下任一维度组合：

  • ["item_group_id"]
  • ["item_group_id","stat_time_day"]
  • ["item_group_id","stat_time_hour"]
  • ["campaign_id","item_group_id"]
  • ["campaign_id","item_group_id","stat_time_day"]
  • ["campaign_id","item_group_id","stat_time_hour"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| campaign_ids | 必填   | 100 | 指定一个商品 GMV Max 推广系列的 ID。<br><br>若想获取此类 ID，可先使用 `campaign_id` 维度请求<a href="#item-link-推广系列层级指标（对于商品 GMV Max）">推广系列层级指标</a>。 |

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| product_name | string | 商品名称   |N/A |
| item_group_id | string | 商品 SPU ID   |N/A |
| product_image_url | string | 商品图片 URL   |N/A |
| product_status | string | 商品状态 | 枚举值：`available`，`unavailable`。<br>示例：`available`。 |
| bid_type | string | 优化模式 | 枚举值：<ul><li> `CUSTOM`：目标 ROI</li><li> `NO_BID`：最大投放量。</li></ul> |
| cost | string | 成本 | 商品 GMV Max 推广系列排期期间，您在此商品的广告上花费的总金额。该指标的数据延迟可达 11 小时。 <br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| orders | string | 订单数（SKU） | 推广系列排期期间完成的此商品的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 |
| cost_per_order | string | 平均下单成本 | 推广系列排期期间的此商品的各订单的平均广告费用（不含直播订单），通过用总广告费用除以推广系列排期内的订单数计算得出。 <br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| gross_revenue | string | 总收入 | 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 |
| roi | string | ROI | 商品 ROI ，通过用所有归因于投放中的推广系列的付费和自然销售额（不含直播订单）除以总广告费用计算得出。 <br> 该指标数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["item_group_id","stat_time_day"]&metrics=["product_name", "item_group_id", "product_image_url", "product_status", "bid_type","cost","orders","cost_per_order", "gross_revenue", "roi"]&filtering={"campaign_ids":["{{campaign_id}}"]}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "item_group_id": "{{item_group_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "bid_type": "CUSTOM",
                    "cost": "13.86",
                    "cost_per_order": "2.77",
                    "currency": "0",
                    "gross_revenue": "55.47",
                    "item_group_id": "{{item_group_id}}",
                    "orders": "5",
                    "product_image_url": "{{product_image_url}}",
                    "product_name": "{{product_name}}",
                    "product_status": "available",
                    "roi": "4.00"
                }
            },
            {
                "dimensions": {
                    "item_group_id": "{{item_group_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "bid_type": "CUSTOM",
                    "cost": "12.11",
                    "cost_per_order": "2.02",
                    "currency": "0",
                    "gross_revenue": "69.49",
                    "item_group_id": "{{item_group_id}}",
                    "orders": "6",
                    "product_image_url": "{{product_image_url}}",
                    "product_name": "{{product_name}}",
                    "product_status": "available",
                    "roi": "5.74"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

创意素材层级指标

这类指标显示了商品 GMV Max 推广系列中创意素材的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

支持的维度组合

若想获取商品 GMV Max 推广系列的创意素材层级指标，需通过 dimensions 字段指定以下维度组合： - ["campaign_id","item_group_id","item_id"] - ["campaign_id","item_group_id","item_id","stat_time_day"] - ["item_id","stat_time_day"]

注意
如果指定维度分组 ["campaign_id","item_group_id","item_id","stat_time_day"]，API 将仅返回有消耗数据的记录。例如，对于一个包含 100 个创意的推广系列，如果其中只有 20 个产生了消耗，那么你将只会收到这 20 个创意的报表数据。

支持的筛选字段

| 筛选字段{25%} | 必填/可选/条件必填{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| campaign_ids | 必填   | 100 | 指定一个商品 GMV Max 推广系列的 ID。<br><br>若想获取此类 ID，可先使用 `campaign_id` 维度请求<a href="#item-link-推广系列层级指标（对于商品 GMV Max）">推广系列层级指标</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您使用本字段筛选了多个 ID，则不支持拉取<a href="#item-link-属性指标">属性指标</a>数据。 |
| item_group_ids | 必填   | 100 | 指定一个商品 GMV Max 推广系列中使用的 SPU 的 ID。<br><br>若想获取此类 ID，可先使用 `item_group_id` 维度请求<a href="#item-link-商品层级指标">商品层级指标</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您使用本字段筛选了多个 ID，则不支持拉取<a href="#item-link-属性指标">属性指标</a>数据。 |
| creative_types{-即将废弃} | 条件必填   | 1 | <ul><li>使用 `campaign_ids` 和 `item_group_ids` 筛选单个 SPU ID 时必填。</li><li>在 `campaign_ids` 或 `item_group_ids` 中指定多个 ID，或同时指定多个 ID 维度时不支持本字段。</li></ul><br>指定以下任一值：<ul><li>`ADS_AND_ORGANIC`：广告和原生。</li><li>`ORGANIC`：仅原生。</li><li>`REMOVED`：已移除。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：本筛选字段不支持与 `creative_delivery_statuses` 同时使用。|
| creative_delivery_statuses | 可选   | N/A |<ul><li>仅支持在以下任一场景中使用此筛选条件：<ul><li>在筛选条件 `campaign_ids` 或 `item_group_ids` 或 `campaign_ids` 和 `item_group_ids` 中指定多个 ID 时</li><li>在筛选条件 `campaign_ids` 或 `item_group_ids` 或 `campaign_ids` 和 `item_group_ids` 中指定一个 ID 时</li><li>同时指定多个 ID 维度时</li></ul></li><li>此筛选条件不可与 `creative_types` 一起使用。</li></ul><br> 指定以下一个或多个值： <ul><li>`IN_QUEUE`：排队中。作品已准备好进行转化驱动潜力测试。</li><li>`LEARNING`：学习中。作品正在接受转化驱动潜力测试。</li><li>`DELIVERING`：投放中。作品已作为推广系列的一部分进行定期推广。</li><li>`NOT_DELIVERYING`：未投放。作品在测试过程中未表现出强大的转化潜力，不会作为广告计划的一部分进行定期推广。</li><li>`AUTHORIZATION_NEEDED`：需要授权。此视频尚未被授权用于广告。您可以从 TikTok 账号授权自己的视频，或向其他达人申请授权。在授权后 20 分钟内，此处的状态将会更新。</li><li>`EXCLUDED`：已排除。作品已被手动删除，无法作为广告计划的一部分进行定期推广。您可以随时将此作品重新添加到你的广告计划中。</li><li>`UNAVAILABLE`：不可用。私密视频、被拒视频、已删除视频或来自已禁用 TikTok 账号的视频不能用于广告。在某些情况下，您可能会看到来自不可用视频的消耗，这是因为在推广系列投放期间被 TikTok 内容审核流程拒绝的视频仍可能会投放一段时间。</li><li>`REJECTED`：拒绝。视频已被内容审查团队拒绝。如果您已提交申诉，那么在申诉审核完成前，视频状态将保持为“已拒绝”。</li><li>`NOT_ACTIVE`：不活跃。此视频已被降级处理，因为它上传超过 30 天且近 30 天内未产生任何收入。</li></ul>|
| search_word | 可选 |N/A | N/A |

对于带有状态标识的创意

带有状态标识的创意素材的指标指您可为带有显示了广告创意作品在测试过程中的进展状态标识的创意所请求的指标。 

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| title | string | 创意素材名称   |N/A |
| item_id | string | TikTok 帖子 ID   |<p><span style="color:darkred"><b>注意</b></span>: 商品卡片无对应的帖子 ID。当 `shop_content_type` 为 `PRODUCT_CARD` 时，本指标值将为 `-1`。 |
| tt_account_name | string | TikTok 账号名称 |  <p><span style="color:darkred"><b>注意</b></span>: 若您的访问令牌对此 TikTok 账号无权限，本指标值将为 `0` 或 `-1`。 |
| tt_account_profile_image_url | string | TikTok 账号头像图片 URL   |N/A |
| tt_account_authorization_type | string | 授权类型 | 枚举值:<ul><li>`TTS_TT`: TikTok Shop 官方账号。</li><li>`AFFILIATE`: 联盟批量授权。</li><li>`TT_USER`: 企业号。 </li><li> `BC_AUTH_TT`: 商务中心。 </li><li>`AUTH_CODE`: 视频代码。</li><li>`UNSET`: N/A。</li></ul>|
| shop_content_type | string | 店铺内容类型 | 枚举值: <ul><li>`VIDEO`: 视频。 </li><li>`PRODUCT_CARD`: 商品卡片。 </li></ul> |
| creative_delivery_status |  string|状态 | 枚举值: <ul><li>`IN_QUEUE`：排队中。作品已准备好进行转化驱动潜力测试。</li><li>`LEARNING`：学习中。作品正在接受转化驱动潜力测试。</li><li>`DELIVERING`：投放中。作品已作为推广系列的一部分进行定期推广。</li><li>`NOT_DELIVERING`：未投放。作品在测试过程中未表现出强大的转化潜力，不会作为广告计划的一部分进行定期推广。</li><li>`AUTHORIZATION_NEEDED`：需要授权。此视频尚未被授权用于广告。您可以从 TikTok 账号授权自己的视频，或向其他达人申请授权。在授权后 20 分钟内，此处的状态将会更新。</li><li>`EXCLUDED`：已排除。作品已被手动删除，无法作为广告计划的一部分进行定期推广。您可以随时将此作品重新添加到你的广告计划中。</li><li>`UNAVAILABLE`：不可用。私密视频、被拒视频、已删除视频或来自已禁用 TikTok 账号的视频不能用于广告。在某些情况下，您可能会看到来自不可用视频的消耗，这是因为在推广系列投放期间被 TikTok 内容审核流程拒绝的视频仍可能会投放一段时间。</li><li>`REJECTED`：拒绝。视频已被内容审查团队拒绝。如果您已提交申诉，那么在申诉审核完成前，视频状态将保持为“已拒绝”。</li><li>`NOT_ACTIVE`：不活跃。此视频已被降级处理，因为它上传超过 30 天且近 30 天内未产生任何收入。</li></ul> |
| cost | string | 成本 | 在您的商品 GMV Max 推广系列排期期间，您在使用此视频的广告上花费的总金额。该指标的数据延迟可达 11 小时。 <br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| orders | string | 订单数（SKU） | 推广系列排期期间完成的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 |
| cost_per_order | string | 平均下单成本 | 推广系列排期期间的各订单的平均广告费用（不含直播订单），通过用总广告费用除以推广系列排期内的订单数计算得出。 <br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| gross_revenue | string | 总收入 | 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 |
| roi | string | ROI | 商品 ROI ，通过用所有归因于投放中的推广系列的付费和自然销售额（不含直播订单）除以总广告费用计算得出。 <br> 您的 ROI 结合了自然和付费 GMV 结果。广告支出过高可能在带来良好效果的同时降低整体 ROI。可使用总收入来评估视频质量。 |
| product_impressions | string | 商品广告曝光数 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量获得的总曝光数，不包括直播商品曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| product_clicks | string | 商品广告点击数 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量获得的总点击数，不包括直播商品点击数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| product_click_rate | string | 商品广告点击率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量获得的点击率（不包含直播点击），计算方法是商品总点击数除以商品总曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_click_rate | string | 广告点击率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量所获曝光数（不包含付费直播曝光）的点击率，计算方法是总点击数除以总曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_conversion_rate | string | 广告转化率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量所获点击（不包含付费直播点击）的转化率，计算方法是总转化数除以总点击数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_2s | string | 2 秒广告视频播放率 | 在推广系列排期期间，所选商品的视频播放至少 2 秒的次数占比，计算方法是 2 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_6s | string | 6 秒广告视频播放率 | 在推广系列排期期间，所选商品的视频播放至少 6 秒的次数占比，计算方法是 6 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p25 | string | 25% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 25% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p50 | string | 50% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 50% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p75 | string | 75% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 75% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p100 | string | 100% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 100% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |

示例

筛选多个 SPU ID 并获取投放指标

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&metrics=["creative_delivery_status","cost","orders","cost_per_order","gross_revenue","roi","product_impressions","product_clicks","product_click_rate","ad_click_rate","ad_conversion_rate","ad_video_view_rate_2s","ad_video_view_rate_6s","ad_video_view_rate_p25","ad_video_view_rate_p50","ad_video_view_rate_p75","ad_video_view_rate_p100"]&dimensions=["campaign_id","item_group_id","item_id"]&filtering={"campaign_ids":["{{campaign_id}}"],"item_group_ids":["{{item_group_id}}","{{item_group_id}}"]}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
 {
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "item_group_id": "{{item_group_id}}",
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "ad_click_rate": "16.67",
                    "ad_conversion_rate": "0.00",
                    "ad_video_view_rate_2s": "40.00",
                    "ad_video_view_rate_6s": "40.00",
                    "ad_video_view_rate_p100": "20.00",
                    "ad_video_view_rate_p25": "40.00",
                    "ad_video_view_rate_p50": "20.00",
                    "ad_video_view_rate_p75": "20.00",
                    "creative_delivery_status": "UNAVAILABLE",
                    "currency": "USD",
                    "cost": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "orders": "0",
                    "roi": "0.00"
                    "product_click_rate": "16.67",
                    "product_clicks": "1",
                    "product_impressions": "6"
                }
            },
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "item_group_id": "{{item_group_id}}",
                    "item_id": "{{item_id}}0"
                },
                "metrics": {
                    "ad_click_rate": "0.00",
                    "ad_conversion_rate": "0.00",
                    "ad_video_view_rate_2s": "0.00",
                    "ad_video_view_rate_6s": "0.00",
                    "ad_video_view_rate_p100": "0.00",
                    "ad_video_view_rate_p25": "0.00",
                    "ad_video_view_rate_p50": "0.00",
                    "ad_video_view_rate_p75": "0.00",
                    "creative_delivery_status": "UNAVAILABLE",
                    "currency": "USD",
                    "cost": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "orders": "0",
                    "roi": "0.00"
                    "product_click_rate": "0.00",
                    "product_clicks": "0",
                    "product_impressions": "0"
                }
            },
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "item_group_id": "{{item_group_id}}",
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "ad_click_rate": "0.00",
                    "ad_conversion_rate": "0.00",
                    "ad_video_view_rate_2s": "0.00",
                    "ad_video_view_rate_6s": "0.00",
                    "ad_video_view_rate_p100": "0.00",
                    "ad_video_view_rate_p25": "0.00",
                    "ad_video_view_rate_p50": "0.00",
                    "ad_video_view_rate_p75": "0.00",
                    "creative_delivery_status": "UNAVAILABLE",
                    "currency": "USD",
                    "cost": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "orders": "0",
                    "roi": "0.00"
                    "product_click_rate": "0.00",
                    "product_clicks": "0",
                    "product_impressions": "0"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 3,
            "total_page": 1
        }
    }
}
(/code)

（即将废弃）对于广告和原生创意素材

广告和原生创意素材的指标指已获授权并用于广告的所有创意素材的指标。此类型中视频的总收入包括广告和原生视频产生的销售额。 若想获取此类指标，需将筛选字段 creative_types 设置为 ["ADS_AND_ORGANIC"]。

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| title | string | 创意素材名称   |N/A |
| item_id | string | TikTok 帖子 ID   |<p><span style="color:darkred"><b>注意</b></span>: 商品卡片无对应的帖子 ID。当 `shop_content_type` 为 `PRODUCT_CARD` 时，本指标值将为 `-1`。 |
| tt_account_name | string | TikTok 账号名称 |  <p><span style="color:darkred"><b>注意</b></span>: 若您的访问令牌对此 TikTok 账号无权限，本指标值将为 `0` 或 `-1`。 |
| tt_account_profile_image_url | string | TikTok 账号头像图片 URL   |N/A |
| tt_account_authorization_type | string | 授权类型 | 枚举值:<ul><li>`TTS_TT`: TikTok Shop 官方账号。</li><li>`AFFILIATE`: 联盟批量授权。</li><li>`TT_USER`: 企业号。 </li><li> `BC_AUTH_TT`: 商务中心。 </li><li>`AUTH_CODE`: 视频代码。</li><li>`UNSET`: N/A。</li></ul>|
| shop_content_type | string | 店铺内容类型 | 枚举值: <ul><li>`VIDEO`: 视频。 </li><li>`PRODUCT_CARD`: 商品卡片。 </li></ul> |
| orders | string | 订单数（SKU） | 推广系列排期期间完成的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 |
| gross_revenue | string | 总收入 | 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 |
| product_impressions | string | 商品广告曝光数 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费和自然流量获得的总曝光数，不包括直播商品曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| product_clicks | string | 商品广告点击数 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费和自然流量获得的总点击数，不包括直播商品点击数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| product_click_rate | string | 商品广告点击率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费和自然流量获得的点击率（不包含直播点击），计算方法是商品总点击数除以商品总曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_click_rate | string | 广告点击率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量所获曝光数（不包含付费直播曝光）的点击率，计算方法是总点击数除以总曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_conversion_rate | string | 广告转化率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量所获点击（不包含付费直播点击）的转化率，计算方法是总转化数除以总点击数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_2s | string | 2 秒广告视频播放率 | 在推广系列排期期间，所选商品的视频播放至少 2 秒的次数占比，计算方法是 2 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_6s | string | 6 秒广告视频播放率 | 在推广系列排期期间，所选商品的视频播放至少 6 秒的次数占比，计算方法是 6 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p25 | string | 25% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 25% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p50 | string | 50% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 50% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p75 | string | 75% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 75% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p100 | string | 100% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 100% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["item_id"]&metrics=["title","item_id","tt_account_name","tt_account_profile_image_url","tt_account_authorization_type","shop_content_type","orders","gross_revenue","product_impressions","product_clicks","product_click_rate","ad_click_rate","ad_conversion_rate","ad_video_view_rate_2s","ad_video_view_rate_6s","ad_video_view_rate_p25","ad_video_view_rate_p50","ad_video_view_rate_p75","ad_video_view_rate_p100"]&filtering={"campaign_ids":["{{campaign_id}}"], "item_group_ids": ["{{item_group_id}}"], "creative_types": ["ADS_AND_ORGANIC"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "ad_click_rate": "0.94",
                    "ad_conversion_rate": "0.00",
                    "ad_video_view_rate_2s": "11.92",
                    "ad_video_view_rate_6s": "3.97",
                    "ad_video_view_rate_p100": "0.70",
                    "ad_video_view_rate_p25": "7.71",
                    "ad_video_view_rate_p50": "3.27",
                    "ad_video_view_rate_p75": "1.87",
                    "gross_revenue": "0.00",
                    "item_id": "{{item_id}}",
                    "orders": "0",
                    "product_click_rate": "0.94",
                    "product_clicks": "5",
                    "product_impressions": "531",
                    "shop_content_type": "VIDEO",
                    "title": "{{title}}",
                    "tt_account_authorization_type": "BC_AUTH_TT",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            },
            {
                "dimensions": {
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "ad_click_rate": "0.00",
                    "ad_conversion_rate": "0.00",
                    "ad_video_view_rate_2s": "8.33",
                    "ad_video_view_rate_6s": "0.00",
                    "ad_video_view_rate_p100": "0.00",
                    "ad_video_view_rate_p25": "0.00",
                    "ad_video_view_rate_p50": "0.00",
                    "ad_video_view_rate_p75": "0.00",
                    "gross_revenue": "0.00",
                    "item_id": "{{item_id}}",
                    "orders": "0",
                    "product_click_rate": "0.00",
                    "product_clicks": "0",
                    "product_impressions": "15",
                    "shop_content_type": "VIDEO",
                    "title": "{{title}}",
                    "tt_account_authorization_type": "AFFILIATE",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

（即将废弃）对于仅原生创意素材

仅原生创意素材的指标指仅用于自然流量的视频的指标。此类型中视频的总收入仅包括原生视频产生的销售额。

若想获取此类指标，需将筛选字段 creative_types 设置为 ["ORGANIC"]。

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| title | string | 创意素材名称   | N/A |
| item_id | string | TikTok 帖子 ID   | N/A |
| tt_account_name | string | TikTok 账号名称  | N/A |
| tt_account_profile_image_url | string | TikTok 账号头像图片 URL  | N/A |
| shop_content_type | string | 店铺内容类型 | 枚举值: <ul><li>`VIDEO`: 视频。 </li></ul> |
| orders | string | 订单数（SKU） | 推广系列排期期间完成的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 |
| gross_revenue | string | 总收入 | 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["item_id"]&metrics=["title","item_id","tt_account_name","tt_account_profile_image_url","shop_content_type","orders","gross_revenue"]&filtering={"campaign_ids":["{{campaign_id}}"], "item_group_ids": ["{{item_group_id}}"], "creative_types": ["ORGANIC"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "gross_revenue": "0.00",
                    "item_id": "{{item_id}}",
                    "orders": "0",
                    "shop_content_type": "VIDEO",
                    "title": "{{title}}",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            },
            {
                "dimensions": {
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "gross_revenue": "13.56",
                    "item_id": "{{item_id}}",
                    "orders": "2",
                    "shop_content_type": "VIDEO",
                    "title": "{{title}}",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

（即将废弃）对于已移除创意素材

已移除创意素材的指标指自动选择的、但已从您的推广系列中手动移除的视频的指标。

若想获取此类指标，需将筛选字段 creative_types 设置为 ["REMOVED"]。

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| title | string | 创意素材名称   |N/A |
| item_id | string | TikTok 帖子 ID   |<p><span style="color:darkred"><b>注意</b></span>: 商品卡片无对应的帖子 ID。当 `shop_content_type` 为 `PRODUCT_CARD` 时，本指标值将为 `-1`。 |
| tt_account_name | string | TikTok 账号名称 |  <p><span style="color:darkred"><b>注意</b></span>: 若您的访问令牌对此 TikTok 账号无权限，本指标值将为 `0` 或 `-1`。 |
| tt_account_profile_image_url | string | TikTok 账号头像图片 URL   |N/A |
| tt_account_authorization_type | string | 授权类型 | 枚举值:<ul><li>`TTS_TT`: TikTok Shop 官方账号。</li><li>`AFFILIATE`: 联盟批量授权。</li><li>`TT_USER`: 企业号。 </li><li> `BC_AUTH_TT`: 商务中心。 </li><li>`AUTH_CODE`: 视频代码。</li><li>`UNSET`: N/A。</li></ul>|
| shop_content_type | string | 店铺内容类型 | 枚举值: <ul><li>`VIDEO`: 视频。 </li><li>`PRODUCT_CARD`: 商品卡片。 </li></ul> |
| orders | string | 订单数（SKU） | 推广系列排期期间完成的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 |
| gross_revenue | string | 总收入 | 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 |
| product_impressions | string | 商品广告曝光数 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费和自然流量获得的总曝光数，不包括直播商品曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| product_clicks | string | 商品广告点击数 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费和自然流量获得的总点击数，不包括直播商品点击数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| product_click_rate | string | 商品广告点击率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费和自然流量获得的点击率（不包含直播点击），计算方法是商品总点击数除以商品总曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_click_rate | string | 广告点击率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量所获曝光数（不包含付费直播曝光）的点击率，计算方法是总点击数除以总曝光数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_conversion_rate | string | 广告转化率 | 在商品 GMV Max 推广系列排期期间，此视频中所选商品通过付费流量所获点击（不包含付费直播点击）的转化率，计算方法是总转化数除以总点击数。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_2s | string | 2 秒广告视频播放率 | 在推广系列排期期间，所选商品的视频播放至少 2 秒的次数占比，计算方法是 2 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_6s | string | 6 秒广告视频播放率 | 在推广系列排期期间，所选商品的视频播放至少 6 秒的次数占比，计算方法是 6 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p25 | string | 25% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 25% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p50 | string | 50% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 50% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p75 | string | 75% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 75% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |
| ad_video_view_rate_p100 | string | 100% 广告视频播放率 | 在推广系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 100% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。<br>推广系列数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["item_id"]&metrics=["title","item_id","tt_account_name","tt_account_profile_image_url","tt_account_authorization_type","shop_content_type","orders","gross_revenue","product_impressions","product_clicks","product_click_rate","ad_click_rate","ad_conversion_rate","ad_video_view_rate_2s","ad_video_view_rate_6s","ad_video_view_rate_p25","ad_video_view_rate_p50","ad_video_view_rate_p75","ad_video_view_rate_p100"]&filtering={"campaign_ids":["{{campaign_id}}"], "item_group_ids": ["{{item_group_id}}"], "creative_types": ["REMOVED"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "ad_click_rate": "1.02",
                    "ad_conversion_rate": "0.00",
                    "ad_video_view_rate_2s": "25.00",
                    "ad_video_view_rate_6s": "9.38",
                    "ad_video_view_rate_p100": "1.04",
                    "ad_video_view_rate_p25": "4.17",
                    "ad_video_view_rate_p50": "2.08",
                    "ad_video_view_rate_p75": "2.08",
                    "gross_revenue": "0.00",
                    "item_id": "{{item_id}}",
                    "orders": "0",
                    "product_click_rate": "1.02",
                    "product_clicks": "1",
                    "product_impressions": "98",
                    "shop_content_type": "VIDEO",
                    "title": "{{title}}",
                    "tt_account_authorization_type": "AFFILIATE",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            },
            {
                "dimensions": {
                    "item_id": "{{item_id}}"
                },
                "metrics": {
                    "ad_click_rate": "1.73",
                    "ad_conversion_rate": "8.33",
                    "ad_video_view_rate_2s": "35.09",
                    "ad_video_view_rate_6s": "7.67",
                    "ad_video_view_rate_p100": "0.85",
                    "ad_video_view_rate_p25": "5.28",
                    "ad_video_view_rate_p50": "3.24",
                    "ad_video_view_rate_p75": "1.70",
                    "gross_revenue": "0.00",
                    "item_id": "{{item_id}}",
                    "orders": "0",
                    "product_click_rate": "1.73",
                    "product_clicks": "12",
                    "product_impressions": "692",
                    "shop_content_type": "VIDEO",
                    "title": "{{title}}",
                    "tt_account_authorization_type": "AFFILIATE",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

时长层级指标

这类指标显示了商品 GMV Max 推广系列的时长的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

  • 若整个推广系列排期期间优化模式保持不变，您将看到一条记录，对应所配置的优化模式。
  • 若整个推广系列排期期间修改了优化模式，您将看到多个记录，每条记录对应所使用的优化模式。

例如，若您一开始将优化模式设置为目标 ROI，随后切换为最大投放量，您将看到两条单独的记录：一条对应使用目标 ROI 的时间段，另一条对应最大投放量。

支持的维度组合

若想获取商品 GMV Max 推广系列的时长层级指标，需通过 dimensions 字段指定以下任一维度组合： - ["duration"] - ["campaign_id","duration"] - ["item_group_id","duration"] - ["campaign_id","item_group_id","duration"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| campaign_ids | 必填 | 100 | 指定一个商品 GMV Max 推广系列的 ID。<br><br> 若要获取此类 ID，可先使用 `campaign_id` 维度请求<a href="#item-link-推广系列层级指标（对于商品 GMV Max）">推广系列层级指标</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您使用本字段筛选了多个 ID，则不支持拉取<a href="#item-link-属性指标">属性指标</a>数据。 |
| item_group_ids | 必填 | 100 | 指定一个商品 GMV Max 推广系列中使用的 SPU 的 ID。<br><br> 若要获取此类 ID，可先使用 `item_group_id` 维度请求<a href="#item-link-商品层级指标">商品层级指标</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您使用本字段筛选了多个 ID，则不支持拉取<a href="#item-link-属性指标">属性指标</a>数据。 |

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| bid_type | string | 优化模式 | 枚举值：<ul><li>`CUSTOM`：目标 ROI。</li><li>`NO_BID`：最大投放量。</li></ul>|
| cost | string | 成本 | 商品 GMV Max 推广系列排期期间，您在此商品的广告上花费的总金额，对应币种为广告账户币种。<br>注意，该指标的数据延迟可达 11 小时。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| orders | string | 订单数（SKU） | 推广系列排期期间完成的此商品的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 |
| cost_per_order | string | 平均下单成本 | 推广系列排期期间的此商品的各订单的平均广告费用（不含直播订单），对应币种为广告账户币种。通过用总广告费用除以推广系列排期内的订单数计算得出。<br>注意，该指标的数据延迟可达 11 小时。 |
| gross_revenue | string | 总收入 | 推广系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 |
| roi | string | ROI | 商品 ROI ，通过用所有归因于投放中的推广系列的付费和自然销售额（不含直播订单）除以总广告费用计算得出。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["duration"]&metrics=["bid_type", "cost", "orders", "cost_per_order", "gross_revenue", "roi"]&filtering={"campaign_ids":["{{campaign_id}}"], "item_group_ids": ["{{item_group_id}}"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "duration": "{{duration}}"
                },
                "metrics": {
                    "bid_type": "CUSTOM",
                    "cost": "1428.80",
                    "cost_per_order": "2.62",
                    "gross_revenue": "6141.15",
                    "orders": "545",
                    "roi": "4.30"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 1,
            "total_page": 1
        }
    }
}
(/code)

对于直播 GMV Max 推广系列

与某一 TikTok Shop 绑定的直播 GMV Max 推广系列的报表指标数据支持推广系列、直播间和时长层级。

推广系列层级指标（对于直播 GMV Max）

这类指标显示了直播 GMV Max 推广系列的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

支持的维度组合

若想获取直播 GMV Max 推广系列的推广系列层级指标，需通过 dimensions 字段指定以下任一维度组合：

  • ["campaign_id"]
  • ["campaign_id","stat_time_day"]
  • ["campaign_id","stat_time_hour"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| gmv_max_promotion_types | 必填 | N/A | `["LIVE"]` |
| campaign_ids | 可选 | 100 | 指定直播 GMV Max 推广系列的 ID 列表。<br><br> 若要获取直播 GMV Max 推广系列的 ID 列表，可使用  [/gmv_max/campaign/get/](1826463372290177.html) 并将 `gmv_max_promotion_types` 设置为 `["LIVE_GMV_MAX"]`，同时通过 `store_ids` 指定 TikTok Shop 的 ID。 |
| campaign_name | 可选 | N/A | N/A |
| campaign_statuses | 可选 | N/A | 指定以下任一值：<ul><li>`STATUS_DELIVERY_OK`：投放中。</li><li>`STATUS_DISABLE`：未投放。</li><li> `STATUS_DELETE`：已删除。</li><li>`STATUS_NOT_DELIVERY`：未投放。</li><li>`STATUS_ALL`：全部状态。</li></ul>|

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| campaign_id | string | 推广系列 ID | N/A |
| operation_status | string | 推广系列开/关状态 | 枚举值：<ul><li>`ENABLE`：开。</li><li>`DISABLE`：关。</li></ul>|
| campaign_name | string | 推广系列名称 | N/A |
| tt_account_name | string | TikTok 账号名称 | <p><span style="color:darkred"><b>注意</b></span>：若您的访问令牌对此 TikTok 账号无权限，本指标值将为 `0` 或 `-1`。 |
| tt_account_profile_image_url | string | TikTok 账号头像图片 URL | N/A |
| identity_id | string | 认证身份 ID （TikTok 账号 ID） | <p><span style="color:darkred"><b>注意</b></span>：若您的访问令牌对此 TikTok 账号无权限，本指标值将为 `0` 或 `-1`。 |
| bid_type | string | 优化模式 | 枚举值：<ul><li>`CUSTOM`：目标 ROI。</li><li>`NO_BID`：最大投放量。</li></ul>|
| schedule_type | string | 排期类型 | 枚举值：<ul><li>`Continuously`：在排定的开始时间之后持续投放推广系列。</li></ul> |
| schedule_start_time | string | 排期起始时间 | 时区：UTC+0。 |
| schedule_end_time | string | 排期终止时间 | 时区：UTC+0。 |
| target_roi_budget | string | 目标 ROI 预算 | N/A |
| max_delivery_budget | string | 最大投放量预算 | N/A |
| roas_bid | string | 目标 ROI | N/A |
| cost | string | 成本 | 在推广系列排期内您已在广告上花费的估计总金额，对应币种为广告账户币种。 |
| net_cost | string | 净成本 | 不包含广告赠款和优惠券的广告消耗（广告成本），对应币种为广告账户币种。<br>注意，该指标的数据延迟可达 11 小时，并且从 2023 年 9 月 1 日后起提供。 |
| cost_per_order | string | 平均下单成本（当前店铺） | 每次下单所产生的平均成本。计算方法是，广告总成本除以广告排期内下达的订单数。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| orders | string | 订单数（当前店铺） | GMV Max 推广系列期间完成的各 SKU 付费和自然直播订单的数量。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| gross_revenue | string | 总收入（当前店铺） | 归因于推广系列的所有店铺订单的总收入。这是指用户支付的金额加上平台向用户提供的所有店铺价格补贴。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| roi | string | 投资回报率 (ROI)（当前店铺） | 归因于推广系列的所有店铺订单的总投资回报率 (ROI)。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| all_shops_cost_per_order | double | 平均下单成本 | 在推广系列排期期间各直播订单的平均广告费用，对应币种为广告账户币种。通过用总广告费用除以推广系列排期内的订单数计算得出。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_orders | integer | 订单数 | 在推广系列排期期间完成的各付费和自然直播订单的数量。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_gross_revenue | double | 总收入 | 在推广系列排期期间的 TikTok Shop 付费和自然直播订单的总收入，对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有补贴计算得出。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_roi | double | ROI | 在推广系列排期期间完成的所有 TikTok Shop 付费和自然直播订单的总投资回报率（ROI）。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| live_views | string | 直播播放量 | 在推广系列排期期间，您的直播的播放次数。同一用户的多次播放将分别统计。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| cost_per_live_view | string | 直播播放平均成本 | 在推广系列排期期间，每次直播播放的平均成本，对应币种为广告账户币种。通过总成本除以直播总播放量计算得出。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| 10_second_live_views | string | 直播播放达 10 秒播放量 | 在推广系列排期期间，您的直播播放至少 10 秒的次数。同一用户的多次播放将分别统计。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| cost_per_10_second_live_view | string | 直播播放达 10 秒平均成本 | 每次直播播放达 10 秒的平均成本，对应币种为广告账户币种。通过总成本除以直播播放达 10 秒总播放量计算得出。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| live_follows | string | 直播关注数 | 在您的直播期间关注您的主页的用户总数。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["campaign_id","stat_time_day"]&metrics=["campaign_id", "operation_status", "campaign_name", "tt_account_name", "tt_account_profile_image_url", "identity_id", "bid_type", "schedule_type", "schedule_start_time", "schedule_end_time", "target_roi_budget", "max_delivery_budget", "roas_bid", "cost", "net_cost", "orders", "cost_per_order", "gross_revenue", "roi", "live_views", "cost_per_live_view", "10_second_live_views", "cost_per_10_second_live_view", "live_follows"]&filtering={"gmv_max_promotion_types": ["LIVE"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "10_second_live_views": "739",
                    "bid_type": "CUSTOM",
                    "campaign_id": "{{campaign_id}}",
                    "campaign_name": "{{campaign_name}}",
                    "cost": "57.75",
                    "cost_per_10_second_live_view": "0.08",
                    "cost_per_live_view": "0.01",
                    "cost_per_order": "1.15",
                    "gross_revenue": "313.17",
                    "identity_id": "",
                    "live_follows": "8",
                    "live_views": "4120",
                    "max_delivery_budget": "0.00",
                    "net_cost": "57.75",
                    "operation_status": "ENABLE",
                    "orders": "50",
                    "roas_bid": "5.50",
                    "roi": "5.42",
                    "schedule_end_time": "{{schedule_end_time}}",
                    "schedule_start_time": "{{schedule_start_time}}",
                    "schedule_type": "Continuously",
                    "target_roi_budget": "10000.00",
                    "tt_account_name": "{{tt_account_name}}",
                    "tt_account_profile_image_url": "{{tt_account_profile_image_url}}"
                }
            },
            {
                "dimensions": {
                    "campaign_id": "{{campaign_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "10_second_live_views": "0",
                    "bid_type": "CUSTOM",
                    "campaign_id": "{{campaign_id}}",
                    "campaign_name": "{{campaign_name}}",
                    "cost": "0.00",
                    "cost_per_10_second_live_view": "0.00",
                    "cost_per_live_view": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "identity_id": "",
                    "live_follows": "0",
                    "live_views": "0",
                    "max_delivery_budget": "0.00",
                    "net_cost": "0.00",
                    "operation_status": "DISABLE",
                    "orders": "0",
                    "roas_bid": "5.00",
                    "roi": "0.00",
                    "schedule_end_time": "{{schedule_end_time}}1",
                    "schedule_start_time": "{{schedule_start_time}}",
                    "schedule_type": "Continuously",
                    "target_roi_budget": "1000.00",
                    "tt_account_name": "0",
                    "tt_account_profile_image_url": "0"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

直播间层级指标

这类指标显示了直播 GMV Max 推广系列中直播间的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

支持的维度组合

若想获取直播 GMV Max 推广系列的直播间层级指标，需通过 dimensions 字段指定以下任一维度组合：

  • ["room_id"]
  • ["room_id","stat_time_day"]
  • ["room_id","stat_time_hour"]
  • ["campaign_id","room_id"]
  • ["campaign_id","room_id","stat_time_day"]
  • ["campaign_id","room_id","stat_time_hour"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| campaign_ids | 必填 | 100 | 指定一个直播 GMV Max 推广系列的 ID。<br><br> 若要获取此类 ID，可先使用 `campaign_id` 维度请求<a href="#item-link-推广系列层级指标（对于直播 GMV Max）">推广系列层级指标</a>。 |

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| live_name | string | 直播名称 | N/A |
| live_status | string | 直播状态 | 枚举值：<ul><li>`ONGOING`：进行中。</li><li>`END`：已结束。</li></ul> |
| live_launched_time | string | 直播开始时间 | 时区：广告账户时区。 |
| live_duration | string | 直播时长 | N/A |
| cost | string | 成本 | 在推广系列排期内您已在广告上花费的估计总金额，对应币种为广告账户币种。 |
| net_cost | string | 净成本 | 不包含广告赠款和优惠券的广告消耗（广告成本），对应币种为广告账户币种。<br>注意，该指标的数据延迟可达 11 小时，并且从 2023 年 9 月 1 日后起提供。 |
| cost_per_order | string | 平均下单成本（当前店铺） | 每次下单所产生的平均成本。计算方法是，广告总成本除以广告排期内下达的订单数。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| orders | string | 订单数（当前店铺） | GMV Max 推广系列期间完成的各 SKU 付费和自然直播订单的数量。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| gross_revenue | string | 总收入（当前店铺） | 归因于推广系列的所有店铺订单的总收入。这是指用户支付的金额加上平台向用户提供的所有店铺价格补贴。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| roi | string | 投资回报率 (ROI)（当前店铺） | 归因于推广系列的所有店铺订单的总投资回报率 (ROI)。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| all_shops_cost_per_order | double | 平均下单成本 | 在推广系列排期期间各直播订单的平均广告费用，对应币种为广告账户币种。通过用总广告费用除以推广系列排期内的订单数计算得出。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_orders | integer | 订单数 | 在推广系列排期期间完成的各付费和自然直播订单的数量。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_gross_revenue | double | 总收入 | 在推广系列排期期间的 TikTok Shop 付费和自然直播订单的总收入，对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有补贴计算得出。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_roi | double | ROI | 在推广系列排期期间完成的所有 TikTok Shop 付费和自然直播订单的总投资回报率（ROI）。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| live_views | string | 直播播放量 | 在推广系列排期期间，您的直播的播放次数。同一用户的多次播放将分别统计。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| cost_per_live_view | string | 直播播放平均成本 | 在推广系列排期期间，每次直播播放的平均成本，对应币种为广告账户币种。通过总成本除以直播总播放量计算得出。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| 10_second_live_views | string | 直播播放达 10 秒播放量 | 在推广系列排期期间，您的直播播放至少 10 秒的次数。同一用户的多次播放将分别统计。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| cost_per_10_second_live_view | string | 直播播放达 10 秒平均成本 | 每次直播播放达 10 秒的平均成本，对应币种为广告账户币种。通过总成本除以直播播放达 10 秒总播放量计算得出。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |
| live_follows | string | 直播关注数 | 在您的直播期间关注您的主页的用户总数。<br> 该指标数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["room_id","stat_time_day"]&metrics=["live_name", "live_status", "live_launched_time", "live_duration", "cost", "net_cost", "orders", "cost_per_order", "gross_revenue", "roi", "live_views", "cost_per_live_view", "10_second_live_views", "cost_per_10_second_live_view", "live_follows"]&filtering={"campaign_ids":["{{campaign_id}}"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "room_id": "{{room_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "10_second_live_views": "0",
                    "cost": "0.00",
                    "cost_per_10_second_live_view": "0.00",
                    "cost_per_live_view": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "11.84",
                    "live_duration": "14h 1m",
                    "live_follows": "0",
                    "live_launched_time": "{{live_launched_time}}",
                    "live_name": "{{live_name}}",
                    "live_status": "END",
                    "live_views": "0",
                    "net_cost": "0.00",
                    "orders": "1",
                    "roi": "0.00"
                }
            },
            {
                "dimensions": {
                    "room_id": "{{room_id}}",
                    "stat_time_day": "{{stat_time_day}}"
                },
                "metrics": {
                    "10_second_live_views": "0",
                    "cost": "0.00",
                    "cost_per_10_second_live_view": "0.00",
                    "cost_per_live_view": "0.00",
                    "cost_per_order": "0.00",
                    "gross_revenue": "0.00",
                    "live_duration": "11h 29m",
                    "live_follows": "0",
                    "live_launched_time": "{{live_launched_time}}",
                    "live_name": "{{live_name}}",
                    "live_status": "END",
                    "live_views": "0",
                    "net_cost": "0.00",
                    "orders": "0",
                    "roi": "0.00"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)

时长层级指标

这类指标显示了直播 GMV Max 推广系列的时长的基本属性和表现，无论这些推广系列创建于 TikTok 广告管理平台还是 TikTok 商家中心。

  • 若整个推广系列排期期间优化模式保持不变，您将看到一条记录，对应所配置的优化模式。
  • 若整个推广系列排期期间修改了优化模式，您将看到多个记录，每条记录对应所使用的优化模式。

例如，若您一开始将优化模式设置为目标 ROI，随后切换为最大投放量，您将看到两条单独的记录：一条对应使用目标 ROI 的时间段，另一条对应最大投放量。

支持的维度组合

若想获取直播 GMV Max 推广系列的时长层级指标，需通过 dimensions 字段指定以下任一维度组合： - ["duration"] - ["campaign_id","duration"] - ["room_id","duration"] - ["campaign_id","room_id","duration"]

支持的筛选字段

| 筛选字段{25%} | 必填/可选{15%} | 最大数量{20%} | 要求{40%} |
|---|---|---|---|
| campaign_ids | 必填 | 100 | 指定一个直播 GMV Max 推广系列的 ID。<br><br> 若要获取此类 ID，可先使用 `campaign_id` 维度请求<a href="#item-link-推广系列层级指标（对于直播 GMV Max）">推广系列层级指标</a>。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您使用本字段筛选了多个 ID，则不支持拉取<a href="#item-link-属性指标">属性指标</a>数据。 |
| room_ids | 必填 | 100 | 指定一个直播 GMV Max 推广系列中使用的直播间的 ID。<br><br> 若要获取此类 ID，可先使用 `room_id` 维度请求<a href="#item-link-直播间层级指标">直播间层级指标</a>。 <br><br><p><span style="color:darkred"><b>注意</b></span>：若您使用本字段筛选了多个 ID，则不支持拉取<a href="#item-link-属性指标">属性指标</a>数据。 |

支持的指标

| 指标字段 {25%}| 数据类型{15%} | 简要描述{20%} | 详细描述 {40%}|
|---|---|---|---|
| bid_type | string | 优化模式 | 枚举值：<ul><li>`CUSTOM`：目标 ROI。</li><li>`NO_BID`：最大投放量。</li></ul>|
| cost | string | 成本 | 在推广系列排期内您已在广告上花费的估计总金额，对应币种为广告账户币种。 |
| cost_per_order | string | 平均下单成本（当前店铺） | 每次下单所产生的平均成本。计算方法是，广告总成本除以广告排期内下达的订单数。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| orders | string | 订单数（当前店铺） | GMV Max 推广系列期间完成的各 SKU 付费和自然直播订单的数量。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| gross_revenue | string | 总收入（当前店铺） | 归因于推广系列的所有店铺订单的总收入。这是指用户支付的金额加上平台向用户提供的所有店铺价格补贴。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| roi | string | 投资回报率 (ROI)（当前店铺） | 归因于推广系列的所有店铺订单的总投资回报率 (ROI)。仅包含来自你当前店铺的订单，即便直播推广了来自其他店铺的商品。 |
| all_shops_cost_per_order | double | 平均下单成本 | 在推广系列排期期间各直播订单的平均广告费用，对应币种为广告账户币种。通过用总广告费用除以推广系列排期内的订单数计算得出。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_orders | integer | 订单数 | 在推广系列排期期间完成的各付费和自然直播订单的数量。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_gross_revenue | double | 总收入 | 在推广系列排期期间的 TikTok Shop 付费和自然直播订单的总收入，对应币种为广告账户币种。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有补贴计算得出。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |
| all_shops_roi | double | ROI | 在推广系列排期期间完成的所有 TikTok Shop 付费和自然直播订单的总投资回报率（ROI）。<br><br>该指标数据从 2024 年 9 月 27 日后起提供。 |

示例

请求

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/?advertiser_id={{advertiser_id}}&store_ids=["{{store_id}}"]&start_date={{start_date}}&end_date={{end_date}}&dimensions=["duration"]&metrics=["bid_type", "cost", "orders", "cost_per_order", "gross_revenue", "roi"]&filtering={"campaign_ids":["{{campaign_id}}"],"room_ids":["{{room_id}}"]}&page_size=1000&page=1' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "dimensions": {
                    "duration": "{{duration}}"
                },
                "metrics": {
                    "bid_type": "CUSTOM",
                    "cost": "763.83",
                    "cost_per_order": "1.43",
                    "gross_revenue": "3749.91",
                    "orders": "535",
                    "roi": "4.91"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 1000,
            "total_number": 1,
            "total_page": 1
        }
    }
}
(/code)
← 生成 GMV Max 推广系列报表认证身份 →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →