tiktok-creative-center/
ad-analysis

Analice un anuncio destacado de TikTok Creative Center a partir de su ID: sus datos, el percentil de impresiones, los países de entrega y las curvas de clics y de retención segundo a segundo.

TikTok Creative Center Ad Analysis API

ID del anuncio
Curva de retención
Curva de clics
1 crédito por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Creative Center Ad Analysis

El análisis de anuncios de TikTok Creative Center sigue segundo a segundo a un anuncio destacado y grafica con qué fuerza hacen clic los espectadores en cada momento y qué proporción sigue viendo, junto con la descripción del anuncio, su objetivo, los países de entrega, la tasa de clics y el lugar que ocupan sus impresiones entre anuncios comparables. Leídas junto al video, las curvas muestran cuánto retiene la apertura a los espectadores, cuándo se van y qué momento provoca el clic.

Funcionalidades de la TikTok Creative Center Ad Analysis API

  • Retención por segundoretention_curve enumera la proporción de espectadores que siguen viendo en cada segundo, contado desde el segundo 0.
  • Fuerza de clics por segundoclick_through_curve da la fuerza relativa de clics de cada segundo en una escala de 0 a 1, lo que marca los momentos que impulsan la acción.
  • Dónde se ubican las impresionesimpressions_percentile sitúa las impresiones del anuncio entre las de anuncios comparables, de 0 a 1.
  • El registro del anuncio detrás de las curvasEl mismo resultado trae la descripción, industry, objective, ctr, likes, countries, landing_page_url y el video, de modo que las curvas se pueden leer junto al anuncio mismo.

Parámetros de la TikTok Creative Center Ad Analysis API

ParámetrosObligatorioDescripción
ad_idObligatorioID de un anuncio de un resultado de TikTok Creative Center Top Ads.

Cómo usar la TikTok Creative Center Ad Analysis API

Tome un ID de anuncio de Top Ads y lea su análisis.

  1. Obtenga anuncios con TikTok Creative Center Top Ads y copie un id.
  2. Envíe {"ad_id": "7697084527089729557"} por POST a /v1/tiktok-creative-center/ad-analysis.
  3. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea el único registro en 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.

Casos de uso de la TikTok Creative Center Ad Analysis API

  • Medir qué tan rápido se van los espectadores de un anuncio destacado: Lea retention_curve durante los primeros segundos para ver cuántos espectadores sobreviven al gancho, y compare eso entre anuncios de una misma categoría.
  • Ubicar en el tiempo el llamado a la acción: Busque el segundo en que click_through_curve llega a su máximo y revise qué frase, toma del producto u oferta aparece en pantalla en ese momento.
  • Revisar el alcance de un anuncio antes de tomar prestado su enfoque: Use countries e impressions_percentile para ver dónde corrió un anuncio y qué tan ampliamente se entregó antes de copiar su estrategia para otro mercado.

Consejos de expertos para la TikTok Creative Center Ad Analysis API

  • click_through_curve es una puntuación relativa de 0 a 1, así que compare en qué momento llegan al máximo los clics entre anuncios y no qué tan alto es ese máximo.
  • Compare la retención en el mismo segundo entre anuncios de duration_seconds parecida, en lugar de promediar curvas completas de distinta longitud.
  • Analice una lista corta y no todos los anuncios, y no base nada en landing_page_url ni en advertiser, que son null en el ejemplo documentado.

Además de la TikTok Creative Center Ad Analysis API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Creative Center.

Explorar otras plataformas

Combine los datos de TikTok Creative Center con datos públicos de otras plataformas sociales compatibles.

TikTok Creative Center Ad Analysis API — FAQ

TikTok Creative Center Ad Analysis API es una interfaz programática para analizar, a partir de su ID, un anuncio destacado de TikTok Creative Center. Devuelve los datos del anuncio, un percentil de impresiones, los países de entrega y las curvas de clics y de retención segundo a segundo.

Tome el id de un resultado de TikTok Creative Center Top Ads. Los anuncios que no están en Top Ads y los videos comunes de TikTok no tienen un ID que funcione aquí.

Cada punto es un segundo contado desde 0 con un valor de 0 a 1: la proporción de espectadores que siguen viendo en retention_curve y la fuerza relativa de clics en click_through_curve. En el ejemplo documentado la retención baja a 0.35 en el segundo 1 y los clics alcanzan su máximo en el segundo 3.

Sí, de cualquier anuncio que aparezca en Top Ads, sin importar quién lo publique. Los informes de anuncios de TikTok cubren solo las campañas que usted mismo ejecuta.

No hay una cifra única: las reglas prácticas publicadas varían mucho y este endpoint no fija ninguna. Juzgue un anuncio frente a otros anuncios destacados de su categoría en el mismo segundo.

Un ad_id desconocido hace fallar la tarea y se devuelve su crédito; un análisis exitoso cuesta 1 crédito.