Facebook Conversions API - kompletny poradnik konfiguracji
Blokery reklam i ograniczenia przeglądarek coraz skuteczniej blokują Facebook Pixel. Conversions API to rozwiązanie serwerowe, które zapewnia dokładne śledzenie niezależnie od ustawień przeglądarki użytkownika.
Krótka odpowiedź
Dlaczego Pixel już nie wystarcza
Facebook Pixel działa w przeglądarce użytkownika (client-side). To oznacza podatność na blokowanie przez:
- Blokery reklam (AdBlock, uBlock Origin) - blokują skrypty śledzące
- Intelligent Tracking Prevention (ITP) w Safari - usuwa ciasteczka po 7 dniach
- Enhanced Tracking Protection w Firefoxie
- iOS 14+ App Tracking Transparency - użytkownicy mogą odmówić śledzenia
Szacuje się, że 20-40% zdarzeń nie jest rejestrowanych przez sam Pixel. To oznacza, że Twoje kampanie optymalizują się na podstawie niepełnych danych, a raporty zaniżają rzeczywiste konwersje.
Conversions API wysyła zdarzenia z Twojego serwera bezpośrednio do Meta. Przeglądarka użytkownika nie jest zaangażowana, więc blokery nie działają. To nie zamiennik Pixela, ale uzupełnienie - obydwa powinny działać równolegle.
Architektura i deduplikacja zdarzeń
Przy jednoczesnym użyciu Pixela i CAPI to samo zdarzenie może zostać wysłane dwukrotnie - raz z przeglądarki, raz z serwera. Meta używa deduplikacji by uniknąć podwójnego liczenia.
Klucz do deduplikacji to event_id - unikalny identyfikator zdarzenia, który musi być identyczny w obu kanałach. Generujesz go po stronie serwera przy ładowaniu strony i przekazujesz do Pixela oraz CAPI.
```javascript
// Przykład: generowanie event_id
const eventId = generateUUID();
// Pixel (client-side)
fbq('track', 'Purchase', {value: 100}, {eventID: eventId});
// CAPI (server-side) - ten sam eventId
```
Event match quality to metryka pokazująca, jak dobrze Meta może dopasować zdarzenia CAPI do użytkowników. Zależy od ilości przesyłanych danych identyfikacyjnych: email (zahashowany), telefon, adres IP, user agent, fbc/fbp cookies. Im więcej danych, tym lepsze dopasowanie.
Metody implementacji CAPI
Istnieje kilka sposobów wdrożenia Conversions API:
1. Partner integracyjny (najprostsze)
Platformy e-commerce oferują gotowe integracje: Shopify, WooCommerce (przez wtyczki), Magento, BigCommerce. Włączasz funkcję w panelu i CAPI działa automatycznie.
2. Google Tag Manager Server-Side
GTM Server-Side działa jako pośrednik - zbiera zdarzenia i wysyła je do Meta przez CAPI. Wymaga hostowania kontenera serwerowego (Google Cloud, AWS lub dedykowany serwer).
3. Bezpośrednia integracja przez API
Najbardziej elastyczna, ale wymaga programowania. Wysyłasz requesty HTTP do endpointu Meta Graph API:
```
POST https://graph.facebook.com/v18.0/{pixel_id}/events
```
4. Meta Conversions API Gateway
Nowe rozwiązanie Meta - dedykowany serwer w AWS lub GCP, który automatyzuje konfigurację CAPI. Wymaga konta cloudowego, ale upraszcza wdrożenie.
Dla większości biznesów partner integracyjny lub GTM Server-Side to optymalne rozwiązanie - balans między łatwością wdrożenia a elastycznością.
Konfiguracja w Events Manager
Po technicznej implementacji skonfiguruj CAPI w Events Manager:
1. Przejdź do swojego Pixela → Ustawienia → Conversions API
2. Wygeneruj Access Token (klucz autoryzacyjny do API)
3. Skonfiguruj zdarzenia do wysyłania przez CAPI
4. Włącz Automatic Advanced Matching dla lepszego dopasowania
W zakładce Diagnostyka sprawdzaj:
- Event match quality - powinno być powyżej 6/10
- Deduplikacja - procent zdarzeń poprawnie zdeduplikowanych
- Opóźnienie zdarzeń - zdarzenia CAPI powinny docierać w ciągu godziny
Testowanie: użyj narzędzia Test Events w Events Manager. Wpisz URL strony testowej, wykonaj akcje i sprawdź, czy zdarzenia docierają przez oba kanały z tym samym event_id.
Częste błędy:
- Brak event_id (podwójne liczenie)
- Niedopasowane parametry (inne nazwy w Pixelu i CAPI)
- Brakujące dane użytkownika (niski event match quality)