Co robi Conversion API
Conversion API (CAPI) przesyła zdarzenia konwersji bezpośrednio z serwera Storeep do platformy reklamowej, z pominięciem przeglądarki kupującego. Ponieważ działa serwer-serwer, nie jest blokowany przez adblocki, ustawienia prywatności przeglądarki ani ograniczenia śledzenia w iOS. Przekazuje też zahaszowane dane klienta, co poprawia dopasowanie do Smart Bidding i odbiorców podobnych. Jeśli interesują Cię piksele po stronie przeglądarki, zobacz powiązany artykuł Browser pixels.
Możesz jednocześnie używać pikseli przeglądarkowych i CAPI dla tej samej platformy. Storeep oznacza oba tym samym identyfikatorem zdarzenia, zbudowanym z typu zdarzenia i numeru zamówienia, dzięki czemu platforma zlicza je jako jedną konwersję, a nie dwie.
Które platformy oferują CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X i Google Ads nie mają serwerowego Conversion API w Storeep, działają tylko po stronie przeglądarki.
Jakie dane są wysyłane
Przy każdym kwalifikującym się zamówieniu Storeep wysyła wartość zamówienia i walutę, produkty, oraz sygnały kupującego: zahaszowany e-mail, telefon, zahaszowane ID klienta (external_id), adres IP, user agent, a dla Facebooka i Snapchata także zahaszowany kraj rynku. Przekazuje również identyfikatory kliknięć reklam z ciasteczek kupującego (Facebook _fbc i _fbp, TikTok ttclid, Snapchat ScCid), by platforma mogła przypisać konwersję do oryginalnego kliknięcia.
Typy zdarzeń konwersji
- Facebook: tylko Lead lub Purchase. Facebook CAPI nie wysyła zdarzeń dodania do koszyka ani rozpoczęcia płatności.
- TikTok: Lead, Purchase, Place an order lub Complete payment.
- Snapchat: Purchase lub Reserve.
Waluta i zamówienia o zerowej wartości
Każde zdarzenie używa waluty zamówienia, jeśli platforma ją obsługuje, w przeciwnym razie wartość jest przeliczana na USD. Facebook CAPI pomija zamówienia o wartości 0, ponieważ Meta odrzuca konwersje bez wartości, co jest zgodne z pikselem przeglądarkowym Facebooka.
Przełącznik śledzenia porzuconych zamówień
To kluczowe zachowanie. Nowe zamówienie zawsze wywołuje wysłanie przez CAPI. Porzucone zamówienie jest inne: wysyłka następuje tylko, gdy włączysz przełącznik Porzucone zamówienia dla tego wpisu CAPI i tylko w momencie, gdy status zamówienia zmienia się z porzuconego na inny.
- Gdy Porzucone zamówienia są wyłączone, odzyskane porzucone zamówienia nigdy nie są przekazywane do platformy.
- Gdy są włączone, zdarzenie wysyłane jest, gdy zamówienie wychodzi ze statusu porzuconego, niezależnie czy zmienisz status ręcznie, czy zrobi to aplikacja Automator.
- Jeśli Automator nie jest zainstalowany, musisz samodzielnie zmienić status zamówienia, by zdarzenie zostało wysłane.
- Przełącznik działa osobno dla każdego wpisu, więc możesz włączyć śledzenie porzuconych zamówień dla jednego Pixel ID, a dla innego zostawić wyłączone.
Instalacja CAPI i jego pola
- Otwórz Apps w lewym menu.
- Znajdź aplikację Conversion API, którą chcesz zainstalować i kliknij Install, a następnie potwierdź.
- Ponownie otwórz aplikację i kliknij Add new pixel, aby utworzyć wpis.
Każdy wpis zawiera następujące pola:
- Activate: po włączeniu zdarzenia konwersji są wysyłane serwer-serwer. Domyślnie włączone.
- Abandoned orders: opisany wyżej przełącznik. Domyślnie wyłączony.
- Ad account name: etykieta tylko do Twojej wiadomości.
- Pixel ID: Twój Pixel ID z Meta, TikTok lub Snapchata.
- Markets: rynki sklepu, których dotyczy ten wpis. Wybierz jeden lub więcej.
- Conversion event type: opcje platformy wymienione wyżej.
- Access token: token dostępu do Conversion API wygenerowany w menedżerze zdarzeń platformy. Wymagany.
- Activate test mode: po włączeniu zdarzenia są wysyłane jako testowe.
- Test code: kod testowy zdarzenia z platformy, np. TEST_1234. Wymagany, gdy tryb testowy jest włączony.
Tryb testowy
Po włączeniu trybu testowego zdarzenia pojawiają się w widoku testowym platformy, dzięki czemu możesz potwierdzić integrację bez wpływu na dane produkcyjne. Zdarzenia testowe nie wpływają na licytację reklam ani optymalizację, więc przed uruchomieniem kampanii wyłącz tryb testowy.
Jak rynki ograniczają działanie CAPI
Wpis CAPI działa tylko dla zamówień z rynków wybranych w tym wpisie. Zamówienie z rynku, którego nie wybrałeś, nie uruchomi tego wpisu, więc możesz mieć różne Pixel ID i tokeny dostępu dla każdego kraju w jednym sklepie.
Na co zwrócić uwagę
- Używaj tego samego Pixel ID w pikselu przeglądarkowym i CAPI, aby platforma zliczała oba jako jedną konwersję.
- Jeśli zdarzenia przestaną pojawiać się w menedżerze zdarzeń platformy, Twój token dostępu mógł wygasnąć. Wygeneruj nowy i zaktualizuj wpis.
- Każdy wpis działa niezależnie. Możesz dodać wiele wpisów na platformę, każdy z własnym Pixel ID, tokenem dostępu, rynkami, typem zdarzenia i ustawieniem porzuconych zamówień.
- Pamiętaj, aby wyłączyć tryb testowy przed startem kampanii, w przeciwnym razie prawdziwe konwersje nie będą zliczane.