Google Ad Library Advertiser Search
Das Google Ads Transparency Center kann zu einer Marke, einer Organisation oder einem Website-Suchbegriff mehrere Datensätze von Werbetreibenden anzeigen, auch regionale oder ähnlich benannte Einheiten. Die Prüfung von IDs, Namen, Websites, Logos, Regionen und verfügbaren Anzeigenzahlen hilft, den richtigen öffentlichen Datensatz auszuwählen, bevor Sie dessen Creatives sammeln.
Funktionen der Google Ad Library Advertiser Search API
- Entdeckung von Werbetreibenden über den NamenSuchen Sie mit einem nicht leeren Begriff für eine Marke, Organisation, einen Werbetreibenden oder eine Website und erhalten Sie normalisierte Kandidaten unter den Werbetreibenden statt Anzeigen-Creatives.
- Optionaler RegionskontextÜbergeben Sie eine Region wie US, um die vorgelagerte Suche einzuordnen, wobei die Region von der Ausspielungsgeografie der Anzeigen getrennt bleibt.
- Identitätsfelder der KandidatenVergleichen Sie die öffentliche ID des Werbetreibenden, Namen, URL, Website, Logo, Region und die von der Quelle gemeldete Anzeigenzahl, sofern verfügbar, ganz ohne abgeleitete Anreicherung.
- Vollständige Speicherung einer einzelnen AntwortSpeichert jeden verwertbaren Werbetreibenden aus der einen vorgelagerten Suchantwort; es gibt weder ein vom Aufrufer steuerbares Ergebnislimit noch eine Paginierungsschleife beim Anbieter.
Parameter der Google Ad Library Advertiser Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Suchbegriff für einen Werbetreibenden, eine Marke, eine Organisation oder eine Website. Das Suchverhalten hängt von der Quelle ab; ein exakter, Präfix- oder unscharfer Abgleich ist nicht garantiert. |
region | Optional | Optionale, nicht leere Regionszeichenfolge wie US, die als geografischer Suchkontext weitergegeben wird. Sie belegt nicht, wo die Anzeigen eines Werbetreibenden ausgespielt wurden. |
So verwenden Sie die Google Ad Library Advertiser Search API
Senden Sie einen Suchbegriff, verfolgen Sie die asynchrone Aufgabe und prüfen Sie jeden normalisierten Kandidaten, bevor Sie dessen Identität in der weiteren Recherche verwenden.
- Wählen Sie einen konkreten Begriff für einen Werbetreibenden, eine Marke, eine Organisation oder eine Website; fügen Sie optional eine Region wie US hinzu.
- Senden Sie query und optional region per POST an /v1/google-ad-library/advertiser-search und speichern Sie task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- Lesen Sie data.results.items und prüfen Sie die Identität der Kandidaten anhand von mehr als der Namensähnlichkeit, bevor Sie eine ID des Werbetreibenden auswählen.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidatesAnwendungsfälle der Google Ad Library Advertiser Search API
- Eine Marke den IDs von Werbetreibenden zuordnen: Erstellen Sie aus einem Namen oder Website-Begriff eine Kandidatenliste, bevor Sie eine ID des Werbetreibenden für eine separate Abfrage des öffentlichen Anzeigenbestands auswählen.
- Regionale oder rechtliche Einheiten trennen: Vergleichen Sie Namen, Regionen, Websites und öffentliche Seiten der Werbetreibenden, wenn mehrere ähnliche Datensätze Tochtergesellschaften, Wiederverkäufer oder unabhängige Organisationen darstellen können.
- Eine Prüfwarteschlange aufbauen: Speichern Sie Identitäten der Kandidaten und Erfassungszeitstempel für die manuelle Prüfung, ohne allein aus der Namensähnlichkeit auf Eigentumsverhältnisse zu schließen.
Profi-Tipps zur Google Ad Library Advertiser Search API
- Verwenden Sie einen konkreten Firmennamen, eine Marke oder einen domainähnlichen Begriff; allgemeine Formulierungen können mehrdeutige Kandidaten liefern, und die Abgleichregeln sind nicht garantiert.
- Behandeln Sie region als Suchkontext und nicht als Beleg dafür, dass jede Anzeige des Werbetreibenden in dieser Geografie lief.
- Prüfen Sie Kandidaten anhand von ID, Name, Website, Region und der öffentlichen Seite des Werbetreibenden, bevor Sie Datensätze zusammenführen oder Creatives sammeln.
- Senden Sie kein results_limit: Diese Operation speichert das verwertbare Array der Werbetreibenden aus einer vorgelagerten Antwort und paginiert die Quelle nicht.
Verwandte APIs
Ergänzend zur Google Ad Library Advertiser Search 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 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.