Server-side tracking: jak poprawnie skonfigurować Meta CAPI i LinkedIn CAPI

Dlaczego server-side tracking jest niezbędny dla Meta i LinkedIn

Piksel w przeglądarce gubi zdarzenia, zanim dotrą do platformy. Adblockery blokują skrypt, ochrona przed śledzeniem w przeglądarce skraca czas życia plików cookie, a tego, co dzieje się w CRM po kliknięciu, piksel w ogóle nie widzi. Zdarzenie serwerowe pochodzi natomiast z backendu Twojego sklepu, z obsługi formularzy albo z Twojego CRM. Dzięki temu możesz zgłaszać także konwersje offline, na przykład kwalifikowanego leada po rozmowie handlowej. API konwersji LinkedIn, wprowadzone w październiku 2023 roku, łączy konwersje online i offline bezpośrednio z LinkedIn (changelog API LinkedIn 2023).

Meta i LinkedIn zalecają redundantną konfigurację: piksel lub Insight Tag w przeglądarce, a do tego API konwersji na serwerze, z tymi samymi zdarzeniami wysyłanymi obiema drogami (Meta, LinkedIn). Aby konwersja nie została policzona podwójnie, zdarzenie z przeglądarki i zdarzenie z serwera mają ten sam identyfikator. Ta deduplikacja jest sednem każdej poprawnej konfiguracji.

Śledzenie po stronie serwera zmienia wyłącznie drogę przesyłania danych. Obowiązek uzyskania zgody pozostaje, więcej na ten temat w sekcji o zgodzie.

Szerszy kontekst znajdziesz w artykule filarowym Social Media Analytics, KPIs & Measurement. Powiązane decyzje omawiają szerzej Share of Search: najtańszy wskaźnik wyprzedzający udziału w rynku, Wskaźnik zgód i prawo dotyczące śledzenia: ile danych naprawdę traci region DACH (Niemcy, Austria, Szwajcaria) oraz Testy inkrementalności: testy geo-lift zamiast ROAS z platform.

Dane i źródła dotyczące Meta CAPI i LinkedIn CAPI

Chatterbuzz, Meta CAPI Guide, 2025, globalnie: koszty: CAPI Gateway od 10 do ponad 400 USD miesięcznie w zależności od wolumenu zdarzeń, Server-Side GTM od 10 do 50 USD miesięcznie za hosting, bezpośrednia integracja z API od 500 do ponad 5000 USD jednorazowo za prace programistyczne.

AdExchanger, 19 lutego 2025, globalnie: raport AdExchanger przedstawia API konwersji LinkedIn jako nowość i informuje, że LinkedIn wydłuża okno retrospektywne swojego Revenue Attribution Report ze 180 do 365 dni. Nie był to jednak start CAPI: według własnego changelogu API LinkedIn wprowadził je w październiku 2023 roku. Jae Oh (Head of Ads Measurement, LinkedIn) mówi o okresie wcześniejszym: „we weren't capturing all those [conversion] events”.

Jako wczesne wyniki reklamodawców korzystających z LinkedIn CAPI AdExchanger podaje o 31% więcej konwersji przypisywanych LinkedIn, o 20% niższy cost per action i o 39% niższy koszt kwalifikowanego leada. Raport nie podaje metodyki. Sam LinkedIn szacuje średni wzrost przypisanych konwersji na 31% i opiera się przy tym na projekcie pilotażowym (LinkedIn). Wartości te opisują wczesne konta testowe, a nie średnią rynkową.

API konwersji LinkedIn, oficjalna dokumentacja, 2026, globalnie: współczynnik dopasowania rośnie, gdy wysyłasz kilka identyfikatorów, na przykład zahaszowany adres e-mail i identyfikator kliknięcia li_fat_id (LinkedIn). Insight Tag i CAPI są deduplikowane na podstawie tego samego eventId (LinkedIn). Od maja 2025 roku dla wybranych typów konwersji, takich jak Lead, Qualified Lead czy Purchase, można ustawić okno atrybucji do 365 dni (changelog LinkedIn).

Stape, studium przypadku Hide and Seek, 2025, Niderlandy: holenderska agencja Hide and Seek podłączyła dla swoich klientów API konwersji Meta przez kontener Server-Side GTM, a następnie odnotowała o 15–30% więcej danych rejestrowanych w Meta Events Manager (Stape). Studium przypadku nie podaje liczby kont, okresu ani punktu odniesienia.

Agencja Chatterbuzz na podstawie własnych wdrożeń CAPI w kilkudziesięciu kontach paid media raportuje o 15–20% lepszy ROAS po zoptymalizowaniu Event Match Quality. To deklaracja dostawcy bez niezależnej weryfikacji, a nie zmierzony efekt przyczynowy. Jako rząd wielkości wartość ta nadaje się do wyliczenia business case'u, jako wartość docelowa już nie.

Wybór wariantu: Gateway, Server-Side GTM czy bezpośrednie API

Dla Meta istnieją trzy popularne sposoby. Koszty pochodzą z przewodnika po Meta CAPI agencji Chatterbuzz i są wartościami orientacyjnymi, a nie ofertami.

Gateway działa na koncie chmurowym Twojej firmy w AWS lub Google Cloud i po zatwierdzeniu aktualizuje się samodzielnie (Meta). Server-Side GTM korzysta z tego samego modelu tagów, reguł i zmiennych co kontener internetowy i działa w Google Cloud lub na wybranej przez Ciebie platformie (Google). LinkedIn CAPI podłączasz przez integrację partnerską albo bezpośrednio przez API. Przy bezpośredniej integracji generujesz token dostępu w Campaign Manager w sekcji Data, Signals Manager, Direct API. Własna Developer App nie jest do tego potrzebna (LinkedIn).

Konfiguracja krok po kroku

1. Określ zdarzenia: wybierz kilka zdarzeń, pod które optymalizują się Twoje kampanie, na przykład Lead, Purchase lub kwalifikowany lead z CRM. Dla każdego zdarzenia ustal, czy będzie przesyłane przez przeglądarkę, serwer czy obiema drogami oraz kto odpowiada za nie technicznie.

2. Deduplikacja w Meta: wysyłaj każde zdarzenie w pikselu z eventID, a na serwerze z tą samą wartością w polu event_id, do tego z identycznym event_name. Meta odrzuci wtedy duplikat, jeśli oba zdarzenia dotrą w ciągu 48 godzin (Meta). Zdarzenia serwerowe mogą mieć najwyżej siedem dni. Jeśli którekolwiek zdarzenie w paczce jest starsze, Meta odrzuca całe żądanie. Wyjątkiem są zakupy offline w sklepie stacjonarnym (action_source physical_store), które można zgłaszać z opóźnieniem do 62 dni (Meta).

3. Przekaż identyfikatory Meta: przekazuj parametry fbp i fbc bez zmian, czyli wartości plików cookie _fbp i _fbc, a do tego adres IP i user agent. Adresy e-mail normalizujesz (usuwasz spacje, zamieniasz na małe litery), a numery telefonów zapisujesz z kierunkowym kraju, bez wiodącego zera i bez znaków specjalnych: z 0664 123456 powstaje więc 43664123456. Obie te wartości haszujesz algorytmem SHA-256 (Meta). Jak dobrze działa dopasowanie, Meta pokazuje w Events Manager dla każdego zdarzenia serwerowego z witryny jako Event Match Quality w skali od 0 do 10 (Meta).

4. Połącz LinkedIn: włącz Enhanced Conversion Tracking w Insight Tag w Campaign Manager. LinkedIn dołącza wtedy przy każdym kliknięciu reklamy identyfikator kliknięcia li_fat_id do adresu URL strony docelowej. Odczytaj go z adresu URL lub z pliku cookie i przekaż jako ukryte pole formularza (LinkedIn). Dla każdej konwersji utwórz jedną regułę dla przeglądarki i jedną dla serwera, a w obu przekazuj ten sam eventId. W przypadku duplikatów LinkedIn liczy zdarzenie z Insight Tag i odrzuca zdarzenie z CAPI (LinkedIn).

5. Wyślij zdarzenia do LinkedIn: przesyłaj li_fat_id jako LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID, a zahaszowany adres e-mail jako SHA256_EMAIL. Konwersja nie może być starsza niż 90 dni (LinkedIn).

6. Testuj: w Meta generujesz w Events Manager w sekcji Test Events kod testowy i wysyłasz go jako test_event_code. Zdarzenia serwerowe pojawiają się wtedy w oknie testowym. Usuń kod przed uruchomieniem produkcyjnym (Meta). W LinkedIn sprawdzasz w podziale konwersji w Campaign Manager, czy konwersja z Insight Tag i konwersja z CAPI pojawiają się osobno.

Zgoda: czego server-side tracking nie rozwiązuje

Pliki cookie _fbp, _fbc i li_fat_id są zapisywane w przeglądarce Twoich użytkowników. W Niemczech zapisywanie lub odczytywanie tam informacji jest zgodnie z § 25 TDDDG dozwolone tylko za zgodą, chyba że jest to bezwzględnie niezbędne do świadczenia usługi, o którą użytkownik wyraźnie poprosił. W Austrii § 165 Abs. 3 TKG 2021 również wymaga aktywnej zgody wyrażonej na podstawie jasnych informacji. Śledzenie konwersji na potrzeby platform reklamowych z reguły nie jest bezwzględnie niezbędne do usługi, z której chcą korzystać Twoi użytkownicy. Nie zmienia tego fakt, że zdarzenie trafia potem do platformy z serwera, a nie z przeglądarki.

Także zahaszowane adresy e-mail służą właśnie do przypisania zdarzenia do konkretnej osoby. Wysyłaj je tylko wtedy, gdy ta osoba wyraziła zgodę. Technicznie oznacza to: przekazuj status zgody z banera aż do kontenera serwerowego lub backendu i wysyłaj tylko zdarzenia objęte zgodą. Dla szwajcarskich stron internetowych obowiązują odrębne przepisy, które warto sprawdzić osobno.

Typowe błędy

• Brak wspólnego identyfikatora zdarzenia: piksel i serwer zgłaszają tę samą konwersję, platforma często nie rozpoznaje duplikatu i konwersja liczy się podwójnie.
• Różne nazwy zdarzeń: w Meta event_name musi być identyczny w przeglądarce i na serwerze, w przeciwnym razie deduplikacja nie działa.
• Zdarzenia serwerowe bez sprawdzania zgody: serwer wysyła zdarzenia także dla użytkowników, którzy odrzucili zgodę w banerze.
• Błędnie zahaszowane identyfikatory: e-mail bez normalizacji, numer telefonu bez kierunkowego kraju lub z wiodącym zerem, fbp i fbc zahaszowane, mimo że Meta oczekuje ich w niezmienionej postaci. Event Match Quality pozostaje niska.
• Spóźnione zdarzenia: Meta odrzuca zdarzenia starsze niż siedem dni, z wyjątkiem zakupów w sklepie stacjonarnym z action_source physical_store, dla których limit wynosi 62 dni. LinkedIn odrzuca konwersje starsze niż 90 dni. Dlatego w przypadku zdarzeń online i z CRM comiesięczny eksport nie wystarczy.
• Kod testowy w środowisku produkcyjnym: test_event_code pozostaje w payloadzie po zakończeniu testów, choć Meta przewiduje go wyłącznie do testowania.
• Kontener bez monitoringu: gdy kontener serwerowy lub Gateway przestanie działać, brakuje zdarzeń serwerowych, a nikt tego nie zauważa.

Pomiar i bieżąca kontrola

Śledzenie po stronie serwera rzadko zawodzi z powodu narzędzia, częściej z powodu niejasnego podziału odpowiedzialności i braku kontroli po uruchomieniu. Te cztery obszary kontroli powinny znaleźć się w każdym przeglądzie.

Porównaj konwersje w Events Manager i Campaign Manager przed zmianą i po niej z danymi ze sklepu lub CRM. Więcej zgłoszonych konwersji nie oznacza jeszcze większego przychodu. Czy kampanie rzeczywiście działają lepiej, pokaże tylko test z grupą kontrolną, na przykład test geo-lift.

Licząc koszty, uwzględnij oprócz hostingu i licencji także wdrożenie, utrzymanie, integrację zgód i monitoring. Podane wyżej wartości Chatterbuzz obejmują tylko hosting i prace programistyczne.