Versionshinweise

Hier erfahren Sie, was sich in den einzelnen Data Manager API-Releases geändert hat.

30.07.2026, Version 1.8

• Die Methode RemoveAllAudienceMembers wurde dem IngestionService hinzugefügt, um alle Zielgruppenmitglieder für die angegebenen Nutzerlisten zu entfernen oder zu ersetzen.
  • Sehen Sie sich zuerst den Leitfaden zum Entfernen aller Mitglieder aus einer Zielgruppe für Ihre spezifische Integration an. Weitere Informationen finden Sie in den Leitfäden zum Kundenabgleich für Google Ads oder Display & Video 360.
• Unterstützung für die Rückgabe von detaillierten Warnungen während der Aufnahme von Ereignissen und Zielgruppen hinzugefügt.
  • Das Feld field_warnings wurde zu IngestEventsResponse und IngestAudienceMembersResponse hinzugefügt. Es enthält eine Liste von FieldWarning-Objekten.
  • Die Ressource FieldWarning wurde hinzugefügt. Sie enthält einen reason-Pfad (WarningReason), einen description-Pfad und einen field-Pfad.
  • Das Enum WarningReason wurde hinzugefügt, um Gründe für Warnungen zu definieren, z. B. dass benutzerdefinierte Variablen nicht aktiviert sind oder Händler-IDs in Warenkorbdaten fehlen.
• Unterstützung für das Senden zusätzlicher Adressfelder für die Aufnahme von Google Analytics-Ereignissen hinzugefügt.
  • Die Felder address_line, city und administrative_area wurden zu AddressInfo hinzugefügt (verwendet in UserData).
• Die Fehlerursachen INVALID_REMOVE_AS_OF_TIME und REQUIRED_PREREQUISITE_LINK_MISSING wurden dem Enum ErrorReason hinzugefügt.

28.05.2026, Version 1.7

• Unterstützung für das Senden von Offline-Conversion-Ereignissen an Google Marketing Platform-Produkte, einschließlich Campaign Manager 360, Search Ads 360 und Display & Video 360, mithilfe eines IngestEventsRequest hinzugefügt.

  • FLOODLIGHT_CONFIG wurde dem Enum AccountType hinzugefügt, um Floodlight-Ziele zu unterstützen.
  • Die Felder dclid, impression_id, match_id und encrypted_user_ids wurden zu AdIdentifiers hinzugefügt.
  • Das Feld conversion_count wurde der Ressource Event hinzugefügt, um das Tracking von Conversion-Mengen zu unterstützen.

  Sehen Sie sich den Leitfaden zum Senden von Ereignissen an, um loszulegen, oder erfahren Sie, wie Sie ein Upgrade von der Campaign Manager 360 API durchführen.

• Das Feld composite_data wurde der Ressource AudienceMember hinzugefügt. Es akzeptiert ein CompositeData-Objekt und ermöglicht die Kombination mehrerer Arten von Kennungen, z. B. UserData und IpData. Weitere Informationen finden Sie unter Zusammengesetzte Daten.

  • Die neuen Status IngestCompositeDataStatus und RemoveCompositeDataStatus wurden hinzugefügt. Sie enthalten Diagnosen (record_count und data_type_counts) für Anfragen von Zielgruppenmitgliedern, die CompositeData verwenden.

• Unterstützung für die Aufnahme von IP-Adressen für den Google Ads-Kundenabgleich durch Senden von IpData in zusammengesetzten Daten hinzugefügt.

• Dem Enum ErrorReason wurden die neuen Fehlerursachen FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED und INSIGHTS_MISSING_FOR_DIMENSION hinzugefügt.

• ProcessingErrorReason wurden neue Diagnosewerte hinzugefügt, um detaillierteres Feedback zu Fehlern bei der Ereignisaufnahme zu erhalten.

07.05.2026, v1.6

• Unterstützung für das Senden von Google Ads-Conversions in Form von Ladenverkäufen über einen IngestEventsRequest hinzugefügt. Damit Sie diese Funktion verwenden können, muss Ihr Google Ads-Konto bestimmte Voraussetzungen erfüllen.
  • Der Datei Event wurde das Feld event_location hinzugefügt, mit dem sich eine physische store_id. angeben lässt.
  • Das Feld third_party_user_data wurde zu Event hinzugefügt, damit aufgenommene Daten explizit als Eigentum eines Drittanbieters gekennzeichnet werden können.
    • Dieses Feld darf nur von Datenpartnern ausgefüllt werden.
  • Die folgenden Felder wurden der Ressource Item hinzugefügt:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (akzeptiert eine Liste von ItemCustomVariable-Objekten)
  • Die folgenden Anleitungen erleichtern Ihnen den Einstieg:
    • Umstellung über Google Ads
    • Ereignisse senden
• Unterstützung für das Senden von Web- oder App-Ereignissen an Google Analytics hinzugefügt, die keine reservierten Ereignisse sind.
  • Der Ressource Event wurde das Feld app_instance_id hinzugefügt.
  • DeviceInfo wurden Felder hinzugefügt, um Metadaten zum Gerät des Nutzers bereitzustellen.
  • Das Feld mobile_device_id wurde zu AdIdentifiers hinzugefügt.
  • Das Feld event_location wurde zu Event hinzugefügt, um Felder wie city, subdivision_code, region_code, subcontinent_code und continent_code zu erfassen.
  • Die folgenden Anleitungen erleichtern Ihnen den Einstieg:
    • Empfohlene und benutzerdefinierte Ereignisse senden
    • Upgrade vom Measurement Protocol
    • Referenz zu empfohlenen Ereignissen
• Es wurde die Unterstützung für das Senden von Ereignissen mit einer Transaktions-ID an Web- und App-Datenstreams als zusätzliche Datenquelle für Ihre Tag- oder Google Analytics for Firebase (GA4F) SDK-Implementierungen hinzugefügt.
  • Diese Funktion ist auf Google Analytics-Properties auf einer Zulassungsliste beschränkt. Füllen Sie dieses Formular aus, wenn Sie Ihre Property der Zulassungsliste hinzufügen möchten.
• Das Feld coupon_codes wurde zu CartData hinzugefügt, um alle Gutscheincodes zu erfassen, die auf den Einkaufswagen für Ereignisse angewendet wurden, die an Google Ads und Google Analytics gesendet werden.
  • Verwenden Sie für die Einlösung von Gutscheinen in Google Ads den Conversion-Typ OFFLINE_PROMOTION_REDEMPTION.
• Es wurde ein neuer OAuth-Bereich (https://www.googleapis.com/auth/datamanager.partnerlink) für Methoden zum Erstellen, Suchen und Löschen von Partnerlinks hinzugefügt.
• Der Aufzählung ErrorReason wurden neue Werte hinzugefügt, um eine detaillierte Validierung für Ladenverkäufe und die Aufnahme von Google Analytics-Ereignissen zu unterstützen.
• Die Felder youtube_members_count und gmail_members_count wurden der Ressource SizeInfo hinzugefügt.

2026-03-26

• EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED wurde dem Enum ErrorReason hinzugefügt.

  Gemäß der EU-Verordnung zu politischer Werbung (EU PAR) müssen alle Google-Kunden per Selbsterklärung angeben, ob ihre Anzeigen gemäß der EU PAR als politische Werbung gelten. Weitere Informationen zur Definition von politischer Werbung in der EU und den Einschränkungen von Google für politische Werbung in der EU

  Ab dem 1. April 2026 können die folgenden Vorgänge für Konten ohne diese Erklärung eingeschränkt sein oder mit dem Fehler EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED fehlschlagen.

  • UserListService (create, update und delete)
  • IngestionService (ingestAudienceMembers)

  Um den Fehler zu beheben, müssen Werbetreibende die verpflichtende Erklärung in der Google Ads-Benutzeroberfläche abgeben. Weitere Informationen

• INVALID_MERCHANT_ID wurde dem Enum ErrorReason hinzugefügt.

17.02.2026, v1.5

Die Data Manager API unterstützt jetzt den gesamten End-to-End-Workflow für die Verwaltung von Zielgruppen, einschließlich Erstellung, Aufnahme und Abruf.

• Die Ressource UserList und UserListService wurden hinzugefügt, um das Erstellen, Abrufen, Aktualisieren und Löschen von Nutzerlisten zu ermöglichen.
  • In den Leitfäden zu Google Ads und Display & Video 360 finden Sie eine detaillierte Anleitung zum Erstellen, Befüllen und Bestätigen von Zielgruppen zum Kundenabgleich mithilfe der Data Manager API.
  • Die Migrationsschritte finden Sie in den Upgrade-Leitfäden für Google Ads oder Display & Video 360.
• Die User-ID kann jetzt über die Aufnahme von Zielgruppenmitgliedern gesendet werden, sodass sie mit dem Kundenabgleich in Google Ads verwendet werden kann.
  • UserIdData wurde zu AudienceMember hinzugefügt.
  • IngestUserIdDataStatus und RemoveUserIdDataStatus wurden den von der Methode RetrieveRequestStatus zurückgegebenen Status hinzugefügt. Mit diesen Feldern können Sie Diagnoseinformationen zur Aufnahme und Entfernung von Nutzer-IDs abrufen.
• Die Ressource PartnerLink und PartnerLinkService wurden hinzugefügt, um Verknüpfungen zwischen Werbetreibenden- und Datenpartnerkonten zu erstellen und zu verwalten.
  • Weitere Informationen finden Sie in den Leitfäden für Partnerlinks.

2026-02-10

Die Funktion zum Senden von Conversions mit mehreren Datenquellen zur Steigerung der Leistung und der Data Strength ist jetzt allgemein für alle Google Ads-Konten verfügbar.

Diese Funktion ist weiterhin nur für Google Analytics-Properties auf einer Zulassungsliste verfügbar. Füllen Sie das Formular aus, wenn Sie Ihre Google Analytics-Property auf die Zulassungsliste setzen lassen möchten.

05.11.2025, v1.4

• Sie können jetzt Google Analytics-purchase-Ereignisse als zusätzliche Datenquelle für Ihre Tag-Conversions senden, um Signale für Anzeigeninteraktionen zu maximieren und Ihre Daten und die Gesamtleistung zu verbessern.

  • GOOGLE_ANALYTICS_PROPERTY wurde zum Enum AccountType hinzugefügt.
  • Event wurden mehrere Felder hinzugefügt:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • additional_user_properties wurde zu UserProperties hinzugefügt.

  Weitere Informationen zum Senden von Google Analytics-purchase-Ereignissen und zum Zuordnen von Google Analytics-Ereignisparametern und ‑Nutzereigenschaften zu den entsprechenden Data Manager API-Äquivalenten finden Sie im Leitfaden zu Ereignissen.

• AwsWrappedKeyInfo wurde hinzugefügt, um die Verwendung von Verschlüsselungsschlüsseln aus AWS Key Management Service zu unterstützen.

• Die folgenden enum-Werte wurden zu ErrorReason hinzugefügt:

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

06.10.2025, Version 1.3

• Die Data Manager API ist jetzt allgemein für alle Nutzer verfügbar.

  Das Senden von Conversions mit mehreren Datenquellen zur Steigerung der Leistung und Datenstärke ist weiterhin nur für Konten auf einer Zulassungsliste verfügbar. Füllen Sie das Formular aus, wenn Sie Ihr Konto hinzufügen möchten.

  Füllen Sie das Antragsformular für Datenpartner aus, um Ihr Interesse an einer Datenpartnerschaft zu bekunden.

• Die Methode RetrieveRequestStatus wurde hinzugefügt, um Diagnoseinformationen für Anfragen zur Aufnahme von Ereignissen und Zielgruppen abzurufen.

• Das Feld product von ProductAccount und das Enum Product wurden verworfen. Verwenden Sie stattdessen das Feld account_type und das neue Enum AccountType.

• Unterstützung für die Angabe des destination für jede AudienceMember in einer IngestAudienceMembersRequest hinzugefügt. Mit dieser Funktion können Sie Zielgruppendaten in einer einzigen Anfrage an mehrere verschiedene Ziele senden.

• Über die API aufgenommene Zielgruppen können jetzt für das Targeting verwendet werden, sobald sie mindestens 100 Mitglieder haben. Bisher lag der Schwellenwert bei 1.000 Mitgliedern.

• Die transaction_id einer Event ist jetzt optional, wenn Offline-Conversions oder erweiterte Conversions für Leads gesendet werden. Die transaction_id ist weiterhin erforderlich, wenn Offline-Conversions als zusätzliche Datenquelle gesendet werden, um die Leistung und Datenqualität zu verbessern.

06.08.2025, Version 1.2

• Unterstützung für das Senden von Offline-Conversions und erweiterten Conversions für Leads an Google Ads-Ziele mit der Methode IngestEvents hinzugefügt. Informationen zum Konfigurieren der Verschlüsselung für diese Conversions finden Sie im aktualisierten Verschlüsselungsleitfaden.
• Die Werte APP, IN_STORE, PHONE und OTHER wurden dem Enum EventSource hinzugefügt. Für Offline-Conversions und erweiterte Conversions für Leads ist ein event_source erforderlich.
• Das Feld user_properties wurde zu Event hinzugefügt. Legen Sie für dieses Feld ein UserProperties-Objekt fest, um vom Werbetreibenden bewertete Informationen zu einem Nutzer hinzuzufügen, wenn das Ereignis aufgetreten ist.
• Der CustomVariable wurde das wiederkehrende Feld destination_references hinzugefügt. Verwenden Sie dieses Feld, um einen benutzerdefinierten Variablenwert nur auf eine Teilmenge der Ziele für ein Event anzuwenden.
• Die folgenden Fehler für Offline-Conversions und erweiterte Conversions für Leads wurden hinzugefügt:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

25.06.2025, Version 1.1

• Die Methode IngestEvents wurde zu IngestionService hinzugefügt. Verwenden Sie IngestEvents als zusätzliche Datenquelle für Ihre Tag-Conversions, um die Signale für Anzeigeninteraktionen zu maximieren und Ihre Daten und die Gesamtleistung zu verbessern.

2025-04-02 v1.0

• Erste Version der Data Manager API mit Unterstützung für das Senden von Zielgruppendaten an Google Ads und Display & Video 360.
• Unterstützung für gRPC und REST hinzugefügt.
• Der IngestionService wurde mit den Methoden IngestAudienceMembers und RemoveAudienceMembers hinzugefügt, um Zielgruppenmitglieder mit den folgenden Datentypen zu verwalten:
  • Kontaktdaten
  • Mobile IDs
  • PAIR-IDs
• Über die Data Manager API verwaltete Zielgruppen können nur für das Targeting verwendet werden,wenn sie mindestens 1.000 Mitglieder haben.