[中文]

用途:

获取广告在同行业中的百分位排名数据

了解广告在各项指标上相对于同行的表现水平

帮助评估广告效果并制定优化策略

参数:

material_id: 广告素材ID，必填参数

metric: 分析指标，可选值：

ctr_percentile: 点击率百分位（默认）

time_attr_conversion_rate_percentile: 时间归因转化率百分位

click_cnt_percentile: 点击次数百分位

time_attr_convert_cnt_percentile: 时间归因转化次数百分位

show_cnt_percentile: 展示次数百分位

period_type: 时间范围(天)，默认180天

cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据

返回内容说明:

percentile_data: 百分位数据

ctr_percentile: 点击率百分位（0-100）

cvr_percentile: 转化率百分位

engagement_percentile: 互动率百分位

view_percentile: 观看量百分位

industry_average: 行业平均值对比

示例响应:

{
  "code": 200,
  "router": "/api/u1/v1/tiktok/ads/get_ad_percentile",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "percentile_data": {
      "ctr_percentile": 85,
      "cvr_percentile": 72,
      "engagement_percentile": 90,
      "view_percentile": 88,
      "industry_average": {
        "ctr": 2.5,
        "cvr": 1.2,
        "engagement": 5.8
      }
    }
  }
}

[English]

Purpose:

Get ad percentile ranking data within the industry

Understand ad performance levels relative to peers across various metrics

Help evaluate ad effectiveness and develop optimization strategies

Parameters:

material_id: Ad material ID, required parameter

metric: Analysis metric, options:

ctr_percentile: CTR percentile (default)

time_attr_conversion_rate_percentile: Time-attributed conversion rate percentile

click_cnt_percentile: Click count percentile

time_attr_convert_cnt_percentile: Time-attributed conversion count percentile

show_cnt_percentile: Impression count percentile

period_type: Time period in days, default 180

cookie: Custom Cookie string, optional parameter, can be used to fetch more data

Return Description:

percentile_data: Percentile data

ctr_percentile: Click-through rate percentile (0-100)

cvr_percentile: Conversion rate percentile

engagement_percentile: Engagement rate percentile

view_percentile: View count percentile

industry_average: Industry average comparison

Example Response:

{
  "code": 200,
  "router": "/api/u1/v1/tiktok/ads/get_ad_percentile",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "percentile_data": {
      "ctr_percentile": 85,
      "cvr_percentile": 72,
      "engagement_percentile": 90,
      "view_percentile": 88,
      "industry_average": {
        "ctr": 2.5,
        "cvr": 1.2,
        "engagement": 5.8
      }
    }
  }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "material_id": "string",
    "metric": "ctr_percentile",
    "period_type": 180
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取广告百分位数据/Get ad percentile data

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Request Code Samples

Responses

获取广告百分位数据/Get ad percentile data

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: