Pełna instrukcja konfiguracji platform (GA4, Google Ads, Meta, TikTok, Synerise), proces wdrożenia, weryfikacja i utrzymanie opisane są w dokumencie: InPost Pay — Integracja Konwersji Marketingowych.

Wymagania wstępne

Konfiguracja localStorage przez Google Tag Manager

Aby system analityczny InPost Pay działał poprawnie, niezbędne jest zapisanie w localStorage przeglądarki czterech identyfikatorów:

gclid (Google Ads),
fbclid (Meta / Facebook Ads),
ttclid (TikTok Ads),
client_id (Google Analytics 4 — identyfikator użytkownika).

Dane te muszą być dostępne po stronie frontendu, ponieważ są odczytywane przez widget InPost Pay w momencie składania zamówienia.

Krok 1: Utwórz nowy tag w Google Tag Manager

Przejdź do swojego kontenera GTM.
Kliknij Dodaj nowy tag i nazwij go np. Zapisz ID do localStorage.
Wybierz typ tagu: HTML niestandardowy.
Wklej poniższy kod:

<script>
function getQueryParam(paramName) {
  var query = window.location.search.substring(1);
  var vars = query ? query.split('&') : [];
  var i;
  var pair;
  var key;
  var value;

  for (i = 0; i < vars.length; i++) {
    pair = vars[i].split('=');
    key = decodeURIComponent(pair[0] || '');
    value = decodeURIComponent(pair[1] || '');

    if (key === paramName) {
      return value;
    }
  }

  return null;
}

function getCookie(cookieName) {
  var nameEQ = cookieName + '=';
  var ca = document.cookie.split(';');
  var i;
  var c;

  for (i = 0; i < ca.length; i++) {
    c = ca[i];
    while (c.charAt(0) === ' ') {
      c = c.substring(1, c.length);
    }
    if (c.indexOf(nameEQ) === 0) {
      return c.substring(nameEQ.length, c.length);
    }
  }

  return null;
}

function getGa4SessionId() {
  try {
    var cookies = document.cookie.split(';');
    var i;
    var cookie;
    var parts;
    var value;

    for (i = 0; i < cookies.length; i++) {
      cookie = cookies[i];
      while (cookie.charAt(0) === ' ') {
        cookie = cookie.substring(1, cookie.length);
      }

      if (cookie.indexOf('_ga_') === 0) {
        value = cookie.split('=').slice(1).join('=');

        if (value) {
          parts = value.split('.');
          if (parts.length >= 3) {
            return parts[2];
          }
        }
      }
    }
  } catch (e) {}

  return null;
}

function saveTrackingIdsToLocalStorage() {
  try {
    var gclid = getQueryParam('gclid');
    var fbclid = getQueryParam('fbclid');
    var ttclid = getQueryParam('ttclid');
    var gaClientId = getCookie('_ga');
    var gaSessionId = getGa4SessionId();

    if (gclid) {
      localStorage.setItem('gclid', gclid);
    }

    if (fbclid) {
      localStorage.setItem('fbclid', fbclid);
    }

    if (ttclid) {
      localStorage.setItem('ttclid', ttclid);
    }

    if (gaClientId) {
      localStorage.setItem('client_id', gaClientId);
    }

    if (gaSessionId) {
      localStorage.setItem('session_id', gaSessionId);
    }
  } catch (e) {}
}

saveTrackingIdsToLocalStorage();
</script>

Krok 2: Ustaw wyzwalacz

Kliknij Wyzwalacze i wybierz All Pages (Wszystkie strony).
Zapisz tag.

Krok 3: Przetestuj

Wejdź na stronę z parametrami w URL, np. ?gclid=111&fbclid=222&ttclid=333.
W narzędziu developerskim przeglądarki (DevTools → Application → localStorage) sprawdź, czy dane zostały zapisane:

localStorage.getItem('gclid')     // "111"
localStorage.getItem('fbclid')    // "222"
localStorage.getItem('ttclid')    // "333"
localStorage.getItem('client_id') // np. "GA1.2.1234567890.1234567890"

Uwagi końcowe

Jeśli używasz Google Consent Mode, upewnij się, że ten tag uruchamiany jest po zgodzie użytkownika na analitykę.

Na tej stronie:

1 Wymagania wstępne
- 1.1 Konfiguracja localStorage przez Google Tag Manager
  - 1.1.1 Krok 1: Utwórz nowy tag w Google Tag Manager
  - 1.1.2 Krok 2: Ustaw wyzwalacz
  - 1.1.3 Krok 3: Przetestuj
  - 1.1.4 Uwagi końcowe
2 Konfiguracja GA4 w module Magento
- 2.1 Krok 1: Pobierz dane z Google Analytics 4
- 2.2 Krok 2: Skonfiguruj Magento
  - 2.2.1 Opcjonalnie: Asynchroniczne wysyłanie danych przez CRON

Konfiguracja GA4 w module Magento

Moduł InPost Pay dla Magento posiada wbudowaną integrację z GA4 (Measurement Protocol). Poniższa instrukcja opisuje konfigurację w panelu administracyjnym Magento.

Krok 1: Pobierz dane z Google Analytics 4

Przejdź do zakładki Admin w panelu GA4
Wybierz Admin > Data collection and modification > Data streams
Wybierz stream danych, do którego chcesz wysyłać zdarzenia zakupu
Skopiuj i zapisz Measurement ID (format: G-XXXXXXXXXX)
Następnie wybierz Measurement Protocol API Secrets → Create → skopiuj Secret value

Krok 2: Skonfiguruj Magento

Szczegóły konfiguracji modułu zawarte są w dokumentacji InPost Pay dla Magento Widget 2.0.

Zaloguj się do panelu administracyjnego Magento i przejdź do Sklepy > Konfiguracja
Wybierz sekcję Metody płatności
Wybierz InPost Pay > Ustawienia Analityki
Wypełnij dane:
- Włącz Analitykę – wybierz Tak
- Google Analytics Measurement ID – wpisz Measurement ID
- Google Analytics API Secret – wpisz Secret value
Kliknij Zapisz konfigurację.

Opcjonalnie: Asynchroniczne wysyłanie danych przez CRON

Pole Włącz Asynchroniczne Wysyłanie danych Analitycznych przez CRON — domyślnie wyłączone.
Po włączeniu dane nie będą wysyłane natychmiast, lecz co 5 minut (domyślnie).
W polu Harmonogram CRON Wysyłki Danych Analitycznych możesz ustawić częstotliwość wysyłania danych.

Uwaga — duplikacja zdarzeń GA4: Jeśli używasz modułu Magento z wbudowaną analityką GA4, NIE włączaj jednocześnie GA4 w integracji serwerowej (Cloud Function) — doprowadzi to do duplikacji zdarzeń purchase. W takim przypadku w Cloud Function włącz tylko Google Ads, Meta, TikTok i/lub Synerise.

InPost Pay - Analityka - Magento