Dokumentation Experience Platform Anleitung zu Quell-Connectoren

Google Ads (v2)

Letzte Aktualisierung: 2. Oktober 2026

Themen:
Sources

Erstellt für:

Developer

IMPORTANT

Die Google Ads ist als Teil der Customer Journey Analytics SKU verfügbar.

Google Ads (V2) ist ein Quell-Connector für bezahlte Medien in Adobe Experience Platform, der Werbe-, Kampagnen-, Anzeigengruppen-, Anzeigen-, Asset-, Erlebnis- und Leistungsdaten aus der Google Ads-API in Experience Platform aufnimmt.

Der Connector ordnet Google Ads Daten standardisierten Paid-Media-Experience-Datenmodell (XDM)-Strukturen zu, sodass Sie Google Ads Daten zusammen mit Daten aus anderen Werbenetzwerken, Web-Eigenschaften, Commerce-Systemen und Kundenanwendungen analysieren können.

Google Ads (V2) verwendet schreibgeschützten Zugriff, um Berichtsdaten und Werbe-Metadaten abzurufen. Es werden keine Google Ads-Ressourcen erstellt, geändert oder gelöscht.

Beispielhafte Anwendungsfälle

Anwendungsfall

Ziel

So hilft Google Ads (v2)

Kanalübergreifende Werbeanalyse

Google Ads Leistung mit Meta Ads und anderen Paid-Media-Kanälen vergleichen.

nimmt Google Ads Daten in gängige XDM-Strukturen für bezahlte Medien mit standardisierten Kennungen auf jeder Entitätsebene auf.

Modellierung und Attribution des Medien-Mix

Bewerten Sie den Beitrag bezahlter Medien zu Geschäftsergebnissen.

Stellt Leistungsdaten zu Kampagnen und Werbung bereit, einschließlich Impressionen, Klicks, Ausgaben, Konversionen und Konversionswerte für nachgelagerte Analysen.

Kampagnen- und Budgetoptimierung

Erfahren Sie, welche Kampagnen, Angebotsstrategien und Zielgruppenkonfigurationen die besten Ergebnisse erzielen.

Nimmt Kampagnenmetadaten, Budgets, Gebotsstrategien, Kanaltypen, Status, Datumsangaben und ausgewählte Targeting-Kriterien auf.

Creative und Asset-Performance

Ermitteln Sie, welche Kreativ-Assets, Anzeigenformate und Erlebnisse am besten funktionieren.

nimmt kreative Metadaten auf Anzeigenebene auf, einschließlich Asset-Zuordnungen, Typen und Leistungsbeschriftungen.

Performance Max-Analyse

Analysieren der Performance Max Asset-Gruppen und der zugehörigen Assets.

Verwendet Daten der Asset-Gruppe „Performance Max“ zur Darstellung der Leistung von Asset-Gruppen und von Erlebnisbeziehungen, bei denen Google Ads keine herkömmliche Struktur auf Anzeigenebene verfügbar macht.

Journey-Analyse des Kunden

Binden Sie Werbeinteraktionen an Web-, Commerce-, CRM- und andere Kundenereignisse an.

Stellt Google Ads Daten in Experience Platform für nachgelagerte Analyse- und Aktivierungs-Workflows zur Verfügung.

Voraussetzungen

Stellen Sie vor dem Verbinden von Google Ads (V2) mit Experience Platform Folgendes sicher:

Konfigurieren von Berechtigungen für Experience Platform

Für Ihr Experience Platform Konto müssen sowohl Quellen anzeigen als auch Quellen verwalten“ aktiviert sein.

Wenden Sie sich an Ihren Produktadministrator, wenn Sie nicht über die erforderlichen Berechtigungen verfügen. Weitere Informationen finden Sie im Handbuch zur Benutzeroberfläche der Zugriffssteuerung.

Konfigurieren Google Ads API-Zugriffs

Experience Platform verwaltet den OAuth 2.0-Autorisierungsfluss für Google Ads (V2). Sie erstellen kein Google Cloud-Projekt, keinen OAuth-Client und kein Aktualisierungs-Token.

Sie müssen über Folgendes verfügen:

Ein gültiges Google Ads-Entwickler-Token.
Zugriff auf das Google Ads Advertiser-Konto, das Sie aufnehmen möchten.
Berechtigung zum Zugriff auf die relevanten Advertiser-Konten über Google Ads oder ein Google Ads Manager-Konto.

Zugriff auf Manager-Konto

Wenn auf das Advertiser-Konto über ein Google Ads Manager-Konto zugegriffen wird, geben Sie auch die entsprechende Manager-Kunden-ID als loginCustomerId an.

Die loginCustomerId ist nicht erforderlich, wenn der OAuth-autorisierte Benutzer direkt auf das Ziel-Advertiser-Konto zugreifen kann und keine Manager-Hierarchie erforderlich ist.

Google Ads (V2) listet barrierefreie Konten auf, identifiziert Manager-Konten, durchläuft die Manager-Konto-Hierarchie und löst die Advertiser-Konten auf, die für die Aufnahme verfügbar sind.

Sammeln erforderlicher Anmeldedaten

Um Google Ads (V2) mit Experience Platform zu verbinden, geben Sie die folgenden Werte an.

Anmeldedaten

Beschreibung

developerToken

Das Google Ads Entwickler-Token, das zum Autorisieren von API-Anfragen verwendet wird.

loginCustomerId

Die numerische Kunden-ID des Manager-Kontos, die für den Zugriff auf das Advertiser-Konto verwendet wird. Diese Berechtigung ist für den Zugriff auf Manager-Konten erforderlich.

Authentifizierung und Kontoerkennung

Google Ads (V2) verwendet OAuth 2.0, um den Zugriff auf die Google Ads-API zu autorisieren. Experience Platform verwaltet den Autorisierungsfluss, sodass Sie keine OAuth-Bereiche oder -Berechtigungen auf der Google Ads konfigurieren.

Nachdem Sie Ihr -Konto autorisiert haben, verwendet Experience Platform Ihr Entwickler-Token, um auf Google Ads Berichtsressourcen zuzugreifen. Bei Manager-Account-Konfigurationen löst der Connector die Account-Hierarchie auf und identifiziert die Advertiser-Konten, die für die Aufnahme verfügbar sind.

Der Workflow zur Kontoerkennung umfasst die folgenden Vorgänge:

Aufzählung der Konten, auf die der autorisierte Benutzer zugreifen kann.
Ermitteln, ob ein barrierefreies Konto ein Manager-Konto ist.
Durchlaufen der Manager-Konto-Hierarchie.
Nicht-Manager-Advertiser-Konten identifizieren.
Verwenden Sie die entsprechende loginCustomerId, wenn -Anfragen durch die Manager-Konto-Hierarchie weitergeleitet werden.
Abrufen von Kontometadaten wie Konto-ID, Kontoname, Währung und Zeitzone.

Google Ads (V2) führt schreibgeschützte API-Vorgänge aus. Es werden keine Mutations-, Erstellungs-, Aktualisierungs- oder Löschanfragen für Google Ads Ressourcen ausgegeben.

Datenauswahl und -aufnahme

Google Ads (V2) verwendet Google Ads Query Language (GAQL) zum Abrufen von Kontometadaten, Kampagnenmetadaten und Berichtsdaten.

Der Connector verwendet ressourcenspezifische Abfragen, um die für jede Entität erforderlichen Attribute, Segmente und Metriken abzurufen. Der Connector verwendet SearchStream für Berichtsressourcen und große Ergebnismengen, bei denen eine inkrementelle Zeilenverarbeitung von Vorteil ist.

Das unterstützte Abfrageinventar umfasst Ressourcen wie:

customer
customer_client
campaign
campaign_budget
campaign_criterion
geo_target_constant
ad_group
ad_group_criterion
ad_group_ad
ad_group_ad_asset_view
ad_group_ad_asset_combination_view
asset
asset_group
asset_group_asset
change_status

Leistungsmetriken werden mithilfe von datumsbasierten Segmenten wie segments.date abgerufen.

Schemakonfiguration

Google Ads (V2) ordnet Quelldaten standardisierten XDM-Strukturen für bezahlte Medien zu. Der Connector organisiert die Daten nach Entitätsebene, sodass Metadaten und Leistungsmetriken über Konto-, Kampagnen-, Anzeigengruppen-, Anzeigen-, Asset- und Erlebnisdatensätze hinweg verbunden werden können.

Entität

Primäre Google Ads

Dargestellte Daten

Konto

customer, customer_client

Konto-ID, Kontoname, Währung, Zeitzone, Manager-Status und Konto-Metadaten.

Campaign

campaign, campaign_budget, campaign_criterion

Kampagnenname, Status, Werbekanal, Untertyp, Ziel, Budgets, Gebotsstrategie, Daten, URL-Tracking und Targeting-Konfiguration.

Anzeigengruppe

ad_group, ad_group_criterion

Anzeigengruppen-ID, Name, Status, Gebote, Zielgruppenbestimmung, Schlüsselwörter, Platzierungen und Kampagnenbeziehung.

ad_group_ad

Anzeigen-ID, Anzeigentyp, kreativer Inhalt, Ziel-URLs, Versandstatus, Richtlinien- und Prüfinformationen sowie Kampagnen-/Anzeigengruppenbeziehungen.

Asset

asset, ad_group_ad_asset_view, asset_group_asset

Asset-ID, Asset-Typ, Text, Bild- oder Videometadaten, Dimensionen, Nutzung, Leistungsbezeichnung und zugehörige Anzeigen oder Kampagnen.

Erlebnis

ad_group_ad_asset_combination_view, asset_group, asset_group_asset

Abgeleitete kreative Komposition, bereitgestellte Assets, Überschriften, Beschreibungen, Aktionsaufrufe, Landingpage-URLs und Erlebnisbeziehungen.

Metriken der Zusammenfassung

Ressourcenspezifische metrics.* und segments.date

Impressionen auf Datumsebene, Klicks, Ausgaben, Konversionen, Konversionswert, CTR, CPC, CPM, Videometriken und andere unterstützte Leistungsmessungen.

Kennungskonventionen

Die V2-Zuordnung definiert plattformqualifizierte Kennungen für Paid-Media-Entitäten. Beispiel:

Der Connector leitet Kontokennungen von der Google Ads Kunden-ID ab.
Kampagnenkennungen kombinieren die Google Ads Kunden-ID und die Kampagnen-ID.
Anzeigengruppen- und Anzeigenkennungen umfassen die übergeordnete Hierarchie.
Asset-IDs kombinieren die Google Ads Kunden-ID und die Asset-ID.
Der Connector leitet Erlebniskennungen aus dem Kontext der kreativen Kombination oder der Asset-Gruppe ab.
Hierarchiepfade stellen die Beziehung zwischen Konto-, Kampagnen-, Anzeigengruppen-, Anzeigen-, Erlebnis- und Asset-Entitäten dar.

Max. Performance-Daten

Kampagnen mit dem Typ „Performance Max“ stellen nicht immer dieselben Entitätsbeziehungen bereit wie herkömmliche Kampagnentypen.

Für Daten mit maximaler Leistung:

asset_group stellt die primäre Gruppierung von Assets dar.
asset_group_asset stellt Beziehungen zwischen Assets und Gruppen dar.
Asset-Gruppenmetriken bieten den erforderlichen Kontext zur Analyse der Asset-Leistung.
Asset-Gruppen agieren als Erlebnis-Proxy, wenn keine native Erlebnisentität verfügbar ist.

Einschränkungen und Überlegungen zu Daten

Beachten Sie die folgenden Einschränkungen bei der Planung Ihrer Implementierung von Google Ads (V2).

Unterstützung für ressourcenspezifische Metriken

Google Ads werden nicht alle Metriken für jede Ressource verfügbar gemacht. Beispielsweise unterstützen einige Ressourcen keine Metriken oder Segmente, während andere nur einen begrenzten Satz von Metriken unterstützen.

Die Verfügbarkeit von Metriken variiert auch zwischen Anzeigen-, Asset-, Erlebnis-, Kampagnen- und Performance Max-Abfragen.

Abgeleitete Erlebnisdatensätze

Google Ads bietet keine einzige universelle Erlebnisentität, die dem Erlebnismodell entspricht, das von den XDM-Schemata für bezahlte Medien verwendet wird.

Der Connector leitet Erlebnisdatensätze aus verfügbaren Anzeigen-, Asset-Kombination- und Asset-Gruppen-Daten ab.

Video-Metadaten

Die Google Ads-API stellt Video-IDs und zugehörige Asset-Verweise bereit. Einige Medieneigenschaften wie Videodauer, Codec, Bitrate, Framerate und Audiopräsenz sind jedoch nicht direkt über die Google Ads-API verfügbar.

Diese Felder sind null, es sei denn, es wird ein genehmigter Anreicherungsdienst hinzugefügt.

Asset-Verfügbarkeit

Die Unterstützung von Asset-Metadaten und -Leistung variiert je nach Asset-Typ. Beispielsweise sind Bild- und Text-Metadaten direkt verfügbar, während einige Videoeigenschaften eine zusätzliche Anreicherung erfordern.

Google-spezifische Felder

Google Ads Konzepte ohne XDM-Entsprechung für direkt bezahlte Medien werden gemäß der genehmigten Zuordnung mit additionalDetails dargestellt oder auf null festgelegt.

Aufzählungszuordnungen

Der Connector ordnet Google Ads API-Aufzählungswerte XDM-Werten mithilfe exakter Übereinstimmungen, enger semantischer Übereinstimmungen oder genehmigter Fallback-Werte zu. Nicht unterstützte, unbekannte, veraltete oder nicht angegebene Werte werden übersprungen oder auf null festgelegt.

Nächste Schritte

Nachdem Sie Ihre Google Ads Anmeldedaten und Ihr Zugriffsmodell bestätigt haben, fahren Sie mit dem Schritt fortErstellen einer Verbindung zu Google Ads mithilfe der Experience Platform-Benutzeroberfläche.

recommendation-more-help

experience-platform-help-sources