InPost Pay - Analityka

Instrukcja dla integracji bezpośredniej (custom backend)

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 — 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": "..." },
  { "key": "ttclid",    "value": "..." }
]

Klucz	Opis	Źródło

Klucz	Opis	Źródło
`client_id`	GA4 Client ID — wymagany dla GA4	Cookie `_ga` lub `gtag('get', ...)`
`gclid`	Google Click ID — wymagany dla Google Ads	URL param `?gclid=...`
`fbclid`	Facebook Click ID — dla Meta CAPI	URL param `?fbclid=...`
`ttclid`	TikTok Click ID — dla TikTok Events API	URL param `?ttclid=...`

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

Wartości są opcjonalne — jeśli dany identyfikator nie jest dostępny, po prostu pomiń odpowiedni klucz.

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 — Integracja bezpośrednia
2 Dodatkowe wymagania — client_id przy dodawaniu i aktualizacji koszyka