Wymagania wstępne

Wymagania wstępne — WordPress WooCommerce + Google Tag Manager

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

• gclid (Google Ads),

• fbclid (Meta / Facebook 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'); if (gclid) { localStorage.setItem('gclid', gclid); } if (fbclid) { localStorage.setItem('fbclid', fbclid); } 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>

Uwaga: 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.

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('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ę.

Na tej stronie:

GA4

Konfiguracja integracji GA4 z WordPress WooCommerce i InPost Pay

Poniższa instrukcja pokazuje krok po kroku, jak skonfigurować wysyłkę zdarzeń zakupowych do Google Analytics 4 (GA4) z użyciem integracji backendowej opartej na Google Cloud Functions.

Krok 1: Pobierz dane z Google Analytics 4

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

   Open

   

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

   Open

   

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

   Open

   

4. Skopiuj i zapisz Measurement ID z okna streamu.
   Będzie on potrzebny później. Następnie wybierz Measurement Protocol API Secrets.
   
   

   Open

   

    

5. Kliknij przycisk Create
   
   

   Open

   

6. Wpisz nazwę i kliknij Create
   
   

   Open

   

7. Skopiuj i zapisz Secret value — będzie potrzebny przy wdrożeniu funkcji

   Open

   

    

Krok 2: Uzyskaj dane dostępu do API InPost Pay
Aby połączyć się z API InPost Pay i pobierać dane zakupowe, potrzebujesz dwóch wartości:

• client_id

• client_secret
  Informację jak uzyskać te wartości znajdziesz w dokumentacji InPost Pay.

Krok 3: Wdrożenie integracji w Google Cloud
Wymagania:

• Konto Google Cloud (GCP) z włączonym billingiem

• Zainstalowane narzędzie gcloud (Google Cloud SDK)

• Podstawowa znajomość terminala (cmd / bash)

• Python 3.11 (lokalnie)

• Folder z 3 plikami:

  • main.py

  • requirements.txt

  • deploy.sh

Możesz pobrać i rozpakować paczkę ręcznie przez przeglądarkę.

Open

1. Uruchom terminal i przejdź do folderu z plikami
   Przykład:

   cd ~/Pobrane/cloud-function-ga4

2. Nadaj uprawnienia do uruchomienia skryptu wdrażającego

   chmod +x deploy.sh

3. Uruchom skrypt wdrożeniowy

   ./deploy.sh

4. Skrypt poprosi Cię o dane wejściowe:

   1. ID Twojego projektu w Google Cloud (np. my-eu-project-123)

   2. Region (można nacisnąć Enter — domyślnie: europe-central2)

   3. client_id i client_secret z InPost Pay

   4. Measurement ID i API Secret z GA4

Skrypt:

• ustawi projekt GCP

• utworzy sekrety z podanymi danymi

• nada odpowiednie uprawnienia dla funkcji

• wdroży funkcję HTTP (Cloud Function Gen2)

• ustawi harmonogram automatycznego wywoływania funkcji co 30 minut

5. Sprawdź funkcję
   Po zakończeniu wdrożenia w terminalu zobaczysz komunikat:

Możesz też wejść do Google Cloud Console → Cloud Run functions → sprawdzić status funkcji inpost-ga4-integration.

6. Co dalej?
   Funkcja będzie teraz samodzielnie co 30 minut:

• łączyła się z API InPost Pay

• pobierała dane zakupowe

• wysyłała je jako zdarzenia purchase do GA4

Jeśli chcesz, możesz ręcznie uruchomić funkcję przez GCP, by przetestować działanie.

Jak pobrać gotowe pliki wdrożeniowe?

Możesz pobrać gotowe pliki z dokumentacji InPost Pay.

1. Kliknij poniżej i pobierz cloud-function-ga4.zip

Open

2. Prześlij paczkę na serwer, do chmury lub rozpakuj lokalnie.

Google Ads

Konfiguracja importu konwersji z GA4 do Google Ads (Woocommerce)

Aby śledzić konwersje pochodzące z integracji GA4 i wykorzystać je w Google Ads (np. do optymalizacji kampanii), należy połączyć konta oraz zaimportować zdarzenia zakupowe jako konwersje.

Poniżej instrukcja, jak to zrobić krok po kroku.

Krok 1: Połącz Google Analytics 4 z Google Ads

1. Zaloguj się do konta Google Analytics 4.

2. Przejdź do zakładki Administrator (Admin).

3. W kolumnie Usługa (Property) kliknij Połączenia z Google Ads (Google Ads Links).

4. Kliknij + aby dodać nowe połączenie.

5. Wybierz konto Google Ads, które chcesz połączyć.

6. Potwierdź i zakończ konfigurację.
   Połączone konto Google Ads będzie mogło pobierać dane o konwersjach z GA4.

Krok 2: Skonfiguruj import konwersji w Google Ads

1. Zaloguj się do połączonego konta Google Ads.

2. Przejdź do zakładki Narzędzia i ustawienia > Pomiar > Konwersje.

3. Kliknij Nowa konwersja > Importuj.

4. Wybierz Google Analytics 4: zdarzenia.

5. Wybierz usługę GA4, z którą wcześniej się połączyłeś.

6. Wybierz zdarzenia do zaimportowania, np. purchase.

7. Kliknij Importuj i kontynuuj.
   Po zaimportowaniu zdarzeń będą one widoczne w panelu Google Ads jako źródło konwersji GA4.

Krok 3: Upewnij się, że konwersje są raportowane

1. Przejdź do panelu Google Ads > Konwersje.

2. Sprawdź, czy wybrane zdarzenia są w statusie "Otrzymuje dane".

3. Po kilku godzinach powinny zacząć się pojawiać dane, jeśli integracja GA4 działa poprawnie.

Uwagi
GA4 nie wspiera już tzw. sesyjnych konwersji — konwersja przypisywana jest do użytkownika na podstawie modelu atrybucji wybranego w Google Ads.
Zdarzenia purchase muszą zawierać transaction_id — to zapewnia poprawną deduplikację.

Źródła i dokumentacja Google:

• Łączenie usług Analytics z kontami Google Ads

• Importowanie konwersji z Google Analytics 4 do Google Ads