Hier erfahren Sie, was sich in den einzelnen Data Manager API-Releases geändert hat.
30.07.2026, Version 1.8
- Die Methode
RemoveAllAudienceMemberswurde demIngestionServicehinzugefügt, um alle Zielgruppenmitglieder für die angegebenen Nutzerlisten zu entfernen oder zu ersetzen.- Sehen Sie sich zuerst die Anleitung zum Entfernen aller Mitglieder aus einem Segment für Ihre spezifische Integration an. Beispiele finden Sie in den Leitfäden zum Kundenabgleich für Google Ads oder Display & Video 360.
- Es werden jetzt detaillierte Warnungen bei der Aufnahme von Ereignissen und Zielgruppen zurückgegeben.
- Das Feld
field_warningswurdeIngestEventsResponseundIngestAudienceMembersResponsehinzugefügt. Es enthält eine Liste vonFieldWarning-Objekten. - Die Ressource
FieldWarningwurde hinzugefügt. Sie enthält die Pfadereason(WarningReason),descriptionundfield. - Die
WarningReason-Enumeration wurde hinzugefügt, um Gründe für Warnungen zu definieren, z. B. wenn benutzerdefinierte Variablen nicht aktiviert sind oder Händler-IDs in Warenkorbdaten fehlen.
- Das Feld
- Es wurde Unterstützung für das Senden zusätzlicher Adressfelder für die Google Analytics-Ereigniserfassung hinzugefügt.
- Die Felder
address_line,cityundadministrative_areawurden zuAddressInfohinzugefügt (wird inUserDataverwendet).
- Die Felder
- Die Fehlerursachen
INVALID_REMOVE_AS_OF_TIMEundREQUIRED_PREREQUISITE_LINK_MISSINGwurden der EnumerationErrorReasonhinzugefügt.
2026-05-28 v1.7
Unterstützung für das Senden von Offline-Conversion-Ereignissen an Google Marketing Platform-Produkte wie Campaign Manager 360, Search Ads 360 und Display & Video 360 über ein
IngestEventsRequestwurde hinzugefügt.FLOODLIGHT_CONFIGwurde demAccountType-Enum hinzugefügt, um Floodlight-Ziele zu unterstützen.- Die Felder
dclid,impression_id,match_idundencrypted_user_idswurden zuAdIdentifiershinzugefügt. - Der Ressource
Eventwurde das Feldconversion_counthinzugefügt, um die Erfassung von Conversion-Mengen zu unterstützen.
Anleitung zum Senden von Ereignissen und Informationen zum Upgrade von der Campaign Manager 360 API
Das Feld
composite_datawurde der RessourceAudienceMemberhinzugefügt. Es akzeptiert einCompositeData-Objekt und ermöglicht es Ihnen, mehrere Arten von Kennungen zu kombinieren, z. B.UserDataundIpData. Weitere Informationen finden Sie unter Zusammengesetzte Daten.- Es wurden die neuen Status
IngestCompositeDataStatusundRemoveCompositeDataStatushinzugefügt, die Diagnosen (record_countunddata_type_counts) für Anfragen von Zielgruppenmitgliedern enthalten, bei denenCompositeDataverwendet wird.
- Es wurden die neuen Status
Es wurde Unterstützung für die Erfassung von IP-Adressen für den Google Ads-Kundenabgleich durch Senden von
IpDatain zusammengesetzten Daten hinzugefügt.Der
ErrorReason-Enum wurden die neuen FehlerursachenFIELD_VALUE_TOO_SHORT,TOO_FEW_ELEMENTS,BASELINE_LOCATION_AUTO_DETECTION_FAILEDundINSIGHTS_MISSING_FOR_DIMENSIONhinzugefügt.Der
ProcessingErrorReasonwurden neue Diagnosewerte hinzugefügt, um detaillierteres Feedback zu Fehlern bei der Ereignisaufnahme zu geben.
07.05.2026 v1.6
- Unterstützung für das Senden von Google Ads-Conversions vom Typ „Ladenverkäufe“ über ein
IngestEventsRequestwurde hinzugefügt. Damit Sie diese Funktion verwenden können, muss Ihr Google Ads-Konto bestimmte Voraussetzungen erfüllen.- Der
Event-Datei wurde das Feldevent_locationhinzugefügt, mit dem sich eine physischestore_id.angeben lässt. - Das Feld
third_party_user_datawurde zuEventhinzugefügt, damit aufgenommene Daten explizit als Eigentum eines Drittanbieters gekennzeichnet werden können.- Das Ausfüllen dieses Felds ist nur für Datenpartner zulässig.
- Der Ressource
Itemwurden die folgenden Felder hinzugefügt:merchant_idmerchant_feed_labelmerchant_feed_language_codeconversion_valuecustom_variables(akzeptiert eine Liste vonItemCustomVariable-Objekten)
- Die folgenden Anleitungen erleichtern Ihnen den Einstieg:
- Der
- Es wurde Unterstützung für das Senden beliebiger Web- oder App-Ereignisse an Google Analytics hinzugefügt, die kein reserviertes Ereignis sind.
- Der Ressource
Eventwurde das Feldapp_instance_idhinzugefügt. DeviceInfowurden Felder hinzugefügt, um Metadaten zum Gerät des Nutzers bereitzustellen.- AdIdentifiers wurde das Feld
mobile_device_idhinzugefügt. - Das Feld
event_locationwurdeEventhinzugefügt, um Felder wiecity,subdivision_code,region_code,subcontinent_codeundcontinent_codezu erfassen. - Die folgenden Anleitungen erleichtern Ihnen den Einstieg:
- Der Ressource
- Es ist jetzt möglich, beliebige Ereignisse mit einer Transaktions-ID sowohl an Web- als auch an App-Datenstreams zu senden. Sie können sie als zusätzliche Datenquelle für Ihre Tag- oder Google Analytics for Firebase (GA4F) SDK-Implementierungen verwenden.
- Diese Funktion ist auf Google Analytics-Properties auf einer Zulassungsliste beschränkt. Wenn Sie Ihre Property auf die Zulassungsliste setzen lassen möchten, füllen Sie dieses Formular aus.
- Das Feld
coupon_codeswurdeCartDatahinzugefügt, um alle Gutscheincodes zu erfassen, die auf den Warenkorb für Ereignisse angewendet werden, die an Google Ads und Google Analytics gesendet werden.- Verwenden Sie für Gutscheineinlösungen in Google Ads den Conversion-Typ
OFFLINE_PROMOTION_REDEMPTION.
- Verwenden Sie für Gutscheineinlösungen in Google Ads den Conversion-Typ
- 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 Enum
ErrorReasonwurden neue Werte hinzugefügt, um die detaillierte Validierung von Ladenverkäufen und die Erfassung von Google Analytics-Ereignissen zu unterstützen. - Die Felder
youtube_members_countundgmail_members_countwurden der RessourceSizeInfohinzugefügt.
2026-03-26
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIREDwurde der Enum-KlasseErrorReasonhinzugefügt.Gemäß der EU-Verordnung zu politischer Werbung (EU PAR) ist Google verpflichtet, alle Kunden zu fragen, ob ihre Anzeigen gemäß 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, für die diese Erklärung fehlt, eingeschränkt werden oder mit dem Fehler
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIREDfehlschlagen.Um den Fehler zu beheben, müssen Werbetreibende die verpflichtende Erklärung in der Google Ads-Benutzeroberfläche abgeben. Weitere Informationen zum Bestätigen für Ihr Konto
INVALID_MERCHANT_IDwurde der Enum-KlasseErrorReasonhinzugefü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 der Erstellung, Aufnahme und des Abrufs von Zielgruppen.
- Die Ressource
UserListundUserListServicewurden hinzugefügt, um das Erstellen, Abrufen, Aktualisieren und Löschen von Nutzerlisten zu ermöglichen.- In den Anleitungen zu Google Ads und Display & Video 360 finden Sie eine schrittweise Anleitung zum Erstellen, Befüllen und Überprüfen von Zielgruppen für den Kundenabgleich mit der Data Manager API.
- Eine Anleitung zur Migration finden Sie in den Google Ads- oder Display & Video 360-Upgrade-Leitfäden.
- Es wurde Unterstützung für das Senden der Nutzer-ID über die Aufnahme von Zielgruppenmitgliedern hinzugefügt. Dadurch kann sie mit dem Kundenabgleich in Google Ads verwendet werden.
UserIdDatawurde zuAudienceMemberhinzugefügt.- Den von der Methode
RetrieveRequestStatuszurückgegebenen Status wurdenIngestUserIdDataStatusundRemoveUserIdDataStatushinzugefügt. Mit diesen Feldern können Sie Diagnoseinformationen zum Erfassen und Entfernen von Nutzer-IDs abrufen.
- Die Ressource
PartnerLinkundPartnerLinkServicewurden hinzugefügt, um Verknüpfungen zwischen Werbetreibenden- und Datenpartnerkonten zu erstellen und zu verwalten.
2026-02-10
Das Senden von Conversions mit mehreren Datenquellen zur Steigerung von Leistung und 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
Es ist jetzt möglich, Google Analytics-
purchase-Ereignisse als zusätzliche Datenquelle für Ihre Tag-Conversions zu senden. So können Sie die Signale für Anzeigeninteraktionen maximieren und Ihre Daten und die Gesamtleistung verbessern.GOOGLE_ANALYTICS_PROPERTYwurde der Enum-KlasseAccountTypehinzugefügt.Eventwurden mehrere Felder hinzugefügt:event_nameclient_iduser_idadditional_event_parameters
additional_user_propertieswurde zuUserPropertieshinzugefügt.
Weitere Informationen zum Senden von
purchase-Ereignissen an Google Analytics und zum Zuordnen von Google Analytics-Ereignisparametern und ‑Nutzereigenschaften zu den entsprechenden Data Manager API-Äquivalenten finden Sie im Leitfaden zu Ereignissen.AwsWrappedKeyInfowurde hinzugefügt, um die Verwendung von Verschlüsselungsschlüsseln aus AWS Key Management Service zu unterstützen.Die folgenden Enum-Werte wurden
ErrorReasonhinzugefügt:EVENT_TIME_INVALIDFIELD_VALUE_TOO_LONGINVALID_EVENT_NAMEINVALID_PROPERTY_TYPEINVALID_REQUEST_IDINVALID_STREAM_TYPELINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNTMULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENTNOT_ALLOWLISTEDOPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCHRESERVED_NAME_USEDTOO_MANY_ELEMENTSUNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNERUNSUPPORTED_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 Partner aus, um Ihr Interesse an einer Partnerschaft als Datenpartner zu bekunden.
Die
RetrieveRequestStatus-Methode wurde hinzugefügt, um Diagnoseinformationen für Anfragen zum Erfassen von Ereignissen und Zielgruppen abzurufen.Das Feld
productvonProductAccountund die EnumerationProductwurden verworfen. Verwenden Sie stattdessen das Feldaccount_typeund das neue EnumAccountType.Es wurde Unterstützung für die Angabe der
destinationfür jedesAudienceMemberin einemIngestAudienceMembersRequesthinzugefügt. Mit diesem Feature können Sie Zielgruppendaten in einer einzigen Anfrage an mehrere unterschiedliche Ziele senden.Zielgruppen, die über die API erfasst werden, können jetzt für das Targeting verwendet werden, sobald sie mindestens 100 Mitglieder haben. Bisher lag die Mindestanzahl an Mitgliedern bei 1.000.
Die
transaction_ideinerEventist jetzt optional, wenn Sie Offline-Conversions oder erweiterte Conversions für Leads senden. Dietransaction_idist weiterhin erforderlich, wenn Sie Offline-Conversions als zusätzliche Datenquelle senden, um die Leistung und Datenstärke zu steigern.
06.08.2025 v1.2
- Es wurde Unterstützung für das Senden von Offline-Conversions und erweiterten Conversions für Leads an Google Ads-Ziele mithilfe der
IngestEvents-Methode hinzugefügt. Informationen zum Konfigurieren der Verschlüsselung für diese Conversions finden Sie in der aktualisierten Anleitung zur Verschlüsselung. - Die Werte
APP,IN_STORE,PHONEundOTHERwurden der AufzählungEventSourcehinzugefügt. Für Offline-Conversions und erweiterte Conversions für Leads ist eineevent_sourceerforderlich. Eventwurde das Felduser_propertieshinzugefügt. Legen Sie für dieses Feld einUserProperties-Objekt fest, um vom Werbetreibenden angegebene Informationen zu einem Nutzer hinzuzufügen, als das Ereignis aufgetreten ist.- Der
CustomVariable-Nachricht wurde das wiederholte Felddestination_referenceshinzugefügt. Mit diesem Feld können Sie einen benutzerdefinierten Variablenwert nur auf eine Teilmenge der Ziele für einEventanwenden. - Die folgenden Fehler für Offline-Conversions und erweiterte Conversions für Leads wurden hinzugefügt:
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADSDESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONSDESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED
2025-06-25 v1.1
- Die Methode
IngestEventswurde demIngestionServicehinzugefügt. IngestEvents als zusätzliche Datenquelle für Ihre Tag-Conversions verwenden, um Signale zu 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.
- IngestionService mit den Methoden
IngestAudienceMembersundRemoveAudienceMemberszum Verwalten von Zielgruppenmitgliedern mit den folgenden Datentypen hinzugefügt: - Zielgruppen, die mit der Data Manager API verwaltet werden, können nur für das Targeting verwendet werden, wenn sie mindestens 1.000 Mitglieder haben.