1. Utwórz webhook zamówienia
- Panel administracyjny Shopify: Ustawienia > Powiadomienia, potem Elementy webhook.
- Kliknij Utwórz element webhook, wybierz zdarzenie Order payment i format JSON, z adresem docelowym:
https://serverside.datafirefly.com/v1/shopify/TWOJ-SITE-ID
zastępującTWOJ-SITE-IDdokładnym Site ID ze strony Twojej witryny. - Zalecane: dodaj też Refund creation, aby zwroty również spływały. Checkout creation i Cart creation są przydatne tylko do czasu dodania piksela DataFirefly.
Wybierz koniecznie Order payment, nigdy Order creation: ten drugi uruchamia się także dla nieopłaconych zamówień i powoduje podwójne zliczanie.
2. Wklej signing secret
- Na dole strony Elementy webhook Shopify pokazuje signing secret: skopiuj go.
- Wklej go w polu „Shopify webhook signing secret” na stronie Twojej witryny w DataFirefly, a następnie zapisz.
3. Dodaj piksel DataFirefly
- Panel administracyjny Shopify: Ustawienia > Zdarzenia klientów, a następnie dodaj własny piksel.
- Wklej snippet z przewodnika Shopify w Twoim panelu klienta (strona Modules).
- Gdy piksel działa, usuń webhooki Checkout creation i Cart creation: piksel je zastępuje.
ChatGPT Ads
Zakup jest wysyłany z serwera przez podpisany webhook Order payment. Referencję kliknięcia reklamy (oppref oraz obref) przechwytuje piksel DataFirefly z kroku 3, wklejony w panelu administracyjnym Shopify (Ustawienia > Zdarzenia klientów), a nie w motywie: wiąże on referencję z finalizacją zamówienia, a serwer dołącza ją do zakupu. Jest przechwytywana tylko za zgodą marketingową.
Jeśli używasz też własnego piksela OpenAI, zastąp jego wywołanie zakupu kodem z przewodnika Shopify w Twoim panelu klienta, tak aby zakup w przeglądarce miał ten sam identyfikator zdarzenia co zakup serwerowy (shopify-order- i numer zamówienia). W przeciwnym razie wyłącz zdarzenie zakupu we własnym pikselu OpenAI.
Zgoda
Piksel DataFirefly respektuje zgodę marketingową zarejestrowaną w Shopify. Gdy odwiedzający nie wyraża zgody na marketing, piksel wysyła jego zdarzenia do DataFirefly oznaczone jako odrzucone, bez żadnego odniesienia do kliknięcia reklamy, i nic z nich nie trafia do platform reklamowych. Zamówienia przychodzą natomiast przez podpisane webhooki, które nie przekazują sygnału zgody, dlatego obowiązuje je polityka zgód Twojego sklepu.
Weryfikacja
- Złóż opłacone zamówienie testowe: musi pojawić się ze statusem Delivered w Monitoringu.
- Przycisk „Diagnose my connection” potwierdza odbiór ostatnich zdarzeń.
Gdy coś nie działa
- Webhook, który nie działa przez około 48 godzin, jest automatycznie usuwany przez Shopify. Jeśli webhook zniknął, sprawdź Site ID w adresie URL, utwórz go ponownie i obserwuj Monitoring.
- Zduplikowane zamówienia? Sprawdź, czy nie pozostał żaden webhook Order creation.
- Pozostałe częste przyczyny znajdziesz w przewodniku rozwiązywania problemów.
Aktualizacja: 1 września 2026