Czym jest Meta Conversions API (CAPI) i czy go potrzebuję?

Meta Conversions API (CAPI) wysyła zdarzenia zakupów do Meta z Twojego serwera, zamiast polegać wyłącznie na przeglądarce odwiedzającego. W Marketing Revolution mechanizm wysyłania zdarzeń Meta po stronie serwera używa Twojego Pixel ID i tokenu dostępu CAPI, a następnie wysyła zdarzenia zakupów do Graph API Meta. Celem jest odzyskanie zakupów, których tracking przeglądarkowy może nie zobaczyć przez blokery reklam, timing zgody, przekierowania checkoutu albo zbyt szybkie zamknięcie strony potwierdzenia przez klienta.

CAPI działa razem z ponowną wysyłką pominiętych zakupów. Moduł loguje tracking zakupu, zaplanowane zadanie ponownej wysyłki działa co godzinę, patrzy wstecz w skonfigurowanym oknie i wysyła pominięte zamówienia przez skonfigurowane API server-side. Dla Meta payload obejmuje zdarzenie Purchase, walutę, wartość, zawartość produktów, ID zamówienia i dane enhanced matching. Email, telefon, imię, nazwisko, miasto, kod pocztowy, województwo/stan i kraj są normalizowane i hashowane SHA-256 przed wysyłką; IP klienta i user agent są wysyłane bez hashowania, ponieważ Meta oczekuje tych pól w takiej formie.

Podstawowa lista kontrolna CAPI:
1. Meta Pixel ID w ustawieniach platformy Meta.

2. Token dostępu Meta CAPI w ustawieniach platformy Meta.

3. Opcjonalny Test Event Code (kod zdarzenia testowego) podczas weryfikacji w Meta Events Manager.
4. Włącz Resend Missed Purchases (ponowną wysyłkę pominiętych zakupów), jeśli chcesz uruchamiać zadanie odzyskiwania co godzinę po stronie serwera.

5. Pozostaw też włączony piksel przeglądarkowy, ponieważ CAPI uzupełnia standardowe śledzenie w przeglądarce, zamiast je zastępować.

Przebieg zdarzeń:
Klient trafia na potwierdzenie zamówienia -> piksel przeglądarkowy próbuje wysłać Purchase.
Marketing Revolution zapisuje próbę śledzenia zakupu.
Zadanie cron uruchamiane co godzinę -> ResendMissedPurchases znajduje zakończone zamówienia bez zapisanego śledzenia w sprawdzanym okresie.
MetaConversionsApi::sendPurchase() -> POST /{pixel_id}/events z Purchase, value, currency, contents, order_id i zahaszowanymi danymi klienta.
Meta Events Manager -> najpierw użyj Test Event Code, a następnie usuń go dla ruchu produkcyjnego.

Potrzebujesz CAPI, jeśli reklamy Meta są ważne dla Twoich raportów albo optymalizacji. Jeśli nie prowadzisz kampanii Meta, jest opcjonalne. Jeśli prowadzisz kampanie Meta, to jedna z najskuteczniejszych poprawek w śledzeniu, ponieważ zmniejsza różnicę między realnymi zamówieniami PrestaShop a tym, co Meta może przypisać.