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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche 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.
- Bereiten Sie eine http- oder https-URL auf adstransparency.google.com vor, deren Pfad /creative/ enthält.
- Senden Sie url per POST an /v1/google-ad-library/ad und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- 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 itemAnwendungsfä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.
Verwandte APIs
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.