Measurement Protocol GA4 w trybie utrzymania: co się zmienia i kiedy warto przejść na Data Manager API

Google opisuje Measurement Protocol GA4 jako dojrzały, ukończony produkt, który pozostaje dostępny bez planowanego wycofania. Ten sam komunikat zaleca Data Manager API do integracji przesyłających zdarzenia między serwerami. Decyzja dotyczy więc dopasowania interfejsu do potrzebnego przepływu danych, a nie dotrzymania ogłoszonego terminu wyłączenia.

„Tryb utrzymania” jest skrótowym opisem tego kierunku, nie gwarancją dotyczącą każdej przyszłej zmiany, poprawki lub decyzji o wsparciu. Poniższe porównanie odpowiada dokumentacji dostępnej 24 października 2026 r.

Co pozostaje możliwe z Measurement Protocol

Istniejąca integracja może nadal wysyłać zdarzenia do strumienia GA4 dla witryny lub aplikacji. Protokół uzupełnia zbieranie przez tag Google, Tag Manager lub Firebase. Wdrożenie wyłącznie serwerowe może dawać niepełne raporty, a starsze zdarzenia nadal podlegają ograniczeniom czasu i atrybucji. Połączenie z CRM nie jest nieograniczonym importem archiwum.

Aktualny komunikat nie podaje daty wyłączenia. Pozwala to zaplanować migrację, ale nie usuwa potrzeby monitorowania integracji, ochrony poświadczeń ani sprawdzania zmienionych wymagań.

Uwierzytelnienie: inne poświadczenia, nadal konieczna obsługa

Measurement Protocol przesyła api_secret w adresie URL żądania. HTTPS chroni transport, lecz dzienniki aplikacji, monitoring i infrastruktura kończąca połączenie TLS mogą ujawnić zapisany adres. Znaczenie mają zarówno ukrywanie wrażliwych parametrów URL, jak i rotacja sekretu. Ujawniony sekret pozwala wysyłać zdarzenia do odpowiedniego strumienia, ale nie służy do odczytywania raportów Analytics.

Data Manager API używa OAuth z zakresem https://www.googleapis.com/auth/datamanager. Dostępne podejścia obejmują poświadczenia użytkownika i konta usług. Konto usługi ani pobrany plik klucza prywatnego nie są obowiązkowe: oficjalna instrukcja opisuje impersonację konta usługi. Wybrana tożsamość potrzebuje też dostępu do każdego celu; dla zdarzeń GA4 instrukcja wymaga roli Edytor lub Administrator.

Tokeny dostępu, poświadczenia odświeżania i ewentualne klucze kont usług nadal wymagają ochrony. OAuth nie czyni bezpiecznym zapisywania całych nagłówków Authorization. Automatyczne odświeżanie tokenów nie zapobiega również odebraniu uprawnień do konta.

Cele i dane wymagają jawnego mapowania

Measurement Protocol adresuje jeden strumień GA4 na żądanie. Data Manager API obsługuje przesyłanie zdarzeń dla Google Analytics, Google Ads i zastosowań Floodlight, w tym odpowiednich produktów Google Marketing Platform. Jedno żądanie może zawierać wiele celów, a destinationReferences przypisuje do celów poszczególne zdarzenia. Nadal obowiązują ograniczenia właściwe dla odbiorcy: pojedyncze zdarzenie nie może trafić do dwóch celów Google Analytics.

Migracja nie polega na zmianie URL przy zachowaniu tego samego JSON-a. Przykładowo transaction_id przechodzi w transactionId, znacznik czasu ma inną reprezentację, a dane produktów trafiają do cartData. W Data Manager API właściwości użytkownika muszą towarzyszyć zdarzeniu; samodzielna aktualizacja takich właściwości, dostępna w Measurement Protocol, nie ma równoważnego odwzorowania.

Ogólna ścieżka zalecanych i niestandardowych zdarzeń jest odrębna od funkcji GA4 multi-source wymagającej dopuszczenia. Ta druga uzupełnia zdarzenia tagu lub Firebase. Nowe dane multi-source ze strumieni internetowych nie trafiają przez 14-dniowy okres próbny do ustalania stawek za konwersje w Google Ads. Lista dopuszczeń dla tej funkcji nie oznacza ogólnej blokady dostępu do całego Data Manager API.

Szyfrowanie uzupełnia haszowanie

Lista UserData.userIdentifiers dopuszcza najwyżej dziesięć identyfikatorów w zdarzeniu lub rekordzie członka grupy odbiorców. Limit dotyczy tej konkretnej listy, nie wszystkich pól identyfikacyjnych rekordu łącznie.

Dla obsługiwanych pól kontaktowych kolejność to normalizacja, haszowanie SHA-256 i opcjonalne szyfrowanie wartości skrótu. Data Manager API używa do dodatkowego szyfrowania XCHACHA20_POLY1305. Measurement Protocol także korzysta z HTTPS: brak dodatkowego szyfrowania pól nie oznacza jawnej transmisji przez sieć.

Obsługa zarządzania kluczami zależy od zastosowania. Aktualna tabela zgodności dopuszcza Google Cloud KMS dla zdarzeń Google Analytics multi-source i oznacza AWS KMS w tym wierszu jako nieobsługiwane. Dostępność AWS w innych częściach API nie dowodzi więc możliwości użycia tej samej konfiguracji przy migracji Analytics. Szyfrowanie nie zastępuje również zgody ani innych właściwych wymagań dotyczących przetwarzania.

Monitoring nie kończy się na sukcesie HTTP

Measurement Protocol potwierdza odbiór żądania odpowiedzią 2xx także wtedy, gdy zawartość jest nieprawidłowa lub zdarzenia nie zostają przetworzone. Punkt /debug/mp/collect pomaga sprawdzić strukturę, ale nie weryfikuje api_secret ani firebase_app_id i nie zasila raportów. Błędy sieciowe, wyniki walidacji i faktyczne pojawienie się zdarzeń w GA4 wymagają odrębnych kontroli.

Data Manager API odrzuca część nieprawidłowych żądań od razu. Udana odpowiedź może jednak zawierać fieldWarnings; przyjęte żądania zwracają też requestId do diagnostyki asynchronicznej. Zalecany przez Google proces rozpoczyna sprawdzanie po około 30 minutach i ponawia zapytania z rosnącymi odstępami, aż każdy cel osiągnie SUCCESS, PARTIAL_SUCCESS lub FAILURE. Ostrzeżenia wymagają sprawdzenia także przy statusie sukcesu. Alarm obejmujący wyłącznie odpowiedzi spoza zakresu 2xx pomija takie problemy przetwarzania.

Migracja z mierzalnym kryterium odbioru

Przydatna kolejność to mapowanie wszystkich pól, konfiguracja poświadczeń i celów, walidacja, ograniczona partia testowa, diagnostyka oraz porównanie z systemem źródłowym. Liczby zdarzeń, kwoty, waluty, identyfikatory i atrybucja wymagają porównania z uwzględnieniem opóźnień przetwarzania. Rejestr wysyłek ułatwia odróżnienie braków od powtórzeń.

Przy nowych integracjach Data Manager API odpowiada kierunkowi wskazanemu przez Google. Dla istniejących połączeń korzyść zależy od potrzebnych celów, diagnostyki, obsługi szyfrowania i kosztu migracji. Działający nadawca wyłącznie do GA4 nie wymaga automatycznie awaryjnej wymiany.