[中文]

用途:

获取广告视频的关键帧分析，了解视频在不同时间点的观众留存情况

分析哪些时间点最吸引观众，哪些时间点观众流失最多

帮助优化广告视频结构，提高观看完成率

参数:

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/u1/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/u1/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]
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取广告关键帧分析/Get ad keyframe analysis

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Request Code Samples

Responses

获取广告关键帧分析/Get ad keyframe analysis

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: