Ereignisse senden

In dieser Kurzanleitung erfahren Sie, wie Sie Ereignisdaten senden.

Ereignisdaten sind eine zusätzliche Datenquelle für Ihre Tag-Conversions. So lassen sich Signale für Anzeigeninteraktionen maximieren und die 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:

  1. Bereiten Sie eine Destination vor, um Ereignisdaten zu empfangen.
  2. Bereiten Sie die zu sendenden Ereignisdaten vor.
  3. Erstellen Sie eine IngestionService-Anfrage für Ereignisse.
  4. Senden Sie die Anfrage mit dem Google APIs Explorer.
  5. Antworten auf erfolgreiche und fehlgeschlagene Vorgänge

Ziel vorbereiten

Bevor Sie Daten senden können, müssen Sie das Ziel vorbereiten, an das die Daten gesendet werden sollen. Hier ist ein Beispiel für eine Destination:

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

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  • Legen Sie die accountId des operatingAccount auf die Google Ads-Konto-ID fest, an die die Ereignisdaten gesendet werden sollen. Die product der operatingAccount muss GOOGLE_ADS sein.

  • Legen Sie für die Ereignisse productDestinationId auf die ID der Conversion-Aktion fest. Die Conversion-Aktion muss eine Google Ads-Conversion-Aktion sein, für die type auf WEBPAGE festgelegt ist.

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

Ereignisdaten vorbereiten

Betrachten Sie die folgenden Ereignisdaten. Jede Tabelle entspricht einem Conversion-Ereignis. Jedes Conversion-Ereignis hat einen Zeitstempel, eine Conversion-Aktion und einen Conversion-Wert.

Jedes Ereignis kann Anzeigen-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
last_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ë
last_name pérez
region_code PT
postal_code 1229-076

Daten formatieren

Formatieren Sie die Felder gemäß der Anleitung im Formatierungsleitfaden. 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
last_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ë
last_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 Hex-Codierung:

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
last_name DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081
region_code US
postal_code 94045

Hier sind die Daten des zweiten Ereignisses nach dem Formatieren, Hashing und der Hex-Codierung:

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
last_name 6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F
region_code PT
postal_code 1229-076

Daten in eine Event konvertieren

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

  • timestamp: Der Zeitpunkt, zu dem das Ereignis eingetreten ist.
  • transaction_id: Die eindeutige Kennung für das Ereignis.
  • event_source: Die Quelle des Ereignisses. Falls angegeben, muss dies EVENT_SOURCE_WEB sein.
  • ad_identifiers oder user_data: Das Ereignis muss entweder eine Anzeigen-ID oder Nutzerdaten enthalten. Sende beide, wenn du beide für das Ereignis hast.

Eine vollständige Liste der verfügbaren Felder finden Sie in der Referenzdokumentation zu Event. Geben Sie in jedem Feld, in dem 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",
   "timestamp": "2025-06-10T23:42:33-05:00",
   "transactionId": "DEF999911111",
   "eventSource": "EVENT_SOURCE_WEB",
   "userData": {
      "userIdentifiers": [
         {
            "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
         },
         {
            "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
         },
         {
            "address": {
              "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
              "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
              "regionCode": "PT",
              "postalCode": "1229-076"
            }
         }
      ]
   }
}

Anfragetext erstellen

Kombiniere 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",
       "timestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "EVENT_SOURCE_WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "lastName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 3.25,
       "currency": "EUR",
       "timestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "EVENT_SOURCE_WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "lastName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       }
     }
  ],
  "validateOnly": true
}
  1. Aktualisieren Sie die Platzhalter im Textkörper, z. B. OPERATING_ACCOUNT_ID und CONVERSION_ACTION_1_ID, mit den Werten für Ihr Konto und Ziel.
  2. Legen Sie validateOnly auf true fest, um die Anfrage zu validieren, ohne die Änderungen anzuwenden. Wenn Sie die Änderungen anwenden möchten, setzen Sie validateOnly auf false.
  3. Hinweis: Für diese Anfrage wird keine Verschlüsselung verwendet.

Anfrage senden

  1. Kopieren Sie den Anfragetext mit der Schaltfläche „Kopieren“ rechts oben in der Beispielanfrage.
  2. Rufen Sie die Seite events.ingest auf.
  3. Klicken Sie rechts auf die Schaltfläche API und dann im maximierten Bereich auf die Schaltfläche Jetzt ausprobieren.
  4. Fügen Sie den kopierten Anfragetext in das Feld Request body (Anfragetext) ein.
  5. Klicken Sie auf die Schaltfläche Ausführen, folgen Sie der Autorisierungsanleitung 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 Statuscode der Fehlerantwort, z. B. 400 Bad Request, und einer Antwort mit Fehlerdetails.

Wenn email_address beispielsweise einen Klartextstring 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"
          }
        ]
      }
    ]
  }
}

Für eine email_address, die nicht gehasht und nur hexadezimal codiert ist, wird 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]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

Ereignisse an mehrere Ziele senden

Wenn Ihre Daten Ereignisse für verschiedene Ziele enthalten, können Sie sie mithilfe von Zielreferenzen in derselben Anfrage senden.

Wenn Sie beispielsweise ein Ereignis für die Conversion-Aktion-ID 123456789 und ein anderes Ereignis für die Conversion-Aktion-ID 777111122 haben, senden Sie beide Ereignisse in einer einzigen Anfrage, indem Sie die reference für jede Destination festlegen. Die reference ist vom Nutzer definiert. Die einzige Voraussetzung ist, dass jede Destination eine eindeutige 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 für jede Event fest, um sie an eine oder mehrere bestimmte Ziele zu senden. Hier ist beispielsweise ein Event, das nur für die erste Destination gilt. Die destination_references-Liste enthält daher nur die reference der ersten Destination:

{
   "adIdentifiers": {
      "gclid": "GCLID_1"
   },
   "conversionValue": 1.99,
   "currency": "USD",
   "timestamp": "2025-06-10T20:07:01Z",
   "transactionId": "ABC798654321",
   "eventSource": "EVENT_SOURCE_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