Ziele und Header konfigurieren

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

Wann sollten Ziele oder Überschriften verwendet werden?

  • Verwenden Sie ein Destination in Aufnahmeanfragen. Bei einer Erfassungsanfrage wird 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, in dem die Daten eingehen. Das kann beispielsweise ein Google Ads-Konto oder eine Google Analytics-Property sein.
    2. Das Ziel 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 Erfassungsanfrage aufnehmen.

  • Verwenden Sie Anfrageheader in Ressourcenverwaltungsanfragen, mit denen Ressourcen erstellt, aktualisiert, gelöscht oder abgerufen werden. Über Header wird der Zugriffspfad für die Anmeldedaten der Anfrage zum Zielkonto der Ressourcenverwaltungsanfrage definiert. 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 Informationen dazu, 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

Klicken Sie auf den Tab Aufnahme oder Ressourcenverwaltung über den einzelnen Tabellen, um zwischen den Details in diesem Leitfaden für die einzelnen Anfragetypen zu wechseln.

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

Wenn Sie ein Datenpartner sind, finden Sie unter 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 einem Partnerlink zu Ihrem Datenpartnerkonto zu senden:

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

Szenarien für Werbetreibende

Hier erfahren Sie, wie Sie Destination oder Anfrageheader 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 ein Diagramm, das eine Gruppe von Google Ads-Konten und ‑Nutzern zeigt.

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 mit direktem Zugriff und im Szenario mit Administratorzugriff 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:

Aufnahme
Ziel
operating_account
account_id Die Kundennummer des Google Ads-Kontos
account_type GOOGLE_ADS
login_account Legen Sie login_account entweder 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 linked-account-Header nicht fest.

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:

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 linked-account-Header nicht fest.

Szenario für den Zugriff auf das Verwaltungskonto

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 linked-account-Header nicht fest.

Hier ist 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:

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 linked-account-Header nicht fest.

Hier ist ein weiteres Beispiel für ein Szenario mit Verwaltungszugriff 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:

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 linked-account-Header nicht fest.

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, bei dem 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 login_account entweder 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 linked-account-Header nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direktem Zugriff, um Daten an einen Werbetreibenden in Display & Video 360 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 linked-account-Header 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, gilt Folgendes:

Aufnahme
Ziel
operating_account
account_id Die ID des Display & Video 360-Partnerkontos
account_type DISPLAY_VIDEO_PARTNER
login_account Legen Sie login_account entweder 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 linked-account-Header nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direktem Zugriff, in dem Daten an einen Partner in Display & Video 360 gesendet werden:

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 linked-account-Header nicht fest.

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:

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 linked-account-Header nicht fest.

Hier ist ein Beispiel für ein 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 DISPLAY_VIDEO_PARTNER_ID ist. 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 linked-account-Header nicht fest.

Google Analytics

Hinweis:Wenn es sich bei operating_account um ein Google Analytics-Konto handelt, legen Sie login_account entweder nicht fest oder verwenden Sie dieselben Werte wie für operating_account. Andernfalls schlägt die Anfrage mit dem Fehler OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH fehl.

Aufnahme
Ziel
operating_account
account_id ID der Google Analytics-Property
account_type GOOGLE_ANALYTICS_PROPERTY
login_account Legen Sie login_account entweder 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 linked-account-Header nicht fest.

Hier ein Beispiel für ein 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 linked-account-Header nicht fest.

Floodlight

Aufnahme
Ziel
operating_account
account_id Die Floodlight-Konfigurations-ID
Wenn Ihr Werbetreibender ein untergeordneter Werbetreibender ist, verwenden Sie die ID des übergeordneten Werbetreibenden in Campaign Manager 360 als Floodlight-Konfigurations-ID. Verwenden Sie andernfalls die ID Ihres Werbetreibenden. Informationen zum Ermitteln der Werbetreibenden-ID in der Campaign Manager 360-Benutzeroberfläche
account_type FLOODLIGHT_CONFIG
login_account Legen Sie login_account entweder 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 eine Destination für gängige Szenarien für einen Datenpartner, der Daten an Werbetreibendenkonten mit einer eingerichteten Partnerverknüpfung zum Datenpartnerkonto sendet.

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

Zugriffspfad für Datenpartner

Google Ads

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

Datenpartner, Google Ads-Konten und ‑Nutzer

Datenpartner D1

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

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

Datenpartner D2

Zwischen D2 und dem Google Ads-Kundenkonto C1 besteht eine Partnerverknü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 haben Sie folgende Möglichkeiten:

Du bist Datenpartner D1.

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 Partnerverknüpfung zwischen D1 und M1 besteht.

Du bist Datenpartner D2.

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, das auf das Datenpartnerkonto D2 festgelegt ist, und linked_account, das auf das Kundenkonto C1 festgelegt ist.

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 ihren übergeordneten Verwaltungskonten besteht.

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

Szenario für direkte Partnerlinks

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 linked-account-Header nicht fest.

Hier sehen Sie ein Beispiel für ein Szenario mit direkter Partnerverknüpfung mit Konten aus dem Diagramm und die entsprechenden Anfrageheadern für Anfragen zur Ressourcenverwaltung. In diesem Szenario sendet Datenpartner D2 Daten zu Zielgruppenmitgliedern an Google Ads-Kunden C1. Dazu werden die Partnerverknüpfung zwischen D2 und C1 sowie die Anmeldedaten für das Google-Konto jeffersonloveshiking@gmail.com verwendet:

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 linked-account-Header nicht fest.

Szenario für die Verknüpfung von Managerkonten mit Partnerkonten

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 ist ein Beispiel für ein Szenario mit einem Partnerlink für ein Verwaltungskonto mit Konten aus dem Diagramm. In diesem Szenario sendet Datenpartner D1 Daten zu Zielgruppenmitgliedern an Google Ads-Kunden C2 über die Partnerverknüpfung zwischen D1 und M2 sowie 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 haben Sie zwei Möglichkeiten, Daten an ein Display & Video 360-Konto zu senden:

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

Wenn Sie Daten an einen Werbetreibenden in Display & Video 360 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 linked-account-Header nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direkter Partnerverknüpfung zum Senden von Daten an einen Display & Video 360-Werbetreibenden sowie die entsprechenden Anfrageheadern für Ressourcenverwaltungsanfragen:

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 linked-account-Header nicht fest.

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

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 linked-account-Header nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direkter Partnerverknüpfung zum Senden von Daten an einen Display & Video 360-Partner sowie die entsprechenden Anfrageheadern für Ressourcenverwaltungsanfragen:

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 linked-account-Header nicht fest.

Wenn Sie Daten an einen Display & Video 360-Werbetreibenden senden möchten und die Partnerverknüpfung zu Ihrem Datenpartnerkonto mit einem 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 sehen Sie ein Beispiel für ein Destination für ein Partnerlink-Szenario, in dem Daten über einen Partnerlink 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 ID der Zielgruppenverknüpfung 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 linked-account-Header nicht fest.

Hier sehen Sie ein Beispiel für einen Destination zum Senden von Daten an ein Google Ad Manager-Konto über einen Partnerlink:

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 linked-account-Header nicht fest.

Google Analytics

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

Floodlight

Mit der Data Manager API können keine Daten über einen Partnerlink an eine Floodlight-Konfiguration gesendet werden. Verwenden Sie stattdessen die Werbetreibendenszenarien für Floodlight.

Detaillierte Anforderungen

Dieser Abschnitt enthält detaillierte Anforderungen für die Kontofelder eines Destination für eine IngestionService-Anfrage, die entsprechenden Anfrageheadern für Ressourcenverwaltungsanfragen, Tipps zum Festlegen des product_destination_id und zum 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, 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 einer 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. Standardmäßig wird die operating_account in einer IngestionService-Anfrage und das Zielkonto in einer Anfrage zur Ressourcenverwaltung verwendet. Verwenden Sie in einer Anfrage zur Ressourcenverwaltung 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 Anmeldekonto.

  2. Das Anmeldekonto ist eines der folgenden:

    • Wie bei der operating_account. Dies ist die Standardeinstellung, wenn Sie die login_account eines Destination in einer IngestionService-Anfrage nicht festlegen oder den Header login-account in einer Anfrage zur Ressourcenverwaltung nicht festlegen.

    • Ein Google Ads-Verwaltungskonto oder ein Display & Video 360-Partnerkonto, das in einer IngestionService-Anfrage übergeordnet für operating_account oder in einer Anfrage zur Ressourcenverwaltung übergeordnet für das Zielkonto ist.

    • Ein Datenpartner-Konto mit einem Partnerlink zu linked_account in einer IngestionService-Anfrage oder dem linked-account-Header in einer Anfrage zur Ressourcenverwaltung.

Feld linked_account und Anfrageheader linked-account

Das linked_account gibt an, welches Konto eine Partnerverknüpfung mit dem login_account einer IngestionService-Anfrage oder dem Zielkonto einer Anfrage zur Ressourcenverwaltung 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 Analyse-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, geben Sie bei Bedarf Anfrageheader an und 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 Conversion-Aktions-ID. Sie können diese ID über die Google Ads-Benutzeroberfläche oder die Google Ads API abrufen.

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.
  3. Wechseln Sie zum Tab Details.
  4. Die Conversion-Aktions-ID ist die Nummer neben Conversion-Typ-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. 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 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ü 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, geben Sie bei Bedarf Anfrageheader an und verwenden Sie die id der UserList für die Produktziel-ID.

Google Analytics-Ereignis

Die ID des Produktziels 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. Hier sind zwei Möglichkeiten, die 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 in der Liste nach der Floodlight-Aktivität. Die ID ist die Zahl neben dem Namen in der Spalte Name der Aktivität.

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 floodlightActivities-Ressource.
  2. Geben Sie die floodlightConfigurationId der Floodlight-Konfiguration an.
  3. Optional können Sie den Parameter searchString verwenden, um nach Aktivitätsname zu filtern.
  4. Rufen Sie die ID der Floodlight-Aktivität aus dem Feld id der ausgewählten FloodlightActivity in der Antwort ab.

Festlegen, wo Anmeldedaten Zugriff haben

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 das 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. 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 login_account ein Google Ads-Verwaltungskonto ist, deaktivieren Sie den Ein/Aus-Button 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 in der Nutzerverwaltung, ob das Google-Konto für Ihre Anmeldedaten ein Nutzer von login_account ist.

Google Analytics

  1. Rufen Sie in der Google Analytics-Benutzeroberfläche 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.

Floodlight (Campaign Manager 360)

  1. Melden Sie sich in der Campaign Manager 360-Benutzeroberfläche an.
  2. Klicken Sie im Menü links auf Verwaltung > Nutzerprofile.
  3. Prüfen Sie, ob das Google-Konto für Ihre Anmeldedaten in der Liste der angezeigten Profilen 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.