[中文]

用途:

• 获取广告在同行业中的百分位排名数据
• 了解广告在各项指标上相对于同行的表现水平
• 帮助评估广告效果并制定优化策略

参数:

• 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/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/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
      }
    }
  }
}