google-ad-library/
ad

Ein öffentliches Creative aus dem Google Ads Transparency Center anhand seiner exakten URL abrufen – mit Werbetreibendem, Text, Medien, Ausspielungszeitraum, Regionen, Format, Ziel und verfügbaren Impressionen in einem normalisierten Datensatz.

Google Ad Library Ad API

Exakte Creative-URL
Werbetreibender und Medien
Öffentlicher Ausspielungskontext
0,5 Credits pro Ergebnis
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

Google Ad Library Ad

Creatives im Google Ads Transparency Center sind öffentliche Werbedatensätze mit Angaben zum Werbetreibenden, sichtbarem Text und Medien, Ziel-Links, Formaten, Ausspielungszeiträumen, Regionen und verfügbaren Impressionsdaten. Diese Details eignen sich für die Prüfung von Creatives, die Anreicherung ausgewählter Anzeigen, die Recherche zum Ausspielungskontext und Archivvergleiche zu einem bestimmten Zeitpunkt.

Funktionen der Google Ad Library Ad API

  • Exakte Auflösung eines CreativesLöst eine adstransparency.google.com-URL mit /creative/ in höchstens einen normalisierten öffentlichen Anzeigendatensatz auf, ohne die Anfrage zu einer Suche auszuweiten.
  • Felder zu Werbetreibendem und CreativeLiefert die Creative-Kennung, die öffentliche Quell-URL, verfügbaren Text, den Verweis auf den Werbetreibenden, das Ziel und das Format in einem stabilen Anzeigenschema.
  • AusspielungskontextBehält verfügbare Start- und Enddaten, Länder, Platzierungen und einen skalaren Impressionswert nur dann bei, wenn sich die Quelldaten sicher normalisieren lassen.
  • Normalisierte Medien-AssetsStellt verfügbare Bild- oder Videoverweise mit Vorschaubildern, Abmessungen und Dauer bereit und lässt fehlende optionale Werte weg.

Parameter der Google Ad Library Ad API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche URL eines öffentlichen Creatives aus dem Google Ads Transparency Center. Das Schema muss http oder https sein, der Host muss auf adstransparency.google.com enden, und der Pfad muss /creative/ enthalten.

So verwenden Sie die Google Ad Library Ad API

Senden Sie die exakte URL eines öffentlichen Creatives, verfolgen Sie die asynchrone Aufgabe und lesen Sie den normalisierten Anzeigendatensatz aus der Standardstruktur der Ergebnisse.

  1. Bereiten Sie eine http- oder https-URL auf adstransparency.google.com vor, deren Pfad /creative/ enthält.
  2. Senden Sie url per POST an /v1/google-ad-library/ad und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
  4. Lesen Sie data.results.items; die Detailabfrage liefert höchstens ein Element, daher ist has_more normalerweise false und next_cursor normalerweise null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Anwendungsfälle der Google Ad Library Ad API

  • Ein ausgewähltes Creative anreichern: Nutzen Sie Creative-ID, Verweis auf den Werbetreibenden, Text, Ziel, Format, Medien und Quell-URL, um einen zuvor gefundenen Anzeigendatensatz zu vervollständigen.
  • Öffentliche Ausspielungsnachweise prüfen: Vergleichen Sie verfügbare Daten, Länder, Platzierungen und Impressionen, um zu dokumentieren, wo und wann ein bekanntes Creative öffentlich beobachtet wurde.
  • Creative-Momentaufnahmen archivieren: Speichern Sie normalisierten Text, Medien, Werbetreibenden, Ausspielung, Ziel und collected_at für einen späteren Vergleich zu bestimmten Zeitpunkten.

Profi-Tipps zur Google Ad Library Ad API

  • Übergeben Sie die vollständige Creative-URL statt einer bloßen CR-Kennung oder der URL des Werbetreibenden, damit Host und Pfad /creative/ die Validierung bestehen.
  • Behandeln Sie eine erfolgreiche Aufgabe ohne Element getrennt von einem Fehler des Anbieters; ein entferntes, eingeschränktes oder nicht verfügbares Creative kann ohne verwertbaren Datensatz bleiben.
  • Behalten Sie nullable Felder zu Ausspielung, Text, Ziel, Werbetreibendem, Impressionen und Medien bei, statt fehlende öffentliche Werte in null oder leere Angaben umzuwandeln.
  • Nutzen Sie die Werbetreibenden-Suche und Company Ads für Entdeckung oder Bestandsaufnahmen; diese Detailabfrage löst bewusst nur das übergebene Creative auf.

Ergänzend zur Google Ad Library Ad API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Ad Library-Daten benötigen.

  • Google Ad Library Advertiser Search API — Öffentliche Werbetreibende im Transparency Center per Suchanfrage und optionaler Region ermitteln – mit Feldern zu Identität, Website, Logo, Region und verfügbarer Anzahl der Anzeigen.
  • Google Ad Library Company Ads API — Öffentliche Creatives des Transparency Centers über Unternehmensdomain oder ID des Werbetreibenden erfassen – mit Optionen für Thema, Region, Datum, Ausspielfläche, Format und Ergebnislimit.

Weitere Plattformen entdecken

Kombinieren Sie Google Ad Library-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Google Ad Library Ad API — FAQ

Google Ad Library Ad API ist eine Schnittstelle zum Abrufen eines öffentlichen Creatives aus dem Google Ads Transparency Center anhand seiner exakten URL. Sie liefert normalisierte Felder zu Werbetreibendem, Text, Medien, Ausspielung, Region, Format, Ziel und verfügbaren Impressionen.

Übergeben Sie eine http- oder https-URL, deren Host auf adstransparency.google.com endet und deren Pfad /creative/ enthält. Bloße Creative-IDs, URLs von Werbetreibenden, Domains, Suchanfragen und URL-Listen werden nicht akzeptiert.

Der normalisierte Datensatz deklariert Identität, Quell-URL, Text, Werbetreibenden, Ausspielungsdaten, Länder, Plattformen, Format, Ziel, Impressionen, Medien, Veröffentlichungszeit und Erfassungszeit. Von der Quelle abhängige Felder bleiben nullable, und Medien können leer sein.

Eine gültige Creative-URL kann auf einen entfernten, eingeschränkten, fehlerhaften oder derzeit nicht verfügbaren öffentlichen Datensatz verweisen. Der Endpunkt ersetzt ihn nicht durch ein anderes Creative und macht aus der Anfrage keine Suche.

Jeder zurückgegebene Datensatz kostet 0,5 SocQ-Credits. Die konfigurierte Regel für leere Ergebnisse berechnet nur die Grundgebühr von null Credits, wenn kein Datensatz zurückkommt.