Google Ad Library Company Ads
Der Creative-Bestand im Google Ads Transparency Center lässt sich über eine ausgewählte ID eines Werbetreibenden oder eine Unternehmensdomain auflisten und mit öffentlichen Abfragefiltern eingrenzen. Creative-Kennungen und Quell-URLs sind die verlässlichsten Werte auf Listenebene, da die Anreicherung mit Details pro Anzeige für diese Operation deaktiviert ist.
Funktionen der Google Ad Library Company Ads API
- Ausgangspunkt Werbetreibender oder DomainGeben Sie mindestens eine Google-ID eines Werbetreibenden oder eine Unternehmensdomain an; sind beide vorhanden, bestimmt die vorgelagerte Quelle, wie sie sich überschneiden.
- Validierte BestandsfilterGrenzen Sie den öffentlichen Creative-Index nach Thema, Region, Zeitfenster, Google-Plattform oder den Formatwerten Text, Bild und Video ein.
- Cursorbasierte ErfassungFolgt den Cursorn des Anbieters in Seiten mit 40 Datensätzen und stoppt beim angeforderten Ergebnislimit von 40 bis 2.000, auf der letzten Seite, bei einer leeren Seite oder bei einem ungültigen wiederholten Cursor.
- Stabile AnzeigendatensätzeLiefert das gemeinsame normalisierte Anzeigenschema und behält Null- und leere Detailfelder auf Listenebene bei, statt Creative-Anreicherung zu erfinden.
Parameter der Google Ad Library Company Ads API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
domain | Erforderlich (mindestens eines) | Website-Domain des Unternehmens, zum Beispiel lululemon.com. Mindestens einer der Parameter domain oder advertiser_id ist erforderlich; der Abgleich über die Domain kann mehr als einen Datensatz eines Werbetreibenden umfassen. |
advertiser_id | Erforderlich (mindestens eines) | Kennung eines Werbetreibenden im Google Transparency Center, die in der Regel mit AR beginnt. Mindestens einer der Parameter advertiser_id oder domain ist erforderlich. |
topic | Optional | Optionaler öffentlicher Themenfilter der Quelle: all oder political. Verhalten und Abdeckung des Filters werden von der Quelle bestimmt. |
region | Optional | Optionaler Regionscode wie US, der als öffentlicher Abfragekontext und nicht als vollständige Targeting-Definition weitergegeben wird. |
start_date | Optional | Optionaler Datumsfilter der Quelle, inklusive Startdatum, im Format YYYY-MM-DD. Er darf nicht nach end_date liegen, wenn beide Daten angegeben werden. |
end_date | Optional | Optionaler Datumsfilter der Quelle im Format YYYY-MM-DD. Er darf nicht vor start_date liegen, wenn beide Daten angegeben werden. |
platform | Optional | Optionale Google-Plattform: google_maps, google_play, google_search, google_shopping oder youtube. |
format | Optional | Optionales Creative-Format: text, image oder video. Ähnliche Creative-Varianten können dennoch als getrennte Datensätze erscheinen. |
results_limit | Optional | Maximale Anzahl gespeicherter Creative-Datensätze. Standardwert ist 40; zulässig sind ganze Zahlen von 40 bis 2.000 in Vielfachen von 40. |
So verwenden Sie die Google Ad Library Company Ads API
Senden Sie eine strukturierte Anfrage zum Bestand eines Werbetreibenden, verfolgen Sie die asynchrone Aufgabe und nutzen Sie die zurückgegebenen Creative-URLs für den gezielten Abruf von Details.
- Wählen Sie eine advertiser_id oder domain; fügen Sie nur Filter hinzu, die zur Vergleichs- oder Erfassungsfrage gehören.
- Setzen Sie results_limit auf 40 bis 2.000 in Vielfachen von 40 und senden Sie die Anfrage per POST an /v1/google-ad-library/company-ads.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt, und blättern Sie bei Bedarf durch die gespeicherten Aufgabenergebnisse.
- Behandeln Sie IDs und Creative-URLs als Indexdatensätze; senden Sie ausgewählte URLs an die separate Operation für Anzeigendetails, wenn Sie umfangreichere Felder benötigen.
curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"advertiser_id":"AR01614014350098432001","region":"US","format":"video","results_limit":80}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and select creative URLs for detail retrievalAnwendungsfälle der Google Ad Library Company Ads API
- Eine gezielte Warteschlange für Details aufbauen: Listen Sie Creative-IDs und öffentliche URLs eines Werbetreibenden auf und wählen Sie dann nur die relevanten Datensätze für umfangreichere Detailanfragen aus.
- Beobachtbare Formatmischungen vergleichen: Zählen Sie die zurückgegebenen Indexdatensätze für Text, Bild und Video bei gleichbleibenden Kennungen, Filtern, Limits und Erfassungszeiträumen.
- Offengelegte Ausspielungszeiträume prüfen: Erkennen Sie Creative-Datensätze, die unter vergleichbaren Filtern für Datum, Region, Thema oder Google-Plattform zurückgegeben wurden, ohne sie als private Targeting-Daten zu behandeln.
Profi-Tipps zur Google Ad Library Company Ads API
- Bevorzugen Sie eine geprüfte advertiser_id gegenüber einer breiten Domain, wenn die gemeinte Einheit im Transparency Center bereits bekannt ist.
- Halten Sie Kennungen, Filter, results_limit und Erfassungsdaten konsistent, wenn Sie Creative-Bestände im Zeitverlauf vergleichen.
- Rechnen Sie damit, dass Text, Datumsangaben, Ziel, Impressionen und Medien auf Listenebene null oder leer sind, weil get_ad_details immer false ist.
- Werten Sie ein erfolgreiches leeres Ergebnis als „kein verwertbares Creative zu den übergebenen Kennungen und Filtern zu diesem Zeitpunkt“ und nicht als Beweis, dass das Unternehmen nie geworben hat.
Verwandte APIs
Ergänzend zur Google Ad Library Company Ads API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Ad Library-Daten benötigen.
- Google Ad Library Ad API — Ein bekanntes öffentliches Creative des Transparency Centers über die URL abrufen – mit Feldern zu Werbetreibendem, Text, Medien, Auslieferung, Region, Format, Ziel und Impressionen.
- 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.