tiktok-creative-center/
ad-analysis

Eine Top-Anzeige des TikTok Creative Center per Anzeigen-ID analysieren: Details, Perzentil der Impressionen, Auslieferungsländer sowie Klick- und Retention-Kurven Sekunde für Sekunde.

TikTok Creative Center Ad Analysis API

Anzeigen-ID als Eingabe
Retention-Kurve
Klickkurve
1 Credit pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok Creative Center Ad Analysis

Die Anzeigenanalyse im TikTok Creative Center verfolgt eine Top-Anzeige Sekunde für Sekunde und zeichnet auf, wie stark Zuschauer in jedem Moment klicken und welcher Anteil noch zuschaut, neben Anzeigentext, Ziel, Auslieferungsländern, Klickrate und dem Rang der Impressionen unter vergleichbaren Anzeigen. Neben dem Video gelesen zeigen die Kurven, wie lange der Einstieg Zuschauer hält, wann sie abspringen und welcher Moment den Klick auslöst.

Funktionen der TikTok Creative Center Ad Analysis API

  • Retention pro Sekunderetention_curve listet den Anteil der Zuschauer auf, die in jeder Sekunde noch zuschauen, gezählt ab Sekunde 0.
  • Klickstärke pro Sekundeclick_through_curve gibt die relative Klickstärke jeder Sekunde auf einer Skala von 0 bis 1 an und markiert damit die Momente, die zum Handeln führen.
  • Rang der Impressionenimpressions_percentile ordnet die Impressionen der Anzeige unter vergleichbaren Anzeigen ein, von 0 bis 1.
  • Der Anzeigen-Datensatz hinter den KurvenDasselbe Ergebnis enthält Anzeigentext, Branche, Ziel, ctr, likes, countries, landing_page_url und Video, sodass sich die Kurven an der Anzeige selbst ablesen lassen.

Parameter der TikTok Creative Center Ad Analysis API

ParameterErforderlichBeschreibung
ad_idErforderlichAnzeigen-ID aus einem Ergebnis von TikTok Creative Center Top Ads.

So verwenden Sie die TikTok Creative Center Ad Analysis API

Nehmen Sie eine Anzeigen-ID aus Top Ads und lesen Sie ihre Analyse aus.

  1. Erfassen Sie Anzeigen mit TikTok Creative Center Top Ads und kopieren Sie eine id.
  2. Senden Sie {"ad_id": "7697084527089729557"} per POST an /v1/tiktok-creative-center/ad-analysis.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie den einzelnen Datensatz 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.

Anwendungsfälle der TikTok Creative Center Ad Analysis API

  • Messen, wie schnell Zuschauer eine Top-Anzeige verlassen: Lesen Sie retention_curve über die ersten Sekunden, um zu sehen, wie viele Zuschauer den Hook überstehen, und vergleichen Sie das über Anzeigen einer Kategorie.
  • Den Call to Action richtig platzieren: Suchen Sie die Sekunde, in der click_through_curve gipfelt, und prüfen Sie, welcher Satz, welche Produktaufnahme oder welches Angebot in diesem Moment im Bild ist.
  • Die Reichweite einer Anzeige prüfen, bevor Sie ihren Ansatz übernehmen: Nutzen Sie countries und impressions_percentile, um zu sehen, wo eine Anzeige lief und wie breit sie ausgeliefert wurde, bevor Sie ihren Ansatz für einen anderen Markt kopieren.

Profi-Tipps zur TikTok Creative Center Ad Analysis API

  • click_through_curve ist ein relativer Wert von 0 bis 1, vergleichen Sie also, wann die Klicks bei verschiedenen Anzeigen gipfeln, und nicht, wie hoch der Gipfel ist.
  • Vergleichen Sie die Retention in derselben Sekunde bei Anzeigen mit ähnlicher duration_seconds, statt ganze Kurven unterschiedlicher Länge zu mitteln.
  • Analysieren Sie eine Vorauswahl statt jeder Anzeige, und bauen Sie nicht auf landing_page_url oder advertiser auf, die im dokumentierten Beispiel null sind.

Ergänzend zur TikTok Creative Center Ad Analysis API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok Creative Center-Daten benötigen.

Weitere Plattformen entdecken

Kombinieren Sie TikTok Creative Center-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Creative Center Ad Analysis API — FAQ

TikTok Creative Center Ad Analysis API ist eine Schnittstelle zur Analyse einer Top-Anzeige aus dem TikTok Creative Center anhand ihrer ad_id. Sie liefert die Details der Anzeige, ein Perzentil der Impressionen, Auslieferungsländer sowie Klick- und Retention-Kurven Sekunde für Sekunde.

Nehmen Sie die id eines Ergebnisses aus TikTok Creative Center Top Ads. Anzeigen außerhalb von Top Ads und gewöhnliche TikTok-Videos haben keine ID, die hier funktioniert.

Jeder Punkt ist eine Sekunde, ab 0 gezählt, mit einem Wert von 0 bis 1: in retention_curve der Anteil der Zuschauer, die noch zuschauen, in click_through_curve die relative Klickstärke. Im dokumentierten Beispiel fällt die Retention bis Sekunde 1 auf 0.35, und die Klicks gipfeln in Sekunde 3.

Ja, bei jeder Anzeige, die in Top Ads steht, egal wer sie schaltet. Das Anzeigen-Reporting von TikTok selbst deckt nur die Kampagnen ab, die Sie selbst betreiben.

Eine einzelne Zahl gibt es nicht: Veröffentlichte Faustregeln gehen weit auseinander, und dieser Endpunkt legt keine fest. Beurteilen Sie eine Anzeige im Vergleich zu anderen Top-Anzeigen ihrer Kategorie in derselben Sekunde.

Eine unbekannte ad_id lässt die Aufgabe fehlschlagen und der Credit wird erstattet; eine erfolgreiche Analyse kostet 1 Credit.