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ètres | Obligatoire | Description |
|---|---|---|
ad_id | Obligatoire | ID 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.
- Collectez des publicités avec TikTok Creative Center Top Ads et copiez un id.
- Envoyez {"ad_id": "7697084527089729557"} en POST à /v1/tiktok-creative-center/ad-analysis.
- 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é.
API associées
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.
- TikTok Creative Center Top Ads API — Parcourez les publicités les plus performantes par mot-clé et par période, avec légendes, CTR, mentions « J’aime » et vidéo publicitaire.
- TikTok Creative Center Trending Hashtags API — Obtenez le classement des hashtags tendance d’un pays, avec nombres de publications, vues et courbes de popularité.
- TikTok Creative Center Hashtag Insights API — Explorez la courbe de popularité d’un hashtag tendance, ses principaux pays et des vidéos d’exemple.
- TikTok Creative Center Top Videos API — Obtenez le classement des vidéos les plus performantes d’un pays, avec vues et taux d’engagement.
- TikTok Creator Marketplace API — Obtenez des fiches Creator Marketplace avec données démographiques des abonnés, vues médianes et tarifs de départ.