LinkedIn Conversions API: konfiguracja i test

LinkedIn Conversions API przesyła zdarzenia z serwera lub CRM bezpośrednio do LinkedIn. Dzięki temu możesz mierzyć zakup zamknięty poza witryną, kwalifikację leada albo spotkanie zapisane w systemie sprzedażowym. Najbezpieczniejszy układ dla działań na stronie łączy kanał serwerowy z Insight Tagiem i deduplikuje dwie kopie tej samej konwersji przez wspólny eventId. Poniżej wybierzesz metodę wdrożenia, przejdziesz konfigurację Direct API i wykonasz test przed optymalizacją kampanii.

Kiedy LinkedIn Conversions API ma sens

Kanał serwerowy jest szczególnie użyteczny, gdy wynik biznesowy powstaje później niż formularz. Przykład: reklama prowadzi do pobrania materiału, handlowiec kwalifikuje kontakt po dwóch dniach, a sprzedaż zamyka się telefonicznie. Z CRM możesz wysłać zdarzenie qualified_lead albo purchase, zamiast kończyć ocenę na wysłaniu formularza.

Według oficjalnego opisu LinkedIn Conversions API rozwiązanie obsługuje dane online i offline, a wdrożenie prowadzi przez partnera technologicznego lub integrację bezpośrednią. LinkedIn podaje również, że przygotowanie integracji Direct API zajmuje przeciętnie od dwóch do czterech tygodni i wymaga późniejszego utrzymania przez dewelopera. Partner jest rozsądnym wyborem, gdy obsługuje twój CRM, właściwe zdarzenia i deduplikację. Direct API wybierz przy własnym backendzie, niestandardowych etapach lejka albo potrzebie pełnej kontroli nad mapowaniem.

Sytuacja	Metoda startowa	Warunek odbioru
CRM ma gotowe połączenie obsługujące wymagane etapy	Integracja partnerska	statusy sprzedażowe trafiają do właściwych reguł
Firma ma własny backend i zespół deweloperski	Direct API	logi potwierdzają wysyłkę i odpowiedź API
Mierzysz formularz na stronie oraz późniejszą kwalifikację	Insight Tag i Conversions API	każde zdarzenie ma jasno wskazane źródło i moment wywołania

Najpierw uporządkuj pomiar przeglądarkowy według instrukcji konfiguracji LinkedIn Insight Tag. Następnie dodaj etap z CRM, który handlowcy nadają według jednej zapisanej definicji. Wysyłanie niejednoznacznego statusu „dobry kontakt” dostarczy algorytmowi niespójny sygnał.

LinkedIn Conversions API krok po kroku

Przy Direct API zacznij w Campaign Managerze na właściwym koncie reklamowym. Panel i system źródłowy powinny być otwarte równocześnie, aby od razu zapisać identyfikatory oraz wykonać próbę.

1. Przejdź do Measure > Conversion tracking > Create conversion i wybierz Conversions API.
2. Nadaj regule nazwę opisującą etap i źródło, na przykład BOFU - qualified lead - CRM.
3. Wybierz kategorię zgodną ze zdarzeniem, ustaw wartość, okna po kliknięciu i wyświetleniu oraz model atrybucji.
4. Wybierz Direct API, sprawdź automatycznie przypisane zestawy reklam i usuń te, które nie powinny korzystać z reguły.
5. Otwórz Measure > Signals manager > Sources > Direct API, kliknij Generate access token i przekaż token deweloperowi bezpiecznym kanałem. LinkedIn informuje, że nie przechowuje wygenerowanego tokenu, więc zapisz go w menedżerze sekretów, poza kodem strony i repozytorium.
6. Zmapuj identyfikator reguły, nazwę zdarzenia, czas wystąpienia, wartość, walutę oraz dozwolone identyfikatory użytkownika. Przed produkcyjną wysyłką sprawdź strukturę danych w udostępnionym przez LinkedIn narzędziu do budowania payloadu.
7. Wyślij zdarzenia testowe, wróć do Measure > Conversion tracking i sprawdź status reguły. Status Unverified przy oczekiwanym ruchu oznacza, że trzeba skontrolować połączenie i wysyłkę.

Token daje dostęp do integracji, dlatego nie wklejaj go do menedżera tagów ani arkusza kampanii. Zakres przekazywanych danych i podstawę prawną uzgodnij z osobą odpowiedzialną za prywatność. Kanał serwerowy nie znosi obowiązków związanych ze zgodami.

Deduplikacja Insight Tag i danych z serwera

Jeżeli jedna konwersja trafia przez Insight Tag i Conversions API, oba kanały muszą przekazać ten sam eventId. LinkedIn porównuje zdarzenia z tego samego konta. Gdy rozpozna kopię przeglądarkową oraz serwerową ze wspólnym identyfikatorem, odrzuca zdarzenie z Conversions API i pozostawia w raportowaniu zdarzenie z tagu. Konwersja jest wtedy liczona raz.

Wygeneruj identyfikator w systemie, który zna wynik działania. Dla leada 58421 może to być qualified_58421_v1. Ten sam ciąg przekaż do zdarzenia przeglądarkowego i serwerowego, jeśli oba opisują dokładnie tę samą kwalifikację. Dwie różne czynności, na przykład wysłanie formularza i późniejsze zaakceptowanie leada, powinny pozostać osobnymi zdarzeniami.

Logika przypomina rozwiązania innych platform, ale nazwy pól i panel są właściwe dla LinkedIn. Przydatnym punktem kontrolnym będzie test deduplikacji w TikTok Events API, z którego warto przenieść samą zasadę wspólnego identyfikatora, a nie gotowy kod integracji.

Test trzech zdarzeń i jakość sygnału

Przed przypięciem konwersji do aktywnej optymalizacji utwórz trzy hipotetyczne rekordy testowe: lead zakwalifikowany, lead odrzucony i sprzedaż o wartości 6000 zł. Do LinkedIn powinny trafić tylko dwa zdarzenia biznesowe, jeśli odrzucony lead nie jest zdefiniowaną konwersją.

Rekord w CRM	Oczekiwane zdarzenie	Wartość	Wynik testu
lead 58421, zakwalifikowany	qualified_lead	według reguły konta	1 odebrane zdarzenie
lead 58422, odrzucony	brak	0 zł	brak zdarzenia
transakcja 58423, zamknięta	purchase	6000 zł	1 odebrane zdarzenie

Reguła odbioru: nie optymalizuj zestawu reklam pod dane z CRM, dopóki trzy kolejne serie testowe nie dają identycznego wyniku w systemie źródłowym i regułach LinkedIn. Sprawdź identyfikator zdarzenia, czas, kategorię, wartość i walutę. Ten próg jest procedurą operacyjną, a nie benchmarkiem platformy.

LinkedIn ocenia także jakość dopasowania zdarzeń Direct API do profili. W maju 2026 r. platforma dodała IPv4 i Google Advertising ID jako uzupełniające identyfikatory. Instrukcja jakości sygnału LinkedIn zaleca przekazywanie możliwie wielu właściwych parametrów, stabilny wolumen oraz używanie adresu e-mail dla zdarzeń leadowych. Tylko dopasowane zdarzenia mogą służyć atrybucji i optymalizacji.

Po wdrożeniu raz w tygodniu porównuj liczbę statusów w CRM z liczbą zdarzeń odebranych przez regułę. Jeśli CRM ma 40 kwalifikowanych leadów, a LinkedIn odebrał 30, pokrycie wynosi 30 ÷ 40 × 100% = 75%. Ustal alarm przy spadku o 10 punktów procentowych tydzień do tygodnia i wtedy sprawdź logi, token, mapowanie oraz ocenę dopasowania. Próg 10 punktów jest twoją regułą diagnostyczną.

Jak wykorzystać sygnał bez błędnej oceny kampanii

Zdarzenie odebrane przez LinkedIn nie musi zostać przypisane reklamie. Raport kampanii uwzględnia między innymi wybrane okno i model atrybucji, dlatego liczba konwersji reklamowych może być niższa od całego wolumenu wysłanego z CRM. Porównuj oba zbiory osobno.

Dla kampanii leadowej oceniaj koszt kwalifikowanego leada i koszt sprzedaży. Metodę liczenia znajdziesz w analizie jakości leadów na podstawie etapów CRM. Jeśli 20 zgłoszeń kosztowało 4000 zł, a osiem przeszło kwalifikację, CPL wynosi 200 zł, natomiast koszt kwalifikowanego leada 500 zł. Druga liczba lepiej opisuje wartość sygnału przekazanego przez Conversions API.

Przez pierwsze dwa tygodnie po uruchomieniu nie zmieniaj jednocześnie mapowania zdarzeń, okna atrybucji i optymalizacji kampanii. Zapisuj datę każdej modyfikacji. Gdy poprawisz jakość przesyłanych danych, dopiero wtedy porównaj kampanię z wynikiem firmy i zastosuj zasady oceny atrybucji na danych biznesowych. Stabilny sygnał pozwala odróżnić problem integracji od realnej zmiany skuteczności reklam.