Ziele und Header konfigurieren

Sowohl das Konzept Destination als auch Anfrageheader werden bei der Arbeit mit der Data Manager API häufig verwendet. In diesem Leitfaden erfahren Sie, wie Sie Ziele und Header für verschiedene Szenarien konfigurieren.

Wann Ziele oder Header verwendet werden sollten

  • Verwenden Sie eine Destination in Aufnahmeanfragen. Bei einer Aufnahme-Anfrage wird die IngestionService verwendet, um Mitglieder einer Zielgruppe hinzuzufügen oder zu entfernen oder Ereignisse zu senden. Die Liste destinations in einem IngestAudienceMembersRequest oder IngestEventsRequest definiert Folgendes:

    1. Das Konto, das die Daten empfängt. Beispielsweise ein Google Ads-Konto oder eine Google Analytics-Property.
    2. Das Zielobjekt 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.

    Sie können mehrere Ziele in dieselbe Aufnahme-Anfrage aufnehmen.

  • Verwenden Sie Anfrageheader in Anfragen zur Ressourcenverwaltung, mit denen Ressourcen erstellt, aktualisiert, gelöscht oder abgerufen werden. Header definieren den Zugriffspfad für die Anmeldedaten der Anfrage an das Zielkonto der Ressourcenverwaltungsanfrage. Hier ist die Liste der Ressourcen mit Ressourcenverwaltungsmethoden, die Anfrageheader unterstützen:

Wenn Sie beispielsweise eine Zielgruppe erstellen, Mitglieder hinzufügen, Diagnosen prüfen und dann die Zielgruppe abrufen möchten, um ihre Größe zu prüfen, finden Sie hier die einzelnen Schritte, den zu verwendenden Anfragetyp und die Information, ob Sie Ziele oder Anfrageheader verwenden sollten:

Schritt Art der Anfrage Ziel- oder Anfrageheader
Zielgruppe erstellen Ressourcenverwaltung Anfrageheader
Einer Zielgruppe Mitglieder hinzufügen Aufnahme Ziele
Diagnoseinformationen ansehen Aufnahme Ziele
Zielgruppe abrufen Ressourcenverwaltung Anfrageheader

Sie können zwischen den Details in diesem Leitfaden für jeden Anfragetyp wechseln, indem Sie auf den Tab Aufnahme oder Ressourcenverwaltung klicken, der jede Tabelle umgibt.

Wenn Sie Werbetreibender oder eine Agentur sind, finden Sie im Abschnitt Szenarien für Werbetreibende Beispiele dafür, wie Sie Header festlegen und einen Destination erstellen:

Wenn Sie ein Datenpartner sind, finden Sie im Abschnitt Szenarien für Datenpartner Beispiele dafür, wie Sie Header festlegen und eine Destination erstellen, um Ressourcen zu verwalten und Daten an ein Konto mit einer Partnerverknüpfung zu Ihrem Datenpartnerkonto zu senden:

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

Szenarien für Werbetreibende

Im Folgenden wird beschrieben, wie Sie einen Destination oder Anfrageheader für gängige Szenarien für Werbetreibende und Agenturen konfigurieren. In diesem Diagramm sehen Sie, wie die Data Manager API die Anmeldedaten und die Destination-Felder verwendet, um auf das Werbetreibendenkonto zuzugreifen.

Zugriffspfad für Werbetreibende

Google Ads

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

Google Ads-Konten und -Nutzer

Verwaltungskonto M1

M1 hat zwei direkt untergeordnete Konten:

  1. Verwaltungskonto M2
  2. Kundenkonto C1

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

Verwaltungskonto M2

M2 hat zwei direkt 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

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

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

In den Szenarien Direkter Zugriff und Verwalterzugriff wird gezeigt, wie Sie ein Ziel konfigurieren, um Daten an diese Konten zu senden.

Szenario für Direktzugriff

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

Aufnahme
Ziel
operating_account
account_id Die Kundennummer des Google Ads-Kontos
account_type GOOGLE_ADS
login_account Legen Sie entweder login_account nicht fest oder legen Sie 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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

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

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Szenario für den Zugriff durch Manager

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:

Aufnahme
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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Hier ist ein weiteres Beispiel für ein Szenario mit Administratorzugriff für das Google Ads-Kundenkonto C2 und die Anmeldedaten für das Google-Konto cloudysanfrancisco@gmail.com, das ein Nutzer im Google Ads-Verwaltungskonto M1 ist:

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Display & Video 360

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

  1. Direkter Zugriff, bei dem die Anmeldedaten für ein Google-Konto gelten, 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:

Aufnahme
Ziel
operating_account
account_id Die ID des Display & Video 360-Werbetreibendenkontos
account_type DISPLAY_VIDEO_ADVERTISER
login_account Legen Sie entweder login_account nicht fest oder legen Sie 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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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:

Aufnahme
Ziel
operating_account
account_id Die ID des Display & Video 360-Partnerkontos
account_type DISPLAY_VIDEO_PARTNER
login_account Legen Sie entweder login_account nicht fest oder legen Sie 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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Szenario für den Zugriff auf Display & Video 360-Partner

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

Aufnahme
Ziel
operating_account
account_id Die 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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Hier ist ein Beispiel für eine Destination für ein Partnerzugriffsszenario, um Daten an einen Display & Video 360-Werbetreibenden zu senden. In diesem Fall müssen die Anmeldedaten für ein Google-Konto gelten, das ein Nutzer im Display & Video 360-Partnerkonto DISPLAY_VIDEO_PARTNER_ID ist, und das Display & Video 360-Werbetreibendenkonto DISPLAY_VIDEO_ADVERTISER_ID muss ein untergeordnetes Konto des Partnerkontos DISPLAY_VIDEO_PARTNER_ID sein.

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Google Analytics

Hinweis: Wenn die operating_account ein Google Analytics-Konto ist, legen Sie entweder die login_account nicht fest oder legen Sie sie auf dieselben Werte wie die operating_account fest. Andernfalls schlägt die Anfrage mit dem Fehler OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH fehl.

Aufnahme
Ziel
operating_account
account_id Die ID der Google Analytics-Property
account_type GOOGLE_ANALYTICS_PROPERTY
login_account Legen Sie entweder login_account nicht fest oder legen Sie dieselben Werte wie für operating_account fest.
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account Legen Sie den Header linked-account nicht fest.

Floodlight

Aufnahme
Ziel
operating_account
account_id Die Floodlight-Konfigurations-ID
Wenn Ihr Werbetreibender einem übergeordneten Werbetreibenden untergeordnet ist, verwenden Sie die ID des übergeordneten Werbetreibenden in Campaign Manager 360 als Floodlight-Konfigurations-ID. Verwenden Sie andernfalls die ID Ihres Werbetreibenden. So finden Sie die Werbetreibenden-ID in der Campaign Manager 360-Benutzeroberfläche
account_type FLOODLIGHT_CONFIG
login_account Legen Sie entweder login_account nicht fest oder legen Sie dieselben Werte wie für operating_account fest.
linked_account Legen Sie das Feld linked_account nicht fest.
product_destination_id Die ID der Floodlight-Aktivität

Hier ist ein Beispiel für ein Destination zum Senden von Ereignissen an Floodlight:

Aufnahme
        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }

Szenarien für Datenpartner

So konfigurieren Sie einen Destination für gängige Szenarien für einen Datenpartner, der Daten an Werbetreibendenkonten mit einer bestehenden Partnerverknüpfung zum Datenpartnerkonto sendet.

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

Zugriffspfad für Datenpartner

Google Ads

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

Datenpartner- und Google Ads-Konten und -Nutzer

Datenpartner D1

Es besteht eine Partnerverknüpfung zwischen D1 und dem Google Ads-Verwaltungskonto M2.

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

Datenpartner D2

Es besteht eine Partnerverknüpfung zwischen D2 und dem Google Ads-Kundenkonto C1.

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

Verwaltungskonto M1

M1 hat zwei direkt untergeordnete Konten:

  1. Verwaltungskonto M2
  2. Kundenkonto C1
Verwaltungskonto M2

M2 hat zwei direkt untergeordnete Konten:

  1. Kundenkonto C1
  2. Kundenkonto C2
Kundenkonto C1

C1 hat zwei direkte übergeordnete Verwaltungskonten:

  1. Verwaltungskonto M1
  2. Verwaltungskonto M2
Kundenkonto C2

Das 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 agieren möchten, verwenden Sie die Anmeldedaten für das Google-Konto 222larabrown@gmail.com, um:

  • Senden Sie Daten an das Kundenkonto C1 oder C2. Verwenden Sie dazu ein Ziel, bei dem login_account auf das Datenpartnerkonto D1 und linked_account auf das Verwaltungskonto M2 festgelegt ist.

  • Daten direkt an das Verwaltungskonto M2 senden, wobei ein Ziel mit login_account auf das Datenpartnerkonto D1 festgelegt ist. Legen Sie linked_account nicht fest.

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

Als Datenpartner D2 agieren

Wenn Sie als Datenpartner D2 agieren möchten, verwenden Sie die Anmeldedaten für das Google-Konto jeffersonloveshiking@gmail.com, um Daten an das Kundenkonto C1 zu senden. Verwenden Sie dazu ein Ziel, bei dem login_account auf das Datenpartnerkonto D2 festgelegt ist. Legen Sie linked_account nicht fest.

Als Datenpartner D2 können Sie keine Daten an das Verwaltungskonto M1, das Verwaltungskonto M2 oder das Kundenkonto C2 senden, da keine Partnerverknüpfung zwischen D2 und einem dieser Konten oder deren ü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 Partnerlink

Wenn Sie Daten an ein Google Ads-Konto senden möchten und die Partnerverknüpfung zwischen dem Google Ads-Konto und Ihrem Datenpartnerkonto besteht:

Aufnahme
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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Hier ist ein Beispiel für ein Szenario mit direkter Partnerverknüpfung mit Konten aus dem Diagramm und den entsprechenden Anfrageheadern für Ressourcenverwaltungsanfragen. In diesem Szenario sendet der Datenpartner D2 Daten zu Zielgruppenmitgliedern an den Google Ads-Zweitkunden C1. Dazu verwendet er die Partnerverknüpfung zwischen D2 und C1 sowie die Anmeldedaten für das Google-Konto jeffersonloveshiking@gmail.com:

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Szenario für die Verknüpfung von Verwaltungskonten

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

Aufnahme
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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Hier ein Beispiel für ein Szenario mit einer Verknüpfung zwischen Verwaltungskonto und Partnerkonto, bei dem Konten aus dem Diagramm verwendet werden. In diesem Szenario sendet der Datenpartner D1 Daten zu Zielgruppenmitgliedern an den Google Ads-Kunden C2. Dazu verwendet er die Partnerverknüpfung zwischen D1 und M2 sowie die Anmeldedaten für das Google-Konto 222larabrown@gmail.com:

Aufnahme
{
  "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"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

Als Datenpartner können Sie Daten auf zwei Arten an ein Display & Video 360-Konto senden:

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

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

Aufnahme
Ziel
operating_account
account_id Die 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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direkter Partnerverknüpfung, um Daten an einen Display & Video 360-Werbetreibenden zu senden, und die entsprechenden Anfrageheader für Anfragen zur Ressourcenverwaltung:

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

Aufnahme
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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direkter Partnerverknüpfung, um Daten an einen Display & Video 360-Partner zu senden, und die entsprechenden Anfrageheader für Anfragen zur Ressourcenverwaltung:

Aufnahme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

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

Aufnahme
Ziel
operating_account
account_id Die 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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Hier ist ein Beispiel für eine Destination für ein Partnerverknüpfungsszenario, bei dem Daten über eine Partnerverknüpfung zwischen dem Datenpartner und dem übergeordneten Display & Video 360-Partner des Werbetreibenden an einen Display & Video 360-Werbetreibenden gesendet werden:

Aufnahme
{
  "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"
    }
  ]
}
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

Wenn Sie Daten an ein Google Ad Manager-Konto senden möchten und eine Partnerverknüpfung zwischen Ihrem Datenpartnerkonto und dem Google Ad Manager-Konto besteht:

Aufnahme
Ziel
operating_account
account_id Die Zielgruppenverknüpfungs-ID des Google Ad Manager-Kontos
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
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.
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Hier ist ein Beispiel für eine Destination, mit der Daten über einen Partnerlink an ein Google Ad Manager-Konto gesendet werden:

Aufnahme
      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
Ressourcenverwaltung
Anfrageheader
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Legen Sie den Header linked-account nicht fest.

Google Analytics

Die Data Manager API unterstützt das Senden von Daten an ein Google Analytics-Konto über einen Partnerlink nicht. Verwenden Sie stattdessen den Ansatz Werbetreibenden-Szenarien für Google Analytics.

Floodlight

Die Data Manager API unterstützt das Senden von Daten an eine Floodlight-Konfiguration über eine Partnerverknüpfung nicht. Verwenden Sie stattdessen den Ansatz Werbetreibenden-Szenarien für Floodlight.

Detaillierte Anforderungen

Dieser Abschnitt enthält detaillierte Anforderungen für die Kontofelder einer Destination für eine IngestionService-Anfrage, die entsprechenden Anfrageheader für Ressourcenverwaltungsanfragen, Tipps zum Festlegen der product_destination_id und Informationen dazu, wie Sie feststellen, worauf Ihre Anmeldedaten Zugriff haben.

Kontofelder

Ein Destination kann bis zu drei verschiedene Konten haben:

operating_account

operating_account ist erforderlich.

operating_account gibt an, welches Konto die Daten in der Anfrage erhält. Der Wert für operating_account kann einer der folgenden sein:

Es gibt keinen Anfrageheader, der dem Feld operating_account eines Destination entspricht. Wenn Sie eine Anfrage zur Ressourcenverwaltung senden, ist das Zielkonto der Anfrage das Betriebskonto.

Feld login_account und Anfrageheader login-account

Die login_account ist nicht immer erforderlich und wird standardmäßig auf die operating_account in einer IngestionService-Anfrage und das Zielkonto in einer Ressourcenverwaltungsanfrage festgelegt. Verwenden Sie in einer Ressourcenverwaltungsanfrage den Anfrageheader login-account, um das Anmeldekonto zu identifizieren.

Die Data Manager API prüft Folgendes:

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

  2. Das Anmeldekonto ist eines der folgenden:

    • Identisch mit operating_account. Dies ist die Standardeinstellung, wenn Sie in einer IngestionService-Anfrage nicht die login_account einer Destination oder in einer Ressourcenverwaltungsanfrage nicht den login-account-Header festlegen.

    • Ein Google Ads-Verwaltungskonto oder ein Display & Video 360-Partnerkonto, das in einer IngestionService-Anfrage ein übergeordnetes Konto des operating_account oder in einer Anfrage zur Ressourcenverwaltung ein übergeordnetes Konto des Zielkontos ist.

    • Ein Datenpartnerkonto mit einem Partnerlink zur linked_account in einer IngestionService-Anfrage oder dem linked-account-Header in einer Ressourcenverwaltungsanfrage.

Feld linked_account und Anfrageheader linked-account

linked_account gibt an, welches Konto eine Partnerverknüpfung mit dem login_account einer IngestionService-Anfrage oder dem Zielkonto einer Ressourcenverwaltungsanfrage hat.

Ziel-ID des Produkts

Der product_destination_id eines Destination gibt an, welches Objekt im 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-Datenstream 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. Sie können diese ID über die Google Ads-Benutzeroberfläche oder die Data Manager API abrufen.

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 Namen der Zielgruppe, um Details aufzurufen.
  3. Die Zielgruppen-ID wird neben Listen-ID aufgeführt.

Data Manager API

Rufen Sie die UserList mit der Methode List ab und geben Sie bei Bedarf Anfrageheader an. Verwenden Sie die id der UserList für die Produktziel-ID.

Google Ads-Ereignis

Die Produktziel-ID für die Aufnahme von Ereignissen ist die ID der Conversion-Aktion. Sie können diese ID über die Google Ads-Benutzeroberfläche oder die Google Ads API abrufen.

So rufen Sie die ID der Conversion-Aktion ü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.
  3. Wechseln Sie zum Tab Details.
  4. Die Conversion-Aktions-ID ist die Nummer neben Conversion-Typ-ID.

So rufen Sie die ID der Conversion-Aktion ü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 ID der Conversion-Aktion aus dem Feld id in der 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. Sie können diese ID über die Display & Video 360-Benutzeroberfläche oder die Data Manager API abrufen.

Display & Video 360-Benutzeroberfläche

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

  1. Melden Sie sich unter https://displayvideo.google.com in der Display & Video 360-Benutzeroberfläche 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ü auf der linken Seite auf Zielgruppen und wählen Sie dann Alle Zielgruppen aus.
  4. Suchen Sie die Zielgruppe in der Liste. Die Zielgruppen-ID ist die Nummer neben dem Namen in der Spalte Name.

Data Manager API

Rufen Sie die UserList mit der Methode List ab und geben Sie bei Bedarf Anfrageheader an. Verwenden Sie die id der UserList für die Produktziel-ID.

Google Analytics-Ereignis

Die Produktziel-ID hängt vom Typ des Datenstreams ab.

Web-Datenstream
Verwenden Sie die Mess-ID des Datenstreams.
App-Datenstream

Verwenden Sie die Firebase-App-ID des Datenstreams. Es gibt zwei Möglichkeiten, Ihre Firebase-App-ID zu finden:

Floodlight-Ereignis

Die Produktziel-ID für die Aufnahme von Ereignissen in Floodlight ist die Floodlight-Aktivitäts-ID. Sie können diese ID über die Campaign Manager 360-Benutzeroberfläche oder die Campaign Manager 360 API abrufen.

Campaign Manager 360-Benutzeroberfläche

So rufen Sie die ID der Floodlight-Aktivität über die Campaign Manager 360-Benutzeroberfläche ab:

  1. Melden Sie sich in der Campaign Manager 360-Benutzeroberfläche an.
  2. Rufen Sie den Campaign Manager 360-Werbetreibenden auf, den Sie für die operating_account verwenden.
  3. Klicken Sie im Menü auf der linken Seite auf Floodlight und wählen Sie dann Aktivitäten aus.
  4. Suchen Sie die Floodlight-Aktivität in der Liste. Die ID ist die Nummer neben dem Namen in der Spalte Aktivitätsname.

Campaign Manager 360 API

So rufen Sie die ID der Floodlight-Aktivität über die Campaign Manager 360 API ab:

  1. Senden Sie eine list-Anfrage an die Ressource floodlightActivities.
  2. Geben Sie die floodlightConfigurationId der Floodlight-Konfiguration an.
  3. Optional können Sie den Parameter searchString verwenden, um nach Aktivitätsnamen zu filtern.
  4. Rufen Sie die ID der Floodlight-Aktivität aus dem Feld id des ausgewählten FloodlightActivity in der Antwort ab.

Festlegen, worauf Anmeldedaten Zugriff haben

Die Anmeldedaten, die Sie zum Autorisieren einer Data Manager API-Anfrage verwenden, sind mit einem bestimmten Google-Konto verknüpft.

  • Wenn Sie Nutzeranmeldedaten verwenden, werden Anfragen als das Google-Konto des Nutzers autorisiert, der Ihnen bei der Erstellung der Anmeldedaten die Berechtigung erteilt hat, in seinem Namen zu handeln.
  • 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-, Google Analytics- oder Campaign Manager 360-Konto hat:

Google Ads oder Datenpartner

  1. Rufen Sie in der Google Ads-Benutzeroberfläche für login_account die Option Zugriff und Sicherheit auf.
  2. Klicken Sie auf den Tab Nutzer.
  3. Wenn das login_account ein Google Ads-Verwaltungskonto ist, deaktivieren Sie die Option 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 enthalten 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 angezeigt wird.

Google Analytics

  1. Rufen Sie in der Google Analytics-Benutzeroberfläche die Zugriffsverwaltung für die Property auf.
  2. Prüfen Sie, ob die in der 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.

Floodlight (Campaign Manager 360)

  1. Melden Sie sich in der Campaign Manager 360-Benutzeroberfläche an.
  2. Gehen Sie im Menü auf der linken Seite zu Verwaltung > Nutzerprofile.
  3. Prüfen Sie, ob das Google-Konto für Ihre Anmeldedaten in der Liste der angezeigten Profile enthalten ist.
  4. Klicken Sie auf das Profil und prüfen Sie, ob es Zugriff auf das Werbetreibendenkonto hat, das als login_account verwendet wird. Wenn Sie in der Anfrage keinen login_account festlegen, wird standardmäßig der operating_account verwendet. Das Konto muss eine Nutzerrolle mit der Berechtigung Offline-Conversions einfügen haben.
Weiter
Nutzerdaten formatieren