tiktok-creative-center/
ad-analysis

広告IDを指定して、TikTok Creative Centerのトップ広告1件を分析します。広告の詳細、インプレッションのパーセンタイル、配信国、1秒ごとのクリック率カーブと視聴維持率カーブを取得できます。

TikTok Creative Center Ad Analysis API

広告IDを入力
視聴維持率カーブ
クリック率カーブ
1リクエストあたり1クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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を取り、その分析結果を読み取ります。

  1. TikTok Creative Center Top Ads で広告を集め、id をコピーします。
  2. {"ad_id": "7697084527089729557"} を /v1/tiktok-creative-center/ad-analysis に POST します。
  3. 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 には依存しないでください。

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 Creative Centerのトップ広告1件を分析するためのプログラムインターフェースです。広告の詳細、インプレッションのパーセンタイル、配信国、1秒ごとのクリック率カーブと視聴維持率カーブを返します。

TikTok Creative Center Top Ads の結果の id を使います。Top Adsにない広告や通常のTikTok動画には、ここで使えるIDがありません。

各ポイントは0秒から数えた1秒ごとの値で、範囲は0〜1です。retention_curve はまだ視聴している人の割合、click_through_curve は相対的なクリック率の強さを表します。ドキュメントのサンプルでは、視聴維持率は1秒目で0.35まで下がり、クリックは3秒目でピークになります。

はい、Top Adsに掲載されている広告なら、誰が配信しているものでも見られます。TikTok自身の広告レポートで見られるのは、自分が配信しているキャンペーンだけです。

すべてに当てはまる数字はありません。公開されている目安は大きくばらつき、このエンドポイントも基準を設けていません。同じカテゴリの他のトップ広告と、同じ秒で比べて判断してください。

存在しない ad_id ではタスクが失敗し、そのクレジットは返却されます。分析が成功した場合は1クレジットです。