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 eine Destination in Aufnahmeanfragen. Bei einer Erfassungsanfrage wird IngestionService verwendet, um Mitglieder einer Zielgruppe hinzuzufügen oder zu entfernen oder Ereignisse zu senden. In der Liste destinations in einem IngestAudienceMembersRequest oder IngestEventsRequest wird Folgendes definiert:

  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 einfügen.

  Tipp :Legen Sie keine Anfrageheader in einer IngestionService-Anfrage fest. Die Data Manager API ignoriert Header in einer Erfassungsanfrage.

• Verwenden Sie Anfrageheader in Anfragen für Ressourcenverwaltung, mit denen Ressourcen erstellt, aktualisiert, gelöscht oder abgerufen werden. In Headern wird der Zugriffspfad für die Anmeldedaten der Anfrage zum Zielkonto der Ressourcenverwaltungsanfrage definiert. Hier ist die Liste der Ressourcen mit Methoden zur Ressourcenverwaltung, die Anforderungsheader unterstützen:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

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 neben 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 für das Festlegen von Headern und das Erstellen einer Destination:

• Google Ads
• Display & Video 360
• Google Analytics

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

• Google Ads
• Display & Video 360
• Google Analytics

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

Szenarios 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.

Google Ads

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

Verwaltungskonto M1

M1 hat zwei untergeordnete Konten:

1. Verwaltungskonto M2
2. Kundenkonto C1

Das Google-Konto [e-mail] ist ein Nutzer in M1.

Verwaltungskonto M2

M2 hat zwei untergeordnete Konten:

1. Kundenkonto C1
2. Kundenkonto C2

Das Google-Konto [e-mail] ist ein Nutzer in M2.

Kundenkonto C1

C1 hat zwei direkte übergeordnete Verwaltungskonten:

1. Verwaltungskonto M1
2. Verwaltungskonto M2

Das Google-Konto [e-mail] 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 Managerzugriff 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	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.

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 [e-mail] 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 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:

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 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 [e-mail]:

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 Verwaltungskonto-Zugriffsszenario für das Google Ads-Kundenkonto C2 und Anmeldedaten für das Google-Konto [e-mail], 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, 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	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.

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 zum Senden von Daten an einen Werbetreibenden in Display & Video 360:

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, gehen Sie so vor:

Aufnahme

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.

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 zum Senden von Daten an einen Partner in Display & Video 360:

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 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 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 operating_account ein Google Analytics-Konto ist, 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	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.

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.

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.

Hinweis :In jedem Datenpartnerszenario müssen die Anmeldedaten für ein Google-Konto verwendet werden, das ein Nutzer im Datenpartnerkonto ist.

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

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 D1

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

Das Google-Konto [e-mail] ist ein Nutzer in D1.

Datenpartner D2

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

Das Google-Konto [e-mail] 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 [e-mail], 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 [e-mail], 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.

• Datenpartner D1 ist mit einem Google Ads-Verwaltungskonto verknüpft. Dies ist ein Beispiel für das Szenario mit Produktverknüpfung für Manager.
• Der Datenpartner D2 ist mit einem Google Ads-Kundenkonto verknüpft. Dies ist ein Beispiel für das Szenario mit direktem Produktlink.

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:

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 direkten Produktlinks, in dem Konten aus dem Diagramm verwendet werden, sowie 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 Produktverknüpfung zwischen D2 und C1 sowie die Anmeldedaten für das Google-Konto [e-mail] 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 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:

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 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 [e-mail] verwendet:

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 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.

Szenarien für direkte Produktlinks

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:

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 direktem Produktlink, um Daten an einen Display & Video 360-Werbetreibenden zu senden, sowie die entsprechenden Anfrageheader 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 Display & Video 360-Partnerkonto senden möchten, muss eine Produktverknü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 linked-account-Header nicht fest.

Hier ist ein Beispiel für eine Destination für ein Szenario mit direktem Produktlink, um Daten an einen Display & Video 360-Partner zu senden, sowie die entsprechenden Anfrageheader 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.

Szenario für die Verknüpfung von Display & Video 360-Partnerprodukten

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:

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

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 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 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, in welchem Konto die Daten in der Anfrage empfangen werden. operating_account kann einer der folgenden Werte sein:

• Ein Google Ads-Konto
• Ein Display & Video 360-Werbetreibendenkonto
• Ein Display & Video 360-Partnerkonto
• Eine Google Analytics-Property
• Ein Datenpartnerkonto, wenn Daten an eine Zielgruppe gesendet werden, die dem Datenpartnerkonto gehört.

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.

login_account-Feld und login-account-Anfrageheader

Die login_account ist nicht immer erforderlich. In einer IngestionService-Anfrage wird standardmäßig die operating_account verwendet und in einer Anfrage zur Ressourcenverwaltung das Zielkonto. 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:

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

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

   • Ein Datenpartnerkonto mit einer Produktverknüpfung zu linked_account in einer IngestionService-Anfrage oder dem linked-account-Header in einer Anfrage zur Ressourcenverwaltung.

linked_account-Feld und linked-account-Anfrageheader

Hinweis :Geben Sie nur ein verknüpftes Konto an, wenn für das Anmeldekonto account_type auf DATA_PARTNER festgelegt ist und ein übergeordnetes Element von operating_account mit dem Konto des Datenpartners verknüpft ist. Wenn operating_account direkt mit dem Konto des Datenpartners verknüpft ist, legen Sie linked_account nicht fest.

Die linked_account gibt an, welches Konto eine Produktverknüpfung mit der 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 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. Rufen Sie diese ID über die Google Ads-Benutzeroberfläche oder die Data Manager API ab.

Google Ads-UI

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.

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.

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. 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ü 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.

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 Produktziel-ID für die Aufnahme von Ereignissen ist die Mess-ID des Datenstreams.

Zugriffsbereiche von Anmeldedaten festlegen

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.