Ziele konfigurieren

Jedes Destination in einem IngestAudienceMembersRequest oder IngestEventsRequest definiert Folgendes:

  1. Das Konto, in dem die Daten eingehen. Das kann beispielsweise ein Google Ads-Konto oder eine Google Analytics-Property sein.
  2. Die Zielentität für die Daten im Konto, z. B. eine Google Ads-Conversion-Aktion oder ein Google Analytics-Stream.
  3. Der Zugriffspfad für die Anmeldedaten der Anfrage für das Konto, das die Daten empfängt.

Wenn Sie ein Werbetreibender oder eine Agentur sind, finden Sie unter Szenarien für Werbetreibende Beispiele für die Erstellung eines Destination:

Wenn Sie ein Datenpartner sind, finden Sie unter Datenpartnerszenarien Beispiele für die Erstellung eines Destination zum Senden von Daten an ein Konto mit einer Produktverknüpfung zu Ihrem Datenpartnerkonto:

Im Abschnitt Detaillierte Anforderungen werden die Anforderungen und Validierungsregeln ausführlich beschrieben.

Szenarios für Werbetreibende

Hier erfahren Sie, wie Sie eine Destination für häufige Szenarien für Werbetreibende und Agenturen konfigurieren. In diesem Diagramm sehen Sie, wie die Data Manager API die Anmeldedaten und Destination-Felder verwendet, um auf das Werbetreibendenkonto zuzugreifen.

Zugriffspfad für Werbetreibende

Google Ads

Hier sehen Sie ein Beispiel für eine Gruppe von Google Ads-Konten und ‑Nutzern.

Google Ads-Konten und ‑Nutzer

Verwaltungskonto M1

M1 hat zwei untergeordnete Konten:

  1. Verwaltungskonto M2
  2. Kundenkonto C1

Das Google-Konto cloudysanfrancisco@gmail.com ist ein Nutzer in M1.

Verwaltungskonto M2

M2 hat zwei untergeordnete Konten:

  1. Kundenkonto C1
  2. Kundenkonto C2

Das Google-Konto baklavainthebalkans@gmail.com ist ein Nutzer in M2.

Kundenkonto C1

C1 hat zwei direkte übergeordnete Verwaltungskonten:

  1. Verwaltungskonto M1
  2. Verwaltungskonto M2

Das Google-Konto jeffersonloveshiking@gmail.com ist ein Nutzer in C1.

Kundenkonto C2

Verwaltungskonto M2 ist das einzige direkte übergeordnete Konto von C2.

Keines der aufgeführten Google-Konten ist ein Nutzer in C2.

Im Szenario für direkten Zugriff und im Szenario für Verwaltungskonto-Zugriff wird gezeigt, wie Sie ein Ziel konfigurieren, um Daten an diese Konten zu senden.

Direktzugriffsszenario

Wenn Sie Daten an ein Google Ads-Konto senden möchten und Ihre Anmeldedaten für ein Google-Konto sind, das ein Nutzer im Google Ads-Konto ist:

Ziel
operating_account
account_id Die Kundennummer des Google Ads-Kontos
account_type GOOGLE_ADS
login_account Entweder legen Sie login_account nicht fest oder Sie legen für login_account dieselben Werte wie für operating_account fest.
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier ist ein Beispiel für ein Szenario mit direktem Zugriff, in dem die Konten aus dem Diagramm und die Anmeldedaten für das Google-Konto jeffersonloveshiking@gmail.com verwendet werden.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Szenario für den Administratorzugriff

Wenn Sie Daten an ein Google Ads-Konto senden möchten und Ihre Anmeldedaten für ein Google-Konto gelten, das ein Nutzer in einem Google Ads-Verwaltungskonto ist, in dem das Werbetreibendenkonto ein untergeordnetes Konto ist:

Ziel
operating_account
account_id Die Kundennummer des Google Ads-Kundenkontos
account_type GOOGLE_ADS
login_account
account_id Die Kundennummer des Google Ads-Verwaltungskontos
account_type GOOGLE_ADS
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier sehen Sie ein Beispiel für ein Verwaltungskonto-Zugriffsszenario für das Google Ads-Kundenkonto C2 aus dem Diagramm und Anmeldedaten für das Google-Konto baklavainthebalkans@gmail.com:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Hier ist ein weiteres Beispiel für ein Verwaltungskonto-Zugriffsszenario für das Google Ads-Kundenkonto C2 und Anmeldedaten für das Google-Konto cloudysanfrancisco@gmail.com, das ein Nutzer des Google Ads-Verwaltungskontos M1 ist:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

Sie haben zwei Möglichkeiten, Daten an Display & Video 360 zu senden:

  1. Direkter Zugriff: Die Anmeldedaten gehören zu einem Google-Konto, das ein Nutzer im Display & Video 360-Werbetreibenden- oder Partnerkonto ist.
  2. Display & Video 360-Partnerzugriff, wobei die Anmeldedaten für ein Google-Konto gelten, das ein Nutzer im Display & Video 360-Partnerkonto ist, und das Betriebskonto ein Display & Video 360-Werbetreibendenkonto unter dem Partnerkonto ist.

Szenarien für den Direktzugriff

Wenn Sie Daten an ein Werbetreibendenkonto in Display & Video 360 senden möchten und Ihre Anmeldedaten für ein Google-Konto gelten, das ein Nutzer im Werbetreibendenkonto ist:

Ziel
operating_account
account_id ID des Display & Video 360-Werbetreibendenkontos
account_type DISPLAY_VIDEO_ADVERTISER
login_account Entweder legen Sie login_account nicht fest oder Sie legen für login_account dieselben Werte wie für operating_account fest.
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direktem Zugriff zum Senden von Daten an einen Werbetreibenden in Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Wenn Sie Daten an ein Display & Video 360-Partnerkonto senden möchten und Ihre Anmeldedaten für ein Google-Konto gelten, das ein Nutzer im Partnerkonto ist, gehen Sie so vor:

Ziel
operating_account
account_id Die ID des Display & Video 360-Partnerkontos
account_type DISPLAY_VIDEO_PARTNER
login_account Entweder legen Sie login_account nicht fest oder Sie legen für login_account dieselben Werte wie für operating_account fest.
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direktem Zugriff zum Senden von Daten an einen Partner in Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Szenario für den Zugriff von Display & Video 360-Partnern

Wenn Sie Daten an einen Werbetreibenden in Display & Video 360 senden möchten und Ihre Anmeldedaten für ein Google-Konto gelten, das ein Nutzer im übergeordneten Display & Video 360-Partnerkonto des Werbetreibenden ist:

Ziel
operating_account
account_id ID des Display & Video 360-Werbetreibendenkontos
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Die ID des Display & Video 360-Partnerkontos
account_type DISPLAY_VIDEO_PARTNER
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe.

Hier ist ein Beispiel für eine Destination für ein Szenario mit Partnerzugriff, in dem Daten an einen Display & Video 360-Werbetreibenden gesendet werden. In diesem Fall müssen die Anmeldedaten für ein Google-Konto verwendet werden, das ein Nutzer im Display & Video 360-Partnerkonto PARTNER_ID ist. Das Display & Video 360-Werbetreibendenkonto ADVERTISER_ID muss ein untergeordnetes Konto des Partnerkontos PARTNER_ID sein.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Analytics

Hinweis:operating_account und login_account müssen identisch sein, wenn das Ziel ein Google Analytics-Konto ist. Andernfalls schlägt die Anfrage mit dem Fehler OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH fehl.

Ziel
operating_account
account_id ID der Google Analytics-Property
account_type GOOGLE_ANALYTICS_PROPERTY
login_account Entweder legen Sie login_account nicht fest oder Sie legen für login_account dieselben Werte wie für operating_account fest.
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die Mess-ID des Datenstreams.

Hier ein Beispiel für ein Destination zum Senden von Ereignissen an Google Analytics:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

Szenarien für Datenpartner

Hier erfahren Sie, wie Sie eine Destination für gängige Szenarien für einen Datenpartner konfigurieren, der Daten an Werbetreibendenkonten mit einer bestehenden Produktverknüpfung zum Datenpartnerkonto sendet.

In diesem Diagramm sehen Sie, wie die Data Manager API die Anmeldedaten und Destination-Felder verwendet, um über eine Produktverknüpfung auf das Werbetreibendenkonto zuzugreifen.

Zugriffspfad für Datenpartner

Google Ads

Hier sehen Sie ein Beispiel für eine Reihe von Google Ads- und Datenpartnerkonten. Das Diagramm zeigt auch, welches Google-Konto ein Nutzer in den einzelnen Google Ads- oder Datenpartnerkonten ist, sowie die Produktverknüpfungen zwischen Konten.

Datenpartner, Google Ads-Konten und ‑Nutzer

Datenpartner D1

Zwischen D1 und dem Google Ads-Verwaltungskonto M2 besteht eine Produktverknüpfung.

Das Google-Konto 222larabrown@gmail.com ist ein Nutzer in D1.

Datenpartner D2

Zwischen D2 und dem Google Ads-Kundenkonto C1 besteht eine Produktverknüpfung.

Das Google-Konto jeffersonloveshiking@gmail.com ist ein Nutzer in D2.

Verwaltungskonto M1

M1 hat zwei untergeordnete Konten:

  1. Verwaltungskonto M2
  2. Kundenkonto C1
Verwaltungskonto M2

M2 hat zwei untergeordnete Konten:

  1. Kundenkonto C1
  2. Kundenkonto C2
Kundenkonto C1

C1 hat zwei direkte übergeordnete Verwaltungskonten:

  1. Verwaltungskonto M1
  2. Verwaltungskonto M2
Kundenkonto C2

Verwaltungskonto M2 ist das einzige direkte übergeordnete Konto von C2.

Mit diesen Konten können Sie Folgendes tun:

Als Datenpartner D1 agieren

Wenn Sie als Datenpartner D1 fungieren möchten, verwenden Sie Anmeldedaten für das Google-Konto 222larabrown@gmail.com, um Daten an das Verwaltungskonto M2, das Kundenkonto C1 oder das Kundenkonto C2 zu senden. Verwenden Sie dazu ein Ziel mit login_account, das auf das Datenpartnerkonto D1 festgelegt ist, und linked_account, das auf das Verwaltungskonto M2 festgelegt ist.

Als Datenpartner D1 können Sie keine Daten an das Verwaltungskonto M1 senden, da keine Produktverknüpfung zwischen D1 und M1 besteht.

Als Datenpartner D2 agieren

Wenn Sie als Datenpartner D2 fungieren möchten, verwenden Sie Anmeldedaten für das Google-Konto jeffersonloveshiking@gmail.com, um Daten an das Kundenkonto C1 zu senden. Verwenden Sie dazu ein Ziel mit login_account für das Datenpartnerkonto D2 und linked_account für das Kundenkonto C1.

Als Datenpartner D2 können Sie keine Daten an das Verwaltungskonto M1, das Verwaltungskonto M2 oder das Kundenkonto C2 senden, da keine Produktverknüpfung zwischen D2 und einem dieser Konten oder den zugehörigen übergeordneten Verwaltungskonten besteht.

Der Hauptunterschied zwischen den Datenpartnern D1 und D2 besteht darin, wie der Datenpartner mit Google Ads-Konten verknüpft ist.

Szenario mit direktem Produktlink

Wenn Sie Daten an ein Google Ads-Konto senden möchten und die Produktverknüpfung zwischen dem Google Ads-Konto und dem Konto Ihres Datenpartners besteht:

Ziel
operating_account
account_id Die Kundennummer des Google Ads-Kontos
account_type GOOGLE_ADS
login_account
account_id Die Kundennummer des Datenpartnerkontos
account_type DATA_PARTNER
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier ist ein Beispiel für ein Szenario mit direktem Produktlink unter Verwendung von Konten aus dem Diagramm. In diesem Szenario sendet Datenpartner D2 Daten zu Zielgruppenmitgliedern an Google Ads-Kunden C1. Dazu werden die Produktverknüpfung zwischen D2 und C1 sowie die Anmeldedaten für das Google-Konto jeffersonloveshiking@gmail.com verwendet:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Szenario für Produktverknüpfung für Verwaltungskonto

Wenn Sie Daten an ein Google Ads-Konto senden möchten und die Produktverknüpfung zwischen einem übergeordneten Google Ads-Verwaltungskonto und Ihrem Datenpartnerkonto besteht:

Ziel
operating_account
account_id Die Kundennummer des Google Ads-Kundenkontos
account_type GOOGLE_ADS
login_account
account_id Die Kundennummer des Datenpartnerkontos
account_type DATA_PARTNER
linked_account
account_id Die Kundennummer des Google Ads-Verwaltungskontos
account_type GOOGLE_ADS
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier ein Beispiel für ein Szenario mit einem Produktlink für ein Verwaltungskonto mit Konten aus dem Diagramm. In diesem Szenario sendet Datenpartner D1 Daten zu Zielgruppenmitgliedern an Google Ads-Kunden C2. Dazu werden die Produktverknüpfung zwischen D1 und M2 sowie die Anmeldedaten für das Google-Konto 222larabrown@gmail.com verwendet:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

Als Datenpartner haben Sie zwei Möglichkeiten, Daten an ein Display & Video 360-Konto zu senden:

  1. Verwenden Sie eine direkte Produktverknüpfung zwischen einem Datenpartnerkonto und dem Display & Video 360-Partner- oder ‑Werbetreibendenkonto.
  2. Daten an einen Display & Video 360-Werbetreibenden senden. Dazu ist eine Produktverknüpfung zwischen einem Datenpartnerkonto und dem übergeordneten Display & Video 360-Partnerkonto des Werbetreibenden erforderlich.

Wenn Sie Daten an einen Werbetreibenden in Display & Video 360 senden möchten und die Produktverknüpfung zwischen dem Display & Video 360-Werbetreibendenkonto und Ihrem Datenpartnerkonto besteht:

Ziel
operating_account
account_id ID des Display & Video 360-Werbetreibendenkontos
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Die Kundennummer des Datenpartnerkontos
account_type DATA_PARTNER
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direktem Produktlink, um Daten an einen Display & Video 360-Werbetreibenden zu senden:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Wenn Sie Daten an ein Display & Video 360-Partnerkonto senden möchten, muss eine Produktverknüpfung zwischen dem Display & Video 360-Partnerkonto und Ihrem Datenpartnerkonto bestehen.

Ziel
operating_account
account_id Die ID des Display & Video 360-Partnerkontos
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id Die Kundennummer des Datenpartnerkontos
account_type DATA_PARTNER
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier ist ein Beispiel für ein Destination für ein Szenario mit direktem Produktlink, um Daten an einen Display & Video 360-Partner zu senden:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Wenn Sie Daten an einen Werbetreibenden in Display & Video 360 senden möchten und die Produktverknüpfung zu Ihrem Datenpartnerkonto mit einem Display & Video 360-Partnerkonto erfolgt, bei dem das Werbetreibendenkonto ein untergeordnetes Konto ist:

Ziel
operating_account
account_id ID des Display & Video 360-Werbetreibendenkontos
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Die Kundennummer des Datenpartnerkontos
account_type DATA_PARTNER
linked_account
account_id Die ID des Display & Video 360-Partnerkontos
account_type DISPLAY_VIDEO_PARTNER
product_destination_id Die ID der Zielgruppe oder Conversion-Aktion.

Hier ist ein Beispiel für eine Destination für ein Szenario mit einer Partnerproduktverknüpfung, in dem Daten über eine Produktverknüpfung zwischen dem Datenpartner und dem übergeordneten Display & Video 360-Partner des Werbetreibenden an einen Display & Video 360-Werbetreibenden gesendet werden:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Analytics

Mit der Data Manager API können keine Daten über eine Produktverknüpfung an ein Google Analytics-Konto gesendet werden. Verwenden Sie stattdessen die Szenarien für Werbetreibende für Google Analytics.

Detaillierte Anforderungen

Dieser Abschnitt enthält detaillierte Anforderungen für die Kontofelder eines Destination, Tipps zum Festlegen des product_destination_id und Informationen dazu, wie Sie ermitteln, wo Ihre Anmeldedaten Zugriff haben.

Kontofelder

Ein Destination kann bis zu drei verschiedene Konten haben:

operating_account

operating_account ist erforderlich.

Mit operating_account wird angegeben, in welchem Konto die Daten in der Anfrage empfangen werden. operating_account kann einer der folgenden Werte sein:

login_account

Die login_account ist nicht immer erforderlich und wird standardmäßig auf die operating_account gesetzt.

Die Data Manager API prüft Folgendes:

  1. Das Google-Konto der Anmeldedaten ist ein Nutzer in der login_account.

  2. login_account ist einer der folgenden Werte:

    • Identisch mit operating_account. Dies ist die Standardeinstellung, wenn Sie login_account nicht festlegen.

    • Ein Google Ads-Verwaltungskonto oder ein Display & Video 360-Partnerkonto, das übergeordnetes Konto von operating_account ist.

    • Ein Datenpartnerkonto mit einer Produktverknüpfung zu linked_account.

linked_account

Die linked_account gibt an, welches Konto eine Produktverknüpfung zur login_account hat.

Ziel-ID des Produkts

Die product_destination_id eines Destination gibt an, welches Objekt in der operating_account die Daten empfängt. Das kann beispielsweise eine Zielgruppen-ID für Google Ads oder Display & Video 360, eine Conversion-Aktions-ID für Google Ads oder eine Mess-ID für einen Google Analytics-Stream sein.

So finden Sie die ID für die einzelnen Arten von Produktzielen.

Google Ads-Zielgruppe

Die Produktziel-ID für die Aufnahme von Zielgruppenmitgliedern ist die Zielgruppen-ID.

So rufen Sie die Zielgruppen-ID über die Google Ads-Benutzeroberfläche ab:

  1. Rufen Sie in der Google Ads-Benutzeroberfläche die Zielgruppenverwaltung auf.
  2. Klicken Sie auf den Zielgruppennamen, um Details aufzurufen.
  3. Die Zielgruppen-ID wird neben Listen-ID aufgeführt.

So rufen Sie die Zielgruppen-ID über die Google Ads API ab:

  1. Senden Sie eine Search- oder SearchStream-Anfrage an GoogleAdsService mit der folgenden Abfrage:

    SELECT
  user_list.id,
  user_list.name
FROM user_list
WHERE user_list.name = 'USER_LIST_NAME'

  2. Rufen Sie die Zielgruppen-ID aus dem Feld id in der user_list in der Antwort ab.

    [
  {
    "results": [
      {
        "userList": {
          "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
          "id": "USER_LIST_ID",
          "name": "USER_LIST_NAME"
        }
      }
    ]
  }
]

Google Ads-Ereignis

Die Produktziel-ID für die Aufnahme von Ereignissen ist die Conversion-Aktions-ID.

So rufen Sie die Conversion-Aktions-ID über die Google Ads-Benutzeroberfläche ab:

  1. Rufen Sie in der Google Ads-Benutzeroberfläche Conversions auf.
  2. Klicken Sie auf den Namen der Conversion-Aktion, um Details aufzurufen.

  3. Die Conversion-Aktions-ID ist der Wert für den URL-Suchparameter mit dem Namen ctId.

    https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...

So rufen Sie die Conversion-Aktions-ID über die Google Ads API ab:

  1. Senden Sie eine Search- oder SearchStream-Anfrage an GoogleAdsService mit der folgenden Abfrage:

    SELECT
  conversion_action.id,
  conversion_action.name
FROM conversion_action
WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'

  2. Rufen Sie die Conversion-Aktions-ID aus dem Feld id im conversion_action in der Antwort ab.

    [
  {
    "results": [
      {
        "conversionAction": {
          "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
          "id": "CONVERSION_ACTION_ID",
          "name": "CONVERSION_ACTION_NAME"
        }
      }
    ]
  }
]

Display & Video 360-Zielgruppe

Die Produktziel-ID für die Aufnahme von Zielgruppenmitgliedern ist die Zielgruppen-ID.

So rufen Sie die Zielgruppen-ID über die Display & Video 360-Benutzeroberfläche ab:

  1. Melden Sie sich in der Display & Video 360-Benutzeroberfläche unter https://displayvideo.google.com an.
  2. Rufen Sie den Display & Video 360-Partner oder -Werbetreibenden auf, den Sie für die operating_account verwenden.
  3. Klicken Sie im Menü links auf Zielgruppen und wählen Sie dann Alle Zielgruppen aus.
  4. Suchen Sie die Zielgruppe in der Liste. Die Zielgruppen-ID ist die Zahl neben dem Namen in der Spalte Name.

Google Analytics-Ereignis

Die Produktziel-ID für die Aufnahme von Ereignissen ist die Mess-ID des Datenstreams.

Zugriffsbereiche von Anmeldedaten ermitteln

Die Anmeldedaten, mit denen Sie eine Data Manager API-Anfrage autorisieren, sind mit einem bestimmten Google-Konto verknüpft.

  • Wenn Sie Nutzeranmeldedaten verwenden, werden Anfragen als das Google-Konto des Nutzers autorisiert, der die Berechtigung erteilt hat, in seinem Namen zu handeln, als Sie die Anmeldedaten generiert haben.
  • Wenn Sie Dienstkonto-Anmeldedaten verwenden, werden Anfragen als Google-Konto des Dienstkontos autorisiert.

So prüfen Sie, ob das Google-Konto für Ihre Anmeldedaten Zugriff auf ein Google Ads-, Display & Video 360- oder Google Analytics-Konto hat:

Google Ads oder Datenpartner

  1. Klicken Sie in der Google Ads-Benutzeroberfläche für login_account auf Zugriff und Sicherheit.
  2. Klicken Sie auf den Tab Nutzer.
  3. Wenn es sich bei login_account um ein Google Ads-Verwaltungskonto handelt, deaktivieren Sie die Ein/Aus-Schaltfläche Komplette Hierarchie der Nutzer anzeigen, um Nutzer aus untergeordneten Konten auszublenden.
  4. Prüfen Sie, ob das Google-Konto für Ihre Anmeldedaten in der Liste der Konten auf dem Tab Nutzer aufgeführt ist.

Display & Video 360

  1. Rufen Sie in der Display & Video 360-Benutzeroberfläche Nutzerverwaltung und E-Mail-Einstellungen auf.
  2. Prüfen Sie, ob in der Nutzerverwaltung das Google-Konto für Ihre Anmeldedaten als Nutzer in der login_account aufgeführt ist.

Google Analytics

  1. Rufen Sie in der Google Analytics-Benutzeroberfläche die Zugriffsverwaltung für Property auf.
  2. Prüfen Sie, ob die in login_account angegebene Google Analytics-Property ausgewählt ist.
  3. Prüfen Sie, ob das Google-Konto für Ihre Anmeldedaten die Rolle „Bearbeiter“ oder „Administrator“ für die Property hat.
Weiter
Nutzerdaten formatieren