tiktok-creative-center/
ad-analysis

Analizza uno dei migliori annunci del TikTok Creative Center a partire dall’ID: dettagli, percentile delle impression, paesi di diffusione e curve di clic e di fidelizzazione secondo per secondo.

TikTok Creative Center Ad Analysis API

Input con ID annuncio
Curva di fidelizzazione
Curva dei clic
1 credito per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Creative Center Ad Analysis

L’analisi degli annunci del TikTok Creative Center segue uno dei migliori annunci secondo per secondo, mostrando quanto gli spettatori tendono a fare clic in ogni momento e quale quota sta ancora guardando, accanto a didascalia, obiettivo, paesi di diffusione, percentuale di clic dell’annuncio e posizione delle sue impression rispetto ad annunci simili. Lette insieme al video, le curve mostrano quanto a lungo l’apertura trattiene gli spettatori, quando se ne vanno e quale momento spinge al clic.

Funzionalità della TikTok Creative Center Ad Analysis API

  • Fidelizzazione secondo per secondoretention_curve elenca la quota di spettatori che sta ancora guardando in ogni secondo, a partire dal secondo 0.
  • Intensità dei clic secondo per secondoclick_through_curve indica l’intensità relativa dei clic in ogni secondo su una scala da 0 a 1, evidenziando i momenti che spingono all’azione.
  • Posizione delle impressionimpressions_percentile colloca le impression dell’annuncio rispetto ad annunci simili, da 0 a 1.
  • Il record dell’annuncio dietro le curveLo stesso risultato contiene didascalia, settore, obiettivo, ctr, likes, countries, landing_page_url e video, così le curve si possono leggere insieme all’annuncio stesso.

Parametri della TikTok Creative Center Ad Analysis API

ParametriObbligatorioDescrizione
ad_idObbligatorioID dell’annuncio preso da un risultato di TikTok Creative Center Top Ads.

Come usare la TikTok Creative Center Ad Analysis API

Prendi l’ID di un annuncio da Top Ads e leggi la sua analisi.

  1. Raccogli gli annunci con TikTok Creative Center Top Ads e copia un id.
  2. Invia con POST {"ad_id": "7697084527089729557"} a /v1/tiktok-creative-center/ad-analysis.
  3. Interroga GET /v1/tasks/{task_id} finché status diventa succeeded e leggi l’unico record in 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.

Casi d’uso della TikTok Creative Center Ad Analysis API

  • Misurare quanto in fretta gli spettatori lasciano un annuncio: Leggi retention_curve nei primi secondi per vedere quanti spettatori superano l’hook, poi confronta il dato tra gli annunci di una stessa categoria.
  • Scegliere il momento della call to action: Trova il secondo in cui click_through_curve raggiunge il picco e controlla quale frase, inquadratura del prodotto od offerta è sullo schermo in quel momento.
  • Verificare la diffusione di un annuncio prima di riprenderne l’approccio: Usa countries e impressions_percentile per vedere dove è stato diffuso un annuncio e quanto ampiamente, prima di copiarne l’approccio per un altro mercato.

Consigli degli esperti per la TikTok Creative Center Ad Analysis API

  • click_through_curve è un punteggio relativo da 0 a 1, quindi confronta quando i clic raggiungono il picco nei diversi annunci, non quanto è alto il picco.
  • Confronta la fidelizzazione allo stesso secondo tra annunci con duration_seconds simile invece di fare la media di curve intere di lunghezza diversa.
  • Analizza una selezione e non tutti gli annunci, e non fare affidamento su landing_page_url o advertiser, che sono null nell’esempio documentato.

Oltre alla TikTok Creative Center Ad Analysis API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok Creative Center.

Esplora altre piattaforme

Combina i dati di TikTok Creative Center con i dati pubblici delle altre piattaforme social supportate.

TikTok Creative Center Ad Analysis API — FAQ

TikTok Creative Center Ad Analysis API è un’interfaccia programmatica per analizzare uno dei migliori annunci del TikTok Creative Center a partire dal suo ID. Restituisce i dettagli dell’annuncio, un percentile delle impression, i paesi di diffusione e le curve di clic e di fidelizzazione secondo per secondo.

Prendi l’id di un risultato di TikTok Creative Center Top Ads. Gli annunci che non compaiono in Top Ads e i normali video di TikTok non hanno un ID utilizzabile qui.

Ogni punto è un secondo contato da 0 con un valore da 0 a 1: la quota di spettatori che sta ancora guardando in retention_curve e l’intensità relativa dei clic in click_through_curve. Nell’esempio documentato la fidelizzazione scende a 0,35 entro il secondo 1 e i clic raggiungono il picco al secondo 3.

Sì, per qualsiasi annuncio presente in Top Ads, chiunque lo gestisca. I report pubblicitari di TikTok coprono solo le campagne che gestisci tu.

Non esiste un numero unico: le regole empiriche pubblicate variano molto e questo endpoint non ne fissa nessuna. Valuta un annuncio rispetto agli altri migliori annunci della sua categoria allo stesso secondo.

Un ad_id sconosciuto fa fallire l’attività e il relativo credito viene rimborsato; un’analisi riuscita costa 1 credito.