Jak mierzyć mailing za pomocą Measurement Protocol?

Measurement Protocol to interfejs (API), który umożliwia wysyłanie danych bezpośrednio do Google Analytics 4 za pomocą żądań HTTP z serwera, dzięki czemu możesz śledzić działania spoza przeglądarki – w tym kampanie e‑mailowe.

Co to jest Measurement Protocol?

Measurement Protocol (MP) to kanał przesyłania zdarzeń i właściwości użytkownika do Google Analytics 4 wprost z systemów serwerowych i urządzeń, które nie mają natywnej integracji z GA4.

To rozwiązanie działa w modelu „serwer–serwer”, bez udziału przeglądarki i kodu front‑end. Dzięki temu można rejestrować zdarzenia z dowolnego źródła podłączonego do internetu, np. z aplikacji mobilnej, CRM czy systemu e‑mailowego.

Dlaczego Measurement Protocol jest ważny dla śledzenia mailingu?

W tradycyjnym śledzeniu e‑maili otwarcie wiadomości lub kliknięcie nie zawsze inicjuje uruchomienie skryptów analitycznych na stronie. MP pozwala przesłać zdarzenie otwarcia lub kliknięcia bezpośrednio do GA4 – nawet jeśli użytkownik nie odwiedził jeszcze witryny.

Takie podejście uzupełnia dane webowe, zapewniając pełniejszy obraz lejka kampanii e‑mailowych i ich wpływu na konwersje.

Jak działa śledzenie mailingu za pomocą Measurement Protocol?

Architektura rozwiązania

W GA4 zdarzenia z MP wysyła się metodą POST z serwera (wymagany jest tajny klucz API Secret), dlatego nie należy odwoływać się do endpointu GA4 bezpośrednio z treści e‑maila.

Praktyczny wzorzec wygląda tak: e‑mail zawiera niewidoczny piksel (obraz 1×1 px), którego adres wskazuje na Twój serwer. Gdy odbiorca otwiera wiadomość, serwer rejestruje żądanie obrazu, a następnie wysyła do GA4 zdarzenie via MP (POST + JSON) i zwraca odbiorcy obrazek.

Przygotowanie e‑maila

E‑mail powinien być w formacie HTML, aby można było wstawić obraz 1×1 px (tzw. piksel śledzący) wskazujący na Twój endpoint serwerowy.

Wstawienie piksela śledzącego

W treści wiadomości umieść obrazek 1×1 px, którego atrybut src wskazuje na Twój serwerowy URL z bezpiecznymi parametrami (bez ujawniania API Secret). Po trafieniu w ten URL Twój serwer wykona wywołanie do GA4 przez MP.

Parametry zdarzenia w GA4

W ładunku MP możesz przekazać kluczowe dane identyfikujące kontekst zdarzenia:

client_id – identyfikator anonimowego urządzenia/przeglądarki (np. pochodny z bazy lub generowany serwerowo);
user_id – opcjonalny identyfikator zalogowanego użytkownika, jeśli stosujesz go w całym ekosystemie;
name (nazwa zdarzenia) – np. email_open lub email_click dla rozróżnienia akcji;
parametry kampanii – np. campaign, source, medium, content, term albo parametry zbliżone do UTM;
dodatkowe parametry – np. message_id, subscriber_segment, template, aby wzbogacić analizę.

Wysyłanie danych do GA4 (MP)

W GA4 Measurement Protocol używa wyłącznie metody POST i przyjmuje dane w formacie JSON na endpointzie /mp/collect. Przykładowe wywołanie z serwera:

POST https://www.google-analytics.com/mp/collect?measurement_id=G-XXXXXXX&api_secret=YOUR_API_SECRET Content-Type: application/json

{ "client_id": "12345.67890", "user_id": "abc_789", "events": [ { "name": "email_open", "params": { "campaign": "newsletter_2026_04", "source": "email", "medium": "newsletter", "message_id": "msg_001", "engagement_time_msec": 1 } } ] }

Do testów możesz użyć endpointu debugującego /debug/mp/collect, aby zweryfikować poprawność ładunku przed wdrożeniem.

Praktyczne zastosowania – śledzenie otwarć e‑maili

Współczynnik otwarć w Google Analytics 4

W GA4 otwarcia e‑maili najlepiej rejestrować jako zdarzenie (np. email_open) z parametrem liczbowym (np. open_count=1) lub bezparametrowo, a metrykę zdefiniować na podstawie parametru zdarzenia.

Aby zbudować metrykę otwarć na podstawie zdarzenia i parametru, wykonaj poniższe kroki w interfejsie GA4:

przejdź do sekcji Administracja → Definicje niestandardowe → Utwórz nową definicję;
utwórz niestandardową metrykę, wskazując parametr zdarzenia (np. open_count) i odpowiedni typ danych;
zapisz definicję i odczekaj na przetwarzanie danych, po czym używaj metryki w raportach i eksploracjach.

Uwaga: w GA4 nie używa się schematu cm1 znanego z Universal Analytics. Zamiast tego definiujesz parametry zdarzeń i następnie przypisujesz do nich niestandardowe metryki/dymensje.

Ograniczenia czasowe wysyłania danych

Zdarzenia i właściwości użytkownika wysyłane przez MP są uwzględniane w listach odbiorców pod warunkiem dotrzymania limitów czasowych.

Musisz przesłać zdarzenie MP najpóźniej do końca dnia roboczego w 30. dniu po ostatnim zdarzeniu online dotyczącym tego samego client_id. Na przykład: jeśli ostatnie zdarzenie online miało miejsce 1 marca, wyślij zdarzenie MP najpóźniej do końca dnia roboczego 31 marca.

Korzyści ze stosowania Measurement Protocol

Poniżej zebraliśmy kluczowe atuty wdrożenia MP w śledzeniu e‑maili:

pełna spójność danych – uzgadniasz kluczowe zdarzenia (np. leady, transakcje, konwersje) niezależnie od kanału i urządzenia;
elastyczność źródeł – wysyłasz dane z CRM, systemów mailingowych i innych aplikacji działających po stronie serwera;
dokładniejsze atrybucje – wiążesz otwarcia/kliknięcia z użytkownikami, a potem z ich sesjami i konwersjami w ekosystemie;
centralizacja analityki – utrzymujesz całość danych kampanii e‑mailowych w GA4, obok danych webowych i aplikacyjnych.

Konfiguracja techniczna

Aby prawidłowo skonfigurować Measurement Protocol dla GA4, przygotuj i zabezpiecz poniższe elementy:

measurement_id – identyfikator pomiaru powiązany ze strumieniem danych GA4 (Administracja → Strumienie danych → wybierz strumień → Identyfikator pomiaru);
api_secret – tajny klucz dla MP generowany w sekcji Klucze API (przechowuj wyłącznie po stronie serwera);
client_id / user_id – identyfikatory do powiązania zdarzeń z użytkownikami/urządzeniami w raportach;
struktura zdarzeń i parametrów – lista nazw zdarzeń (np. email_open, email_click) i parametrów kampanii, które chcesz analizować.

Pamiętaj: w przeciwieństwie do tagów webowych (gtag, GTM) i SDK, w MP samodzielnie definiujesz i wysyłasz każde zdarzenie – łącznie z jego parametrami i kontekstem.

Ważne uwagi praktyczne

Przed wdrożeniem rozważ następujące kwestie techniczne i biznesowe:

bezpieczeństwo – nie umieszczaj api_secret w treści e‑maila ani po stronie klienta; wywołania MP wykonuj wyłącznie z zaufanego serwera;
wiarygodność otwarć – część klientów pocztowych blokuje obrazy lub korzysta z prywatności poczty (np. buforowanie), co może zawyżać lub zaniżać metrykę;
zgody i prywatność – uwzględnij lokalne przepisy i praktyki zgodowe (RODO) w zakresie identyfikatorów i przechowywania danych;
deduplikacja – zaplanuj logikę usuwania duplikatów i ewentualnego throttlingu przy ponownych otwarciach tej samej wiadomości.