Połącz Shopify

Bez modułu do instalacji: Shopify wypycha zamówienia przez podpisane webhooki, a piksel DataFirefly obejmuje nawigację.

1. Utwórz webhook zamówienia

  1. Panel administracyjny Shopify: Ustawienia > Powiadomienia, potem Elementy webhook.
  2. 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ąc TWOJ-SITE-ID dokładnym Site ID ze strony Twojej witryny.
  3. 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

  1. Na dole strony Elementy webhook Shopify pokazuje signing secret: skopiuj go.
  2. Wklej go w polu „Shopify webhook signing secret” na stronie Twojej witryny w DataFirefly, a następnie zapisz.

3. Dodaj piksel DataFirefly

  1. Panel administracyjny Shopify: Ustawienia > Zdarzenia klientów, a następnie dodaj własny piksel.
  2. Wklej snippet z przewodnika Shopify w Twoim panelu klienta (strona Modules).
  3. 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

  1. Złóż opłacone zamówienie testowe: musi pojawić się ze statusem Delivered w Monitoringu.
  2. Przycisk „Diagnose my connection” potwierdza odbiór ostatnich zdarzeń.

Gdy coś nie działa

Aktualizacja: 1 września 2026