Conversion-Anpassungen

Mit der Methode IngestEvents können Sie Anpassungen an zuvor erfassten Google Ads-Conversions vornehmen. In der Data Manager API kann mit einer Anpassung ein Conversion-Wert neu angegeben oder Nutzerdaten ergänzt werden.

Wenn Sie von der Google Ads API migrieren, finden Sie hier einen Vergleich der Vorgehensweise bei Anpassungen in den einzelnen APIs.

Unterstützte Conversion-Typen

Sie können die folgenden Google Ads-Conversion-Typen anpassen:

Funktionsweise von Anpassungen

Innerhalb derselben Conversion-Aktion werden Ereignisse in Google Ads anhand der folgenden Parameter abgeglichen: transactionId:

  • Wenn transactionId mit einer vorhandenen Conversion für dieselbe Conversion-Aktion übereinstimmt, wird die Anfrage in der Data Manager API als Conversion-Korrektur behandelt.
  • Wenn die transactionId nicht mit einer vorhandenen Conversion übereinstimmt, wird in Google Ads eine neue Conversion erstellt. Weitere Informationen finden Sie unter Nicht abgeglichene Ereignisse.

Anpassung senden

Wenn Sie eine vorhandene Conversion anpassen möchten, senden Sie eine IngestEvents-Anfrage mit folgenden Angaben:

Wir empfehlen, dieselben Kennungen zu senden, die Sie mit dem ursprünglichen Ereignis gesendet oder erfasst haben. Wenn die transactionId keiner vorhandenen Conversion entspricht, werden diese Kennungen in Google Ads verwendet, um die neue Conversion zuzuordnen.

Sie müssen keinen Anpassungstyp angeben. Die Data Manager API leitet aus transactionId und den von Ihnen angegebenen Feldern ab, wie die Anfrage verarbeitet werden soll.

Weitere Informationen zum Senden von Aufnahmeanfragen finden Sie in den Anleitungen zum Senden von Ereignissen für Offline-Conversions oder Conversions aus mehreren Quellen.

Unterstützte Felder

In der folgenden Tabelle sehen Sie, wie Google Ads die einzelnen Felder anwendet, wenn ein Ereignis mit einer vorhandenen Conversion übereinstimmt:

Feld Verhalten
conversionValue, currency Überschrieben. Der neue Wert ersetzt den aufgezeichneten Wert.
userData Ergänzt, wenn das ursprüngliche Ereignis keine Nutzerdaten enthielt, andernfalls ignoriert.
Alle anderen Felder, z. B. adIdentifiers.gclid Nicht aktualisiert. In Google Ads werden die mit dem ursprünglichen Ereignis erfassten Werte beibehalten. Pflichtfelder müssen weiterhin vorhanden sein.

Conversion-Werte

Senden Sie ein neues conversionValue und currency, um den Wert einer erfassten Conversion neu anzugeben. Der neue Wert überschreibt den zuvor erfassten Wert in Berichten und Geboten, ohne die Conversion-Anzahl zu erhöhen.

Nutzerdaten

So werden userData wie eine E‑Mail-Adresse oder Telefonnummer in Google Ads verarbeitet:

  • Ergänzt, falls fehlend:Wenn das ursprüngliche Ereignis ohne Nutzerdaten erfasst wurde, werden die Nutzerdaten durch die Anpassung angehängt, um die Attribution zu verbessern.

  • Wird ignoriert, falls vorhanden:Wenn mit dem Google-Tag oder bei einem früheren Upload bereits Nutzerdaten erfasst wurden, werden die neuen Nutzerdaten ignoriert. Die vorhandenen Nutzerdaten werden nicht überschrieben oder angehängt.

Andere Felder

Andere Kennungen und Metadaten als Conversion-Wert, Währung und Nutzerdaten, z. B. adIdentifiers.gclid, können für abgeglichene Ereignisse nicht aktualisiert werden. In Google Ads werden die mit dem ursprünglichen Ereignis erfassten Werte beibehalten.

Sie müssen weiterhin alle erforderlichen Felder angeben, z. B. mindestens eine Kennung. Die Data Manager API validiert sie für jedes Ereignis.

Nicht abgeglichene Ereignisse

Wenn transactionId nicht mit einem vorhandenen Ereignis übereinstimmt, wird die Anfrage als Upload einer neuen Conversion und nicht als Anpassung behandelt.

Google Ads versucht, die neue Conversion anhand der von Ihnen bereitgestellten Kennungen, z. B. adIdentifiers.gclid oder userData, einem Anzeigenklick zuzuordnen.