Conversions API (API konwersji Meta) – co to jest i jak je wdrożyć

Krótka odpowiedź

Conversions API, w polskim Menedżerze zdarzeń nazywane API konwersji, to sposób przesyłania zdarzeń, np. zakupów i formularzy, do Meta bezpośrednio z serwera, a nie tylko z przeglądarki. Działa razem z pikselem i uzupełnia dane, które piksel gubi przez blokery reklam i ograniczenia przeglądarek. Najważniejsze przy wdrożeniu są trzy rzeczy:

• deduplikacja zdarzeń,
• przesyłanie danych pozwalających dopasować zdarzenie do użytkownika,
• poszanowanie zgód cookies.

Dlaczego sam piksel już nie wystarcza

Piksel Meta to kod JavaScript, który działa w przeglądarce użytkownika. Kiedy ktoś kupuje w Twoim sklepie, piksel wysyła informację o zakupie do Meta. Problem w tym, że przeglądarka nie zawsze na to pozwala:

• blokery reklam często blokują piksel całkowicie,
• część przeglądarek ogranicza śledzenie i skraca życie plików cookies,
• osoba może zamknąć stronę, zanim piksel zdąży wysłać zdarzenie,
• błędy w kodzie strony potrafią zatrzymać piksel bez żadnego komunikatu.

Każde zgubione zdarzenie to mniej danych dla algorytmu. Meta uczy się na konwersjach, więc jeśli widzi tylko część zakupów, gorzej dobiera odbiorców, a raporty w Menedżerze reklam zaniżają wyniki.

Jak działa Conversions API

API konwersji wysyła te same zdarzenia drugą drogą: z serwera Twojej strony albo sklepu bezpośrednio do Meta. Serwer nie zależy od przeglądarki użytkownika, więc blokery reklam go nie zatrzymują.

Meta zaleca korzystanie z obu rozwiązań jednocześnie. Piksel i API konwersji wysyłają to samo zdarzenie, a Meta łączy je w jedno. Dzięki temu, jeśli jedna droga zawiedzie, zdarzenie wciąż dotrze drugą.

Deduplikacja: najważniejszy szczegół wdrożenia

Skoro ten sam zakup przychodzi dwa razy, z piksela i z serwera, Meta musi wiedzieć, że to jedno zdarzenie. Do tego służy deduplikacja. Oba zdarzenia muszą mieć:

• tę samą nazwę, np. Purchase,
• ten sam identyfikator zdarzenia (event_id w API konwersji i eventID w pikselu).

Meta łączy takie pary, jeśli dotrą w ciągu 48 godzin. Brak wspólnego identyfikatora to najczęstszy błąd, jaki widzę: każdy zakup liczy się wtedy dwa razy, a wyniki kampanii wyglądają lepiej, niż są naprawdę.

Jakie dane przesyłać

Każde zdarzenie wysyłane przez API konwersji powinno zawierać podstawowe informacje:

• nazwę zdarzenia, czas zdarzenia i jego identyfikator,
• źródło zdarzenia (action_source, dla strony internetowej website) i adres strony, na której do niego doszło,
• przy zakupie wartość i walutę, np. PLN.

Do tego dochodzą dane, które pozwalają Meta dopasować zdarzenie do konkretnego użytkownika: adres IP i informacja o przeglądarce (user agent), identyfikatory z plików cookies Meta, czyli fbp oraz fbc, jeśli użytkownik kliknął w reklamę, a także adres e-mail i numer telefonu, jeśli je znasz, np. z formularza zamówienia.

E-mail i telefon przed wysłaniem muszą zostać zahaszowane algorytmem SHA-256. Meta nie dostaje ich wtedy w czytelnej postaci, tylko jako zaszyfrowany ciąg znaków.

To, jak dobrze Meta dopasowuje zdarzenia, widać w Menedżerze zdarzeń jako „Jakość dopasowania zdarzeń”, w skali od 0 do 10. Im więcej poprawnych danych przesyłasz, tym wyższa ocena i tym lepiej algorytm wie, kto naprawdę kupuje.

Cztery sposoby wdrożenia

• Gotowa integracja platformy sklepowej. Wiele platform, np. Shopify i WooCommerce, ma oficjalne integracje z Meta, które uruchamiają API konwersji po kilku kliknięciach. To najszybsza droga dla większości sklepów. Warto tylko sprawdzić, czy integracja poprawnie deduplikuje zdarzenia i czy nie dubluje się z ręcznie wklejonym pikselem.
• Conversions API Gateway. Rozwiązanie Meta, które działa na Twoim koncie w chmurze i przesyła zdarzenia z piksela do API konwersji bez pisania kodu. Sprawdza się, gdy nie masz gotowej integracji, a nie chcesz angażować programisty.
• Google Tag Manager po stronie serwera. Zdarzenia trafiają najpierw do Twojego serwerowego kontenera GTM, a stamtąd do Meta, Google Analytics i innych narzędzi. Daje największą kontrolę nad danymi i jednym wdrożeniem obsługuje kilka platform. Wymaga jednak hostingu kontenera i więcej wiedzy technicznej.
• Własna integracja. Programista wysyła zdarzenia z serwera Twojej aplikacji bezpośrednio przez API Meta. To dobre rozwiązanie dla niestandardowych systemów, np. gdy sprzedaż odbywa się poza typowym sklepem internetowym.

Dla większości sklepów zaczynam od pierwszej opcji. Jeśli firma korzysta z wielu narzędzi reklamowych i analitycznych, zwykle wybieram GTM po stronie serwera.

Jak sprawdzić, czy API konwersji działa

• W Menedżerze zdarzeń otwórz zakładkę „Testuj zdarzenia” i przejdź ścieżkę zakupu na swojej stronie. Powinieneś zobaczyć zdarzenia zarówno z przeglądarki, jak i z serwera.
• W przeglądzie zdarzenia sprawdź, czy Meta pokazuje deduplikację, czyli czy pary zdarzeń z piksela i serwera są łączone.
• Zobacz ocenę „Jakość dopasowania zdarzeń” dla najważniejszych zdarzeń, zwłaszcza dla zakupu.
• Porównaj liczbę zakupów w Menedżerze reklam z danymi ze sklepu z tego samego okresu. Nie będą identyczne, bo Meta przypisuje konwersje według własnych okien atrybucji, ale nie powinny się mocno rozjeżdżać.
• Zajrzyj do zakładki diagnostyki. Meta pokazuje tam ostrzeżenia, np. o brakujących parametrach albo opóźnionych zdarzeniach.

API konwersji a zgody na cookies

API konwersji nie zwalnia z obowiązku zbierania zgód. Jeśli użytkownik nie zgodził się na marketingowe pliki cookies, jego zdarzenia nie powinny trafiać do Meta, niezależnie od tego, czy wysyła je piksel, czy serwer. Dlatego wdrożenie API konwersji zawsze łączę z poprawnie działającym banerem zgód, np. z trybem uzyskiwania zgody (Consent Mode). Szczegóły prawne warto skonsultować z prawnikiem, bo zależą od tego, jakie dane i w jakim celu przetwarzasz.

Najczęstsze błędy przy wdrożeniu

• Brak wspólnego identyfikatora zdarzenia, przez co zakupy liczą się podwójnie.
• Dwie integracje naraz, np. wtyczka sklepu i ręcznie dodany kod, które wysyłają te same zdarzenia.
• Zakupy bez wartości i waluty, przez co Meta nie może optymalizować pod wartość zamówień.
• Przesyłanie samego zdarzenia bez danych do dopasowania, co daje niską jakość dopasowania.
• Wysyłanie zdarzeń z opóźnieniem zamiast na bieżąco.
• Wysyłanie zdarzeń mimo braku zgody użytkownika.