tiktok-creative-center/
ad-analysis

按广告 ID 分析一条 TikTok 创意中心高效广告,返回广告详情、展示量百分位、投放国家,以及逐秒的点击曲线和留存曲线。

TikTok Creative Center Ad Analysis API

广告 ID 输入
留存曲线
点击率曲线
每次请求 1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Creative Center Ad Analysis

TikTok 创意中心的广告分析把一条高效广告拆到每一秒:每个时刻观众点击得有多强、还有多少人在继续看,并和广告文案、投放目标、投放国家、点击率以及展示量在同类广告中的排位放在一起。对照视频画面来读,就能看出开头能留住观众多久、观众在哪里离开、哪一刻促成了点击。

TikTok Creative Center Ad Analysis API 主要特性

  • 逐秒的留存retention_curve 给出每一秒仍在观看的观众比例,秒数从 0 开始计。
  • 逐秒的点击强度click_through_curve 用 0 到 1 的相对值表示每一秒的点击强度,峰值就是促使观众行动的时刻。
  • 展示量的同类排位impressions_percentile 用 0 到 1 表示这条广告的展示量在同类广告中的位置。
  • 曲线背后的广告本身同一条结果里还有文案、行业、投放目标、ctr、点赞、投放国家、landing_page_url 和视频,曲线可以直接对着广告来读。

TikTok Creative Center Ad Analysis API 参数

参数必填描述
ad_id必填取自 TikTok Creative Center Top Ads 结果的广告 ID。

如何使用 TikTok Creative Center Ad Analysis API

从 Top Ads 拿到广告 ID,读取它的分析结果。

  1. 用 TikTok Creative Center Top Ads 采集广告,复制其中一条的 id。
  2. 向 /v1/tiktok-creative-center/ad-analysis 发送 {"ad_id": "7697084527089729557"}。
  3. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded,读取 results.items 中的那条记录。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_id":"7697084527089729557"}'

# retention_curve 和 click_through_curve 是 {second, value} 数据点列表。

TikTok Creative Center Ad Analysis API 最佳使用场景

  • 测量观众多快离开一条爆款广告: 读开头几秒的 retention_curve,看有多少观众撑过了钩子,再在同一品类的多条广告之间对比。
  • 确定转化引导出现的时机: 找到 click_through_curve 的峰值落在第几秒,再看那一刻画面里是哪句话、哪个产品镜头或哪个优惠。
  • 借用思路之前先看这条广告投放到哪、铺得多广: 用 countries 和 impressions_percentile 看广告投放在哪些国家、展示得有多广,再决定要不要把它的思路搬到另一个市场。

TikTok Creative Center Ad Analysis API 使用建议

  • click_through_curve 是 0 到 1 的相对值,跨广告对比时看点击在第几秒达到峰值,不要比峰有多高。
  • 对比留存时,在时长相近的广告之间取同一秒的值,不要把长度不同的整条曲线求平均。
  • 只分析筛选出来的候选广告,不要逐条全量分析;另外 landing_page_url 和 advertiser 在文档示例里是 null,别依赖它们。

除了 TikTok Creative Center Ad Analysis API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。

探索其他平台

还可以将 TikTok Creative Center 数据与其他已支持社交平台的公开数据结合使用。

TikTok Creative Center Ad Analysis API — 常见问题

TikTok Creative Center Ad Analysis API 是一个用于根据广告 ID 分析一条 TikTok 创意中心高效广告的 API。它返回广告详情、展示量百分位、投放国家,以及逐秒的点击曲线和留存曲线。

取 TikTok Creative Center Top Ads 结果里的 id。不在 Top Ads 里的广告和普通 TikTok 视频,没有可用于这里的 ID。

每个点是从 0 开始计的一秒,数值在 0 到 1 之间:retention_curve 是仍在观看的观众比例,click_through_curve 是相对的点击强度。文档示例里,留存到第 1 秒降到 0.35,点击在第 3 秒达到峰值。

能,只要这条广告出现在 Top Ads 里,不论是谁投放的。TikTok 自己的广告报表只覆盖你自己投放的广告。

没有统一的数字:各处流传的经验值差别很大,这个接口也不设标准。要判断一条广告,请和同品类其他爆款广告在同一秒的数值比。

ID 不存在时任务失败,这 1 积分会退回;分析成功才计费,每条广告 1 积分。