Meta CAPI dla Shoper

Server-side Facebook Conversions API — aplikacja z Shoper Marketplace

Shoper Marketplace

Czym jest Meta CAPI?

Aplikacja Meta CAPI wysyla dane zamowien z Twojego sklepu Shoper bezposrednio do Meta (Facebook) przez Conversions API. Dane ida z naszego serwera do Meta, nie z przegladarki klienta. Dzieki temu:

Omija ad blockery

Dane wysylane server-side — blokowanie reklam nie ma wplywu na tracking.

Lepsza atrybucja

Meta lepiej przypisuje konwersje do Twoich reklam dzieki dokladniejszym danym.

EMQ 12–13/13

Maksymalny Event Match Quality — 13 parametrow klienta wysylanych do Meta.

Automatyczna konfiguracja

Webhooks i snippet trackingowy instaluja sie same po zainstalowaniu aplikacji.

Wymagania

Aktywny sklep na platformie Shoper
Konto Meta Business z wlaczonym Conversions API
Utworzony Meta Pixel w Events Manager

Instalacja

Znajdz aplikacje Meta CAPI w Shoper Marketplace
Kliknij Zainstaluj — nastapi przekierowanie do autoryzacji
Po autoryzacji aplikacja automatycznie zarejestruje webhooks (zdarzenia zamowien) i wstrzyknie snippet trackingowy na frontend sklepu
Otworz aplikacje z panelu administracyjnego Shoper aby skonfigurowac dane Meta

Shoper Marketplace — strona aplikacji Meta CAPI

Zastap: screenshot strony aplikacji w Marketplace

Konfiguracja

Po instalacji otworz aplikacje w panelu Shoper. Zobaczysz formularz z trzema polami:

Pole	Gdzie znalezc	Wymagane
Meta Pixel ID	Meta Events Manager → Data Sources → Twoj Pixel → Settings	Tak
Meta Access Token	Meta Events Manager → Settings → Conversions API → Generate Access Token	Tak
Test Event Code	Meta Events Manager → zakladka Test Events (np. `TEST12345`)	Nie (tylko do testow)

Jak uzyskac Pixel ID

Otworz Meta Events Manager (business.facebook.com/events_manager)
Wybierz swoj Pixel w sekcji Data Sources
Pixel ID (15–16 cyfr) znajdziesz u gory strony

Jak uzyskac Access Token

W Events Manager przejdz do Settings wybranego Pixela
Znajdz sekcje Conversions API
Kliknij Generate Access Token
Skopiuj wygenerowany token

Panel aplikacji — formularz konfiguracji

Zastap: screenshot formularza z polami Pixel ID, Access Token, Test Event Code

Wskazniki statusu

Panel aplikacji pokazuje status kazdego komponentu:

Status	Znaczenie
Aplikacja zainstalowana	OAuth zakonczony, aplikacja ma dostep do sklepu
Webhooks zarejestrowane	Zdarzenia zamowien sa wysylane na nasz serwer
Snippet trackingowy aktywny	Frontend zbiera dane przegladarki (_fbp, _fbc, UTM)
Meta CAPI skonfigurowane	Pixel ID i Access Token zapisane i poprawne

Aplikacja jest w pelni aktywna dopiero gdy wszystkie cztery wskazniki sa zielone. Bez danych Meta zdarzenia zamowien sa odbierane, ale nie sa przekazywane do Facebooka.

Jak dziala tracking

Snippet trackingowy jest automatycznie wstrzykiwany na frontend sklepu. Zbiera:

_fbp — identyfikator przegladarki Meta (ustawiany przez Pixel)
_fbc — Click ID z reklam Facebook (gdy klient kliknal reklame)
Parametry UTM — source, medium, campaign, term, content
Email przy zamowieniu — przechwycony przy wypelnianiu formularza (hashowany SHA-256)

Te dane przegladarkowe sa laczone z danymi zamowienia po stronie serwera, aby uzyskac maksymalne Event Match Quality.

Snippet trackingowy nie zastepuje Twojego Meta Pixela — uzupelnia go o dane server-side.

Event Match Quality (EMQ)

Meta uzywa EMQ do oceny jak dobrze dane eventow pasuja do profili uzytkownikow Facebooka. Wyzsze EMQ = lepsza atrybucja reklam i nizszy koszt konwersji.

#	Parametr	Zrodlo
1	Email	Formularz zamowienia (SHA-256)
2	Numer telefonu	Dane rozliczeniowe (normalizacja +48)
3	Imie	Dane rozliczeniowe
4	Nazwisko	Dane rozliczeniowe
5	Miasto	Adres rozliczeniowy
6	Wojewodztwo	Adres rozliczeniowy
7	Kod pocztowy	Adres rozliczeniowy
8	Kraj	Adres rozliczeniowy (kod ISO)
9	External ID	ID konta klienta w sklepie
10	IP klienta	Przechwycony server-side
11	User Agent	Przechwycony server-side
12	_fbp	Snippet trackingowy
13	_fbc	Snippet trackingowy (gdy z reklamy)

Przy wszystkich parametrach uzyskujesz EMQ 12–13 z 13. Parametr #13 (_fbc) jest dostepny tylko gdy klient kliknal reklame na Facebooku.

Testowanie

W Meta Events Manager przejdz do zakladki Test Events
Skopiuj Test Event Code (np. TEST12345)
Wklej go w ustawieniach aplikacji w polu „Test Event Code”
Zloz testowe zamowienie w swoim sklepie Shoper
Sprawdz zakladke Test Events w Events Manager — event Purchase powinien pojawic sie w ciagu 1–2 minut
Usun Test Event Code z ustawien aby przejsc na produkcje

Eventy wyslane z Test Event Code nie sa liczone do optymalizacji reklam. Zawsze usun kod testowy po weryfikacji.

Najczesciej zadawane pytania

Czy potrzebuje Meta Pixel na stronie?

Tak. Aplikacja Meta CAPI uzupelnia Pixel przegladarkowy o dane server-side. Pixel jest nadal potrzebny do zbierania cookie _fbp i _fbc.

Czy moge uzywac aplikacji z wieloma Pixelami?

Aktualnie aplikacja obsluguje jeden Pixel ID na sklep. Jesli potrzebujesz wielu Pixeli, skontaktuj sie z nami.

Jak szybko pojawiaja sie eventy w Meta?

Eventy sa przetwarzane w kolejce i zazwyczaj pojawiaja sie w Events Manager w ciagu 1–2 minut od zlozenia zamowienia.

Co jesli usune aplikacje?

Webhooks i snippet trackingowy zostana automatycznie usuniete z Twojego sklepu. Historyczne dane w Meta pozostana bez zmian.