Donnerstag, 30. Juli 2026
Die neueste Version der Data Manager API bietet Funktionen, die die Zielgruppenverwaltung vereinfachen, Workflows für die Datenaufnahme mit Warnungen auf Feldebene verbessern und detailliertere von Nutzern bereitgestellte Daten für Google Analytics ermöglichen.
Alle Zielgruppenmitglieder entfernen
Mit der neuen Methode RemoveAllAudienceMembers können Sie alle Mitglieder aus bestimmten Nutzerlisten in einem einzigen Vorgang entfernen.
Mit dem optionalen Parameter removeAsOfTime können Sie nur die Mitglieder ansprechen, die vor einem bestimmten Zeitstempel hinzugefügt wurden.
Das ist besonders nützlich, wenn Sie Ihre Zielgruppendaten vollständig aktualisieren (oder „alle ersetzen“) müssen. So können Sie die vorhandene Liste löschen und mit einer neuen Gruppe von Nutzern füllen.
Warnungen zu Aufnahmefeldern
Die Antworten der Data Manager API auf die Datenaufnahme enthalten jetzt detaillierte Warnungen auf Feldebene zu Validierungsproblemen bei optionalen Feldern. Wenn die API Validierungsprobleme bei optionalen Feldern erkennt, wird Ihre Aufnahme-Anfrage erfolgreich ausgeführt und die restlichen Aufnahmedaten werden trotzdem verarbeitet. Validierungsfehler bei Pflichtfeldern führen weiterhin dazu, dass die gesamte Anfrage gemäß dem Fast-Fail-Modell fehlschlägt.
Wenn ein von Ihnen angegebenes optionales Feld ungültig ist, enthält die Antwort von IngestEventsRequest oder IngestAudienceMembersRequest ein field_warnings-Feld mit einer Liste von FieldWarning-Objekten. Jede Warnung enthält einen bestimmten Grund (WarningReason), eine beschreibende Meldung und die Position des Felds in der Anfrage, in dem das Problem aufgetreten ist.
Zusätzliche Adressdaten für Google Analytics-Ereignisse
Sie können jetzt zusätzliche Adressinformationen von Nutzern angeben, wenn Sie Ereignisse in Google Analytics-Ziele aufnehmen. Zusätzlich zu den Feldern given_name, family_name, region_code und postal_code unterstützt die Ressource AddressInfo jetzt Folgendes:
address_line(Adresse)cityadministrative_area(Bundesland oder Kanton)
Außerdem können Sie jetzt das vorhandene Feld für von Nutzern bereitgestellte Daten (user_data) verwenden, um die Anforderungen an Kennungen für Ereignisse mit mehreren Quellen zu erfüllen, die an Web-Datenstreams gesendet werden. Dies ist eine weitere Option, wenn Sie nicht über die ad_identifiers.gclid, user_id oder client_id für ein Ereignis mit mehreren Quellen verfügen.
Jetzt starten
-
So implementieren Sie die neue
RemoveAllAudienceMembers-Methode für Ihren Workflow: - Im Abschnitt Warnungen bei der Aufnahme des Leitfadens API-Fehler verstehen erfahren Sie, wie Sie Ihre Antworten auf Warnungen prüfen.
- So senden Sie Ereignisse mit der Data Manager API an Google Analytics:
Schneller entwickeln mit KI-Agenten-Skills: Wir haben vor Kurzem neue Data Manager API-Agenten-Skills eingeführt, mit denen Sie Ihre Integrationen beschleunigen können. Sehen Sie sich die neuen Skills im GitHub-Repository für Google Skills an, um genauere und effizientere Anleitungen direkt in Ihrer KI-gestützten Programmierumgebung zu erhalten.
Wenn ihr Fragen habt oder diesen Beitrag diskutieren möchtet, könnt ihr euch auf unserem Discord-Server Google Advertising and Measurement Community an uns wenden. Wenn Sie ein Problem haben oder Hilfe bei der API benötigen, können Sie uns auch über die Supportseite kontaktieren.
Wenn Sie Datenpartner werden möchten, füllen Sie bitte das Antragsformular für Partner aus.
– Lindsey Volta im Namen des Data Manager API-Teams
Labels: analytics, data-manager-api