Conversion-Anpassungen

Mit der Methode IngestEvents können Sie Anpassungen an zuvor erfassten Google Ads-Conversions vornehmen. In der Data Manager API kann eine Anpassung einen Conversion-Wert neu angeben oder Nutzerdaten ergänzen.

Wenn Sie von der Google Ads API migrieren, finden Sie unter Upgrade von der Google Ads API einen Vergleich der Anpassungen in den beiden APIs.

Unterstützte Conversion-Typen

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

• Conversions mit mehreren Quellen: Conversions, die vom Google-Tag Ihrer Website für eine WEBSITE-Conversion-Aktion erfasst wurden.
• Offline-Conversions und erweiterte Conversions für Leads: Zuvor hochgeladene Offline-Ereignisse für eine UPLOAD_CLICKS-Conversion-Aktion.

Hinweis: Anpassungen an Conversions in Form von Ladenverkäufen werden nicht unterstützt.

Funktionsweise von Anpassungen

Innerhalb derselben Conversion-Aktion gleicht Google Ads Ereignisse mithilfe von transactionId ab:

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

Anpassung senden

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

• Dieselbe transactionId wie beim ursprünglichen Ereignis.
• Dasselbe Ziel und dieselbe Conversion-Aktion wie beim ursprünglichen Ereignis.
• Die aktualisierten Werte für die Felder, die Sie anpassen möchten.
• Alle für ein Ereignis erforderlichen Felder, einschließlich mindestens einer Kennung, z. B. adIdentifiers oder userData. Anforderungen an Ereignisse und Kennungen für Offline-Conversions oder Conversions aus mehreren Quellen

Wichtiger Hinweis: Die Data Manager API validiert jedes Ereignis, wenn sie die Anfrage empfängt, bevor sie nach einem übereinstimmenden transactionId sucht. Für eine Anpassung gelten dieselben Anforderungen an Felder und Kennungen wie für ein neues Ereignis. Andernfalls schlägt die Anfrage mit einem Fehler wie NO_IDENTIFIERS_PROVIDED fehl.

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

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

Weitere Informationen zum Senden von Aufnahme-Anfragen finden Sie in den Leitfäden zum Senden von Ereignissen für Offline-Conversions oder Conversions aus mehreren Quellen.

Unterstützte Felder

In der folgenden Tabelle ist aufgeführt, 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 Werte beibehalten, die mit dem ursprünglichen Ereignis erfasst wurden. Pflichtfelder müssen weiterhin vorhanden sein.

Conversion-Werte

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

Hinweis: Während des anfänglichen 14-tägigen Testzeitraums für Conversions mit mehreren Quellen sind Wertaktualisierungen deaktiviert. Der Wert des Tags wird in Google Ads-Berichten erst nach Ablauf des Testzeitraums überschrieben.

Nutzerdaten

So werden userData wie E-Mail-Adressen oder Telefonnummern 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.

  Hinweis: Wir empfehlen, ergänzende Offlinedaten innerhalb von 24 Stunden nach dem ursprünglichen Ereignis hochzuladen, um eine optimale Leistung zu erzielen.

• Ignoriert, falls vorhanden:Wenn das Google-Tag oder ein vorheriger Upload bereits Nutzerdaten erfasst hat, werden die neuen Nutzerdaten ignoriert. Die vorhandenen Nutzerdaten werden nicht überschrieben oder ergänzt.

Andere Felder

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

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

Nicht übereinstimmende Ereignisse

Wenn die 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.

Hinweis :Während des anfänglichen 14‑tägigen Testzeitraums für Conversions mit mehreren Quellen erscheinen neu erstellte Conversions zwar in Berichten, werden aber nicht für Gebote verwendet. Nach Ablauf des Testzeitraums können sie für Gebote verwendet werden.