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
Destinationin Aufnahmeanfragen. Bei einer Erfassungsanfrage wirdIngestionServiceverwendet, um Mitglieder einer Zielgruppe hinzuzufügen oder zu entfernen oder Ereignisse zu senden. Die Listedestinationsin einemIngestAudienceMembersRequestoderIngestEventsRequestdefiniert Folgendes:- Das Konto, in dem die Daten eingehen. Das kann beispielsweise ein Google Ads-Konto oder eine Google Analytics-Property sein.
- Das Ziel für die Daten im Konto, z. B. eine Google Ads-Conversion-Aktion oder ein Google Analytics-Stream.
- 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.
Google Ads
Hier sehen Sie ein Beispiel für ein Diagramm, das eine Gruppe von Google Ads-Konten und ‑Nutzern zeigt.
- Verwaltungskonto M1
M1 hat zwei untergeordnete Konten:
- Verwaltungskonto M2
- Kundenkonto C1
Das Google-Konto
cloudysanfrancisco@gmail.comist ein Nutzer in M1.- Verwaltungskonto M2
M2 hat zwei untergeordnete Konten:
- Kundenkonto C1
- Kundenkonto C2
Das Google-Konto
baklavainthebalkans@gmail.comist ein Nutzer in M2.- Kundenkonto C1
C1 hat zwei direkte übergeordnete Verwaltungskonten:
- Verwaltungskonto M1
- Verwaltungskonto M2
Das Google-Konto
jeffersonloveshiking@gmail.comist 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 |
|
||||
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 |
|
||||
login_account |
|
||||
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:
- Direkter Zugriff: Die Anmeldedaten gehören zu einem Google-Konto, das ein Nutzer im Display & Video 360-Werbetreibenden- oder Partnerkonto ist.
- 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 |
|
||||
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 |
|
||||
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 |
|
||||
login_account |
|
||||
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 |
|
||||
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 |
|
||||
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.
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 D1
Zwischen D1 und dem Google Ads-Verwaltungskonto M2 besteht eine Partnerverknüpfung.
Das Google-Konto
222larabrown@gmail.comist ein Nutzer in D1.- Datenpartner D2
Zwischen D2 und dem Google Ads-Kundenkonto C1 besteht eine Partnerverknüpfung.
Das Google-Konto
jeffersonloveshiking@gmail.comist ein Nutzer in D2.- Verwaltungskonto M1
M1 hat zwei untergeordnete Konten:
- Verwaltungskonto M2
- Kundenkonto C1
- Verwaltungskonto M2
M2 hat zwei untergeordnete Konten:
- Kundenkonto C1
- Kundenkonto C2
- Kundenkonto C1
C1 hat zwei direkte übergeordnete Verwaltungskonten:
- Verwaltungskonto M1
- 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 mitlogin_account, das auf das Datenpartnerkonto D1 festgelegt ist, undlinked_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 mitlogin_account, das auf das Datenpartnerkonto D2 festgelegt ist, undlinked_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.
- Der Datenpartner D1 ist mit einem Google Ads-Verwaltungskonto verknüpft. Dies ist ein Beispiel für das Szenario mit Manager-Partner-Verknüpfung.
- Der Datenpartner D2 ist mit einem Google Ads-Kundenkonto verknüpft. Dies ist ein Beispiel für das Szenario mit direktem Partnerlink.
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 |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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:
- Verwenden Sie eine direkte Partnerverknüpfung zwischen einem Datenpartnerkonto und dem Display & Video 360-Partner- oder ‑Werbetreibendenkonto.
- 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.
Szenarien für direkte Partnerlinks
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 |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
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. |
Szenario für Partnerlink für Eltern
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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 |
|
||||
login_account |
|
||||
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_accountoperating_accountist erforderlich.Mit
operating_accountwird angegeben, welches Konto die Daten in der Anfrage erhält. Der Wert füroperating_accountkann einer der folgenden sein:- Ein Google Ads-Konto
- Ein Display & Video 360-Werbetreibendenkonto
- Ein Display & Video 360-Partnerkonto
- Ein Google Ad Manager-Konto
- Eine Google Analytics-Property
- Ein Datenpartnerkonto, wenn Sie Daten an eine Zielgruppe senden, die dem Datenpartnerkonto gehört.
Es gibt keinen Anfrageheader, der dem Feld
operating_accounteinerDestinationentspricht. Wenn Sie eine Anfrage zur Ressourcenverwaltung senden, ist das Zielkonto der Anfrage das Betriebskonto.- Feld
login_accountund Anfrageheaderlogin-account Die
login_accountist nicht immer erforderlich. Standardmäßig wird dieoperating_accountin einerIngestionService-Anfrage und das Zielkonto in einer Anfrage zur Ressourcenverwaltung verwendet. Verwenden Sie in einer Anfrage zur Ressourcenverwaltung den Anfrageheaderlogin-account, um das Anmeldekonto zu identifizieren.Die Data Manager API prüft Folgendes:
Das Google-Konto der Anmeldedaten ist ein Nutzer im Anmeldekonto.
Das Anmeldekonto ist eines der folgenden:
Wie bei der
operating_account. Dies ist die Standardeinstellung, wenn Sie dielogin_accounteinesDestinationin einerIngestionService-Anfrage nicht festlegen oder den Headerlogin-accountin einer Anfrage zur Ressourcenverwaltung nicht festlegen.Ein Google Ads-Verwaltungskonto oder ein Display & Video 360-Partnerkonto, das in einer
IngestionService-Anfrage übergeordnet füroperating_accountoder in einer Anfrage zur Ressourcenverwaltung übergeordnet für das Zielkonto ist.Ein Datenpartner-Konto mit einem Partnerlink zu
linked_accountin einerIngestionService-Anfrage oder demlinked-account-Header in einer Anfrage zur Ressourcenverwaltung.
- Feld
linked_accountund Anfrageheaderlinked-account -
Das
linked_accountgibt an, welches Konto eine Partnerverknüpfung mit demlogin_accounteinerIngestionService-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.
Google Ads-UI
So rufen Sie die Zielgruppen-ID über die Google Ads-Benutzeroberfläche ab:
- Rufen Sie in der Google Ads-Benutzeroberfläche die Zielgruppenverwaltung auf.
- Klicken Sie auf den Namen der Zielgruppe, um Details aufzurufen.
- 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.
Google Ads-UI
So rufen Sie die Conversion-Aktions-ID über die Google Ads-Benutzeroberfläche ab:
- Rufen Sie in der Google Ads-Benutzeroberfläche Conversions auf.
- Klicken Sie auf den Namen der Conversion-Aktion.
- Wechseln Sie zum Tab Details.
- Die Conversion-Aktions-ID ist die Nummer neben Conversion-Typ-ID.
Google Ads API
So rufen Sie die Conversion-Aktions-ID über die Google Ads API ab:
Senden Sie eine
Search- oderSearchStream-Anfrage anGoogleAdsServicemit der folgenden Abfrage:SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'Rufen Sie die Conversion-Aktions-ID aus dem Feld
idimconversion_actionin 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:
- Melden Sie sich in der Display & Video 360-Benutzeroberfläche unter https://displayvideo.google.com an.
- Rufen Sie den Display & Video 360-Partner oder ‑Werbetreibenden auf, den Sie für die
operating_accountverwenden. - Klicken Sie im Menü auf der linken Seite auf Zielgruppen und wählen Sie dann Alle Zielgruppen aus.
- 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:
- Rufen Sie in der Google Analytics-Benutzeroberfläche Datenstreams auf, klicken Sie auf den Datenstream und suchen Sie nach der FIREBASE-APP-ID.
- Firebase Console verwenden
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:
- Melden Sie sich in der Campaign Manager 360-Benutzeroberfläche an.
- Rufen Sie den Campaign Manager 360-Werbetreibenden auf, den Sie für die
operating_accountverwenden. - Klicken Sie im Menü auf der linken Seite auf Floodlight und wählen Sie dann Aktivitäten aus.
- 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:
- Senden Sie eine
list-Anfrage an diefloodlightActivities-Ressource. - Geben Sie die
floodlightConfigurationIdder Floodlight-Konfiguration an. - Optional können Sie den Parameter
searchStringverwenden, um nach Aktivitätsname zu filtern. - Rufen Sie die ID der Floodlight-Aktivität aus dem Feld
idder ausgewähltenFloodlightActivityin 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
- Klicken Sie in der Google Ads-Benutzeroberfläche für
login_accountauf Zugriff und Sicherheit. - Klicken Sie auf den Tab Nutzer.
- Wenn
login_accountein Google Ads-Verwaltungskonto ist, deaktivieren Sie den Ein/Aus-Button Komplette Hierarchie der Nutzer anzeigen, um Nutzer aus untergeordneten Konten auszublenden. - 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
- Rufen Sie in der Display & Video 360-Benutzeroberfläche Nutzerverwaltung und E-Mail-Einstellungen auf.
- Prüfen Sie in der Nutzerverwaltung, ob das Google-Konto für Ihre Anmeldedaten ein Nutzer von
login_accountist.
Google Analytics
- Rufen Sie in der Google Analytics-Benutzeroberfläche Zugriffsverwaltung für Property auf.
- Prüfen Sie, ob die in
login_accountangegebene Google Analytics-Property ausgewählt ist. - 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)
- Melden Sie sich in der Campaign Manager 360-Benutzeroberfläche an.
- Klicken Sie im Menü links auf Verwaltung > Nutzerprofile.
- Prüfen Sie, ob das Google-Konto für Ihre Anmeldedaten in der Liste der angezeigten Profilen enthalten ist.
- Klicken Sie auf das Profil und prüfen Sie, ob es Zugriff auf das Werbetreibendenkonto hat, das als
login_accountverwendet wird. Wenn Sie in der Anfrage keinenlogin_accountfestlegen, wird standardmäßig deroperating_accountverwendet. Das Konto muss eine Nutzerrolle mit der Berechtigung Offline-Conversions einfügen haben.