A Shopilot akkor tud igazán hasznos lenni, ha nemcsak a webshopod termékeit és rendeléseit látja, hanem a forgalmi adatokat is: honnan jönnek a látogatók, mely oldalak működnek jól, mennyit hoz egy-egy csatorna. Ehhez össze kell kötnöd a Shopilotot a Google Analytics 4-tulajdonoddal. Ez egyszeri beállítás, és ha végigmész az alábbi lépéseken, negyedóra alatt megvan.
Az összekötés két dolgot igényel: egy tulajdonazonosítót (ez mondja meg a Shopilotnak, melyik GA4-tulajdonból olvasson) és egy Google-szolgáltatásfiókot JSON-kulccsal (ezzel hitelesíti magát a Shopilot a Google felé). A szolgáltatásfiók lényegében egy „gépi felhasználó”, amelynek csak megtekintői jogot adsz a GA4-tulajdonhoz – így a Shopilot olvasni tudja a statisztikákat, de semmit nem tud módosítani.
Amire szükséged lesz
- Egy Google-fiók, amelyhez a webshopod GA4-tulajdona tartozik.
- Adminisztrátori jog a GA4-tulajdonon – a szolgáltatásfiókot csak így tudod hozzáadni. Ha a GA4-et egy ügynökség kezeli, kérd meg őket erre a lépésre.
- Kb. 10–15 perc.
1. lépés: másold ki a GA4-tulajdonazonosítót
- Nyisd meg a Google Analytics felületét, és a bal alsó sarokban kattints az Adminisztrálás (fogaskerék) menüre.
- A Tulajdonbeállítások szakaszban nyisd le a Tulajdon kártyát, és válaszd a Tulajdon részletei menüpontot.
- A jobb felső sarokban találod a TULAJDONAZONOSÍTÓ feliratot és mellette egy 9–10 jegyű számot, másolás ikonnal. Ezt másold ki.


Figyelj arra, hogy a tulajdonazonosító csak számokból áll (pl. 123456789). Ne keverd össze a mérési azonosítóval, amely „G-” előtaggal kezdődik – azt a webshop kódjába kell beilleszteni, a Shopilothoz viszont a tulajdonazonosító kell.
- Lépj át a Shopilot adminfelületére, nyisd meg a Webshop beállításai oldalt, és a Google Analytics 4 szakaszban illeszd be a számot a GA4-tulajdonazonosító mezőbe (csak a számokat, a „properties/” előtag nélkül). Még ne ments – előbb a JSON-kulcsra is szükség lesz.
2. lépés: hozz létre egy szolgáltatásfiókot a Google Cloudban
A Google Cloud Console nyelve fiókonként eltérhet, ezért a menüpontokat magyarul és zárójelben angolul is megadjuk.
- Nyisd meg a Google Cloud Console-t ugyanazzal a Google-fiókkal. Ha még soha nem használtad, először egy projektet kell létrehoznod – a felső sávban a projektválasztóra kattintva, az Új projekt (New project) gombbal. A neve tetszőleges, például „Shopilot”.
- A bal oldali menüben kattints az IAM és rendszergazda (IAM & Admin) menüre, azon belül a Szolgáltatásfiókok (Service accounts) pontra.
- Kattints a Szolgáltatásfiók létrehozása (Create service account) gombra.
- Adj neki egy nevet, például shopilot. Az azonosító automatikusan kitöltődik. Kattints a Létrehozás és folytatás (Create and continue) gombra.
- A szerepkörnél válaszd a Megtekintő (Viewer) szerepkört, majd Folytatás (Continue).
- A harmadik lépésben nincs teendőd, kattints a Kész (Done) gombra.




A listában megjelenik az új szolgáltatásfiók egy e-mail címmel, amely így néz ki: shopilot@a-projekted-neve.iam.gserviceaccount.com. Erre a címre később, az 5. lépésben lesz szükséged.
3. lépés: töltsd le a JSON-kulcsot
- A szolgáltatásfiókok listájában kattints a most létrehozott fiók e-mail címére.
- Válaszd a Kulcsok (Keys) fület.
- Kattints a Kulcs hozzáadása (Add key) legördülőre, majd az Új kulcs létrehozása (Create new key) pontra.
- Hagyd a JSON formátumot kiválasztva, és kattints a Létrehozás (Create) gombra. A böngésző automatikusan letölt egy
.json fájlt a gépedre – ezt fogod feltölteni a Shopilotba.


A JSON-fájl bizalmas: aki hozzáfér, az a szolgáltatásfiók nevében olvashatja a GA4-adataidat. Ne küldd el e-mailben, ne tedd közzé, és ne töltsd fel megosztott mappába.
4. lépés: engedélyezd a Google Analytics Data API-t
A szolgáltatásfiók önmagában még nem tud Analytics-adatokat lekérni – ehhez a projektben be kell kapcsolni a megfelelő API-t.
- A Cloud Console felső keresőmezőjébe írd be: Google Analytics Data API, és kattints a találatra (a „Marketplace” / „API-k és szolgáltatások” alatt jelenik meg).
- Kattints az Engedélyezés (Enable) gombra.

Ügyelj arra, hogy ugyanabban a projektben engedélyezd az API-t, amelyben a szolgáltatásfiókot létrehoztad. A projekt neve a felső sávban látszik.
5. lépés: adj hozzáférést a szolgáltatásfióknak a GA4-tulajdonhoz
Most „be kell engedned” a szolgáltatásfiókot a GA4-be, ugyanúgy, mintha egy kollégát adnál hozzá.
- Térj vissza a Google Analytics felületére, és kattints az Adminisztrálás menüre.
- A Tulajdonbeállítások szakaszban, a Tulajdon kártyán válaszd a Tulajdonhoz való hozzáférés kezelése menüpontot.
Fontos: a felületen két hasonló menüpont van. A Fiókhozzáférés kezelése (a Fiókbeállítások szakaszban) az egész Analytics-fiókra vonatkozik, a Tulajdonhoz való hozzáférés kezelése pedig csak az adott tulajdonra. A szolgáltatásfiókot elég – és érdemes is – a tulajdonhoz hozzáadni. Ezt a menüpontot csak az látja, akinek adminisztrátori joga van a tulajdonon.
- A jobb felső sarokban kattints a kék + ikonra, majd a Felhasználók hozzáadása pontra.
- Az e-mail mezőbe illeszd be a szolgáltatásfiók e-mail címét (a 2. lépésben létrehozott,
…@….iam.gserviceaccount.com végződésű címet). Ha nem másoltad ki, a Cloud Console Szolgáltatásfiókok listájából bármikor kimásolhatod.
- Szerepkörnek válaszd a Megtekintő lehetőséget – ennél több jogra a Shopilotnak nincs szüksége.
- Kattints a jobb felső sarokban a Hozzáadás gombra.


6. lépés: töltsd fel a JSON-kulcsot a Shopilotba, és ments
- Menj vissza a Shopilot adminfelületére, a Webshop beállításai oldal Google Analytics 4 szakaszába.
- Ellenőrizd, hogy a GA4-tulajdonazonosító mezőben ott van az 1. lépésben kimásolt szám.
- A Szolgáltatásfiók JSON-kulcsa mezőnél válaszd ki a 3. lépésben letöltött
.json fájlt.
- Kattints a Mentés gombra.
A Shopilot mentéskor rögtön ellenőrzi a kapcsolatot. Ha minden rendben, ezt az üzenetet látod: „A Google Analytics 4 integráció beállítva, a kapcsolat ellenőrizve.” Ettől kezdve a Shopilot Chatben rákérdezhetsz a webshopod forgalmi adataira, és a hirdetési költéseidhez is a valós GA4-bevétel alapján számolja a ROAS-t.
Ha valami nem működik
„A Google Analytics Data API le van tiltva a Google Cloud-projektben.”
A 4. lépés maradt ki, vagy másik projektben engedélyezted az API-t, mint amelyikben a szolgáltatásfiók van. Nyisd meg a letöltött JSON-fájlt egy szövegszerkesztőben: a project_id mező mondja meg, melyik projektben kell engedélyezni az API-t. Az engedélyezés után várj 5–10 percet, mielőtt újra mentenél.
Jogosultsági hiba (a szolgáltatásfiók hitelesítése sikeres, de nincs hozzáférése a tulajdonhoz)
A szolgáltatásfiók e-mail címe nincs hozzáadva Megtekintőként a GA4-tulajdonhoz (5. lépés). Ellenőrizd a Tulajdonhoz való hozzáférés kezelése listában, hogy szerepel-e benne a …iam.gserviceaccount.com cím – és hogy tényleg ahhoz a tulajdonhoz adtad hozzá, amelynek az azonosítóját megadtad.
A Shopilot nem talál adatot, vagy érvénytelen a tulajdonazonosító
Valószínűleg a „G-” kezdetű mérési azonosítót írtad be a tulajdonazonosító helyett, vagy a szám elé odakerült a „properties/” előtag. Az 1. lépés szerint másold ki újra a csak számokból álló tulajdonazonosítót.
A Google elutasította a hitelesítést a kulccsal
A JSON-kulcsot időközben törölted vagy letiltottad a Cloud Console-ban, esetleg nem a megfelelő fájlt töltötted fel. Készíts egy új kulcsot a 3. lépés szerint, és töltsd fel újra.
Ha ezek után is elakadsz, írj nekünk az info@eshop-gyorsan.hu címre – a hibaüzenetet és a képernyőképet mellékelve gyorsabban tudunk segíteni.