DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

Google Ads

Letzte Aktualisierung: 16. Oktober 2025

Erstellt für:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Google Ads ist die Online-Werbeplattform von Google, mit der Sie potenzielle Kunden über Search-, YouTube-, Maps- und Partner-Websites hinweg erreichen können. Sie können die richtige Zielgruppe ansprechen, Ihr Budget kontrollieren und die Ergebnisse verfolgen, um Aufmerksamkeit, Leads und Verkäufe zu steigern.

Verwenden Sie die Google Ads, um sich bei der Google Ads-API zu authentifizieren, Advertiser-Konten oder Manager-Konto-Hierarchien zu verbinden und Berichtsdaten für nachgelagerte Analyse- und Aktivierungs-Workflows in Experience Platform aufzunehmen.

IMPORTANT
Die Google Ads in der Experience Platform-Benutzeroberfläche befindet sich derzeit in der Beta-Phase und unterstützt nur eine einmalige Aufnahme. Verwenden Sie für die inkrementelle Aufnahme die API-basierte Verbindung und den Datenfluss.

Voraussetzungen

Bevor Sie Ihr Google Ads-Konto mit Experience Platform verbinden, stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind.

Zulassungsliste von IP-Adressen

Sie müssen Ihrer Zulassungsliste regionsspezifische IP-Adressen hinzufügen, bevor Sie Ihre Quellen mit Experience Platform verbinden. Weitere Informationen finden Sie im Handbuch unter Zulassungsauflistung von IP-Adressen für die Verbindung mit Experience Platform .

Konfigurieren von Berechtigungen für Experience Platform

Sie müssen sowohl Quellen anzeigen als auch Quellen verwalten für Ihr Konto aktiviert haben, um Ihr Google Ads-Konto mit Experience Platform zu verbinden. Wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten. Weitere Informationen finden Sie im Handbuch zur Benutzeroberfläche der Zugriffssteuerung.

Sie müssen über gültige Google Ads-API-Anmeldeinformationen und Zugriff auf das Google Ads-Konto verfügen, aus dem Sie lesen möchten. Wenn das Ziel-Advertiser-Konto über ein Google AdsManager-Konto (MCC) verwaltet wird muss die Verbindung auch die richtige Anmelde-Kunden-ID enthalten, damit Anfragen über die richtige Manager-Hierarchie weitergeleitet werden können.

In der Praxis gilt Folgendes:

  • Wenn das Target-Advertiser-Konto von einem OAuth-autorisierten Benutzer direkt aufgerufen werden kann, ist loginCustomerId möglicherweise nicht erforderlich.
  • Wenn das Advertiser-Konto nur über eine MCC-Hierarchie zugänglich ist, müssen loginCustomerId das Manager-Konto identifizieren, das für den Zugriff auf dieses untergeordnete Konto verwendet wird.
  • Eine falsche oder fehlende loginCustomerId kann zu Autorisierungsfehlern beim Versuch führen, verwaltete untergeordnete Konten abzufragen.

Sammeln erforderlicher Anmeldedaten

Um Google Ads mit Experience Platform zu verbinden, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben.

Anmeldedaten
Beschreibung
clientCustomerId
Die Kontonummer des Google Ads Client-Kontos, das Sie mit der Google Ads-API verwalten möchten. Diese ID folgt normalerweise dem Format 123-456-7890.
loginCustomerId
Die Kontonummer des Google Ads Manager-Kontos, das zum Abrufen von Berichtsdaten für einen bestimmten aktiven Kunden verwendet wird. Dies ist erforderlich, wenn der Zugriff auf das Zielkonto über eine MCC-Hierarchie vermittelt wird.
developerToken
Das Entwickler-Token, das für den Zugriff auf die Google Ads-API verwendet wird. Ein einzelnes Entwickler-Token kann für Google Ads Konten verwendet werden, auf die Ihre Anwendung zugreifen darf.
refreshToken
Das OAuth 2.0-Aktualisierungstoken, mit dem neue Zugriffstoken nach ihrem Ablauf abgerufen werden.
clientId
Die mit Ihrer Google-Anwendung verknüpfte OAuth 2.0-Client-ID.
clientSecret
Der mit Ihrer Google-Anwendung verknüpfte geheime Clientschlüssel für OAuth 2.0.
googleAdsApiVersion
Die vom Connector verwendete Google Ads-API-Version. Experience Platform unterstützt derzeit Version v19 und höher.
connectionSpec.id
Die Google Ads Verbindungsspezifikations-ID, die für Flow Service-API-Anfragen erforderlich ist: d771e9c1-4f26-40dc-8617-ce58c4b53702.

Über loginCustomerId

Der loginCustomerId ist eines der wichtigsten Konfigurationsfelder in der Google Ads.

loginCustomerId verwenden, wenn:

  • Der OAuth-autorisierte Benutzer hat Zugriff über ein Manager-Konto.
  • Das Ziel-Advertiser-Konto ist ein untergeordnetes Konto unter einem MCC,
  • Das Konto wird nicht direkt als barrierefreies Konto der obersten Ebene zurückgegeben.

Legen Sie für direkt zugängliche Advertiser-Konten keine unnötigen loginCustomerId fest. Überprüfen Sie nach Möglichkeit, ob das Konto zuerst direkt zugänglich ist, und geben Sie nur dann eine Manager-ID an, wenn der Zugriff wirklich von dieser Hierarchie abhängt.

Authentifizierungs- und Verbindungsverhalten

Die Google Ads-Quelle verwendet OAuth 2.0, um Anforderungen an die Google Ads-API zu authentifizieren. Experience Platform speichert die Verbindungsdetails in einer Basisverbindung und verwendet die angegebenen Anmeldeinformationen, um Google Ads API-Aufrufe im Namen des Kunden zu autorisieren.

Bei Szenarien mit Manager-Konten muss der Connector möglicherweise die entsprechende Manager-Hierarchie auflösen, um erfolgreich auf das Ziel-Advertiser-Konto zugreifen zu können. Intern umfasst dies in der Regel:

  1. Aufzählung der zugänglichen Konten,
  2. Feststellen, ob ein Konto ein Manager-Konto ist,
  3. Nicht-Manager-Leaf-Konten identifizieren,
  4. Beheben der richtigen loginCustomerId, wenn das Zielkonto nur über eine MCC-Hierarchie erreichbar ist.

Dieses Verhalten ist besonders für Kunden wichtig, die mehrere Advertiser-Konten über eine einzige Manager-Kontostruktur verwalten.

Verhalten bei Datenauswahl und Reporting

Google Ads Datenauswahl basiert auf Google AdsQuery Language (GAQL). Während des Setups geben Sie die Attribute, Segmente und Metriken an, die für die Aufnahme abgerufen werden sollen.

Bei großen Report Pull-Vorgängen unterstützt Google Ads sowohl Standardsuchmuster als auch Streaming-Abrufmuster. Intern wird der Streaming-Abruf für größere Ergebnismengen bevorzugt, da er es ermöglicht, Berichtszeilen inkrementell zu nutzen, anstatt sie Seite für Seite gepuffert zu halten.

Verwenden Sie beim Konfigurieren der Datenauswahl in der Experience Platform-Benutzeroberfläche den Google AdsQuery Builder um den Ressourcentyp und die Felder auszuwählen, die Sie aufnehmen möchten, die Abfrage zu validieren und dann die erforderlichen Attribute in den Quell-Workflow zu kopieren.

Unterstützte Verbindungspfade

Sie können Google Ads entweder über APIs oder die Benutzeroberfläche mit Experience Platform verbinden.

Verwenden von APIs

Verwenden Sie die Flow Service API, wenn Sie eine programmgesteuerte Einrichtung, eine wiederholbare Konfiguration oder Unterstützung für die inkrementelle Aufnahme benötigen. Der API-Workflow umfasst auf allgemeiner Ebene:

  1. Erstellen einer Basisverbindung,
  2. Erkunden der Quellkonfiguration,
  3. Erstellen der Quell- und Zielverbindung,
  4. Erstellen eines Datenflusses für die Aufnahme

Verwenden der Benutzeroberfläche

Verwenden Sie den Arbeitsbereich "Experience Platform-" für eine geführte Einrichtung, wenn Sie Google Ads über die Benutzeroberfläche verbinden möchten. Der Benutzeroberflächen-Fluss unterstützt die Eingabe von Anmeldeinformationen, Attributauswahl, Vorschau und Erstellung von Datenflüssen. Derzeit bleibt der Benutzeroberflächen-Pfad die Beta-Version und unterstützt nur eine einmalige Aufnahme.

Bekannte Einschränkungen und Hinweise

  • Die Google Ads in der Benutzeroberfläche ist derzeit die Beta-Version.
  • Die Benutzeroberfläche unterstützt derzeit nur eine einmalige Aufnahme.
  • Verwenden Sie den API-basierten Pfad für die inkrementelle Aufnahme.
  • Experience Platform unterstützt derzeit Google Ads API-Version v19 und höher.
  • Manager-Konto-Hierarchien erfordern eine sorgfältige Handhabung der loginCustomerId. Falsche Werte können den Zugriff auf untergeordnete Advertiser-Konten verhindern.

Nächste Schritte

Nachdem Sie Ihre Anmeldedaten erfasst und Ihr Zugriffsmuster für das Konto bestätigt haben, fahren Sie mit einem der folgenden Einrichtungspfade fort:

recommendation-more-help
experience-platform-help-sources