Návody na inštaláciu

WooCommerce

Stiahnite plugin Convertry pre WordPress.
V administrácii: Pluginy, Pridať nový, Nahrať plugin, Aktivovať.
V Nastavenia, Gaelta Meranie zadajte ID webu a tajný kľúč z účtu (Inštalácia, Kľúč pre server e-shopu).
Zvoľte, akú hodnotu má mať nákup (s DPH a dopravou alebo bez) a aké ID produktu je vo vašom produktovom feede.
Ak máte PixelYourSite Pro alebo Meta for WooCommerce, vypnite v nich Conversions API. Pixel nechajte zapnutý.
Vyčistite cache (WP Rocket, LiteSpeed). Skript má značky, ktoré mu povedia, aby ho neodkladali.

Plugin pošle nákup aj zo servera e-shopu, keď objednávka prejde do zvoleného stavu. Pošle ho iba raz a iba so súhlasom, ktorý zákazník dal v cookie lište.

Shoptet

Administrácia, Vzhľad a obsah, Editor HTML kódu, Hlavička. Vložte riadok so skriptom na začiatok.
V Propojení, Sociální sítě, Facebook nechajte pixel. Token Conversions API zmažte, inak pôjdu nákupy do Meta dvakrát.
V účte v Nastaveniach zvoľte, či je ID produktu kód (SKU) alebo ID, podľa toho, čo posiela váš feed.

Nákup prečítame z údajov Shoptetu na stránke s poďakovaním (číslo objednávky, suma, produkty). E-mail ani telefón zákazníka tam Shoptet nedáva.

Upgates

Skript vložte do vlastného HTML kódu v hlavičke stránky, v administrácii Upgates v časti pre vlastné skripty. Doplnok Facebook s Conversions API v Upgates vypnite alebo zmažte token. Nákup prečítame z GA4 udalosti purchase, ak ju e-shop posiela do dataLayer.

Shopify

Riadok vložte do theme.liquid hneď za <head>. Pixel z aplikácie Facebook & Instagram beží v oddelenom okne (web pixel), skript ho nevidí. Na Shopify preto odporúčame pixel cez Google Tag Manager alebo priamo v šablóne. Nákup na stránke s poďakovaním (Checkout Extensibility) zatiaľ nepodporujeme.

Google Tag Manager

Ak vkladáte pixel cez GTM, skript Convertry dajte do hlavičky webu pred kód GTM. Funguje aj ako značka Vlastný HTML v GTM, ale musí sa spustiť skôr ako značka pixelu: nastavte jej vyššiu prioritu (napríklad 100) alebo použite poradie značiek. Pri udalostiach z dataLayer (napríklad prihláška) dajte značke pixelu ID udalosti z premennej, napríklad {{dlv - event_id}}, a to isté ID pošlite aj zo servera.

Vlastný web

Bez async a defer, za cookie lištou a pred pixelom. Vlastnú udalosť pošlete takto (vráti ID, ktoré dáte aj pixelu):

var id = gaeltaMeranie.track('generate_lead', { value: 20, currency: 'EUR' }); fbq('track', 'Lead', { value: 20, currency: 'EUR' }, { eventID: id });

Ak volanie fbq('track', …) robíte až po načítaní skriptu, ID doplní sám a track nepotrebujete.

Udalosti zo servera (API)

Nákupy, registrácie či predplatné, ktoré vznikajú mimo prehliadača (váš backend, CRM, platobná brána), pošlite na POST https://meranie.gaelta.com/s2s/<id-webu>. Telo je JSON, hlavičky x-gm-ts (unixový čas v sekundách) a x-gm-signature (HMAC-SHA256 z ts + "." + telo kľúčom pre server e-shopu, v hex). Dostupné v plánoch Štart a Pro.

{ "url": "https://vasobchod.sk/pokladna/", "ip": "203.0.113.9", "ua": "Mozilla/5.0 …", "consent": { "analytics": true, "marketing": true, "source": "gc_cookie" }, "cookies": { "_fbp": "fb.1.…", "_fbc": "fb.1.…", "_ga": "GA1.1.…" }, "user": { "em": "jana@example.sk", "ph": "0905123456", "country": "sk" }, "events": [{ "id": "purchase-1042", "name": "purchase", "ts": 1761200000000, "data": { "transaction_id": "1042", "value": 59.9, "currency": "EUR", "items": [{ "id": "77", "name": "Poukaz", "price": 59.9, "quantity": 1 }] } }] }

Súhlas pošlite taký, aký zákazník dal v cookie lište (napríklad zo zapamätanej cookie gc_consent). Bez neho neodíde nič. Osobné údaje môžete poslať aj ako hash SHA-256.

Kontrola

V účte v časti Inštalácia kliknite Overiť. Zistíme, či je skript na úvodnej stránke a pred pixelom.
V časti Pripojenia vložte kód Test Events a v Meta Events Manageri sledujte udalosti. Mali by mať zdroj Prehliadač aj Server a stav Deduplikované.
V časti Udalosti vidíte každú udalosť, ktorá prišla, a čo sa s ňou stalo.

Inštalácia krok za krokom