Czwartek, 30 lipca 2026 r.
Najnowsza wersja interfejsu Data Manager API wprowadza funkcje, które upraszczają zarządzanie odbiorcami, ulepszają przepływy pracy związane z pozyskiwaniem danych dzięki ostrzeżeniom na poziomie pola i umożliwiają przekazywanie do Google Analytics bardziej szczegółowych danych przekazywanych przez użytkowników.
Usuwanie wszystkich odbiorców
Użyj nowej metody RemoveAllAudienceMembers, aby w ramach jednej operacji usunąć wszystkich członków z określonych list użytkowników.
Opcjonalny parametr removeAsOfTime pozwala kierować reklamy tylko na tych użytkowników, którzy zostali dodani przed określoną sygnaturą czasową.
Jest to szczególnie przydatne, gdy chcesz przeprowadzić pełne odświeżenie (lub „zastąpienie wszystkich”) danych o odbiorcach, ponieważ umożliwia wyczyszczenie dotychczasowej listy i wypełnienie jej nowym zestawem użytkowników.
Ostrzeżenia dotyczące pól przetwarzania
Odpowiedzi interfejsu Data Manager API dotyczące pozyskiwania danych zawierają teraz szczegółowe ostrzeżenia na poziomie pola dotyczące problemów z weryfikacją pól opcjonalnych. Jeśli interfejs API wykryje problemy z weryfikacją pól opcjonalnych, żądanie pozyskania zostanie zrealizowane, a pozostałe dane zostaną przetworzone. Błędy weryfikacji wymaganych pól będą nadal powodować niepowodzenie całego żądania zgodnie z modelem szybkiego niepowodzenia.
Jeśli którekolwiek z podanych pól opcjonalnych jest nieprawidłowe, odpowiedź z IngestEventsRequest lub IngestAudienceMembersRequest zawiera pole field_warnings z listą obiektów FieldWarning. Każde ostrzeżenie zawiera konkretną przyczynę (WarningReason), komunikat opisowy i lokalizację pola w żądaniu, w którym wystąpił problem.
Dodatkowe dane adresowe na potrzeby zdarzeń Google Analytics
Podczas pozyskiwania zdarzeń do miejsc docelowych Google Analytics możesz teraz podawać dodatkowe informacje o adresie użytkownika. Oprócz pól given_name, family_name, region_code i postal_code zasób AddressInfo obsługuje teraz:
address_line(adres)cityadministrative_area(stan lub prowincja)
Możesz też teraz używać dotychczasowego pola danych przekazywanych przez użytkowników (user_data), aby spełniać wymagania dotyczące identyfikatorów w przypadku zdarzeń z wieloma źródłami wysyłanych do strumieni danych z sieci. Dzięki temu masz inną opcję, gdy nie masz ad_identifiers.gclid, user_id ani client_id w przypadku zdarzenia z wielu źródeł.
Rozpocznij
-
Dowiedz się, jak wdrożyć nową metodę
RemoveAllAudienceMembersw swoim przepływie pracy: - Aby dowiedzieć się, jak sprawdzać odpowiedzi pod kątem ostrzeżeń, zapoznaj się z sekcją Ostrzeżenia dotyczące pozyskiwania w przewodniku Informacje o błędach interfejsu API.
- Zacznij wysyłać zdarzenia do Google Analytics za pomocą interfejsu Data Manager API:
Szybsze tworzenie dzięki umiejętnościom agenta AI: niedawno wprowadziliśmy nowe umiejętności agenta interfejsu API Menedżera danych, które pomogą Ci przyspieszyć integrację. Zapoznaj się z nowymi umiejętnościami w repozytorium Google Skills na GitHubie, aby uzyskać dokładniejsze i bardziej efektywne wskazówki bezpośrednio w środowisku programistycznym wspomaganym przez AI.
Jeśli masz pytania lub chcesz omówić ten post, skontaktuj się z nami na serwerze Discord „Google Advertising and Measurement Community”. Jeśli masz problem lub potrzebujesz pomocy z interfejsem API, możesz też skontaktować się z nami na stronie pomocy.
Jeśli chcesz zostać dostawcą danych, wypełnij formularz zgłoszenia zainteresowania.
– Lindsey Volta, w imieniu zespołu ds. interfejsu Data Manager API
Etykiety: analytics, data-manager-api