Conversions API (CAPI) – czym jest i dlaczego sklep internetowy powinien je wdrożyć

Sposoby wdrożenia Conversions API

Meta oferuje kilka dróg wdrożenia – od rozwiązań włączanych jednym kliknięciem po pełną integrację programistyczną. Porównanie opcji znajdziesz w Pomocy Meta. Wybór zależy od platformy sklepu, budżetu i tego, jak dużą kontrolę nad danymi chcesz mieć.

Conversions API włączane przez Meta

To najprostsza opcja. Według Pomocy Meta jest to konfiguracja tylko dla witryn, która automatycznie tworzy połączenie po stronie serwera i przesyła dane z witryny do Meta równolegle z pikselem. Zdarzenia i parametry udostępniane przez piksel są też udostępniane przez to połączenie i automatycznie deduplikowane. Ograniczeniem jest to, że nie dodasz w ten sposób zdarzeń, których nie widzi piksel, np. zakupów opłaconych później przelewem.

Integracja platformy sklepu

Jeśli prowadzisz sklep na popularnej platformie, Conversions API często włączysz w oficjalnej aplikacji lub wtyczce Meta. Pomoc Meta wymienia m.in. Shopify i WooCommerce jako platformy, na których konfiguracja zajmuje kilka kliknięć i nie wiąże się z dodatkowymi kosztami. Szczegóły opisujemy w poradnikach o Shopify i Meta, Facebook for WooCommerce i pikselu Facebooka w Shoper.

Conversions API Gateway

Conversions API Gateway to rozwiązanie bez kodu, które uruchamia się z poziomu Menedżera zdarzeń, w sekcji platform połączeń danych. Gateway działa na infrastrukturze chmurowej, za którą płacisz dostawcy chmury – według Meta opłaty zaczynają się od 30 USD miesięcznie. Meta wskazuje, że to dobre rozwiązanie dla firm, które już korzystają z piksela, nie wysyłają jeszcze zdarzeń przez Conversions API i wydają ponad 300 USD miesięcznie na kampanie optymalizowane pod zdarzenia w witrynie. Aktualne warunki i koszty sprawdź przed wdrożeniem.

Google Tag Manager i integracja bezpośrednia

Sklepy, które zarządzają tagami w Google Tag Manager, mogą wysyłać zdarzenia przez kontener serwerowy – więcej piszemy w poradniku piksel Meta przez Google Tag Manager. Integracja bezpośrednia daje najwięcej kontroli, ale wymaga programisty i infrastruktury, która przesyła zdarzenia do Meta w czasie rzeczywistym. Meta szacuje czas wdrożenia nowej integracji na 2–4 tygodnie.

[#tip] Jeśli Twoja platforma ma oficjalną integrację z Meta, zacznij od niej. Integrację bezpośrednią warto rozważyć dopiero wtedy, gdy potrzebujesz zdarzeń, których integracja nie obsługuje – np. zakupów potwierdzanych po zaksięgowaniu przelewu albo sprzedaży z kilku systemów jednocześnie.

Wykres – wdrożenie Conversions API w sklepie krok po kroku. [#chart:m13b]

Jakie dane wysyła się przez Conversions API

Zdarzenie z serwera składa się z kilku grup informacji. Pełną listę parametrów opisuje dokumentacja Meta dla deweloperów. Najważniejsze z nich to:

• event_name – nazwa zdarzenia, np. Purchase; taka sama jak w pikselu.

• event_time – czas zdarzenia; według dokumentacji może być maksymalnie 7 dni wcześniejszy niż moment wysyłki.

• event_id – identyfikator zdarzenia, np. numer zamówienia, potrzebny do deduplikacji z pikselem.

• action_source – źródło zdarzenia; dla sklepu internetowego website. Parametr jest wymagany.

• event_source_url – adres strony, na której doszło do zdarzenia; wymagany dla zdarzeń z witryny.

• user_data – dane do dopasowania: zahashowane (SHA-256) e-mail i telefon oraz niehashowane identyfikatory przeglądarki (fbp, fbc), adres IP i user agent.

• custom_data – szczegóły zdarzenia: value, currency, content_ids, contents, content_type.

Im więcej poprawnych danych do dopasowania, tym większa szansa, że Meta powiąże zdarzenie z kontem i wykorzysta je w optymalizacji. Nie oznacza to jednak, że trzeba wysyłać wszystko, co sklep ma w bazie – przesyłaj tylko to, na co pozwalają zasady Meta, Twoja polityka prywatności i zgody klienta.

[#uwaga] Wysyłanie danych klientów przez Conversions API to przetwarzanie danych osobowych. Zakres przesyłanych danych, podstawę prawną i zapisy w polityce prywatności skonsultuj z prawnikiem lub inspektorem ochrony danych. Praktyczne aspekty łączenia pomiaru z banerem zgód opisujemy we wpisie piksel Meta a zgody cookies.

Konfiguracja redundantna i deduplikacja

Meta zaleca, by najważniejsze zdarzenia – np. zakup, rozpoczęcie zamówienia czy kontakt – wysyłać jednocześnie przez piksel i Conversions API. To tak zwana konfiguracja redundantna. Według opisanych w Pomocy Meta najlepszych praktyk warto dążyć do tego, by liczba zdarzeń z Conversions API wynosiła co najmniej 75% liczby zdarzeń z piksela (wskaźnik pokrycia zdarzeń widoczny w Menedżerze zdarzeń).

Konfiguracja redundantna wymaga deduplikacji. Jeśli to samo zamówienie dotrze z przeglądarki i z serwera, Meta musi wiedzieć, że chodzi o jedno zdarzenie. Służą do tego zgodna nazwa zdarzenia i ten sam identyfikator zdarzenia (event_id) w obu źródłach. Bez tego zakupy mogą być liczone podwójnie, a ROAS w raportach będzie zawyżony. Szczegóły opisujemy w poradniku o deduplikacji zdarzeń piksela i Conversions API.

[#przyklad] Sklep z kosmetykami ma piksel na stronie podziękowania i Conversions API w integracji platformy. Zamówienie numer 58231 wysyła się dwa razy: z przeglądarki i z serwera, oba razy jako Purchase z event_id 58231. Meta zachowuje jedno zdarzenie. Gdy inna klientka zamknie kartę przed załadowaniem strony podziękowania, piksel nic nie wyśle – ale zakup i tak dotrze z serwera.

Jak sprawdzić, czy Conversions API działa

Po wdrożeniu nie wystarczy włączyć integracji i zapomnieć. Warto sprawdzić kilka rzeczy w Menedżerze zdarzeń:

1. W przeglądzie zbioru danych zobacz, czy przy najważniejszych zdarzeniach widać oba źródła: przeglądarkę i serwer.

2. Użyj narzędzia testowania zdarzeń – zdarzenia z serwera możesz oznaczyć kodem testowym i obserwować je na bieżąco.

3. Sprawdź wskaźnik pokrycia zdarzeń i wynik jakości dopasowania przy zdarzeniu Purchase.

4. Zajrzyj do zakładki Diagnostyka – Meta pokazuje tam m.in. problemy z deduplikacją i brakujące parametry.

5. Porównaj liczbę zakupów w Menedżerze zdarzeń z liczbą zamówień w panelu sklepu z tego samego okresu.

Szczegółowy przewodnik po tych narzędziach znajdziesz we wpisie o Menedżerze zdarzeń Meta. Jeśli liczba zakupów z serwera jest wyraźnie wyższa niż liczba zamówień w sklepie, najczęściej przyczyną jest brak deduplikacji albo wysyłanie zdarzenia przy każdej zmianie statusu zamówienia.

Ile kosztuje wdrożenie Conversions API

Koszt zależy od wybranej drogi. Conversions API włączane przez Meta jest bezpłatne, a oficjalne integracje dużych platform według Meta nie wiążą się z dodatkowymi opłatami po stronie Meta – choć niektóre wtyczki czy aplikacje mogą mieć własny cennik. Conversions API Gateway generuje koszt infrastruktury chmurowej. Integracja bezpośrednia to przede wszystkim czas pracy programistów oraz późniejsze utrzymanie i aktualizacje.

Przy ocenie opłacalności warto patrzeć nie na sam koszt wdrożenia, ale na to, ile zakupów i jakiej wartości obecnie „ginie” w raportach. Jeśli sklep wydaje na reklamy kilka tysięcy złotych miesięcznie, a kampanie optymalizują się na niepełnych danych, nawet niewielka poprawa liczby dopasowanych zdarzeń może przełożyć się na lepsze decyzje o budżecie. Na ile realnie przekłada się to na wyniki – sprawdzisz dopiero na danych własnego sklepu.

Najczęściej zadawane pytania

Czy Conversions API zastępuje piksel Meta?

Nie. Meta zaleca korzystanie z obu rozwiązań jednocześnie i wysyłanie najważniejszych zdarzeń obiema drogami, z deduplikacją. Piksel zbiera informacje z przeglądarki, a Conversions API zabezpiecza zdarzenia, które piksel mógłby zgubić.

Czy do wdrożenia Conversions API potrzebny jest programista?

Nie zawsze. Conversions API włączane przez Meta, integracje platform sklepowych i Conversions API Gateway można skonfigurować bez programowania. Programista jest potrzebny przy integracji bezpośredniej albo przy niestandardowych zdarzeniach.

Czy Conversions API działa bez zgody na pliki cookie?

Conversions API nie służy do omijania zgód. Zakres wysyłanych zdarzeń i danych powinien wynikać z tego, na co klient się zgodził, oraz z ustaleń z prawnikiem lub inspektorem ochrony danych.

Skąd mam wiedzieć, czy zakupy nie liczą się podwójnie?

Sprawdź w Menedżerze zdarzeń, czy zdarzenia z przeglądarki i serwera mają ten sam event_id, i porównaj liczbę zakupów z liczbą zamówień w sklepie. Problemy z deduplikacją Meta pokazuje też w zakładce Diagnostyka.

Czy po wdrożeniu Conversions API wyniki kampanii od razu się poprawią?

Nie ma takiej gwarancji. Najpierw zwykle widać więcej zarejestrowanych zdarzeń i lepsze dopasowanie. Wpływ na koszt zakupu zależy od tego, ile zdarzeń wcześniej ginęło, od budżetu i od jakości kampanii.

Jak długo trwa wdrożenie Conversions API?

Według Meta: od jednego kliknięcia w przypadku Conversions API włączanego przez Meta, przez mniej niż 30 minut dla Gateway, do 2–4 tygodni przy nowej integracji bezpośredniej. Do tego dochodzi czas na testy i porównanie danych z panelem sklepu.

Podsumowanie

Conversions API to przesyłanie zdarzeń ze sklepu do Meta z serwera, niezależnie od przeglądarki klienta. Uzupełnia piksel o zdarzenia, które ten gubi przez blokery, błędy ładowania czy zamknięte karty, pozwala przekazać więcej danych do dopasowania i wysyłać zdarzenia spoza strony. Najlepiej działa w konfiguracji redundantnej z pikselem i poprawną deduplikacją. Dla większości sklepów najprostszą drogą jest oficjalna integracja platformy lub Conversions API włączane przez Meta.

Jeśli chcesz, żebyśmy jako Meta Business Partner wdrożyli Conversions API w Twoim sklepie, sprawdzili deduplikację i poprowadzili kampanie na pełnych danych, sprawdź naszą obsługę kampanii Meta Ads.