Ereignisse senden

In dieser Kurzanleitung erfahren Sie, wie Sie Ereignisdaten senden.

Verwenden Sie die Data Manager API für eines 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 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:

Werbetreibender Datenpartner

In dieser Kurzanleitung führen Sie die folgenden Schritte aus:

1. Bereiten Sie ein Destination vor, um Ereignisdaten zu empfangen.
2. Ereignisdaten für den Versand vorbereiten
3. Erstellen Sie eine IngestionService-Anfrage für Ereignisse.
4. Senden Sie die Anfrage mit dem Google APIs Explorer.
5. Erfolgs- und Fehlerantworten verstehen

Ziele vorbereiten

Bevor Sie Daten senden können, müssen Sie mindestens eine 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 eines Destination:

operatingAccount

Das 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. Legen Sie accountType auf GOOGLE_ADS oder GOOGLE_ANALYTICS_PROPERTY und accountId auf die Google Ads-Kundennummer oder die Google Analytics-Property-ID fest. Wenn accountType gleich GOOGLE_ANALYTICS_PROPERTY ist, müssen die Anmeldedaten der Anfrage für einen Google Analytics-Nutzer mit der Rolle Bearbeiter oder Administrator für die Property sein.

Bei Offline-Conversions und erweiterten Conversions für Leads muss das Betriebskonto ein Google Ads-Konto sein. Legen Sie daher accountType auf GOOGLE_ADS und accountId auf die Google Ads-Kunden-ID fest.

loginAccount

Das Konto, auf das der Nutzer der Anmeldedaten Zugriff hat.

Wenn Ihre OAuth-Anmeldedaten für einen Nutzer mit Zugriff auf ein Google Ads-Verwaltungskonto gelten, zu dessen Unterkonten operatingAccount gehört, ist loginAccount erforderlich. Legen Sie die accountId des loginAccount auf die ID des Verwaltungskontos und die accountType des loginAccount auf GOOGLE_ADS fest.

Wenn Ihre OAuth-Anmeldedaten für einen Nutzer mit direktem Zugriff auf die operatingAccount sind, müssen Sie loginAccount nicht festlegen. Der Standardwert ist die operatingAccount. Wir empfehlen jedoch, loginAccount auf dieselben accountId und accountType wie die operatingAccount festzulegen. So lassen sich Probleme vermeiden, wenn sich die Anzahl der Konten ändert, auf die der Nutzer zugreifen kann.

productDestinationId

Die ID der Entität in operatingAccount, die die Ereignisse empfängt.

Bei Ereignissen, die als zusätzliche Datenquelle gesendet werden, muss productDestinationId die ID einer Google Ads-Conversion mit type auf WEBPAGE festgelegt sein oder die Mess-ID eines Google Analytics-Web-Datenstreams. Sie können keine Ereignisse als zusätzliche Datenquelle an einen Google Analytics-Stream für iOS- oder Android-Apps senden.

Bei Offline-Conversions oder erweiterten Conversions für Leads muss productDestinationId die ID einer Google Ads-Conversion-Aktion sein, bei der type auf UPLOAD_CLICKS festgelegt ist.

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_id oder user_id für Google Analytics.

Hier sind die Ereignisdaten:

Daten formatieren

Formatieren Sie die Felder gemäß der Formatierungsanleitung. Hier sind die formatierten Ereignisdaten:

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:

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:

1. Legen Sie eventTimestamp auf die Zeit fest, zu der das Ereignis aufgetreten ist.

   Ereignisse für Google Analytics müssen einen eventTimestamp innerhalb der letzten 72 Stunden haben.

2. Legen Sie die erforderlichen Felder für Ihren Anwendungsfall fest.

   Anwendungsfall	IDs	transactionId	eventSource
   Offline-Conversions oder erweiterte Conversions für Leads	Erforderlich. Legen Sie mindestens einen der folgenden Werte fest: adIdentifiers mit mindestens einem der folgenden Werte: gclid, gbraid, wbraid oder sessionAttributes userData	Optional	Erforderlich. Legen Sie einen der Aufzählungswerte für EventSource fest.
   Ereignisse, die als zusätzliche Datenquelle an ein Google Ads-Ziel gesendet werden	Erforderlich. Legen Sie mindestens einen der folgenden Werte fest: adIdentifiers mit mindestens einem der folgenden Werte: gclid, gbraid oder wbraid userData	Erforderlich	Optional. Falls festgelegt, muss der Wert WEB sein.
   Ereignisse, die als zusätzliche Datenquelle an ein Google Analytics-Ziel gesendet werden	Erforderlich. Legen Sie mindestens einen der folgenden Werte fest: clientId adIdentifiers mit gclid festgelegt userData	Erforderlich	Optional. Falls festgelegt, muss der Wert WEB sein.

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

eventName

Erforderlich. Der Name des Google Analytics-Ereignisses.

transactionId

Erforderlich 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 über das Measurement Protocol senden.

• adIdentifiers.gclid: Eine Google-Klick-ID.

• userData: Kennungen für den Nutzer, z. B. E-Mail-Adressen, Telefonnummern oder Adressinformationen.

destinationReferences

Erforderlich, wenn die Liste destinations auf Anfrageebene mehr als eine Google Analytics-Destination enthält. Fügen Sie einen Eintrag zu destinationReferences hinzu, 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 destinationReferences nicht festgelegt ist oder mehrere Einträge enthält, die auf Google Analytics-Ziele verweisen, lehnt die Data Manager API das Ereignis mit dem Fehler MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT ab.

userId

Optional. Die Nutzer-ID für den Nutzer.

additionalEventParameters

Optional, 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 dem purchase-Ereignis oder andere Parameter enthalten, die Sie erfassen möchten. Verwenden Sie den Google Analytics-Parameternamen für die parameterName der EventParameter.

Wenn Sie beispielsweise die Steuern für eine Transaktion haben, fügen Sie additionalEventParameters einen Eintrag hinzu, wobei parameterName auf tax und value auf die Steuerkosten festgelegt ist.

Wir empfehlen, keine Einträge für die Google Analytics-Ereignisparameter transactionId, currency oder value hinzuzufügen. Füllen Sie stattdessen die transactionId, currency und conversionValue des Event aus, die Vorrang vor allen Einträgen in additionalEventParameters haben.

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.

unitPrice

Erforderlich. 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.67 und einen Rabatt pro Einheit von 6.66 hat, legen Sie unitPrice auf 21.01 fest.

quantity

Erforderlich. Die Anzahl der für diesen Artikel gekauften Einheiten.

additionalItemParameters

Füllen Sie diese Liste mit allen parametrisierten Elementen aus, die nicht in den anderen Item-Feldern erfasst werden. Verwenden Sie den Google Analytics-Artikelparametername für die parameterName der ItemParameter.

Wenn Sie beispielsweise die Marke und die Kategorie für ein Element haben, fügen Sie dem additionalItemParameters des Elements einen Eintrag mit parameterName auf item_brand und value auf den Markennamen hinzu. Fügen Sie außerdem einen weiteren Eintrag mit parameterName auf item_category und value auf die Kategorie des Elements hinzu.

Wir empfehlen, keine Einträge für die Google Analytics-Artikelparameter quantity, price oder item_id hinzuzufügen. Füllen Sie stattdessen die itemId, unitPrice und quantity des Item aus, die Vorrang vor allen Einträgen in additionalItemParameters haben.

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
}

1. Aktualisieren Sie die Platzhalter im Text, z. B. OPERATING_ACCOUNT_ID und PRODUCT_DESTINATION_ID, mit den Werten für Ihr Konto und Ziel.
2. Setzen Sie validateOnly auf true, um die Anfrage zu validieren, ohne die Änderungen zu übernehmen. Wenn Sie die Änderungen anwenden möchten, setzen Sie validateOnly auf false.
3. In diesem Beispiel wird keine Verschlüsselung verwendet.

Anfrage senden

1. Kopieren Sie den Anfragetext mit der Schaltfläche zum Kopieren oben rechts im Beispiel.
2. Klicken Sie in der Symbolleiste auf die Schaltfläche API.
3. Fügen Sie den kopierten Anfragetext in das Feld Anfragetext ein.
4. 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ückgegebene 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 und 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 im selben Request 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 Liste destinationReferences 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