Wymagania wstępne

Wymagania wstępne — Integracja bezpośrednia

W przypadku integracji bezpośredniej, poniższe dane powinny być przesyłane zgodnie z dokumentacją API dostępną pod adresem:

Na potrzeby analityki, wymagane jest przekazywanie następujących parametrów w strukturze order_additional_parameters:

"order_additional_parameters": [
  {
    "key": "client_id",
    "value": "..."
  },
  {
    "key": "fbclid",
    "value": "..."
  },
  {
    "key": "gclid",
    "value": "..."
  }
]

Parametry te muszą być dostarczone przez frontend i przypisane do użytkownika składającego zamówienie.

Dodatkowe wymagania — client_id przy dodawaniu i aktualizacji koszyka

W przypadku integracji bezpośredniej wymaga się, aby client_id z ciasteczka Google Analytics 4 był przesyłany również przy:

dodawaniu produktu do koszyka,
aktualizacji koszyka (np. zmiana ilości, usunięcie).

Dane te powinny być przekazywane do API InPost Pay jako element order_additional_parameters:

"order_additional_parameters": [
  {
    "key": "client_id",
    "value": "GA1.2.1234567890.1234567890"
  }
]

Zalecane źródło: odczyt client_id z ciasteczka _ga lub przez gtag('get', ..., 'client_id', callback) po stronie frontendu.

Brak przekazania client_id na tym etapie może uniemożliwić prawidłowe przypisanie sesji i konwersji w analityce GA4 oraz Google Ads.

Na tej stronie:

1 Wymagania wstępne
- 1.1 Wymagania wstępne — Integracja bezpośrednia
- 1.2 Dodatkowe wymagania — client_id przy dodawaniu i aktualizacji koszyka
2 GA4
- 2.1 Konfiguracja integracji GA4 z InPost Pay
3 Google Ads
- 3.1 Konfiguracja importu konwersji z GA4 do Google Ads

GA4

Konfiguracja integracji GA4 z 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

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 z okna streamu.
Będzie on potrzebny później. Następnie wybierz Measurement Protocol API Secrets.
Kliknij przycisk Create
Wpisz nazwę i kliknij Create
Skopiuj i zapisz Secret value — będzie potrzebny przy wdrożeniu funkcji

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

Uruchom terminal i przejdź do folderu z plikami
Przykład:
cd ~/Pobrane/cloud-function-ga4
Nadaj uprawnienia do uruchomienia skryptu wdrażającego
chmod +x deploy.sh
Uruchom skrypt wdrożeniowy
./deploy.sh
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

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

Funkcja została wdrożona i harmonogram uruchamiania został ustawiony.

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

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.

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

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

Google Ads

Konfiguracja importu konwersji z GA4 do Google Ads

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

Zaloguj się do konta Google Analytics 4.
Przejdź do zakładki Administrator (Admin).
W kolumnie Usługa (Property) kliknij Połączenia z Google Ads (Google Ads Links).
Kliknij + aby dodać nowe połączenie.
Wybierz konto Google Ads, które chcesz połączyć.
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

Zaloguj się do połączonego konta Google Ads.
Przejdź do zakładki Narzędzia i ustawienia > Pomiar > Konwersje.
Kliknij Nowa konwersja > Importuj.
Wybierz Google Analytics 4: zdarzenia.
Wybierz usługę GA4, z którą wcześniej się połączyłeś.
Wybierz zdarzenia do zaimportowania, np. purchase.
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

Przejdź do panelu Google Ads > Konwersje.
Sprawdź, czy wybrane zdarzenia są w statusie "Otrzymuje dane".
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:

InPost Pay - Analityka

Wymagania wstępne