Suche, YouTube und DisplaySuche einen Werbetreibenden und sammle seine öffentlichen Google-Anzeigen. Vergleiche Formate, Erscheinungsdaten und Botschaften zwischen Märkten.
Probiere diese Beispiele für Marketing, Wachstum und Wettbewerbsrecherche.
Suche vor einem SaaS-Start drei Wettbewerberdomains. Prüfe Formate und Botschaften in Suche, Display und Video. Nutze die Beispiele für eigene Kanaltests.
Halte Wettbewerbermotive und Notizen zu den Kanälen fest, die du untersuchen möchtest.
Beobachte für einen Handelsstart die Werbeaktivität in zwei Zielländern. Prüfe mit den ersten und letzten Ausspielungsdaten, wann Motive erschienen und wie sich Texte unterscheiden.
Erstelle einen Ländervergleich mit Links zu den öffentlichen Anzeigen.
Aktiviere Details für eine kleine Advertiser-Gruppe und speichere Varianten-URLs. Löse verfügbare öffentliche YouTube-IDs auf und prüfe die Inhalte vor der Produktion.
Ordne die Inhalte nach Format, damit dein Team Kampagnenvorlagen findet.
VOM ERSTEN LAUF ZUM REGELMÄSSIGEN ABLAUF
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "all",
"maxAds": 50,
"fetchAdDetails": false,
"resolveMedia": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Fügen Sie dies in den JSON-Eingabeeditor des Actors ein. Ersetzen Sie die Beispielziele vor dem Start.
Das aktuelle Eingabeformular auf Apify ansehenNamen, Domains, IDs und URLs des Transparency Centers können einen Werbetreibenden identifizieren. Verwende eine ID, wenn eine Marke mehrere Rechtsträger hat oder die Namenssuche den falschen auswählt.
| Suchmethode | Wann es sinnvoll ist | Was sich ändert |
|---|---|---|
| Website-Domains | Wann es sinnvoll istDu hast eine Liste von Wettbewerbern. | Was sich ändertVerifizierte Domains wie nike.com sind genauer als Markennamen. Ohne Domain-Treffer kann eine Namenssuche folgen; prüfen Sie den gewählten Werbetreibenden. |
| Werbetreibender oder Markenname | Wann es sinnvoll istDu möchtest passende Ergebnisse finden, bevor du konkrete Ziele auswählst. | Was sich ändertSuchen Sie nach Marken oder Unternehmen. Der Actor prüft auch deren Domain und wählt einen Werbetreibenden. Kontrollieren Sie die Identität und fixieren Sie sie bei Bedarf mit einer AR-ID. |
| Werbetreibenden-IDs | Wann es sinnvoll istDu kennst genau die Entität, deren Daten du sammeln möchtest. | Was sich ändertAR-IDs aus Transparency-Center-URLs. Sie vermeiden mehrdeutige Namensauflösung und verfolgen zuverlässig dieselbe juristische Person. |
| URLs der Werbebibliothek | Wann es sinnvoll istDu hast die Suche bereits auf der Quellwebsite eingerichtet. | Was sich ändertFügen Sie Werbetreibenden-URLs aus dem Transparency Center ein. Jede URL behält Region und Plattform; globale Werte ergänzen fehlende Filter. |
Behält Anzeigen mit letzter Auslieferung ab diesem Datum. Die Filterung erfolgt nach dem Abruf; Googles Schnittstelle bietet keinen Datumsfilter und garantiert keine geringere Anfragezahl.
Den verwandten Scraper vergleichenVerwenden Sie in JSON die genauen Feldnamen unten. Geben Sie Listenwerte im Apify-Formular einzeln ein und verwenden Sie Zahlen und Wahrheitswerte im richtigen Datentyp.
Standardwert und Vorbelegung sind verschieden. Der Standardwert gilt, wenn du eine Einstellung auslässt; die Vorbelegung ist ein Beispiel im Apify-Formular. Prüfe Ziele und Limits vor jedem Lauf. Manche Einstellungen haben keinen Standardwert im Schema. Du musst trotzdem mindestens ein unterstütztes Ziel angeben.
searchTermsSuchen Sie nach Marken oder Unternehmen. Der Actor prüft auch deren Domain und wählt einen Werbetreibenden. Kontrollieren Sie die Identität und fixieren Sie sie bei Bedarf mit einer AR-ID.
domainsVerifizierte Domains wie nike.com sind genauer als Markennamen. Ohne Domain-Treffer kann eine Namenssuche folgen; prüfen Sie den gewählten Werbetreibenden.
domainEine Domain statt der domains-Liste. Nutzen Sie die reine Domain; Website-Pfade grenzen Anzeigen nicht ein.
advertiserIdsAR-IDs aus Transparency-Center-URLs. Sie vermeiden mehrdeutige Namensauflösung und verfolgen zuverlässig dieselbe juristische Person.
advertiserIdEinzelversion von advertiserIds. Kopieren Sie den AR-Wert der Werbetreibenden-URL, keine Creative-ID.
transparencyUrlsFügen Sie Werbetreibenden-URLs aus dem Transparency Center ein. Jede URL behält Region und Plattform; globale Werte ergänzen fehlende Filter.
transparencyUrlEine Werbetreibenden-URL mit derselben Priorität wie transparencyUrls. Die URL-Region überschreibt eine abweichende globale Region.
regionsMehrere Länder erzeugen getrennte Aufgaben je Werbetreibendem und Region. Duplikate werden über creative_id entfernt. Leer umfasst alle bedienten Regionen; nicht unterstützte Länder werden übersprungen.
regionEin Land, nur bei leerer regions-Liste. Nutzen Sie regions zum Vergleich mehrerer Märkte.
platformBegrenzt die Google-Werbefläche. Wählen Sie search, youtube, display, shopping, maps, play oder all. Summen können sich zwischen Flächen überschneiden.
all search youtube display shopping maps playminDateBehält Anzeigen mit letzter Auslieferung ab diesem Datum. Die Filterung erfolgt nach dem Abruf; Googles Schnittstelle bietet keinen Datumsfilter und garantiert keine geringere Anfragezahl.
maxDateBehält Anzeigen, die bis zu diesem Datum erstmals liefen. Mit minDate wird eine Überschneidung mit dem Zeitraum gewählt. Nutzen Sie YYYY-MM-DD.
proxyConfigurationApify Proxy wird empfohlen; Datacenter genügt meistens. Residential ist nicht erforderlich. Eine abgelehnte Konfiguration kann auf den Konto-Standard zurückfallen.
maxConcurrency1 bis 10 parallele Aufgaben je Werbetreibendem und Region. Mehr Parallelität hilft bei mehreren Zielen; ein Ziel in einer Region bleibt sequenziell.
maxAdsFeste Grenze für eindeutige Anzeigen im gesamten Lauf, über alle Ziele und Märkte. Beginnen Sie mit 50. Ohne diese Grenze kann eine breite Suche sehr groß werden.
maxPagesSeitenlimit je Werbetreibendem und Region. Eine Seite enthält höchstens pageSize Anzeigen, maximal 100. Dies ist ein Testlimit, keine globale Ergebnisgrenze.
fetchAdDetailsErgänzt Regionen, regionale Auslieferungsdaten und Varianten. Eine zusätzliche Anfrage je Anzeige; nur aktivieren, wenn diese Felder gebraucht werden.
resolveMediaLöst mit weiteren Anfragen öffentliche YouTube-Video-IDs aus Vorschauen auf. Für Display-Videos ohne öffentliche URL kann kein solcher Link erzeugt werden.
pageSize1 bis 100 Anzeigen je Anfrage. Höhere Werte werden auf 100 begrenzt, da Google größere Pakete ablehnt. Normalerweise bei 100 belassen.
delayMsPause zwischen Seitenanfragen in Millisekunden. Erhöhen Sie sie bei Drosselung; eine Verringerung hebt weder Netzwerklatenz noch Quelllimits auf.
rawGibt die Quellstruktur statt der normalisierten Darstellung zurück. Nutzen Sie false für einheitliche Analysespalten und true für Diagnose oder eigene Transformationen.
proxyRotationsWiederholt verweigerte Aufgaben mit einer neuen Proxy-Sitzung. Weitere Versuche können vorübergehende Sperren überwinden, erhöhen aber Dauer und Datenverkehr. Ändern Sie den Standard nur bei Hinweisen im Protokoll.
resumeSpeichert den Fortschritt etwa alle 30 Sekunden für Neustarts oder Migrationen durch Apify. Lassen Sie es normalerweise aktiviert.
continueFromLastRunSetzt unerledigte Arbeit des vorherigen Laufs mit passender Eingabe fort. Bisherige Daten bleiben in dessen Dataset. Nutzen Sie false für neue oder regelmäßige Erhebungen.
impersonateBrowser-Identität der Anfragen. Behalten Sie den Actor-Standard bei, außer bei der Diagnose sofortiger Sperren. Sie verändert den Fingerabdruck der Anfrage, nicht die angefragten Daten.
proxySessionIdFixiert eine Proxy-Sitzung zur Diagnose. Lassen Sie das Feld normalerweise leer. Parallele Aufgaben brauchen eigene Sitzungen und können die feste Sitzung daher nicht nutzen.
Diese Referenz folgt den Eingabefeldern des Actors. Prüfen Sie das aktuelle Formular, bevor Sie einen produktiven Ablauf ändern. Das aktuelle Eingabeformular auf Apify ansehen.
Jedes Beispiel ist ein eigener Lauf. Beginnen Sie klein, prüfen Sie die Ergebnisse und erweitern Sie dann. Passen Sie Ziele, Länder und Zeiträume an Ihre Frage an.
Zwei Domains und zwei Regionen erzeugen vier Werbetreibenden-Region-Aufträge. Das Limit von 150 gilt für den gemeinsamen, deduplizierten Datensatz. Es garantiert keine gleiche Stichprobe pro Marke oder Land.
{
"domains": ["nike.com", "adidas.com"],
"regions": ["GB", "FR"],
"maxAds": 150,
"fetchAdDetails": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Filtere nach YouTube und aktiviere resolveMedia, um Video-IDs und URLs aufzulösen. Prüfe die Medienfelder, bevor du Claude Links gibst; manche Anzeigen enthalten weiterhin kein direkt zugängliches Video.
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "youtube",
"maxAds": 50,
"resolveMedia": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Ergänze Details und einen Auslieferungszeitraum für Deutschland. Die Daten werden nach dem Abruf geprüft; ein enger Zeitraum garantiert daher keine günstige Ausführung. Passe die Daten an und beginne mit einem kleinen Limit.
{
"domains": ["nike.com"],
"regions": ["DE"],
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 50,
"fetchAdDetails": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Speichere Werbetreibenden- und Creative-IDs mit Region, Plattform und Erhebungsdatum. Detail- und Medienoptionen ergänzen dieselben Datensätze, keine Leistungsdaten. Nutze Sheets zur Anzeigenprüfung oder BigQuery und dbt für eine deduplizierte Historie. Ausgaben, ROAS und Conversions liefert die Quelle nicht.
resume schützt den aktuellen Lauf bei einem Neustart durch Apify. continueFromLastRun setzt einen früheren Lauf mit derselben Konfiguration fort; vorhandene Daten bleiben im alten Dataset. Führen Sie beide Datasets zusammen und erhöhen Sie erreichte Grenzen. Starten Sie neu, um heutige Änderungen zu erfassen.
Speichere eine Konfiguration oben als input.json. Setze APIFY_TOKEN im Terminal auf deinen Apify-API-Token und sende die Datei als Anfrageinhalt.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~google-ads-transparency-center-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonDie Antwort enthält eine Run-ID und defaultDatasetId, keine fertigen Ergebnisse. Warte auf einen erfolgreichen Abschluss, setze DATASET_ID auf diese Dataset-ID und rufe die Einträge ab. Nutze bei großen Datensätzen limit und offset zur Paginierung.
curl --fail-with-body \
--url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
--header "Authorization: Bearer $APIFY_TOKEN"Apifys API-Referenz für Start und Export
Optionen für den Datenexport
Ändern Sie jeweils nur eine Einstellung, behalten Sie eine kleine Grenze und prüfen Sie die Zusammenfassung vor einer Erweiterung.
AR-IDs aus Transparency-Center-URLs. Sie vermeiden mehrdeutige Namensauflösung und verfolgen zuverlässig dieselbe juristische Person.
Löst mit weiteren Anfragen öffentliche YouTube-Video-IDs aus Vorschauen auf. Für Display-Videos ohne öffentliche URL kann kein solcher Link erzeugt werden.
1 bis 10 parallele Aufgaben je Werbetreibendem und Region. Mehr Parallelität hilft bei mehreren Zielen; ein Ziel in einer Region bleibt sequenziell.
Erfolg bedeutet, dass der Actor die Anfrage bearbeitet hat, nicht dass die Quelle Daten geliefert hat. Prüfen Sie SUMMARY.inputProblem, SUMMARY.problem und das Protokoll auf fehlende Ziele, ungültige Filter oder verweigerte Anfragen. Testen Sie ein bekanntes Ziel mit weniger Filtern.
Prüfen Sie globale Grenzen, Such- und Seitengrenzen, Abdeckung und Duplikate. Mehrere Suchen können denselben Datensatz finden. Die angezeigte Gesamtzahl der Quelle kann öffentlich nicht verfügbare Datensätze enthalten. Prüfen Sie offene Aufgaben, bevor Sie den Bestand als vollständig ansehen.
Sammle creative_id, advertiser_name, format, first_shown, last_shown und preview_url in einer Tabelle. Ergänze eine Spalte zum Kampagnenthema für Teamnotizen.
Anleitung lesenLass Claude Formate und Ausspielungsdaten einer kleinen Advertiser-Gruppe vergleichen. Verlange Quellenlinks und trenne Interpretationen von beobachteten Daten.
Anleitung lesenVergleiche Formate nach Werbetreibendem und zeige neue Kreativ-IDs. Wenn du Regionen sammelst, flache das Array vor der Marktberichterstattung ab.
Anleitung lesenEntferne Duplikate über creative_id, behalte aber jede datierte Beobachtung. Speichere Regionen und Varianten in Untertabellen, damit Joins die Motivzahl nicht erhöhen.
Anleitung lesen
Prüfe das Eingabeschema von jmlp/google-ads-transparency-center-scraper und sammle höchstens 50 Datensätze für nike.com in GB. Fasse verfügbare Formate und Ausspielungsdaten zusammen, zitiere transparency_url und nenne offene Marketingfragen. Schätze weder Ausgaben noch ROAS.Behalte Erfassungszeit und Original-IDs, um die Herkunft eines Ergebnisses zu prüfen oder spätere Läufe zu vergleichen.
Googles Transparenzdaten enthalten keine Wettbewerber-Conversions oder ROAS. Datumsfilter greifen nach der Sammlung; ein enger Zeitraum verkürzt den Crawl nicht unbedingt. Details und Videoauflösung erzeugen zusätzliche Anfragen. Aktiviere sie nach Bedarf.
Er kann Anzeigen aus Suche, YouTube, Display, Shopping und Maps erfassen, abhängig von der gewählten Plattform und den verfügbaren öffentlichen Daten.
Nicht unbedingt. Der Quellendpunkt hat keinen Datumsfilter. Der Scraper sammelt Seiten und filtert danach. Begrenze den Lauf mit maxAds und den optionalen Details.
Quelle und aktuelle Produktdetails: JMLPs Google Ads Transparency Actor auf Apify.
Facebook & Instagram01Sieh, wofür deine Wettbewerber werben.
Sammle Wettbewerberanzeigen an einem Ort. Vergleiche Texte, Angebote und Zeitpunkte vor deiner nächsten Kampagne.
Bibliothek kommerzieller Inhalte02Finde Videoideen zum Testen.
Sammle TikTok-Anzeigen aus 32 Märkten in EU/EWR, Großbritannien und der Schweiz. Behalte Videolinks und Auslieferungsdaten und prüfe interessante Creatives.
Sag mir, was du sammeln oder verstehen möchtest. Ich helfe mit einem individuellen Scraper, einer Pipeline oder der Analyse.
Projekt besprechen