Meta Conversions API przez server-side GTM: konfiguracja krok po kroku

Jak działa Conversions API przez GTM w wersji serwerowej

W server-side tagging przeglądarka nie wysyła danych bezpośrednio do każdej platformy, tylko do Twojego serwera. Serwer decyduje, które dane i w jakiej postaci przekazać dalej. Dla Meta oznacza to, że Conversions API otrzymuje zdarzenia z kontenera serwerowego, a piksel nadal raportuje je z przeglądarki.

Przepływ jednego zakupu wygląda następująco:

1. Sklep wypycha do warstwy danych zdarzenie purchase z numerem zamówienia, wartością i produktami.
2. Kontener web odpala tag piksela Meta z eventID oraz tag GA4, który wysyła zdarzenie do kontenera serwerowego.
3. Klient GA4 w kontenerze serwerowym odbiera żądanie i zamienia je na dane zdarzenia.
4. Tag Meta Conversions API odczytuje dane zdarzenia, pliki cookie _fbp i _fbc, adres IP oraz user agent i wysyła zdarzenie do Meta.
5. Meta deduplikuje zdarzenie z przeglądarki i z serwera na podstawie nazwy i event_id.

Jeśli nie masz jeszcze kontenera serwerowego, zacznij od poradnika server-side tagging w praktyce. Wybór infrastruktury i jej koszty porównujemy w tekście o hostingu server-side GTM.

Co przygotować przed konfiguracją

Zanim zaczniesz, zbierz wszystkie elementy w jednym miejscu. Brak któregokolwiek z nich zatrzyma konfigurację w połowie.

Subdomena musi należeć do tej samej domeny co sklep. Tylko wtedy przeglądarka dołączy do żądania pliki cookie _fbp i _fbc, zapisane przez piksel na poziomie domeny głównej, a tag w kontenerze serwerowym będzie mógł je odczytać.

Konfiguracja kontenera web: zdarzenia, event_id i dane klienta

Kontener web ma dwa zadania: wysłać do serwera komplet danych o zdarzeniu i zadbać, by piksel używał tego samego identyfikatora. W tagu Google ustaw parametr server_container_url na adres Twojej subdomeny, np. https://sgtm.twojsklep.pl, a następnie skonfiguruj tagi zdarzeń GA4.

Tag: GA4 – purchase
Typ: Zdarzenie Google Analytics
Identyfikator pomiaru: G-XXXXXXX
Nazwa zdarzenia: purchase
Parametry zdarzenia:
  event_id      {{DL - event_id}}
  value         {{DL - ecommerce.value}}
  currency      {{DL - ecommerce.currency}}
  items         {{DL - ecommerce.items}}
Reguła: CE - purchase
Kontrole zgody: wbudowane

Tag: Meta Pixel – Purchase
Typ: szablon piksela Meta lub Custom HTML
eventID: {{DL - event_id}}
Kontrole zgody: wymagaj dodatkowej zgody: ad_storage
Reguła: CE - purchase

Ta sama zmienna {{DL - event_id}} w obu tagach to warunek poprawnej deduplikacji. Jak generować identyfikatory dla zdarzeń bez numeru z backendu, pokazujemy w artykule o deduplikacji zdarzeń piksela i Conversions API.

Dane klienta, takie jak e-mail i telefon z formularza zamówienia, możesz przekazać w obiekcie danych użytkownika w tagu Google albo jako parametry zdarzenia. Przed konfiguracją tagu Meta otwórz podgląd kontenera serwerowego i sprawdź, pod jakimi kluczami pojawiają się w danych zdarzenia. Od kompletności tych danych zależy jakość dopasowania, którą opisujemy w poradniku o Event Match Quality.

Konfiguracja kontenera serwerowego krok po kroku

W kontenerze serwerowym korzystasz z oficjalnego szablonu tagu Conversions API publikowanego przez Meta w galerii szablonów. Wszystkie kroki wykonujesz w jednym obszarze roboczym, a publikujesz dopiero po testach.

1. Sprawdź klienta GA4. Domyślny klient GA4 powinien przejmować żądania kierowane do ścieżki /g/collect.
2. Dodaj szablon. W sekcji szablonów tagów wyszukaj w galerii szablon Conversions API od Meta i dodaj go do obszaru roboczego.
3. Utwórz zmienne. Zapisz identyfikator piksela i token dostępu jako zmienne typu stała, a parametr gcs jako zmienną typu Query Parameter.
4. Skonfiguruj tag. Podaj identyfikator piksela, token dostępu, kod zdarzeń testowych i źródło akcji website.
5. Utwórz regułę. Warunki: nazwa klienta równa się GA4, nazwa zdarzenia pasuje do wyrażenia ^(page_view|view_item|add_to_cart|begin_checkout|purchase|generate_lead)$, a gcs pasuje do ^G11.
6. Sprawdź mapowanie nazw. Szablon zamienia standardowe nazwy zdarzeń GA4 na zdarzenia standardowe Meta. Dla zdarzeń o własnych nazwach sprawdź w dokumentacji szablonu, jak ustawić nazwę zdarzenia Meta.
7. Uruchom podgląd. Złóż testowe zamówienie i w szczegółach tagu sprawdź wychodzące żądanie HTTP do Meta oraz kod odpowiedzi.
8. Sprawdź narzędzie testowania zdarzeń. Zdarzenie serwerowe powinno pojawić się obok zdarzenia z przeglądarki z tym samym identyfikatorem.
9. Usuń kod testowy i opublikuj najpierw kontener serwerowy, potem web.

Typowe mapowanie zdarzeń wygląda tak:

Sklepy, które chcą optymalizować kampanie pod zysk, a nie pod przychód, mogą w kontenerze serwerowym podmienić lub uzupełnić wartość zdarzenia o marżę z własnej bazy. Taki scenariusz opisujemy w artykule o wzbogacaniu zdarzeń po stronie serwera.

event_id, fbp i fbc w kontenerze serwerowym

Plik _fbp zapisuje piksel przy pierwszej wizycie i zawiera identyfikator przeglądarki. Plik _fbc powstaje, gdy użytkownik trafia na stronę z reklamy z parametrem fbclid w adresie. Oba trafiają do tagu w kontenerze serwerowym, o ile żądanie idzie na subdomenę w tej samej domenie.

Jeśli pliku _fbc brakuje, a adres strony docelowej zawiera fbclid, wartość fbc można zbudować samodzielnie. Format to fb.1., znacznik czasu w milisekundach i identyfikator kliknięcia:

// Wywołuj tylko na stronie docelowej z fbclid, a wynik zapisz i używaj dalej
function zbudujFbc(adres) {
  var fbclid = new URL(adres).searchParams.get('fbclid');
  return fbclid ? 'fb.1.' + Date.now() + '.' + fbclid : undefined;
}

Nie generuj fbc od nowa na każdej podstronie, bo zmieniający się znacznik czasu zaburza dopasowanie. Część przeglądarek ogranicza ważność plików cookie zapisywanych przez skrypty, a Safari 26 w określonych kontekstach usuwa z adresów znane parametry śledzące, w tym fbclid. Co to oznacza dla pomiaru, wyjaśniamy w tekście o Safari 26 i identyfikatorach kliknięć.

Zwróć też uwagę na adres IP. Jeśli kontener serwerowy działa za load balancerem lub CDN, upewnij się, że klient GA4 odczytuje adres użytkownika, a nie adres pośrednika. Błędny IP obniża jakość dopasowania wszystkich zdarzeń jednocześnie.

Zgody i dane osobowe w kontenerze serwerowym

Tag Meta w kontenerze serwerowym nie widzi banera, więc decyzję użytkownika musi dostać razem z żądaniem. Najprostszy sposób to warunek w regule oparty na parametrze gcs: wartość zaczynająca się od G11 oznacza zgodę na ad_storage. Jak sprawdzić, że parametr dociera poprawnie, pokazujemy w poradniku o teście Consent Mode z parametrami gcs i gcd, a pełną konfigurację zgód w kontenerze web – w checkliście Consent Mode v2.

Dane osobowe w kontenerze serwerowym wymagają dodatkowej dyscypliny:

• e-mail i telefon wysyłaj do Meta wyłącznie w postaci zahaszowanej SHA-256 po normalizacji; sprawdź w opisie wersji szablonu, czy haszuje dane automatycznie,
• nie zapisuj pełnych danych zdarzeń w logach serwera, bo logi zawierają wtedy dane osobowe klientów,
• przekazuj tylko te parametry, których Meta potrzebuje do pomiaru i dopasowania,
• opisz przekazywanie danych do Meta w polityce prywatności i skonsultuj podstawę prawną z prawnikiem.

Testowanie, monitoring i najczęstsze błędy

Po publikacji obserwuj zbiór danych w Menedżerze zdarzeń przez co najmniej tydzień. Przy kluczowych zdarzeniach powinny być widoczne oba źródła, przeglądarka i serwer, a karta diagnostyki nie powinna zgłaszać problemów z deduplikacją ani z parametrami.

Najczęstsze błędy w tej konfiguracji to:

• nieważny token dostępu – tag zwraca błąd autoryzacji, a w Menedżerze zdarzeń nie ma zdarzeń serwerowych,
• kod testowy zostawiony w produkcji – narzędzie testowe zapełnia się ruchem produkcyjnym i kolejne testy stają się nieczytelne,
• subdomena w innej domenie – brak fbp i fbc w zdarzeniach serwerowych,
• podwójna integracja – wtyczka sklepu i kontener serwerowy wysyłają Conversions API równolegle,
• brak warunku zgody – zdarzenia serwerowe wysyłane także dla użytkowników, którzy odmówili.

Jeśli prowadzisz kampanie leadowe, ten sam kontener możesz wykorzystać do wysyłania zdarzeń z CRM o zakwalifikowanych leadach; szczegóły znajdziesz w tekście o kampaniach leadowych w Meta Ads. Kompletne i wiarygodne sygnały konwersji mają też znaczenie dla systemu dobierania reklam, co opisujemy w artykule o Meta Ads po Andromedzie. Ten sam kontener obsłuży również TikTok Events API, a pozostałe poradniki o pikselach i API konwersji znajdziesz w podtemacie Meta Pixel i Conversions API. Ustawienia kontenerów opisujemy na stronie Google Tag Manager.