Conversion-Anpassungen

Verwenden Sie die Methode IngestEvents, um Anpassungen an zuvor erfassten Google Ads-Conversions vorzunehmen. 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, wie Anpassungen in den einzelnen APIs gehandhabt werden.

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 für Conversions in Form von Ladenverkäufen werden nicht unterstützt.

Funktionsweise von Anpassungen

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

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

Anpassung senden

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

• Dasselbe 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.

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 Erfassungsanfragen finden Sie unter Ereignisse senden.

Unterstützte Felder

In der folgenden Tabelle sind die Felder aufgeführt, die Sie anpassen können, und es wird beschrieben, wie Updates angewendet werden:

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	Ignoriert

Conversion-Werte

Senden Sie eine neue conversionValue und currency, um den Wert einer aufgezeichneten Conversion neu anzugeben. Der neue Wert überschreibt den zuvor erfassten Wert in Berichten und Geboten, ohne die Anzahl der Conversions 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 eine E-Mail-Adresse oder Telefonnummer in Google Ads behandelt:

• 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, zusätzliche Offlinedaten innerhalb von 24 Stunden nach dem ursprünglichen Ereignis hochzuladen, um eine optimale Leistung zu erzielen.

• 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

Kennungen und Metadaten, die nicht Conversion-Wert, Währung und Nutzerdaten sind, z. B. adIdentifiers.gclid, können für abgeglichene Ereignisse nicht aktualisiert werden. Google Ads ignoriert diese Felder und behält die mit dem ursprünglichen Ereignis aufgezeichneten Werte bei.

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.

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