TikTok Creative Center Ad Analysis
TikTok Creative Centerの広告分析は、トップ広告を1秒ごとにたどり、各瞬間にどれだけ強くクリックされているか、まだ視聴を続けている人の割合がどれだけかをグラフにして、広告のキャプション、目的、配信国、クリック率、同種の広告の中でのインプレッションの位置づけとあわせて示します。動画と照らし合わせて読むと、冒頭がどのくらい視聴者をつなぎとめ、どこで離脱し、どの瞬間がクリックを促しているかがわかります。
TikTok Creative Center Ad Analysis API の主な機能
- 秒ごとの視聴維持率retention_curve には、0秒目から数えた各秒の時点で、まだ視聴している人の割合が並びます。
- 秒ごとのクリックの強さclick_through_curve は各秒の相対的なクリック率の強さを0〜1の尺度で示し、行動を促している瞬間がわかります。
- インプレッションの順位impressions_percentile は、同種の広告の中での、その広告のインプレッションの位置を0〜1で示します。
- カーブの背景にある広告レコード同じ結果にキャプション、industry、objective、ctr、likes、countries、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を取り、その分析結果を読み取ります。
- TikTok Creative Center Top Ads で広告を集め、id をコピーします。
- {"ad_id": "7697084527089729557"} を /v1/tiktok-creative-center/ad-analysis に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items の1件のレコードを読み取ります。
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 and click_through_curve list {second, value} points.TikTok Creative Center Ad Analysis API の主なユースケース
- トップ広告から視聴者が離れる速さを測る: 冒頭の数秒の retention_curve を読んで、フックの後にどれだけ視聴者が残るかを確認し、同じカテゴリの広告同士で比べます。
- CTAのタイミングを探る: click_through_curve が最も高くなる秒を見つけ、その瞬間に画面に出ているセリフ、商品カット、オファーを確認します。
- 切り口を参考にする前に広告のリーチを確認: 別の市場でその手法をまねる前に、countries と impressions_percentile で、広告がどこで配信され、どれだけ広く届いたかを確かめます。
TikTok Creative Center Ad Analysis API 活用のヒント
- click_through_curve は0〜1の相対スコアなので、広告同士ではピークの高さではなく、クリックがピークになる時点を比べてください。
- 長さの違うカーブ全体を平均するのではなく、duration_seconds が近い広告同士で、同じ秒の視聴維持率を比べてください。
- すべての広告ではなく、絞り込んだ候補を分析してください。ドキュメントのサンプルで null になっている landing_page_url と advertiser には依存しないでください。
関連API
TikTok Creative Center Ad Analysis API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Creative Center Top Ads API — 成果の高い広告をキーワードと期間で閲覧し、キャプション、CTR、いいね数、広告動画を返します。
- TikTok Creative Center Trending Hashtags API — 国別のトレンドハッシュタグのランキングを、投稿数、再生数、人気度カーブとともに取得します。
- TikTok Creative Center Hashtag Insights API — トレンドハッシュタグ1つについて、人気度カーブ、上位の国、サンプル動画を詳しく調べます。
- TikTok Creative Center Top Videos API — 国別の成果の高い動画のチャートを、再生数とエンゲージメント率とともに取得します。
- TikTok Creator Marketplace API — Creator Marketplace のカードを、フォロワーの属性、再生数の中央値、最低料金とともに取得します。