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 je nach 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 IngestEvents-Methode unterstützt. Erfordert die separate ConversionAdjustmentUploadService.
Kontingente und Limits Projektbasierte Kontingente und Limits pro Anfrage. Kontingente auf Basis von Entwicklertokens und Limits pro Anfrage.
Fehlermodell Verwendet ein Fast-Fail-Modell. Verwendet ein Modell für Teilausfälle.

Unterschiedliche Anforderungen an Zielkonten

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

Die Google Ads API unterstützt das Senden von Conversions für ein Google Ads-Konto mit der customer_id von:

  1. Der Google Ads-Conversion-Kunde.

    Die Data Manager API unterstützt diesen Ansatz.

  2. Alle Konten, die über- oder untergeordnet sind, im Verhältnis zum Google Ads-Conversion-Kunden.

    Die Data Manager API unterstützt diesen Ansatz nicht. 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

Die Data Manager API vereint erste Conversion-Uploads und nachfolgende Conversion-Anpassungen in einer einzigen Methode.

In der Google Ads API:

  • Für die Anpassung von Conversions muss die separate Methode UploadConversionAdjustments im 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 die 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 einer 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 wegen doppelter Transaktions-ID zurück.
  • In der Anfrage ist kein Anpassungstyp erforderlich. Die Data Manager API leitet anhand der im Ereignis angegebenen Felder ab, wie die Anpassung verarbeitet werden soll.
  • Im Gegensatz zur Google Ads API unterstützt die Data Manager API keine Conversion-Widerrufe, bei denen eine zuvor erfasste Conversion vollständig entfernt wird, indem ihr Conversion-Wert und ihre Anzahl auf 0 gesetzt werden. Sie können den Wert einer Conversion neu angeben, die Anzahl der Conversions bleibt jedoch gleich.

Weitere Informationen finden Sie unter Conversion-Anpassungen.

Weiter
Upgrade ausführen