LW IT Solutions logo LW IT Solutions logo LW IT Solutions
« Przegląd bloga /Digital Analytics / Measurement Protocol GA4 w trybie utrzymania: co...
Ten artykuł w innych językach:

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

Measurement Protocol GA4 w trybie utrzymania: co się zmienia i kiedy warto przejść na Data Manager API
Spis treści
  1. Co tryb utrzymania znaczy w praktyce
  2. Trzy różnice, które się liczą
  3. Co przemawia przeciw natychmiastowej zmianie
  4. Kiedy zmiana się opłaca
  5. Pytania i odpowiedzi
  6. Źródła

Na stronie Google poświęconej Measurement Protocol widnieje od czerwca 2026 wzmianka opisująca niecodzienny stan: interfejs osiągnął dojrzały, zamknięty stan produktu i pozostaje w działaniu, a wycofanie nie jest planowane. Dla integracji serwer-serwer zalecane jest w zamian Data Manager API, określone jako centralna infrastruktura przyszłych nowości w przyjmowaniu danych.

Oznacza to, że nic nie zostaje wyłączone i nic nowego nie dochodzi. Nie ma wyznaczonego terminu migracji, więc użytkownik musi sam zdecydować, kiedy warto przejść na drugi interfejs.

Dwie odbite piasty: po lewej szara piasta z jedną szprychą do Google Analytics i dwoma celami rysowanymi przerywaną linią, które wymagałyby własnej integracji; po prawej niebieska piasta z trzema szprychami do Google Ads, Google Analytics i Display and Video 360, pod każdą stroną lista cech przesyłu
To samo zdarzenie, dwie drogi na zewnątrz. Różnica leży nie w ładunku, lecz w tym, ile celów potrafi osiągnąć jedno żądanie i co niesie jego koperta.

Co tryb utrzymania znaczy w praktyce

Istniejąca integracja działa dalej. Kto dziś dosyła do GA4 zamówienia z systemu magazynowego albo zamknięte transakcje z systemu obsługi klienta, nie musi niczego ruszać, i nie ma daty, w której cokolwiek przestaje działać.

Przestaje rozwój. Każda przyszła możliwość w przyjmowaniu danych po stronie serwera powstaje w nowym interfejsie. Konfiguracja stojąca na Measurement Protocol starzeje się więc nie przez to, że się psuje, lecz przez to, że otoczenie wokół niej zyskuje zdolności, po które ona nie potrafi sięgnąć.

Trzy różnice, które się liczą

Pierwsza to uwierzytelnienie. Measurement Protocol pracuje z api_secret wysyłanym w zapytaniu – długowieczną tajemnicą w ciągu znaków, która ląduje w dziennikach i rzadko bywa wymieniana. Data Manager API wymaga OAuth 2.0 z zakresem datamanager. Wspólna tajemnica znika, a uprawnienie da się związać z kontem usługi i odebrać pojedynczo.

Druga różnica to liczba celów, do których może dotrzeć jedno żądanie. Measurement Protocol wysyła dane do Google Analytics. Google Ads albo Display & Video 360 wymagają innego interfejsu z własnym schematem, uwierzytelnianiem i obsługą błędów. Data Manager API obejmuje te cele jednym modelem danych, więc jedno zdarzenie może trafić do kilku z nich w jednym żądaniu.

Trzecia dotyczy identyfikatorów. Nowy interfejs obsługuje do dziesięciu identyfikatorów na rekord oraz szyfrowanie XChaCha20-Poly1305, którego zarządzanie kluczami może leżeć w Google Cloud albo w AWS. Dla danych dopasowywanych znaczy to, że identyfikator opuszcza firmę zaszyfrowany, a nie jedynie zahaszowany.

Tekst
To samo zadanie, dwie drogi

  Measurement Protocol
    POST /mp/collect?measurement_id=G-…&api_secret=…
    jeden punkt końcowy, jeden cel, tajemnica w zapytaniu
    identyfikatory jawnie albo zahaszowane

  Data Manager API
    REST albo gRPC, OAuth 2.0, zakres "datamanager"
    jedno wywołanie, kilka celów Google
    do 10 identyfikatorów na rekord, XChaCha20-Poly1305

  lista dopuszczeń: tylko zdarzenia GA z identyfikatorem transakcji jako dodatkowe źródło

Co przemawia przeciw natychmiastowej zmianie

Przesyłanie do GA4 zdarzeń z identyfikatorem transakcji jako dodatkowego źródła danych wymaga wpisu na listę dopuszczeń Data Manager API. Jeśli potrzebujesz właśnie tej funkcji, migracja musi poczekać na przyznanie dostępu. Plan migracji nie może zakładać dostępu, którego jeszcze nie przyznano.

Dochodzi do tego nakład niedoceniany przy każdej zmianie interfejsu: OAuth wymaga konta usługi, zarządzania kluczami i sposobu na zauważenie wygasłego uprawnienia, zanim zabraknie trzech dni transakcji. api_secret w zmiennej środowiskowej nie ma żadnego z tych wymagań – i to jest jednocześnie jego słabością i powodem, dla którego istniejąca integracja potrzebuje tak mało opieki.

Kiedy zmiana się opłaca

Trzy przypadki przemawiają za nią wyraźnie. Pierwszy to planowana druga integracja: kto i tak zamierza dostarczać transakcje również do Google Ads, zbuduje inaczej drugą integrację obok pierwszej i będzie potem utrzymywał dwie. Drugi to obchodzenie się z danymi osobowymi – tam, gdzie identyfikatory opuszczają firmę, szyfrowanie z własnym zarządzaniem kluczami to inna rozmowa z działem ochrony danych niż wartość skrótu. Trzeci to budowa od nowa, bo zaczynanie nieistniejącej jeszcze integracji na zamrożonym interfejsie kosztuje tę samą pracę dwa razy.

Tam, gdzie żaden z tych przypadków nie zachodzi, czekanie jest do obrony, a nawet nasuwa się samo. Wzmianka na stronie Google nie jest odliczaniem. Jest informacją, że jeden interfejs jest gotowy, a drugi jest budowany dalej, i ta informacja nie zmienia się przez to, że ktoś przeczyta ją pół roku później.

Pytania i odpowiedzi

Dlaczego api_secret w zapytaniu to coś więcej niż defekt kosmetyczny?

Adres wraz z parametrami zapytania trafia do wielu miejsc, których nikt nie traktuje jako magazynu sekretów: do dzienników dostępu serwerów proxy i load balancerów, komunikatów o błędach, narzędzi monitorujących oraz dzienników aplikacji. Każde z tych miejsc przechowuje sekret tak długo jak swoje wpisy, często dłużej, niż powinien pozostawać ważny.

Kto zna tajemnicę, nie odczyta za jej pomocą danych z GA4, ale może zapisywać dowolne zdarzenia w strumieniu danych. Szkodą nie jest więc wyciek danych, lecz zafałszowane raporty, a wychodzi ona na jaw późno, bo podrzucone zdarzenia wyglądają jak prawdziwe.

Dopóki istniejąca integracja działa dalej, środkiem zaradczym pozostaje wymiana tajemnicy. GA4 pozwala utworzyć kilka takich tajemnic na strumień danych, widocznych w ustawieniach strumienia jako „Measurement Protocol API secrets”, więc wymiana polega na utworzeniu i wdrożeniu nowej, a na usunięciu starej dopiero potem. OAuth 2.0 w Data Manager API rozwiązuje ten sam problem u podstaw, bo tokeny dostępu są krótkotrwałe i nie są umieszczane w adresie.

Czy oba interfejsy mogą działać równolegle w trakcie przejścia?

Tak, o ile to samo zdarzenie nie trafia obiema drogami do tego samego celu, bo inaczej transakcje pojawią się w GA4 podwójnie. Czystym rozwiązaniem jest podział według celów, na przykład GA4 dalej przez Measurement Protocol, a Google Ads już przez Data Manager API, albo twarde przełączenie każdego celu w ustalonym momencie.

Jak wychodzi na jaw błędna albo wygasła integracja, zanim zabraknie transakcji?

W obu interfejsach w różny sposób. Measurement Protocol odpowiada na każde otrzymane żądanie statusem powodzenia, nawet gdy zdarzenie jest błędne albo zostaje odrzucone. Sprawdzenie w punkcie walidacyjnym /debug/mp/collect pokazuje błędy, ale należy do etapu tworzenia, a nie do każdego żądania. W działaniu pozostaje tylko uzgadnianie: liczba wysłanych zdarzeń wobec liczby tych, które docierają do GA4.

W Data Manager API brak lub wygaśnięcie uprawnienia powoduje odpowiedź z błędem. Alarm dla odpowiedzi spoza zakresu powodzenia pozwala zauważyć problem przy pierwszym niepowodzeniu, zamiast dopiero po brakujących transakcjach. Warunkiem jest to, że integracja w ogóle analizuje odpowiedzi.

Lukas Wójcik

Lukas Wójcik

Systems architect and technology enthusiast specializing in scalable tracking solutions, GMP Stack (GA4 & GTM), and robust backend architectures. Advocate for clean code and privacy-first design.

Kontakt

Masz pytanie lub pomysł na projekt internetowy? Napisz krótko, o co chodzi. Formularz korzysta z reCAPTCHA do ochrony przed spamem.

Napisanie komentarza

Odmienne wyniki z innych kont i pytania o konfigurację są tu mile widziane.

Adres e-mail nie jest publikowany. Pola obowiązkowe oznaczono gwiazdką.