← 返回目录
📁 Marketing API › Reporting › Guides › Report types

试玩素材报表

试玩素材报表是一种报表类型,您可以通过此类报表获取获取试玩广告的数据。

注意

  • 试玩素材报表返回试玩素材的投放数据。请求此类报表时,您无需指定 data_level。
  • 不支持使用CHUNK模式 (query_mode= CHUNK)生成试玩素材报表。CHUNK模式仅支持同步基础报表。

支持的维度

获取试玩素材报表支持的维度,请参阅此处。

支持的指标

获取试玩素材报表支持的指标,请参阅此处。

支持的筛选条件

获取试玩素材报表支持的筛选条件,请参阅此处。

Lifetime指标支持情况

试玩素材报表在广告主层级、推广系列层级、广告组层级以及广告层级均支持Lifetime 指标。

Lifetime 指标不支持分时间或地域查询,当设置 query_lifetime = True 时,dimensions 中不可包含 stat_time_day,stat_time_hour,或country_code。

您仅可在同步试玩素材报表中使用Lifetime指标,因为试玩素材报表不支持异步模式。

使用案例

1. 查询广告主某段时间内消耗在0-100之间的试玩素材投放效果。

请求参数:

(code json JSON)
{
    "advertiser_id": 666,
    "service_type": "AUCTION",
    "report_type": "PLAYABLE_MATERIAL",
    "dimensions": [
        "playable_id"
    ],
    "metrics": [
        "playable_id",
        "playable_name",   
        "spend",
        "cpm",
        "impressions",
        "clicks",
        "ctr"
    ],
    "filtering": [
        {
            "field_name": "spend",
            "filter_type": "RANGE",
            "filter_value": "[0,100]"
        }
    ],
    "start_date": "2020-10-10",
    "end_date": "2020-11-10",
    "page": 1,
    "page_size": 100
}
(/code)


2. 查询广告主某段时间内各试玩素材在不同国家的投放效果。

请求参数:

(code json JSON)
{
    "advertiser_id": 666,
    "service_type": "AUCTION",
    "report_type": "PLAYABLE_MATERIAL",
    "dimensions": [
        "playable_id", "country_code"
    ],
    "metrics": [
        "playable_id",
        "playable_name",   
        "spend",
        "cpm",
        "impressions",
        "clicks",
        "ctr"
    ],
    "start_date": "2020-10-10",
    "end_date": "2020-11-10",
    "page": 1,
    "page_size": 100
}
(/code)

内容来源: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 每日平台更新简报 →