[中文]

用途:

• 获取广告视频的关键帧分析，了解视频在不同时间点的观众留存情况
• 分析哪些时间点最吸引观众，哪些时间点观众流失最多
• 帮助优化广告视频结构，提高观看完成率

参数:

• material_id: 广告素材ID，必填参数
• metric: 分析指标，可选值：
  • retain_ctr: 留存点击率（默认）
  • retain_cvr: 留存转化率
  • click_cnt: 点击次数
  • convert_cnt: 转化次数
  • play_retain_cnt: 播放留存量
• cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据

返回内容说明:

• keyframe_data: 关键帧数据
  • time_points: 时间点列表（秒）
  • retention_rates: 对应时间点的留存率（百分比）
  • drop_points: 流失率较高的时间点
  • highlight_points: 观众兴趣较高的时间点

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ad_keyframe_analysis",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "keyframe_data": {
      "time_points": [0, 1, 2, 3, 4, 5],
      "retention_rates": [100, 95, 88, 82, 78, 75],
      "drop_points": [2, 4],
      "highlight_points": [1, 5]
    }
  }
}

[English]

Purpose:

• Get keyframe analysis of ad videos to understand audience retention at different time points
• Analyze which time points attract viewers most and where viewers drop off
• Help optimize ad video structure to improve completion rates

Parameters:

• material_id: Ad material ID, required parameter
• metric: Analysis metric, options:
  • retain_ctr: Retention CTR (default)
  • retain_cvr: Retention CVR
  • click_cnt: Click count
  • convert_cnt: Conversion count
  • play_retain_cnt: Play retention count
• cookie: Custom Cookie string, optional parameter, can be used to fetch more data

Return Description:

• keyframe_data: Keyframe data
  • time_points: List of time points (seconds)
  • retention_rates: Retention rates at corresponding time points (percentage)
  • drop_points: Time points with high drop-off rates
  • highlight_points: Time points with high viewer interest

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ad_keyframe_analysis",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "keyframe_data": {
      "time_points": [0, 1, 2, 3, 4, 5],
      "retention_rates": [100, 95, 88, 82, 78, 75],
      "drop_points": [2, 4],
      "highlight_points": [1, 5]
    }
  }
}