InPost Pay - Analityka - Magento

InPost Pay - Analityka - Magento

 

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

  1. Przejdź do swojego kontenera GTM.

  2. Kliknij Dodaj nowy tag i nazwij go np. Zapisz ID do localStorage.

  3. Wybierz typ tagu: HTML niestandardowy.

  4. Wklej poniższy kod:

<script> function saveTrackingIdsToLocalStorage() { try { const params = new URLSearchParams(window.location.search); const gclid = params.get('gclid'); const fbclid = params.get('fbclid'); const ttclid = params.get('ttclid'); if (gclid) localStorage.setItem('gclid', gclid); if (fbclid) localStorage.setItem('fbclid', fbclid); if (ttclid) localStorage.setItem('ttclid', ttclid); if (typeof gtag === "function") { gtag('get', 'G-XXXXXXXXXX', 'client_id', function(clientId) { if (clientId) localStorage.setItem('client_id', clientId); }); } } catch (error) { console.error('Błąd przy zapisywaniu identyfikatorów do localStorage:', error); } } saveTrackingIdsToLocalStorage(); </script>

Zastąp G-XXXXXXXXXX swoim rzeczywistym Measurement ID z GA4 (np. G-ABC123DEF4).

Krok 2: Ustaw wyzwalacz

  1. Kliknij Wyzwalacze i wybierz All Pages (Wszystkie strony).

  2. Zapisz tag.

Krok 3: Przetestuj

  1. Wejdź na stronę z parametrami w URL, np. ?gclid=111&fbclid=222&ttclid=333.

  2. 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

  • Funkcja gtag('get', ...) działa tylko, jeśli GA4 jest już poprawnie załadowane na stronie.

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


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

  1. Przejdź do zakładki Admin w panelu GA4

  2. Wybierz Admin > Data collection and modification > Data streams

  3. Wybierz stream danych, do którego chcesz wysyłać zdarzenia zakupu

  4. Skopiuj i zapisz Measurement ID (format: G-XXXXXXXXXX)

  5. Następnie wybierz Measurement Protocol API SecretsCreate → skopiuj Secret value

Krok 2: Skonfiguruj Magento

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

  1. Zaloguj się do panelu administracyjnego Magento i przejdź do Sklepy > Konfiguracja

  2. Wybierz sekcję Metody płatności

  3. Wybierz InPost Pay > Ustawienia Analityki

  4. Wypełnij dane:

    • Włącz Analitykę – wybierz Tak

    • Google Analytics Measurement ID – wpisz Measurement ID

    • Google Analytics API Secret – wpisz Secret value

  5. 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.