1. Vytvoření webhooku objednávky
- Administrace Shopify: Settings > Notifications > Webhooks.
- 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
kdeVASE-SITE-IDnahradíte přesným Site ID ze stránky vašeho webu. - 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
- V dolní části stránky Webhooks zobrazuje Shopify signing secret: zkopírujte jej.
- Vložte jej do pole „Shopify webhook signing secret“ na stránce vašeho webu v DataFirefly a uložte.
3. Nasazení pixelu DataFirefly
- Administrace Shopify: Settings > Customer events, poté přidejte vlastní pixel.
- Vložte snippet uvedený v průvodci pro Shopify ve vaší klientské sekci (stránka Modules).
- 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í
- Vytvořte zaplacenou testovací objednávku: musí se zobrazit jako Delivered v Monitoringu.
- 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íží.
Aktualizováno: 1. září 2026