tiktok-creative-center/
ad-analysis

Analysez une publicité Top Ads du TikTok Creative Center à partir de son ID : détails, percentile d’impressions, pays de diffusion et courbes de clics et de rétention seconde par seconde.

TikTok Creative Center Ad Analysis API

ID de publicité en entrée
Courbe de rétention
Courbe de clics
1 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Creative Center Ad Analysis

L’analyse publicitaire du TikTok Creative Center suit une publicité Top Ads seconde par seconde : elle trace l’intensité des clics à chaque instant et la part de spectateurs encore présents, à côté de la légende, de l’objectif, des pays de diffusion, du taux de clics et du rang des impressions parmi des publicités comparables. Lues avec la vidéo, les courbes montrent combien de temps l’ouverture retient les spectateurs, quand ils partent et quel moment déclenche le clic.

Fonctionnalités de la TikTok Creative Center Ad Analysis API

  • Rétention seconde par seconderetention_curve liste la part de spectateurs encore présents à chaque seconde, comptée à partir de la seconde 0.
  • Intensité des clics seconde par secondeclick_through_curve donne pour chaque seconde l’intensité relative du taux de clics sur une échelle de 0 à 1, ce qui repère les moments qui poussent à l’action.
  • Le rang des impressionsimpressions_percentile situe les impressions de la publicité parmi celles de publicités comparables, de 0 à 1.
  • La fiche de la publicité derrière les courbesLe même résultat contient la légende, le secteur, l’objectif, ctr, likes, countries, landing_page_url et la vidéo : les courbes se lisent donc avec la publicité elle-même.

Paramètres de la TikTok Creative Center Ad Analysis API

ParamètresObligatoireDescription
ad_idObligatoireID de publicité issu d’un résultat de TikTok Creative Center Top Ads.

Comment utiliser la TikTok Creative Center Ad Analysis API

Prenez un ID de publicité dans Top Ads et lisez son analyse.

  1. Collectez des publicités avec TikTok Creative Center Top Ads et copiez un id.
  2. Envoyez {"ad_id": "7697084527089729557"} en POST à /v1/tiktok-creative-center/ad-analysis.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez l’enregistrement unique dans 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 and click_through_curve list {second, value} points.

Cas d’usage de la TikTok Creative Center Ad Analysis API

  • Mesurer la vitesse à laquelle les spectateurs quittent une publicité performante : Lisez retention_curve sur les premières secondes pour voir combien de spectateurs passent l’accroche, puis comparez ce chiffre entre publicités d’une même catégorie.
  • Caler l’appel à l’action : Repérez la seconde où click_through_curve culmine et regardez quelle phrase, quel plan produit ou quelle offre est à l’écran à ce moment.
  • Vérifier la portée d’une publicité avant d’en reprendre l’angle : Servez-vous de countries et d’impressions_percentile pour voir où la publicité a été diffusée et avec quelle ampleur avant de copier son approche pour un autre marché.

Conseils d’expert pour la TikTok Creative Center Ad Analysis API

  • click_through_curve est un score relatif de 0 à 1 : comparez le moment où les clics culminent d’une publicité à l’autre, pas la hauteur du pic.
  • Comparez la rétention à la même seconde pour des publicités de duration_seconds voisine, plutôt que de moyenner des courbes entières de longueurs différentes.
  • Analysez une présélection plutôt que toutes les publicités, et ne vous appuyez pas sur landing_page_url ni sur advertiser, qui valent null dans l’exemple documenté.

En complément de la TikTok Creative Center Ad Analysis API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Creative Center.

Explorer d’autres plateformes

Combinez les données TikTok Creative Center avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Creative Center Ad Analysis API — FAQ

TikTok Creative Center Ad Analysis API est une interface programmatique pour analyser une publicité Top Ads du TikTok Creative Center à partir de son ID. Elle renvoie les détails de la publicité, un percentile d’impressions, les pays de diffusion et les courbes de clics et de rétention seconde par seconde.

Prenez l’id d’un résultat de TikTok Creative Center Top Ads. Les publicités absentes de Top Ads et les vidéos TikTok ordinaires n’ont aucun ID utilisable ici.

Chaque point est une seconde comptée à partir de 0, avec une valeur de 0 à 1 : la part de spectateurs encore présents dans retention_curve, l’intensité relative des clics dans click_through_curve. Dans l’exemple documenté, la rétention tombe à 0,35 dès la seconde 1 et les clics culminent à la seconde 3.

Oui, pour toute publicité présente dans Top Ads, quel que soit son annonceur. Les rapports publicitaires de TikTok ne couvrent que les campagnes que vous diffusez vous-même.

Aucun chiffre unique ne tient : les repères publiés varient beaucoup et cet endpoint n’en fixe aucun. Jugez une publicité par rapport aux autres publicités de sa catégorie dans Top Ads, à la même seconde.

Un ad_id inconnu fait échouer la tâche et son crédit est remboursé ; une analyse réussie coûte 1 crédit.