Pixel i Conversions API zliczają tę samą transakcję dwukrotnie na stronie potwierdzenia
Reklamy i pozyskiwanie klientów · Kacper Bernecki
Problem: na stronie potwierdzenia zamówienia (order confirmation / thank-you) obserwujesz, że konwersja jest raportowana dwa razy w narzędziach Meta (Facebook/Meta Ads). Najczęściej przyczyną nie jest „bug” samego pixela ani API, lecz nakładające się źródła zdarzeń: front-endowy Meta Pixel wysyła event purchase oraz backendowy Conversions API przesyła ten sam event bez korelacji. Celem tej instrukcji jest przedstawienie metodycznej diagnostyki różnicowej, lista konkretnych kroków naprawczych, oraz testy, które potwierdzą usunięcie podwójnego zliczania. Nie zakładamy jedynej przyczyny — przeanalizujemy co zwykle występuje w konfiguracjach SPA, serwerów pośredniczących i integracji e-commerce.
Jak rozpoznać przyczynę
Najczęstszy scenariusz: na stronie potwierdzenia zarówno klient (przeglądarka) wywołuje Meta Pixel (fbq('track','Purchase',...)), jak i serwer wysyła Conversions API z tym samym identyfikatorem transakcji. Brak deduplikacji po stronie Meta (event_id lub deduplication parameters) powoduje powielenie. Sprawdź, czy event_id jest generowany i przekazywany identycznie z front-endu i backendu.
Inne możliwe przyczyny: wielokrotne ładowanie skryptu pixela (np. SPA bez kontroli routingu), retry logiki na serwerze wysyłającej ponownie CAPI przy błędach, lub integracje pośrednie (np. tag manager lub wtyczka sklepu) które wysyłają dodatkowe zdarzenia Purchase. Zidentyfikuj źródło każdego zdarzenia w Event Managerze według 'Event source' i 'Event source detail'.
Rozwiązanie krok po kroku
1. Krok 1 — Zidentyfikuj czas i identyfikator zdarzeń: w Meta Events Manager wybierz przykładowe zduplikowane zdarzenie i zanotuj timestamp, event_name, oraz event_id (jeśli dostępny). Ustal, czy oba wpisy mają ten sam event_id.
2. Krok 2 — Przejrzyj frontend: otwórz stronę potwierdzenia w trybie deweloperskim, monitoruj konsolę i Network. Sprawdź czy fbq('track','Purchase') jest wywoływane więcej niż raz oraz czy event_id jest dołączone jako parametr custom_data.event_id lub event_id w request payload.
3. Krok 3 — Przejrzyj backend/serwer: sprawdź logi serwera lub mechanizm wysyłki Conversions API. Znajdź payload wysyłany do /events z pola event_name=Purchase i sprawdź, czy przesyłany jest ten sam event_id lub identyfikator transakcji order_id. Jeśli brak event_id, wprowadź generowanie spójnego event_id.
4. Krok 4 — Wdrożenie deduplikacji: jeśli chcesz stosować oba źródła, upewnij się, że front-end generuje unikalny event_id (UUID v4) i przekazuje go do backendu razem z zamówieniem, a backend wysyła ten sam event_id w polu 'event_id' w Conversions API.
5. Krok 5 — Blokowanie duplikatów po stronie klienta: jeśli nie używasz CAPI lub wolisz wyłączyć pixel, dodaj warunek na stronie potwierdzenia, który wysyła pixel tylko jeśli zamówienie nie było wcześniej zarejestrowane w sesji (np. flaga sessionStorage 'purchase_sent').
6. Krok 6 — Sprawdzenie integracji pośrednich: przejrzyj konfiguracje Tag Managera, wtyczek sklepowych (Shopify/ WooCommerce), i middleware CDN, by upewnić się, że żadne narzędzie nie wysyła dodatkowego Purchase. Wyłącz pojedynczo podejrzane reguły i obserwuj zdarzenia.
7. Krok 7 — Testuj retry i idempotencję: jeśli backend retryuje wysyłkę przy błędach, upewnij się że retry używa tego samego event_id, a nie generuje nowego. W przeciwnym wypadku Meta potraktuje retry jako nową konwersję.
Jak sprawdzić, czy problem zniknął
Test 1 — Odwzorowanie: wykonaj testowe zamówienie z unikalnym event_id, następnie w Events Manager sprawdź, że tylko jedno zdarzenie Purchase pojawia się z tym event_id. Upewnij się, że czas stempla front i backend pasuje do ruchu.
Test 2 — A/B: tymczasowo wyłącz wysyłkę backendu (CAPI) i zrób zamówienie: powinno pozostać pojedyncze zdarzenie z source 'Pixel'. Potem wyłącz pixel i włącz tylko CAPI — znów powinno być jedno zdarzenie. To potwierdzi które źródło generuje duplikat.
Czego nie robić
Ostrzeżenie 1 — Nie polegaj wyłącznie na order_id z systemu sklepowego: Meta używa pola event_id do deduplikacji; order_id może być różny formatowo i nie gwarantuje deduplikacji, jeśli nie mapujesz go na event_id.
Ostrzeżenie 2 — Nie generuj nowych event_id przy retry: jeśli retry tworzy nowy event_id, Meta potraktuje to jako odrębną konwersję. Zaimplementuj przechowywanie event_id na poziomie zapisu zamówienia.
Ostrzeżenie 3 — Unikaj usuwania pixela bez planu: gruntowne wyłączenie pixela może przerwać inne zdarzenia marketingowe (ViewContent, AddToCart). Lepiej deduplikować niż arbitralnie wyłączać źródła.