A Facebook Conversions API (CAPI) szerveroldali bekötése Shopify-on hírhedten macerás tud lenni — de ha az alapinfrastruktúra már megvan, akkor a tényleges CAPI-beállítás meglepően gyors. Ez az Analytics Mania videó pontosan ezt mutatja meg: a Stape Setup Assistant varázslójával és kész konténer-sablonokkal nagyjából 10 perc alatt összerakja a hibrid (böngésző + szerver) mérést, deduplikációval együtt.
Az alábbi összefoglaló magyarul, fejezetenként követi a videót, hogy el tudd dönteni, megéri-e végignézned, és hogy a saját beállításodhoz is legyen egy térképed. A cikk nem a kattintós leírás pótlása — azt a videó jobban megmutatja —, hanem a logika magyar átirata.
Előfeltétel: a Stape-alapnak már állnia kell
Fontos: ez egy gyors tutorial, ami feltételezi, hogy a szerveroldali GTM-infrastruktúra már fut nálad. Konkrétan: telepítve van a Stape Shopify-plugin, be van kötve a webes GTM-konténer ID-ja és az egyedi domain, engedélyezve van a Custom Loader és a Cookie Keeper, és létre van hozva a checkout követéséhez szükséges custom pixel. A szerző maga is jelzi, hogy ehhez van egy külön, részletes videója.
Előbb a szerveroldali tagging teljes beállítását érdemes elvégezned — ezt a Szerveroldali tagging Shopify-on Stape-pel cikk (és a benne beágyazott videó) veszi végig a nulláról: Stape-fiók, saját domain, plugin, konténer-sablonok. Ez a mostani, gyors CAPI-útmutató arra épül rá.
A gyors út: a Stape Setup Assistant
A lényeg egy varázsló a Stape felületén. A Setup Assistant végigkérdezi a beállításokat, és ez alapján előkészít egy konténer-sablont:
- Típus: e-commerce, platform: Shopify.
- Cookie consent: ha van támogatott consent-megoldásod, itt kiválaszthatod (a videóban nincs, ezért „no").
- Cél (destination): Meta.
- Szerver-konténer URL-je (amit a Stape-ben mappeltél).
- Pixel ID és CAPI token — mindkettőt a Facebook Events Managerében találod: a pixel ID a dataset Settings alatt (dataset ID), a CAPI tokent ugyanott a Conversions API → Generate Access Token gombbal.
A végén választhatsz automatikus import (a Stape hozzáférést kap a GTM-konténeredhez) vagy manuális import között — utóbbinál két konténer-fájlt töltesz le.
A konténer-sablonok kézi importja
Manuális importnál két fájlt kapsz: egyet a webes, egyet a szerver GTM-konténerhez.
- Webes konténer: admin → import container → a web-sablon fájlja → a meglévő (default) workspace → merge.
- Szerver-konténer: ugyanígy, a szerver-sablonnal.
Ha a konténered már tartalmaz elemeket, mindig a merge opciót válaszd — így a meglévő elemek megmaradnak, és csak az új sablon-elemek kerülnek be. Az override csak üres konténernél biztonságos.
Az importtal egy csomó változó, tag, trigger és sablon kerül a konténerekbe — ezek intézik a Meta felé menő mérést.
Ellenőrzés preview módban: a hibrid setup
A beállítás után jön a teszt. A szerver-konténerben és a webes konténerben is bekapcsolod a preview módot, majd böngészel a boltban (katalógus → termék → kosárba). Ekkor látszik a lényeg:
- A webes konténerből több esemény érkezik a szerver-konténerbe.
- A Facebook pixel tag tüzel a böngészőben, és a data tagek adatot küldenek a szerverre.
Ez a hibrid modell: a böngészős pixel adatát kombinálod a szerveroldali adattal — a redundancia miatt pontosabb és ellenállóbb a mérés.
Publikálás és a deduplikáció ellenőrzése
A checkout eseményekhez publikálni kell a webes GTM-konténert (a Shopify checkout korlátai miatt). Utána a Facebook Test Events szekciójában ellenőrzöd a szerver-eseményeket:
- A Test Events ad egy test ID-t; ezt a szerver-konténer minden releváns tagjéhez be kell írni egyenként (payment info, purchase stb.).
- Beírod a bolt URL-jét, és lefuttatsz egy teljes vásárlást.
A cél, hogy a purchase eseménynél két esemény érkezzen — egy a böngészőből, egy a szerverről —, azonos event ID-val. Ha az event ID egyezik, a Facebook deduplikál, vagyis nem számolja duplán a konverziót. Ez a helyes működés jele.
A Test Events néha nem írja ki külön, hogy „deduplicated" — ez önmagában nem baj. Ami számít: a böngészős és a szerveroldali esemény event ID-ja megegyezzen. Ha igen, a deduplikáció rendben van, függetlenül a felület címkéjétől.
Kulcs-tanulságok
- A gyorsaság titka a Setup Assistant: a Stape varázslója előre elkészített web- és szerver-sablonokat generál, így nem kézzel építed fel a CAPI-mérést.
- Hibrid mérés: a böngészős Facebook pixel és a szerveroldali CAPI együtt fut — a kettő együtt pontosabb, mint bármelyik önmagában.
- A deduplikáció a közös event ID-n múlik — ezt ellenőrizd a Test Eventsben, ne a felület „deduplicated" címkéjét.
- A checkouthoz publikálni kell a webes konténert, és a szerver-tagekbe be kell írni a test ID-t a teszteléshez.
- Ez egy gyors út, nem alapozó: a Stape-plugin és a szerver-konténer megléte előfeltétel.
Ha a méréshez a Meta-oldalt is rendbe tennéd, nézd meg a Meta Pixel és Conversions API beállítása Shopify-on cikket, a GA4-alapokhoz pedig a Google Analytics 4 bekötése Shopify-ra útmutatót. Ha duplikált eventekkel küzdesz, a Shopify GA4 hibakeresés cikk segít.
Forrás
Az eredeti (angol nyelvű) videó az Analytics Mania csatornától származik, a bemutatót Julius készítette. A teljes, lépésről lépésre kattintós beállításhoz nézd meg a fenti beágyazott videót — ez a cikk a gondolatmenet magyar összefoglalója, nem az eredeti tartalom pótlása.
Gyuri
Hugyecz György – keresőoptimalizálási szakértő és a TotalStudio egyik tulajdonosa. Weboldalaknál és webáruházaknál elsősorban SEO-val, tartalomfejlesztéssel és technikai auditokkal foglalkozik, emellett fizetett hirdetésekkel (Google Ads, Meta), szövegírással és általános tanácsadással is; aktívan érdeklődik és használja a különböző AI-megoldásokat.
Profil
