Upgrade von der Google Ads API

Wenn Sie Ihre Conversion-Uploads von der Google Ads API auf die Data Manager API umstellen, erhalten Sie Zugriff auf mehrere Verbesserungen und Funktionen.

Hier finden Sie einen Vergleich zwischen der Data Manager API und der Google Ads API für die Verwaltung von Conversions.

	Data Manager API	Google Ads API
Unterstützung beim Senden von Offline-Conversions und erweiterten Conversions für Leads	Unterstützt.	Unterstützt.
Unterstützung für das Senden von Google Ads-Tag-Conversions als zusätzliche Datenquelle für Ihre Tag-Conversions, um Signale für Anzeigeninteraktionen zu maximieren und Ihre Daten und die Gesamtleistung zu verbessern	Unterstützt.	Nicht unterstützt.
Datenmodell	Einheitliches Datenmodell für alle Google Ads-Conversion-Anwendungsfälle und alle Google-Werbeprodukte.	Das Datenmodell ist nur für Google Ads-Anwendungsfälle vorgesehen und unterscheidet sich für jeden Anwendungsfall.
Verschlüsselung	Unterstützt Verschlüsselung.	Nicht unterstützt.
Entwickler-Token	Nicht erforderlich.	Erforderlich.
Unterstützung für das Hochladen von Sitzungsattributen und IP-Adressen für Ereignisse	Für alle API-Nutzer verfügbar.	Nur für bestimmte API-Nutzer verfügbar.
Conversion-Anpassungen	Wird in der einheitlichen Methode IngestEvents unterstützt.	Erfordert die separate ConversionAdjustmentUploadService.
Kontingente und Limits	Kontingente und Limits pro Anfrage auf Projektebene.	Kontingente auf Grundlage von Entwicklertokens und Limits pro Anfrage.
Fehlermodell	Verwendet ein Fast-Fail-Modell.	Verwendet ein Modell für Teilausfälle.

Unterschiede bei den Anforderungen an das Zielkonto

In der Data Manager API muss die operating_account des Ziels der Google Ads-Conversion-Kunde sein. Das unterscheidet sich von der Google Ads API.

Mit der Google Ads API können Sie Conversions für ein Google Ads-Konto senden. Dazu verwenden Sie die customer_id von:

1. Der Google Ads-Conversion-Kunde.

   Die Data Manager API unterstützt diesen Ansatz.

2. Alle Konten, die ein übergeordnetes oder untergeordnetes Konto des Google Ads-Conversion-Kunden sind.

   Dieser Ansatz wird von der Data Manager API nicht unterstützt. Wenn Sie dieses Verhalten in der Google Ads API nutzen, ändern Sie die operating_account jedes Ziels in den Inhaber der Conversion-Aktion. Diese kann sich von der customer_id unterscheiden, die Sie in Ihren Google Ads API-Anfragen verwenden.

Conversion-Anpassungen

Mit der Data Manager API werden ursprüngliche Conversion-Uploads und nachfolgende Conversion-Anpassungen in einer einzigen Methode zusammengeführt.

In der Google Ads API:

• Zum Anpassen von Conversions muss die separate Methode UploadConversionAdjustments in der ConversionAdjustmentUploadService verwendet werden.
• Wenn Sie versuchen, mehrere Conversions mit der Standardmethode UploadClickConversions für dieselbe Conversion-Aktion mit derselben Transaktions-ID (order_id) hochzuladen, schlägt die Anfrage fehl.
• Sie müssen ConversionAdjustmentType in der Anfrage angeben.

In der Data Manager API:

• Für Conversion-Uploads und ‑Anpassungen wird der einheitliche Endpunkt IngestEvents verwendet.
• Wenn Sie ein Ereignis mit einem vorhandenen transaction_id für dieselbe Conversion-Aktion mit aktualisierten Conversion-Werten oder Nutzerdaten hochladen, wird dies automatisch als Anpassung behandelt. Die API gibt keinen Fehler für doppelte Transaktions-IDs zurück.
• In der Anfrage ist kein Anpassungstyp erforderlich. Die Data Manager API leitet ab, wie die Anpassung basierend auf den im Ereignis angegebenen Feldern verarbeitet werden soll.
• Im Gegensatz zur Google Ads API werden in der Data Manager API keine Conversion-Rücknahmen unterstützt. Dabei wird eine zuvor erfasste Conversion vollständig entfernt, indem ihr Conversion-Wert und ihre Anzahl auf 0 festgelegt werden. Sie können den Wert einer Conversion neu formulieren, die Anzahl der Conversions bleibt jedoch gleich.

Weitere Informationen zu Conversion-Anpassungen