DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

Verbinden von Google Ads mit Experience Platform mithilfe der Flow Service-API

Letzte Aktualisierung: 16. Oktober 2025

Erstellt für:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}
NOTE
Die Google Ads befindet sich derzeit in der Beta-Phase und unterstützt nur eine einmalige Aufnahme. Weitere Informationen zur Verwendung von Betagekennzeichneten Quellen finden Sie ​ „Quellen - Übersicht“ .

Eine Basisverbindung stellt die authentifizierte Verbindung zwischen Ihrer Quelle und Adobe Experience Platform dar. Verwenden Sie dieses Tutorial, um Ihr Google Ads-Konto mithilfe der Flow Service API mit Experience Platform zu verbinden.

Eine Google Ads-Basisverbindung speichert die Authentifizierungsdetails, die für den Zugriff auf die Google Ads-API erforderlich sind, und erstellt die Verbindungs-ID, die Sie in späteren Schritten verwenden werden, um Ihre Quellkonfiguration zu untersuchen und einen Datenfluss zu erstellen.

Erste Schritte

Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Experience Platform voraus:

  • Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Experience Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
  • Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um mithilfe der Flow Service-API eine Verbindung zu Google Ads herstellen zu können.

Verwenden von Experience Platform-APIs

Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter ​ mit Experience Platform-APIs.

Sammeln von Werten für erforderliche Kopfzeilen

Um Experience Platform-APIs aufzurufen, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Kopfzeilen in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
x-sandbox-name: {SANDBOX_NAME}
Content-Type: application/json

Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Bei allen Anfragen an Experience Platform-APIs ist eine Kopfzeile erforderlich, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll.

Sammeln erforderlicher Anmeldedaten

Informationen zur Authentifizierung finden Sie im Abschnitt Google Ads Quellenübersicht.

Erstellen einer Basisverbindung

Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Experience Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen ID der Basisverbindung.

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections-Endpunkt und geben Sie dabei Ihre Google Ads-Authentifizierungsdaten als Teil der Anfrageparameter an.

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Google Ads:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "refreshToken": "{REFRESH_TOKEN}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "googleAdsApiVersion": "v19"

          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'

Wenn Ihr Target-Advertiser-Konto direkt zugänglich ist und kein Manager-Konto-Routing erfordert, können Sie loginCustomerID im auth.params-Objekt auslassen.

Eigenschaft
Beschreibung
name
Der Name Ihrer Basisverbindung. Verwenden Sie einen beschreibenden Namen, der die spätere Identifizierung der Google Ads-Verbindung erleichtert.
description
Eine optionale Beschreibung, mit der Sie zusätzlichen Kontext über die Verbindung speichern können.
auth.specName
Der vom Connector verwendete Authentifizierungstyp.
auth.params.clientCustomerID
Die Kunden-ID Ihres Google Ads Kontos.
auth.params.loginCustomerID
Die Kunden-ID für die Anmeldung, die Ihrem Google Ads Manager-Konto entspricht.
auth.params.developerToken
Das Entwickler-Token Ihres Google Ads.
auth.params.refreshToken
Das Aktualisierungs-Token Ihres Google Ads Kontos.
auth.params.clientID
Die Client-ID Ihres Google Ads.
auth.params.clientSecret
Das Client-Geheimnis Ihres Google Ads.
auth.params.googleAdsApiVersion
Die Google Ads API-Version, die Sie verwenden. Experience Platform unterstützt derzeit Version v19 und höher. Stellen Sie sicher, dass Sie eine dieser unterstützten Versionen verwenden, um die Kompatibilität sicherzustellen.
connectionSpec.id
Die Spezifikations-ID der Google Ads-Verbindung: d771e9c1-4f26-40dc-8617-ce58c4b53702.

Antwort

Bei einer erfolgreichen Antwort werden Details zu der neu erstellten Basisverbindung zurückgegeben, einschließlich ihrer eindeutigen Kennung (id). Diese ID ist im nächsten Schritt erforderlich, um eine Quellverbindung zu erstellen.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

Überprüfen der Verbindungsdetails

Nachdem Sie Ihre Basisverbindung erstellt haben, überprüfen Sie Folgendes, bevor Sie fortfahren:

  • Die Basisverbindung wurde in der vorgesehenen Sandbox erstellt.
  • Die clientCustomerId verweist auf das beabsichtigte Advertiser-Konto,
  • Die loginCustomerId ist korrekt, wenn der Zugriff auf das Advertiser-Konto über einen MCC erfolgt.
  • Die Google Ads-API-Version wird von Experience Platform unterstützt.

Wenn die Authentifizierung erfolgreich ist, aber der nachgelagerte Datenzugriff fehlschlägt, ist die häufigste Ursache eine falsche oder unnötige loginCustomerId.

Nächste Schritte

In diesem Tutorial haben Sie eine Google Ads-Basisverbindung mithilfe der Flow Service-API erstellt.

Sie können jetzt mit den folgenden Tutorials fortfahren:

Fehlerbehebung

Autorisierungsfehler für untergeordnete Advertiser-Konten

Wenn Anfragen fehlschlagen, wenn Sie versuchen, auf ein untergeordnetes Advertiser-Konto zuzugreifen, stellen Sie sicher, dass loginCustomerId auf das richtige Manager-Konto festgelegt ist. Dies ist erforderlich, wenn der Zugriff über eine MCC-Hierarchie vermittelt wird.

Ungültiges oder widerrufenes Aktualisierungstoken

Wenn der Connector Zugriffstoken nicht aktualisieren kann, autorisieren Sie das Google Ads-Konto erneut, ein neues Aktualisierungstoken zu generieren.

Nicht unterstützte API-Version

Wenn Anfragen aufgrund von Versionskonflikten fehlschlagen, stellen Sie sicher, dass googleAdsApiVersion auf eine von Experience Platform unterstützte Version eingestellt ist.

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