# Połącz Shopify

> Połącz sklep Shopify z DataFirefly Server-Side: podpisany webhook Order payment, signing secret, piksel DataFirefly dla zdarzeń nawigacyjnych.

- Strona oryginalna: https://server-side.datafirefly.com/pl/docs/shopify.html
- Język: pl
- Zaktualizowano: 2026-09-01
- Wydawca: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pl/

---

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](https://server-side.datafirefly.com/pl/docs/connect-your-site.html).
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**](https://admin.datafirefly.com/app/connectors)).
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

- 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](https://server-side.datafirefly.com/pl/docs/troubleshooting.html).

Aktualizacja: 1 września 2026
