Diese Seite wurde von der Cloud Translation API übersetzt.

Ereignisse senden

In dieser Kurzanleitung erfahren Sie, wie Sie Ereignisdaten senden.

Ereignisdaten sind eine zusätzliche Datenquelle für Ihre Tag-Conversions. Damit lassen sich Signale für Anzeigeninteraktionen maximieren und Ihre Daten und die Gesamtleistung verbessern.

Wählen Sie die gewünschte Version des Leitfadens aus:

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

Bereiten Sie ein Destination vor, 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

Ziel vorbereiten

Bevor Sie Daten senden können, müssen Sie das Ziel vorbereiten. Hier ist ein Beispiel für Destination, das Sie verwenden können:

    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }

Legen Sie die accountId der operatingAccount auf die Google Ads-Konto-ID fest, an die die Ereignisdaten gesendet werden sollen. Die product des operatingAccount muss GOOGLE_ADS sein.
Legen Sie productDestinationId auf die ID der Conversion-Aktion für die Ereignisse fest. Die Conversion-Aktion muss eine Google Ads-Conversion-Aktion sein, bei der type auf WEBPAGE festgelegt ist.

In dieser Anleitung wird beschrieben, wie Sie eine Anfrage erstellen, mit der alle Ereignisse an dieselbe Conversion-Aktion gesendet werden. Wenn Sie Ereignisse für mehrere Conversion-Aktionen in derselben Anfrage senden möchten, lesen Sie den Abschnitt Mehrere Ziele.

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.

Hier sind die Daten des ersten Ereignisses:

Ereignis 1
`conversion_time`	`2025-06-10 15:07:01-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`ABC798654321`
`conversion_value`	`1.99`
`currency`	`USD`
`gclid`	`GCLID_1`
`emails`
`given_name`	`John`
`family_name`	`Smith-Jones`
`region_code`	`us`
`postal_code`	`94045`

Hier sind die Daten des zweiten Ereignisses:

Ereignis 2
`conversion_time`	`June 10, 2025 11:42:33PM America/New_York`
`conversion_action_id`	`123456789`
`transaction_id`	`DEF999911111`
`conversion_value`	`3.25`
`currency`	`eur`
`gclid`	`GCLID_2`
`emails`	`zoe@EXAMPLE.COM` `cloudy.sanfrancisco@gmail.com`
`given_name`	`zoë`
`family_name`	`pérez`
`region_code`	`PT`
`postal_code`	`1229-076`

Daten formatieren

Formatieren Sie die Felder gemäß der Formatierungsanleitung. Hier sind die Daten des ersten Ereignisses nach der Formatierung:

Ereignis 1
`conversion_time`	`2025-06-10 15:07:01-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`ABC798654321`
`conversion_value`	`1.99`
`currency`	`USD`
`gclid`	`GCLID_1`
`emails`
`given_name`	`john`
`family_name`	`smith-jones`
`region_code`	`US`
`postal_code`	`94045`

Hier sind die Daten des zweiten Ereignisses nach der Formatierung:

Ereignis 2
`conversion_time`	`2025-06-10T23:42:33-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`DEF999911111`
`conversion_value`	`3.25`
`currency`	`EUR`
`gclid`	`GCLID_2`
`emails`	`zoe@example.com` `cloudysanfrancisco@gmail.com`
`given_name`	`zoë`
`family_name`	`pérez`
`region_code`	`PT`
`postal_code`	`1229-076`

Daten hashen und codieren

Außerdem müssen die formatierten E‑Mail-Adressen, Vornamen und Nachnamen mit dem SHA‑256-Algorithmus gehasht und entweder mit Hexadezimal- oder Base64-Codierung codiert werden. Hier sind die Daten des ersten Ereignisses nach der Formatierung, dem Hashing und der Codierung mit Hexadezimalcodierung:

Ereignis 1
`conversion_time`	`2025-06-10 15:07:01-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`ABC798654321`
`conversion_value`	`1.99`
`currency`	`USD`
`gclid`	`GCLID_1`
`emails`
`given_name`	`96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A`
`family_name`	`DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081`
`region_code`	`US`
`postal_code`	`94045`

Hier sind die Daten des zweiten Ereignisses nach der Formatierung, dem Hashing und der Hexadezimalcodierung:

Ereignis 2
`conversion_time`	`2025-06-10T23:42:33-05:00`
`conversion_action_id`	`123456789`
`transaction_id`	`DEF999911111`
`conversion_value`	`3.25`
`currency`	`EUR`
`gclid`	`GCLID_2`
`emails`	`3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250` `223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4`
`given_name`	`2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450`
`family_name`	`6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F`
`region_code`	`PT`
`postal_code`	`1229-076`

Konvertieren Sie die Daten in ein `Event`.

Konvertieren Sie die formatierten und gehashten Daten jedes Ereignisses in ein Event. Füllen Sie die folgenden Pflichtfelder aus:

event_timestamp: Die Uhrzeit, zu der das Ereignis aufgetreten ist.
transaction_id: Die eindeutige Kennung für das Ereignis.
event_source: Die Quelle des Ereignisses. Falls angegeben, muss dies WEB sein.
ad_identifiers oder user_data: Das Ereignis muss entweder eine Werbe-ID oder Nutzerdaten enthalten. Senden Sie beide, wenn Sie beide für das Event haben.

Eine vollständige Liste der verfügbaren Felder finden Sie in der Referenzdokumentation zu Event. Geben Sie für jedes Feld, für das Sie einen Wert für das Ereignis haben, einen Wert ein.

Hier ist ein Beispiel für eine Event für die formatierten, gehashten und codierten Daten aus dem zweiten Ereignis:

{
   "adIdentifiers": {
      "gclid": "GCLID_2"
   },
   "conversionValue": 3.25,
   "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"
            }
         }
      ]
   }
}

Anfragetext erstellen

Kombinieren Sie Destination und Events für den Anfragetext:

{
  "destinations": [
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 1.99,
       "currency": "USD",
       "eventTimestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 3.25,
       "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"
             }
           }
         ]
       }
     }
  ],
  "validateOnly": true
}

Aktualisieren Sie die Platzhalter im Text, z. B. OPERATING_ACCOUNT_ID und CONVERSION_ACTION_1_ID, mit den Werten für Ihr Konto und Ziel.
Setzen Sie validateOnly auf true, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, setzen Sie validateOnly auf false.
Hinweis: Für diese Anfrage wird keine Verschlüsselung verwendet.

Anfrage senden

Kopieren Sie den Anfragetext mit der Schaltfläche zum Kopieren oben rechts im Beispiel.
Rufen Sie die Seite events.ingest auf.
Klicken Sie rechts auf die Schaltfläche API und dann im maximierten Bereich auf die Schaltfläche Jetzt ausprobieren.
Fügen Sie den kopierten Anfragetext in das Feld Request body (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"
}

Fehlerantworten

Eine fehlgeschlagene Anfrage führt zu einem Fehlerantwort-Statuscode wie 400 Bad Request und einer Antwort mit Fehlerdetails.

Wenn beispielsweise ein email_address 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 email_address, 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 nutzerdefiniert. Die einzige Anforderung ist, dass jeder Destination einen eindeutigen reference hat. Hier ist die geänderte destinations-Liste für die Anfrage:

  "destinations": [
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "123456789"
      "reference": "conversion_action_1"
    },
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "777111122"
      "reference": "conversion_action_2"
    }
  ]

Legen Sie die destination_references 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 destination_references 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": [
      "conversion_action_1"
   ]
}

Das Feld destination_references ist eine Liste, sodass Sie mehrere Ziele für ein Ereignis angeben können. Wenn Sie die destination_references eines Event nicht festlegen, sendet die Data Manager API das Ereignis an alle Ziele in der Anfrage.

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
Best Practices
Weitere Informationen zu Limits und Kontingenten

Ereignisse senden Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.