In dieser Kurzanleitung erfahren Sie, wie Sie Ereignisdaten senden.
Verwenden Sie die Data Manager API in einem der folgenden Szenarien:
Senden Sie Google Ads-Tag-Conversions oder Google Analytics-Schlüsselereignisse als zusätzliche Datenquelle für Ihre Tag-Conversions, um die Signale für Anzeigeninteraktionen zu maximieren und Ihre Daten und die Gesamtleistung zu verbessern.
Diese Funktion ist nur für Konten mit einer Zulassungsliste verfügbar. Füllen Sie das Formular aus, wenn Sie Ihr Google Ads-Konto oder Ihre Google Analytics-Property hinzufügen möchten.
Senden Sie Ereignisdaten für Offline-Conversions oder erweiterte Conversions für Leads in Google Ads.
Wählen Sie die gewünschte Version des Leitfadens aus:
In dieser Kurzanleitung führen Sie die folgenden Schritte aus:
- Bereiten Sie ein
Destinationvor, um Ereignisdaten zu empfangen. - Ereignisdaten für den Versand vorbereiten
- Erstellen Sie eine
IngestionService-Anfrage für Ereignisse. - Senden Sie die Anfrage mit dem Google APIs Explorer.
- Erfolgs- und Fehlerantworten verstehen
Ziele vorbereiten
Bevor Sie Daten senden können, müssen Sie mindestens ein Destination für die Daten vorbereiten. Hier ist ein Beispiel für Destination, das Sie verwenden können:
{
"operatingAccount": {
"accountType": "OPERATING_ACCOUNT_TYPE",
"accountId": "OPERATING_ACCOUNT_ID"
},
"loginAccount": {
"accountType": "LOGIN_ACCOUNT_TYPE",
"accountId": "LOGIN_ACCOUNT_ID"
},
"productDestinationId": "PRODUCT_DESTINATION_ID"
}
Hier sind die Felder einer Destination. Weitere Informationen und Beispiele für Zielanwendungen für verschiedene Szenarien finden Sie unter Zielanwendungen konfigurieren.
operatingAccountDas Konto, in dem die Ereignisse empfangen werden.
Bei Ereignissen, die als zusätzliche Datenquelle gesendet werden, kann das Betriebskonto entweder ein Google Ads-Konto oder eine Google Analytics-Property sein.
Wenn
accountTypegleichGOOGLE_ANALYTICS_PROPERTYist, müssen die Anmeldedaten der Anfrage für einen Google Analytics-Nutzer mit der Rolle „Bearbeiter“ oder „Administrator“ für die Property sein.Für Offline-Conversions und erweiterte Conversions für Leads muss das Betriebskonto ein Google Ads-Konto sein.
loginAccount- Das Konto, in dem das Google-Konto für die Anmeldedaten ein Nutzer ist.
productDestinationIdDie ID der Entität in
operatingAccount, die die Ereignisse empfängt.Bei Ereignissen, die als zusätzliche Datenquelle gesendet werden, muss
productDestinationIdeiner der folgenden Werte sein:Die ID einer Google Ads-Conversion mit
type, die aufWEBPAGEfestgelegt ist. In der Google Ads-Benutzeroberfläche ist die Conversion-Quelle für eineWEBPAGE-Conversion-Aktion Website.Die Mess-ID eines Google Analytics-Webstreams. Sie können keine Ereignisse als zusätzliche Datenquelle an einen Google Analytics-App-Datenstream für iOS oder Android senden.
Bei Offline-Conversions oder erweiterten Conversions für Leads muss
productDestinationIddie ID einer Google Ads-Conversion-Aktion sein, bei dertypeaufUPLOAD_CLICKSfestgelegt ist. In der Google Ads-Benutzeroberfläche ist die Conversion-Quelle für eineUPLOAD_CLICKS-Conversion-Aktion Website (Import aus Klicks).
Im Beispiel in diesem Leitfaden wird gezeigt, wie Sie eine Anfrage erstellen, mit der alle Ereignisse an dasselbe Ziel gesendet werden. Wenn Sie Ereignisse für mehrere Ziele in derselben Anfrage senden möchten, lesen Sie den Abschnitt Ereignisse für mehrere Ziele senden.
Ereignisdaten vorbereiten
Sehen Sie sich die folgenden Ereignisdaten an. Jede Tabelle entspricht einem Conversion-Ereignis. Jedes Conversion-Ereignis hat einen Zeitstempel, eine Conversion-Aktion und einen Conversion-Wert.
Jedes Ereignis kann Werbe-IDs wie gclid oder Nutzer-IDs wie E‑Mail-Adressen, Telefonnummern und Adressinformationen enthalten. Ein Ereignis kann auch Folgendes haben:
- Informationen zum Nutzer, die zum Zeitpunkt des Ereignisses erhoben werden, z. B. der Wert des Kunden oder ob es sich um einen neuen, wiederkehrenden oder reaktivierten Kunden handelt.
- Daten zum Einkaufswagen.
- Zusätzliche Ereignisparameter oder Nutzereigenschaften für ein Ziel, z. B.
client_idoderuser_idfür Google Analytics.
Hier sind die Ereignisdaten:
Ereignis 1
| Ereignis 1 | |
|---|---|
conversion_time |
2025-06-10 15:07:01-05:00 |
conversion_action_id |
123456789 |
transaction_id |
ABC798654321 |
conversion_value |
30.03 |
currency |
USD |
gclid |
GCLID_1 |
emails |
|
given_name |
John |
family_name |
Smith-Jones |
region_code |
us |
postal_code |
94045 |
customer_type |
NEW |
customer_value_bucket |
HIGH |
client_id |
1234567890.1761581763 |
user_id |
user_ABC12345 |
ad_unit_name |
Banner_01 |
event_name |
purchase |
| Warenkorbartikel | |
item_id |
SKU_12345 |
item_name |
Stan and Friends Tee |
item_affiliation |
Google Merchandise Store |
item_coupon |
SUMMER_FUN |
item_discount |
2.22 |
item_index |
0 |
item_brand |
Google |
item_category |
Apparel |
item_category2 |
Adult |
item_category3 |
Shirts |
item_category4 |
Crew |
item_category5 |
Short sleeve |
item_list_id |
related_products |
item_list_name |
Related Products |
item_price |
10.01 |
item_quantity |
3 |
Ereignis 2
| Ereignis 2 | |
|---|---|
conversion_time |
June 10, 2025 11:42:33PM America/New_York |
conversion_action_id |
123456789 |
transaction_id |
DEF999911111 |
conversion_value |
42.02 |
currency |
eur |
gclid |
GCLID_2 |
emails |
|
given_name |
zoë |
family_name |
pérez |
region_code |
PT |
postal_code |
1229-076 |
customer_type |
RETURNING |
client_id |
9876543210.1761582117 |
user_id |
user_DEF9876 |
ad_unit_name |
Banner_02 |
event_name |
purchase |
| Warenkorbartikel | |
item_id |
SKU_12346 |
item_name |
Google Grey Women's Tee |
item_affiliation |
Google Merchandise Store |
item_coupon |
SUMMER_FUN |
item_discount |
3.33 |
item_index |
1 |
item_brand |
Google |
item_category |
Apparel |
item_category2 |
Adult |
item_category3 |
Shirts |
item_category4 |
Crew |
item_category5 |
Short sleeve |
item_list_id |
related_products |
item_list_name |
Related Products |
item_price |
21.01 |
item_quantity |
2 |
Daten formatieren
Formatieren Sie die Felder gemäß der Formatierungsanleitung. Hier sind die formatierten Ereignisdaten:
Ereignis 1
| Ereignis 1 | |
|---|---|
conversion_time |
2025-06-10T15:07:01-05:00 |
conversion_action_id |
123456789 |
transaction_id |
ABC798654321 |
conversion_value |
30.03 |
currency |
USD |
gclid |
GCLID_1 |
emails |
|
given_name |
john |
family_name |
smith-jones |
region_code |
US |
postal_code |
94045 |
customer_type |
NEW |
customer_value_bucket |
HIGH |
client_id |
1234567890.1761581763 |
user_id |
user_ABC12345 |
ad_unit_name |
Banner_01 |
event_name |
purchase |
| Warenkorbartikel | |
item_id |
SKU_12345 |
item_name |
Stan and Friends Tee |
item_affiliation |
Google Merchandise Store |
item_coupon |
SUMMER_FUN |
item_discount |
2.22 |
item_index |
0 |
item_brand |
Google |
item_category |
Apparel |
item_category2 |
Adult |
item_category3 |
Shirts |
item_category4 |
Crew |
item_category5 |
Short sleeve |
item_list_id |
related_products |
item_list_name |
Related Products |
item_price |
10.01 |
item_quantity |
3 |
Ereignis 2
| Ereignis 2 | |
|---|---|
conversion_time |
2025-06-10T23:42:33-05:00 |
conversion_action_id |
123456789 |
transaction_id |
DEF999911111 |
conversion_value |
42.02 |
currency |
EUR |
gclid |
GCLID_2 |
emails |
|
given_name |
zoë |
family_name |
pérez |
region_code |
PT |
postal_code |
1229-076 |
customer_type |
RETURNING |
client_id |
9876543210.1761582117 |
user_id |
user_DEF9876 |
ad_unit_name |
Banner_02 |
event_name |
purchase |
| Warenkorbartikel | |
item_id |
SKU_12346 |
item_name |
Google Grey Women's Tee |
item_affiliation |
Google Merchandise Store |
item_coupon |
SUMMER_FUN |
item_discount |
3.33 |
item_index |
1 |
item_brand |
Google |
item_category |
Apparel |
item_category2 |
Adult |
item_category3 |
Shirts |
item_category4 |
Crew |
item_category5 |
Short sleeve |
item_list_id |
related_products |
item_list_name |
Related Products |
item_price |
21.01 |
item_quantity |
2 |
Daten hashen und codieren
Außerdem müssen die formatierten E‑Mail-Adressen, Vornamen und Nachnamen mit dem SHA‑256-Algorithmus gehasht und mit Hexadezimal- oder Base64-Codierung codiert werden. So sehen die Ereignisdaten nach der Formatierung, dem Hashing und der Codierung mit Hexadezimalcodierung aus:
Ereignis 1
| Ereignis 1 | |
|---|---|
conversion_time |
2025-06-10T15:07:01-05:00 |
conversion_action_id |
123456789 |
transaction_id |
ABC798654321 |
conversion_value |
30.03 |
currency |
USD |
gclid |
GCLID_1 |
emails |
|
given_name |
96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A |
family_name |
DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081 |
region_code |
US |
postal_code |
94045 |
customer_type |
NEW |
customer_value_bucket |
HIGH |
client_id |
1234567890.1761581763 |
user_id |
user_ABC12345 |
ad_unit_name |
Banner_01 |
event_name |
purchase |
| Warenkorbartikel | |
item_id |
SKU_12345 |
item_name |
Stan and Friends Tee |
item_affiliation |
Google Merchandise Store |
item_coupon |
SUMMER_FUN |
item_discount |
2.22 |
item_index |
0 |
item_brand |
Google |
item_category |
Apparel |
item_category2 |
Adult |
item_category3 |
Shirts |
item_category4 |
Crew |
item_category5 |
Short sleeve |
item_list_id |
related_products |
item_list_name |
Related Products |
item_price |
10.01 |
item_quantity |
3 |
Ereignis 2
| Ereignis 2 | |
|---|---|
conversion_time |
2025-06-10T23:42:33-05:00 |
conversion_action_id |
123456789 |
transaction_id |
DEF999911111 |
conversion_value |
42.02 |
currency |
EUR |
gclid |
GCLID_2 |
emails |
|
given_name |
2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450 |
family_name |
6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F |
region_code |
PT |
postal_code |
1229-076 |
customer_type |
RETURNING |
client_id |
9876543210.1761582117 |
user_id |
user_DEF9876 |
ad_unit_name |
Banner_02 |
event_name |
purchase |
| Warenkorbartikel | |
item_id |
SKU_12346 |
item_name |
Google Grey Women's Tee |
item_affiliation |
Google Merchandise Store |
item_coupon |
SUMMER_FUN |
item_discount |
3.33 |
item_index |
1 |
item_brand |
Google |
item_category |
Apparel |
item_category2 |
Adult |
item_category3 |
Shirts |
item_category4 |
Crew |
item_category5 |
Short sleeve |
item_list_id |
related_products |
item_list_name |
Related Products |
item_price |
21.01 |
item_quantity |
2 |
Daten in Event-Objekte konvertieren
Konvertieren Sie die formatierten und gehashten Daten jedes Ereignisses in ein Event. Füllen Sie die folgenden Felder wie angegeben aus:
Legen Sie
eventTimestampauf die Zeit fest, zu der das Ereignis aufgetreten ist.Ereignisse für Google Analytics müssen einen
eventTimestampinnerhalb der letzten 72 Stunden haben.Legen Sie die erforderlichen Felder für Ihren Anwendungsfall fest.
Anwendungsfall IDs transactionIdeventSourceOffline-Conversions oder erweiterte Conversions für Leads Erforderlich. Legen Sie mindestens einen der folgenden Werte fest: adIdentifiersmit mindestens einem der folgenden Werte:gclid,gbraid,wbraidodersessionAttributesuserData
Optional Erforderlich. Legen Sie einen der Aufzählungswerte für EventSourcefest.Ereignisse, die als zusätzliche Datenquelle an ein Google Ads-Ziel gesendet werden Erforderlich. Legen Sie mindestens einen der folgenden Werte fest: adIdentifiersmit mindestens einem der folgenden Werte:gclid,gbraidoderwbraiduserData
Erforderlich Optional. Wenn festgelegt, muss der Wert WEBsein.Ereignisse, die als zusätzliche Datenquelle an ein Google Analytics-Ziel gesendet werden Erforderlich. Legen Sie mindestens einen der folgenden Werte fest: clientIdadIdentifiersmitgclidfestgelegtuserData
Erforderlich Optional. Wenn festgelegt, muss der Wert WEBsein.Füllen Sie alle anderen Felder aus, für die Sie einen Wert für das Ereignis haben. Eine vollständige Liste der verfügbaren Felder finden Sie in der Referenzdokumentation zu
Event.
Google Analytics-Informationen hinzufügen
Wenn die Ziele für ein Ereignis, das als zusätzliche Datenquelle gesendet wird, eine Google Analytics-Property umfassen, füllen Sie die folgenden Felder wie angegeben aus:
eventNameErforderlich. Der Name des Google Analytics-Ereignisses.
transactionIdErforderlich Die eindeutige Kennung für das Ereignis.
- Mindestens eine Kennung
Mindestens eines der folgenden Felder muss festgelegt werden:
clientId: Eindeutige Kennung für eine Nutzerinstanz eines Webclients. Weitere Informationen finden Sie unter Ereignis an das Measurement Protocol senden.userData: Kennungen für den Nutzer, z. B. E-Mail-Adressen, Telefonnummern oder Adressinformationen.
destinationReferencesErforderlich, wenn die Liste
destinationsauf Anfrageebene mehr als eine Google Analytics-Destinationenthält. Fügen Sie einen Eintrag zudestinationReferenceshinzu, um anzugeben, an welches Google Analytics-Ziel das Ereignis gesendet werden soll. Weitere Informationen zu Zielreferenzen finden Sie unter Ereignisse an mehrere Ziele senden.Wenn
destinationReferencesnicht festgelegt ist oder mehrere Einträge enthält, die auf Google Analytics-Ziele verweisen, lehnt die Data Manager API das Ereignis mit dem FehlerMULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENTab.userIdOptional. Die Nutzer-ID für den Nutzer.
additionalEventParametersOptional, aber empfohlen. Füllen Sie diese Liste mit allen Google Analytics-Ereignisparametern aus, die nicht in den anderen
Event-Feldern erfasst werden. Die Parameter können zusätzliche empfohlene Parameter aus dempurchase-Ereignis oder andere Parameter enthalten, die Sie erfassen möchten. Verwenden Sie den Google Analytics-Parameternamen für dieparameterNamederEventParameter.Wenn Sie beispielsweise die Steuern für eine Transaktion haben, fügen Sie
additionalEventParameterseinen Eintrag hinzu, wobeiparameterNameauftaxundvalueauf die Steuerkosten festgelegt ist.Wir empfehlen, keine Einträge für die Google Analytics-Ereignisparameter
transactionId,currencyodervaluehinzuzufügen. Füllen Sie stattdessen dietransactionId,currencyundconversionValuedesEventaus, die Vorrang vor allen Einträgen inadditionalEventParametershaben.
Warenkorbdaten für Kaufereignisse hinzufügen
Füllen Sie das Feld cartData des Event-Objekts mit Informationen zu den gekauften Artikeln. Fügen Sie für jeden gekauften Artikel der Liste items des CartData-Objekts ein Item-Objekt hinzu und füllen Sie die folgenden Felder wie angegeben aus:
itemId- Erforderlich. Eine eindeutige Kennung für das Element.
unitPriceErforderlich. Der Stückpreis ohne Steuern, Versandkosten und ereignisbezogene (Transaktionsebene) Rabatte.
Wenn für den Artikel ein artikelbezogener Rabatt gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von
27.67und einen Rabatt pro Einheit von6.66hat, legen SieunitPriceauf21.01fest.quantityErforderlich. Die Anzahl der für diesen Artikel gekauften Einheiten.
additionalItemParametersFüllen Sie diese Liste mit allen parametrisierten Elementen aus, die nicht in den anderen
Item-Feldern erfasst werden. Verwenden Sie den Namen des Google Analytics-Artikelparameters für dieparameterNamederItemParameter.Wenn Sie beispielsweise die Marke und Kategorie für ein Element haben, fügen Sie dem
additionalItemParametersdes Elements einen Eintrag hinzu, wobeiparameterNameaufitem_brandundvalueauf den Markennamen festgelegt ist. Fügen Sie außerdem einen weiteren Eintrag hinzu, wobeiparameterNameaufitem_categoryundvalueauf die Kategorie des Elements festgelegt ist.Wir empfehlen, keine Einträge für die Google Analytics-Artikelparameter
quantity,priceoderitem_idhinzuzufügen. Füllen Sie stattdessen dieitemId,unitPriceundquantitydesItemaus, die Vorrang vor allen Einträgen inadditionalItemParametershaben.
Hier ist ein Beispiel für die formatierte, gehashte und codierte Event aus dem zweiten Ereignis mit zusätzlichen Daten für Google Analytics:
{
"adIdentifiers": {
"gclid": "GCLID_2"
},
"conversionValue": 42.02,
"currency": "EUR",
"eventTimestamp": "2025-06-10T23:42:33-05:00",
"transactionId": "DEF999911111",
"eventSource": "WEB",
"userData": {
"userIdentifiers": [
{
"emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
},
{
"emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
},
{
"address": {
"givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
"familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
"regionCode": "PT",
"postalCode": "1229-076"
}
}
],
},
"userProperties": {
"customerType": "RETURNING"
},
"eventName": "purchase",
"clientId": "9876543210.1761582117",
"userId": "user_DEF9876",
"additionalEventParameters": [
{
"parameterName": "ad_unit_name",
"value": "Banner_02"
}
],
"cartData": {
"transactionDiscount": 6.66,
"items": [
{
"itemId": "SKU_12346",
"quantity": 2,
"unitPrice": 21.01,
"additionalItemParameters": [
{
"parameterName": "item_name",
"value": "Google Grey Women's Tee"
},
{
"parameterName": "affiliation",
"value": "Google Merchandise Store"
},
{
"parameterName": "coupon",
"value": "SUMMER_FUN"
},
{
"parameterName": "discount",
"value": "3.33"
},
{
"parameterName": "index",
"value": "1"
},
{
"parameterName": "item_brand",
"value": "Google"
},
{
"parameterName": "item_category",
"value": "Apparel"
},
{
"parameterName": "item_category2",
"value": "Adult"
},
{
"parameterName": "item_category3",
"value": "Shirts"
},
{
"parameterName": "item_category4",
"value": "Crew"
},
{
"parameterName": "item_category5",
"value": "Short sleeve"
},
{
"parameterName": "item_list_id",
"value": "related_products"
},
{
"parameterName": "item_list_name",
"value": "Related Products"
}
]
}
]
}
}
Anfragetext erstellen
Kombinieren Sie Destination und Events für den Anfragetext:
{
"destinations": [
{
"operatingAccount": {
"accountType": "OPERATING_ACCOUNT_TYPE",
"accountId": "OPERATING_ACCOUNT_ID"
},
"loginAccount": {
"accountType": "LOGIN_ACCOUNT_TYPE",
"accountId": "LOGIN_ACCOUNT_ID"
},
"productDestinationId": "CONVERSION_ACTION_1_ID"
}
],
"encoding": "HEX",
"events": [
{
"adIdentifiers": {
"gclid": "GCLID_1"
},
"conversionValue": 30.03,
"currency": "USD",
"eventTimestamp": "2025-06-10T20:07:01Z",
"transactionId": "ABC798654321",
"eventSource": "WEB",
"userData": {
"userIdentifiers": [
{
"address": {
"givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
"familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
"regionCode": "US",
"postalCode": "94045"
}
}
]
},
"userProperties": {
"customerType": "NEW",
"customerValueBucket": "HIGH"
},
"eventName": "purchase",
"clientId": "1234567890.1761581763",
"userId": "user_ABC12345",
"additionalEventParameters": [
{
"parameterName": "ad_unit_name",
"value": "Banner_01"
}
],
"cartData": {
"transactionDiscount": 6.66,
"items": [
{
"itemId": "SKU_12345",
"quantity": 3,
"unitPrice": 10.01,
"additionalItemParameters": [
{
"parameterName": "item_name",
"value": "Stan and Friends Tee"
},
{
"parameterName": "affiliation",
"value": "Google Merchandise Store"
},
{
"parameterName": "coupon",
"value": "SUMMER_FUN"
},
{
"parameterName": "discount",
"value": "2.22"
},
{
"parameterName": "index",
"value": "0"
},
{
"parameterName": "item_brand",
"value": "Google"
},
{
"parameterName": "item_category",
"value": "Apparel"
},
{
"parameterName": "item_category2",
"value": "Adult"
},
{
"parameterName": "item_category3",
"value": "Shirts"
},
{
"parameterName": "item_category4",
"value": "Crew"
},
{
"parameterName": "item_category5",
"value": "Short sleeve"
},
{
"parameterName": "item_list_id",
"value": "related_products"
},
{
"parameterName": "item_list_name",
"value": "Related Products"
}
]
}
]
}
},
{
"adIdentifiers": {
"gclid": "GCLID_2"
},
"conversionValue": 42.02,
"currency": "EUR",
"eventTimestamp": "2025-06-11T04:42:33Z",
"transactionId": "DEF999911111",
"eventSource": "WEB",
"userData": {
"userIdentifiers": [
{
"emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
},
{
"emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
},
{
"address": {
"givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
"familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
"regionCode": "PT",
"postalCode": "1229-076"
}
}
]
},
"userProperties": {
"customerType": "RETURNING"
},
"eventName": "purchase",
"clientId": "9876543210.1761582117",
"userId": "user_DEF9876",
"additionalEventParameters": [
{
"parameterName": "ad_unit_name",
"value": "Banner_02"
}
],
"cartData": {
"transactionDiscount": 6.66,
"items": [
{
"itemId": "SKU_12346",
"quantity": 2,
"unitPrice": 21.01,
"additionalItemParameters": [
{
"parameterName": "item_name",
"value": "Google Grey Women's Tee"
},
{
"parameterName": "affiliation",
"value": "Google Merchandise Store"
},
{
"parameterName": "coupon",
"value": "SUMMER_FUN"
},
{
"parameterName": "discount",
"value": "3.33"
},
{
"parameterName": "index",
"value": "1"
},
{
"parameterName": "item_brand",
"value": "Google"
},
{
"parameterName": "item_category",
"value": "Apparel"
},
{
"parameterName": "item_category2",
"value": "Adult"
},
{
"parameterName": "item_category3",
"value": "Shirts"
},
{
"parameterName": "item_category4",
"value": "Crew"
},
{
"parameterName": "item_category5",
"value": "Short sleeve"
},
{
"parameterName": "item_list_id",
"value": "related_products"
},
{
"parameterName": "item_list_name",
"value": "Related Products"
}
]
}
]
}
}
],
"validateOnly": true
}
- Aktualisieren Sie die Platzhalter im Text, z. B.
OPERATING_ACCOUNT_IDundPRODUCT_DESTINATION_ID, mit den Werten für Ihr Konto und Ziel. - Setzen Sie
validateOnlyauftrue, um die Anfrage zu validieren, ohne die Änderungen zu übernehmen. Wenn Sie die Änderungen anwenden möchten, setzen SievalidateOnlyauffalse. - In diesem Beispiel wird keine Verschlüsselung verwendet.
Anfrage senden
- Kopieren Sie den Anfragetext mit der Schaltfläche zum Kopieren oben rechts im Beispiel.
- Klicken Sie in der Symbolleiste auf die Schaltfläche API.
- Fügen Sie den kopierten Anfragetext in das Feld Anfragetext ein.
- Klicken Sie auf die Schaltfläche Ausführen, füllen Sie die Autorisierungsaufforderungen aus und prüfen Sie die Antwort.
Erfolgsantworten
Eine erfolgreiche Anfrage gibt eine Antwort mit einem Objekt zurück, das eine requestId enthält.
{
"requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}
Erfassen Sie die zurückgegebenen requestId, damit Sie Diagnosedaten abrufen können, wenn die einzelnen Ziele in der Anfrage verarbeitet werden.
Fehlerantworten
Eine fehlgeschlagene Anfrage führt zu einem Fehlerantwort-Statuscode wie 400 Bad
Request und einer Antwort mit Fehlerdetails.
Wenn beispielsweise ein emailAddress einen Nur-Text-String anstelle eines hexadezimal codierten Werts enthält, wird die folgende Antwort zurückgegeben:
{
"error": {
"code": 400,
"message": "There was a problem with the request.",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INVALID_ARGUMENT",
"domain": "datamanager.googleapis.com"
},
{
"@type": "type.googleapis.com/google.rpc.BadRequest",
"fieldViolations": [
{
"field": "events.events[0].user_data.user_identifiers",
"description": "Email is not hex encoded.",
"reason": "INVALID_HEX_ENCODING"
}
]
}
]
}
}
Eine emailAddress, die nicht gehasht, sondern nur hexadezimal codiert ist, führt zu folgender Antwort:
{
"error": {
"code": 400,
"message": "There was a problem with the request.",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "INVALID_ARGUMENT",
"domain": "datamanager.googleapis.com"
},
{
"@type": "type.googleapis.com/google.rpc.BadRequest",
"fieldViolations": [
{
"field": "events.events[0]",
"reason": "INVALID_SHA256_FORMAT"
}
]
}
]
}
}
Ereignisse für mehrere Ziele senden
Wenn Ihre Daten Ereignisse für verschiedene Ziele enthalten, können Sie sie mit Zielreferenzen in derselben Anfrage senden.
Wenn Sie beispielsweise ein Ereignis für die Conversion-Aktions-ID 123456789 und ein weiteres Ereignis für die Conversion-Aktions-ID 777111122 haben, senden Sie beide Ereignisse in einer einzelnen Anfrage, indem Sie die reference der einzelnen Destination festlegen. Der reference ist benutzerdefiniert. Die einzige Anforderung ist, dass jede Destination eine eindeutige reference hat. Hier ist die geänderte destinations-Liste für die Anfrage:
"destinations": [
{
"operatingAccount": {
"accountType": "OPERATING_ACCOUNT_TYPE",
"accountId": "OPERATING_ACCOUNT_ID"
},
"loginAccount": {
"accountType": "LOGIN_ACCOUNT_TYPE",
"accountId": "LOGIN_ACCOUNT_ID"
},
"productDestinationId": "PRODUCT_DESTINATION_ID",
"reference": "destination_a"
},
{
"operatingAccount": {
"accountType": "OPERATING_ACCOUNT_2_TYPE",
"accountId": "OPERATING_ACCOUNT_2_ID"
},
"loginAccount": {
"accountType": "LOGIN_ACCOUNT_2_TYPE",
"accountId": "LOGIN_ACCOUNT_2_ID"
},
"productDestinationId": "777111122",
"reference": "destination_b"
}
]
Legen Sie die destinationReferences jedes Event fest, um es an ein oder mehrere bestimmte Ziele zu senden. Hier ist beispielsweise ein Event, das nur für das erste Destination gilt. Die destinationReferences-Liste enthält also nur die reference des ersten Destination:
{
"adIdentifiers": {
"gclid": "GCLID_1"
},
"conversionValue": 1.99,
"currency": "USD",
"eventTimestamp": "2025-06-10T20:07:01Z",
"transactionId": "ABC798654321",
"eventSource": "WEB",
"destinationReferences": [
"destination_a"
]
}
Das Feld destinationReferences ist eine Liste, sodass Sie mehrere Ziele für ein Ereignis angeben können. Wenn Sie die destinationReferences eines Event nicht festlegen, sendet die Data Manager API das Ereignis an alle Ziele in der Anfrage.
Wenn ein Ereignis mehrere Ziele hat, werden die relevanten Felder über die Data Manager API an jedes Ziel gesendet. Wenn ein Ereignis beispielsweise ein Google Ads-Ziel und ein Google Analytics-Ziel hat, enthält die API Google Analytics-Felder wie clientId oder eventName, wenn das Ereignis an das Google Analytics-Ziel gesendet wird, und Google Ads-Felder wie customVariables, wenn das Ereignis an das Google Ads-Ziel gesendet wird.
Nächste Schritte
- Konfigurieren Sie die Authentifizierung und richten Sie Ihre Umgebung mit einer Clientbibliothek ein.
- Weitere Informationen zu den Formatierungs-, Hash- und Codierungsanforderungen für die einzelnen Datentypen
- Informationen zum Verschlüsseln von Nutzerdaten
- Informationen zum Abrufen von Diagnosedaten für Ihre Anfragen
- Best Practices
- Weitere Informationen zu Limits und Kontingenten