# Připojení Shopify

> Připojení obchodu Shopify k DataFirefly Server-Side: podepsaný webhook Order payment, signing secret, pixel DataFirefly pro události navigace.

- Původní stránka: https://server-side.datafirefly.com/cs/docs/shopify.html
- Jazyk: cs
- Aktualizováno: 2026-09-01
- Vydavatel: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/cs/

---

Žádný modul k instalaci: Shopify posílá objednávky přes podepsané webhooky a navigaci pokrývá pixel DataFirefly.

## 1. Vytvoření webhooku objednávky

1. Administrace Shopify: **Settings > Notifications > Webhooks**.
2. Klikněte na **Create webhook**, zvolte událost **Order payment** a formát JSON, s cílovou adresou:  
   `https://serverside.datafirefly.com/v1/shopify/VASE-SITE-ID`  
   kde `VASE-SITE-ID` nahradíte přesným Site ID ze [stránky vašeho webu](https://server-side.datafirefly.com/cs/docs/connect-your-site.html).
3. Doporučeno: přidejte také **Refund creation**, aby se přenášely i refundace. **Checkout creation** a **Cart creation** mají smysl jen do doby, než nasadíte pixel DataFirefly.

Vyberte **Order payment**, nikdy **Order creation**: ten se spouští i u nezaplacených objednávek a způsobuje dvojí započítání.

## 2. Vložení signing secretu

1. V dolní části stránky Webhooks zobrazuje Shopify **signing secret**: zkopírujte jej.
2. Vložte jej do pole **„Shopify webhook signing secret“** na stránce vašeho webu v DataFirefly a uložte.

## 3. Nasazení pixelu DataFirefly

1. Administrace Shopify: **Settings > Customer events**, poté přidejte vlastní pixel.
2. Vložte snippet uvedený v průvodci pro Shopify ve vaší klientské sekci (stránka [**Modules**](https://admin.datafirefly.com/app/connectors)).
3. Jakmile je pixel nasazen, smažte webhooky Checkout creation a Cart creation: pixel je nahrazuje.

## ChatGPT Ads

Nákup se odesílá ze serveru přes podepsaný webhook **Order payment**. Referenci reklamního kliknutí (`oppref` a `obref`) zachytává pixel DataFirefly z kroku 3, vložený v administraci Shopify (**Settings > Customer events**) a ne v šabloně: spojí referenci s pokladnou a server ji přiřadí k nákupu. Zachytává se jen s marketingovým souhlasem.

Pokud používáte i vlastní pixel OpenAI, nahraďte jeho volání nákupu kódem z návodu pro Shopify ve své klientské sekci, aby nákup v prohlížeči měl stejné ID události jako nákup ze serveru (`shopify-order-` a číslo objednávky). Jinak vypněte událost nákupu ve vlastním pixelu OpenAI.

## Souhlas

Pixel DataFirefly se řídí marketingovým souhlasem zaznamenaným v Shopify. Pokud návštěvník marketing odmítne, pixel odesílá jeho události do DataFirefly označené jako odmítnuté, bez jakéhokoli odkazu na reklamní kliknutí, a nic z nich se nepředává reklamním platformám. Objednávky naopak přicházejí přes podepsané webhooky, které žádný signál souhlasu nepředávají, a proto se na ně vztahují zásady souhlasu vašeho obchodu.

## Ověření

1. Vytvořte zaplacenou testovací objednávku: musí se zobrazit jako **Delivered** v Monitoringu.
2. Tlačítko **„Diagnose my connection“** potvrdí příjem posledních událostí.

## Když něco nefunguje

- Webhook, který selhává přibližně 48 hodin, **Shopify automaticky smaže**. Pokud webhook zmizel, zkontrolujte Site ID v URL, vytvořte jej znovu a sledujte Monitoring.
- Duplicitní objednávky? Ověřte, že nikde nezůstal webhook **Order creation**.
- Další časté příčiny najdete v [průvodci řešením potíží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

Aktualizováno: 1. září 2026
