Kezelési útmutató
A GA4 Insights egy böngészőben futó, egyfájlos audit eszköz. Egy weboldal címéből megnézi a GA4, Google Tag Manager, Google Ads, Meta Pixel és Consent Mode beállításokat, alap SEO és technikai auditot készít, saját AI API kulccsal pedig részletes auditot és online marketing javaslatokat is ad.
Az adataid a böngésződben maradnak. Nincs regisztráció és nincs saját szerver: az elemzések, a beállítások és az AI kulcs csak ebben a böngészőben tárolódnak. Részletek: Adatkezelés és biztonság.
Letöltött változat. Az app üresen indul, vagy – ha a letöltéskor már voltak – a saját elemzéseiddel és beállításaiddal (az AI kulcsot újra meg kell adnod). Az index.html és ez az útmutató maradjon ugyanabban a mappában.
DEMÓ Az online változat megnyitáskor egy kitalált adatokon alapuló mintaelemzést tölt be
(pelda-webshop.hu). Az abban látható AI részek előre elkészített minták, nem valódi AI-futás eredményei.
Gyors kezdés 3 lépésben ↑ fel
- Nyisd meg az appot Kattints duplán az index.html fájlra – a böngésződben nyílik meg, telepíteni nem kell.
- Nézd meg a demót Az online változat magától megnyit egy kitalált mintaelemzést – így látod, mit kapsz.
- Elemezz egy saját oldalt Írd be a címet a mezőbe, és nyomd meg az Elemzés indítása gombot. Ehhez nem kell kulcs.
- Kapcsold be az AI-t Beállítások → add meg a saját (akár ingyenes Gemini) kulcsodat → Mentés.
1 Demó megnézése ↑ fel
Az online változat tetején egy sárga DEMÓ sáv látható. Ha még nincs saját elemzésed, az app megnyitja a mintaelemzést.
- A mintaelemzés fejlécén és az Előzmények listában DEMÓ címke jelzi, hogy kitalált adat.
- A Részletes audit és az Online marketing elemzés fejlécén a Mintaelemzés (előre generált) címke látszik.
- A minta a kézi mód segítségével készült, ezért benne a Mély SEO vizsgálat nem futtatható – egy saját, URL-ből indított elemzésnél igen.
A sáv gombjai
| Gomb | Mit csinál |
|---|---|
| Letöltés | Letölti az appot egy ga4-insights-app.zip csomagban: az üres eszköz a saját mentett elemzéseiddel és beállításaiddal (az AI kulcs és a mintaelemzés nélkül), valamint ez az útmutató. Kicsomagolás után az index.html megnyitásával indul. |
| Útmutató | Megnyitja ezt az útmutatót az appon belül, teljes képernyős nézetben. A ✕ Bezárás gombbal, az Esc billentyűvel vagy a ← Vissza az apphoz gombbal zárható. |
| Ingyenes Gemini kulcs ↗ | Új lapon megnyitja a Google AI Studio kulcsoldalát (lásd: AI kulcs beállítása). |
| Kulcs megadása | Megnyitja a Beállítások ablakot, ahol a kulcsot megadhatod. |
A mintaelemzést az Előzmények listában a ✕ gombbal törölheted, de az oldal következő megnyitásakor visszakerül. Ha már van saját elemzésed, a demó nem nyílik meg magától.
2 Saját elemzés indítása URL-ből ↑ fel
- Kattints felül az Elemzés fülre.
- (Opcionális) Az Ügyfél: sávban válaszd ki vagy vedd fel az ügyfelet (+ Új ügyfél). Ügyfél nélkül a riport ügyfélnév nélkül készül.
- Írd be a vizsgálandó oldal címét a mezőbe, pl.
pelda.huvagyhttps://pelda.hu/oldal. - Kattints az Elemzés indítása gombra. Menet közben a ■ Leállítás gombbal megszakíthatod.
- Az eredmény az űrlap alatt jelenik meg, és automatikusan bekerül az Előzmények közé.
Honnan jön az oldal? A böngésző biztonsági okból (CORS) nem tölthet le szabadon idegen oldalt. Az app ezért először közvetlenül próbálkozik, majd a beépített proxyn keresztül (ehhez nem kell semmit beállítani), végül nyilvános proxy szolgáltatásokon. Ha így sem sikerül, a hibaüzenetben megjelenik a ⌨ Váltás kézi módra és a Proxy beállítások gomb.
A sikertelen vagy leállított próbálkozás is bekerül az Előzmények közé; megnyitva az Újrapróbálom gombbal indíthatod újra.
Kézi mód – forrás beillesztése ↑ fel
Ha az oldal nem tölthető le, a kézi mód mindig működik, mert nem kell hozzá hálózat.
- Kattints az URL mező alatti ⌨ Kézi mód — forrás beillesztése (nem kell hozzá hálózat) gombra.
- Nyisd meg a vizsgálandó oldalt egy másik lapon, és nyisd meg a forráskódját: Ctrl/Cmd + U (Safariban: Fejlesztés → Forrás megtekintése).
- Jelöld ki és másold ki az egészet: Ctrl/Cmd + A, majd Ctrl/Cmd + C.
- Töltsd ki A vizsgált oldal címe mezőt, és illeszd be a kódot Az oldal forráskódja mezőbe – vagy tölts be egy mentett HTML fájlt.
- Kattints az Elemzés a beillesztett forrásból gombra.
Kézi módban a robots.txt, a sitemap és a HTTP fejlécek nem vizsgálhatók, és a Mély SEO vizsgálat sem érhető el; ezt az eredmény kézi mód címkéje jelzi.
3 AI kulcs beállítása (ingyenes Gemini) ↑ fel
Az alap audit, a Mély SEO vizsgálat, a GTM konténer-elemzés, a mérési specifikáció és az UTM eszköz kulcs nélkül is működik. A Részletes audit és az Online marketing elemzés gombjai viszont csak AI kulccsal aktívak.
A. Kulcs igénylése
- Nyisd meg: aistudio.google.com/apikey (a sáv Ingyenes Gemini kulcs ↗ gombja is ide visz).
- Jelentkezz be a Google-fiókoddal, és hozz létre egy új API kulcsot (Create API key).
- Másold ki a kulcsot. Jellemzően
AIza…kezdetű.
B. Kulcs megadása az appban
- Kattints a Beállítások gombra a felső menüben (vagy a sáv Kulcs megadása gombjára). Az AI szolgáltató fül nyílik meg.
- Az AI szolgáltató listában válaszd a Google Gemini lehetőséget. A modell mező ekkor kitöltődik az alapértelmezett modellel (
gemini-2.5-pro). - Illeszd be a kulcsot az API kulcs mezőbe.
- (Opcionális) A Modell sorban a Lista gombbal lekérheted az elérhető modelleket, és választhatsz közülük; vagy beírhatod a modell azonosítóját kézzel.
- (Opcionális) Hagyd bekapcsolva a Webes keresés engedélyezése jelölőt – ez kell a megbízhatóbb konkurenselemzéshez.
- Kattints a Kapcsolat teszt gombra. Ha minden rendben, ezt látod: ✓ A kapcsolat működik.
- Kattints a Mentés gombra.
A többi szolgáltató is választható: Claude (Anthropic), OpenAI, OpenRouter (sok modell, egy kulcs) és Egyéb OpenAI-kompatibilis végpont. Az API kulcs mező alatt mindig ott a link, ahol az adott szolgáltatónál kulcsot igényelhetsz.
A kulcs csak ebben a böngészőben tárolódik, és közvetlenül a választott szolgáltatóhoz megy – nincs köztes szerver. Közös gépen ne mentsd el.
C. Kulcs eltávolítása
- Beállítások → AI szolgáltató fül.
- Töröld ki a teljes tartalmát az API kulcs mezőnek.
- Kattints a Mentés gombra. Az AI gombok ezután újra inaktívak.
Ha a kulcsot már nem használod, a szolgáltató oldalán (Geminihez: aistudio.google.com/apikey) is törölheted.
Az eredmény részei ↑ fel
Az eredmény felett az Ugrás: sáv a szekciókhoz visz; a számok a tételek darabszámát, a ✓ a már elkészült részt jelzi. Csak az a szekció látszik, amelyhez van tartalom.
Fejléc és pontszámok
- A fejléc a vizsgált címet, a HTTP állapotot, a válaszidőt és a felismert platformot mutatja. A proxy: … címke azt jelzi, hogy az oldal proxyn keresztül jött (beépített vagy nyilvános).
- Pontszámok 0–100 között: Összesített (osztályzattal), Mérés & hirdetés, SEO & technikai, Konverzió, valamint a megállapítások száma súlyosság szerint.
Platform-korlátok
Ha az app felismeri, hogy az oldal olyan rendszeren fut, amely bizonyos beállításokat nem enged, ezt külön kártyán jelzi. Az ilyen javaslatok nem hibák, és nem számítanak a pontszámba.
Mérési beállítások
A Detektált mérési beállítások táblázat a forráskódból felismert elemeket sorolja fel: Google Analytics 4, Google Tag Manager (és ha beolvasható, a konténer tartalma), Google Ads, Universal Analytics, Meta Pixel és események, Consent Mode, Cookie consent (CMP), Server-side GTM, dataLayer, GA4 e-commerce és konverziós események, egyéb eszközök.
Megállapítások
- Egy sorra kattintva lenyílik a részletes leírás, a bizonyíték és a várható hatás.
- A fejléc gombjaival szűrhetsz súlyosság szerint: Kritikus Figyelmeztetés Lehetőség Rendben.
Mély SEO vizsgálat
A Mély vizsgálat indítása gomb a sitemapből mintát vesz, és több oldalt bejárva keres olyan hibákat, amelyek egy oldalból nem látszanak: duplikált címek és leírások, hiányzó H1, vékony tartalom, canonical eltérés, törött belső linkek, www/nem-www duplikáció, soft-404. Kulcs nem kell hozzá, de percekig is tarthat; bármikor leállítható, a részeredmény megmarad. A bejárt oldalak és linkek számát a Beállítások → Vizsgálat fülön állíthatod.
GTM konténer-elemzés
Kívülről csak az látszik, hogy a GTM betöltődik; a tartalmát a konténer exportjából elemzi az app.
- Google Tag Manager → Admin → Konténer exportálása.
- Válaszd ki a verziót (jellemzően a legutóbb publikáltat) → Exportálás.
- A letöltött
.jsonfájlt töltsd fel a GTM konténer-elemzés kártyán.
A fájl nem töltődik fel sehova, a böngésződ dolgozza fel. Később a Másik konténer gombbal cserélheted, a Törlés gombbal eltávolíthatod.
Részletes audit és marketing elemzés ↑ fel
Mindkettőhöz AI kulcs kell (beállítás). Kulcs nélkül a Részletes audit készítése és a Marketing elemzés készítése gomb inaktív.
Részletes audit
- Gomb: Részletes audit készítése.
- Az alap auditot értelmezi és kiegészíti: vezetői összefoglaló, mérési érettség, Javasolt mérési terv eseményszinten, Ütemterv és További megállapítások.
- Az ütemterv fázisainál a ↗ Things gomb az adott fázis feladatait küldi a Things 3-ba.
Online marketing elemzés
- Gomb: Marketing elemzés készítése. Előtte a További kontextus (opcionális) mezőben megadhatsz pontosító információt (pl. B2B, csak a magyar piac számít).
- Részei: 1 Optimalizációs lehetőségek (csatornák, tartalmak, tartalomtípusok), 2 TOP5 konkurens és összehasonlítás, a javasolt teendők pedig a Feladatok kártyára kerülnek.
- A konkurenskutatás a webes keresésre támaszkodik; ha a keresés ki van kapcsolva, a konkurensek megbízhatatlanok lehetnek – ezt az app is jelzi.
A futás percekig is tarthat (a marketing elemzés jellemzően 1–3 percig), közben a Leállítás gombbal megszakítható. Kész elemzésnél az Újragenerálás gomb készít újat.
Feladatok és Things 3 ↑ fel
A Feladatok kártya egy listában gyűjti a teendőket az alap auditból, a részletes auditból és a marketing elemzésből, P1–P3 prioritás szerint rendezve. A Részletek alatt a leírás és az alfeladatok olvashatók.
- Kijelölés: Mind kijelöl, Kijelölés törlése, Csak P1, vagy egyenként a jelölőnégyzettel.
- ↗ Kijelöltek a Things 3-ba: a kijelölt feladatok új Things projektként kerülnek át.
- ↗ Things egy feladat mellett: csak azt az egyet küldi a Things Inboxába.
A Things 3 küldéshez a Things 3 alkalmazásnak telepítve kell lennie azon az eszközön, ahol a böngésző fut. Ha nem használod, a feladatokat CSV-ben is kiexportálhatod (Exportok).
Eszközök: mérési specifikáció és UTM ↑ fel
Mérési specifikáció
Fejlesztőnek átadható dokumentum arról, milyen dataLayer eseményeket kell küldeni, milyen paraméterekkel és mikor – az oldal típusához igazítva.
- Megnézem – megjeleníti az oldalon (hány esemény van meg és hány hiányzik).
- Letöltés (.md) – Markdown fájlként menti.
- Things 3-ba – a hiányzó események bevezetését feladatként küldi át.
UTM építő és ellenőrző
A Megnyitom gomb három fület nyit:
- Építő – a
utm_source,utm_medium,utm_campaign(és opcionálisanutm_content,utm_term) mezőkből összerakja a kampány URL-t. - Ellenőrző – soronként egy meglévő kampány URL-t ellenőriz (kis-nagybetű, szóköz, ékezet, hiányzó mező, self-referral).
- Konvenció – javasolt UTM elnevezési szabályok, Letöltés (.md) gombbal.
Előzmények és ügyfelek ↑ fel
Előzmények
- Az Előzmények fülön a korábbi elemzések listája látható pontszámmal, dátummal és címkékkel (pl. mély, részletes, marketing).
- Egy sorra kattintva az elemzés újra megnyílik; a ✕ gomb törli.
- Az elemzések száma nincs korlátozva, és az app magától egyet sem töröl. Ha viszont a böngésző adatait törlöd, velük együtt az elemzések is elvesznek – amit meg akarsz tartani, exportáld.
Ügyfelek
- Az Elemzés fülön az Ügyfél: sávban a + Új ügyfél gombbal vehetsz fel ügyfelet (név és opcionálisan Things 3 Area), a listából pedig kiválaszthatod az aktuálisat.
- Az elemzés a kiválasztott ügyfélhez készül: a neve megjelenik az eredmény fejlécében és a riportokban.
- Az ügyfeleket a Beállítások → Riport & Things fülön kezelheted (Things Area módosítása, törlés).
Exportok ↑ fel
Egy elemzés exportja (az eredmény alján, Export kártya)
| Gomb | Eredmény |
|---|---|
| PDF (nyomtatási nézet) | Nyomtatási nézetet nyit, és elindítja a nyomtatást. PDF-hez válaszd a „Mentés PDF-ként” célt (Cmd/Ctrl + P). A nézetből a Nyomtatás / PDF és a Bezárás gombbal lépsz tovább. |
| Markdown | A teljes riport .md fájlban. |
| Feladatok CSV | A feladatlista táblázatként (Excelben megnyitható). |
| Megállapítások CSV | A megállapítások táblázatként. |
| Things JSON | A feladatok Things projektként, JSON fájlban. |
| Teljes JSON | Az elemzés összes adata. |
Az összes elemzés exportja
Az Előzmények fülön, az Összes exportálása: sorban: Összefoglaló CSV, Feladatok CSV, Megállapítások CSV, Markdown, JSON.
Saját arculat a riporton
A Beállítások → Riport & Things fülön megadhatod a Készítő (ügynökség / saját név) nevet és egy Logó a riportra képet (max. 300 KB). Ezek a PDF és a Markdown riport fejlécében jelennek meg; a logót a böngésző menti el, nem töltődik fel sehova.
Beállítások áttekintése ↑ fel
| Fül | Mit állíthatsz |
|---|---|
| AI szolgáltató | Szolgáltató, API kulcs, modell (Lista), webes keresés, Kapcsolat teszt. |
| Letöltés | Saját proxy (nem kötelező) megadása, útmutató saját ingyenes proxy készítéséhez, Proxy teszt futtatása. |
| Vizsgálat | A mély vizsgálat által bejárt oldalak és ellenőrzött belső linkek száma. |
| Riport & Things | Készítő neve, ügyfelek, logó, Things 3 – alapértelmezett célterület (Area). |
A módosítások a Mentés gombbal lépnek életbe. A felső menü ◐ gombja világos és sötét téma között vált; alapból a rendszer beállítását követi. Az Útmutató gomb ezt az útmutatót nyitja meg az appon belül; a ✕ Bezárás gombbal, az Esc billentyűvel vagy a ← Vissza az apphoz gombbal zárható.
Adatkezelés és biztonság ↑ fel
| Adat | Hol van / hová megy |
|---|---|
| Beállítások, AI kulcs, ügyfelek, logó | A böngésző helyi tárolójában (localStorage), ezen az eszközön és ebben a böngészőben. |
| Elemzések (Előzmények) | Szintén a böngészőben, ezen az eszközön: a böngésző helyi adatbázisában (IndexedDB), darabszám-korlát nélkül. |
| A vizsgált oldal letöltése | Először közvetlenül a vizsgált oldalról; ha az nem engedi, a beépített proxyn (a GA4 Insights saját Cloudflare Workere) keresztül; ha az sem érhető el, nyilvános CORS proxy szolgáltatásokon (pl. allorigins, codetabs, cors.isomorphic-git). Ha megadtál saját proxyt, az a beépített elé kerül. Ilyenkor a vizsgált cím és az oldal tartalma áthalad az adott proxyn. Ugyanígy tölti le az app a robots.txt-t, a sitemapet, a GTM konténert és néhány külső szkriptet. |
| AI elemzés | Közvetlenül a választott szolgáltatóhoz megy (pl. Google Gemini), a te kulcsoddal. Az elemzés összesített adatai kerülnek elküldésre, köztes szerver nélkül. |
| GTM export, beillesztett forráskód | A böngésződben dolgozza fel az app, nem töltődik fel. |
- Közös vagy idegen gépen ne ments el AI kulcsot; használat után töröld (C. Kulcs eltávolítása).
- Ha egy kulcs nyilvánosságra került (pl. képernyőképen vagy e-mailben), töröld a szolgáltató oldalán, és igényelj újat.
- Érzékeny vagy nem nyilvános oldalt inkább kézi módban vagy saját proxyval elemezz, hogy ne haladjon át a beépített vagy egy nyilvános proxyn.
- Az elmentett elemzések (Előzmények), a beállítások és az AI kulcs csak a látogató saját böngészőjében tárolódnak, ezért az oldal más látogatói nem látják őket.
- A böngészőadatok törlése (cookie-k és webhelyadatok) az elemzéseket és a beállításokat is törli.
Gyakori kérdések és hibák ↑ fel
„Nem sikerült elemezni.” – nem töltődik le az oldal
A beépített proxynak napi kerete van (éjfélkor, UTC szerint újraindul), a nyilvános proxyk pedig időnként leállnak vagy korlátoznak. Lehetőségek:
- ⌨ Váltás kézi módra – illeszd be az oldal forráskódját (Kézi mód). Ez mindig működik.
- Proxy beállítások → Proxy teszt futtatása: megmutatja, melyik letöltési mód él most.
- Adj meg saját proxyt a Beállítások → Letöltés fülön (a fülön lépésenkénti leírás is van).
Szürke (inaktív) a Részletes audit vagy a Marketing elemzés gombja
Nincs beállítva AI kulcs vagy modell. (Az egérmutatót a gomb fölé víve ezt látod: „Nincs API kulcs”.) Állítsd be a 3. pont szerint, majd kattints a Mentés gombra.
Hibát ad az AI elemzés
- Nyisd meg a Beállítások ablakot, és futtass Kapcsolat tesztet – a hibaüzenet megmutatja az okot.
- Ellenőrizd, hogy a kulcs a kiválasztott szolgáltatóhoz tartozik-e, és hibátlanul (szóköz nélkül) van-e bemásolva.
- Ellenőrizd a modellt: a Lista gombbal válassz olyat, amelyet a kulcsod elér.
- Ha a hiba keretre vagy kvótára utal (az ingyenes kulcsnak korlátai vannak), várj egy kicsit, vagy válassz a listából egy könnyebb modellt.
Nem történik semmi a Things gombokra
A küldéshez a Things 3 alkalmazásnak telepítve kell lennie azon az eszközön, ahol a böngésző fut. Nélküle használd a Feladatok CSV exportot.
Nem jelenik meg a PDF
A PDF (nyomtatási nézet) a böngésző nyomtatási ablakát nyitja meg. Ott a célnál válaszd a „Mentés PDF-ként” lehetőséget. Ha az ablak nem jött fel, a nyomtatási nézetben kattints a Nyomtatás / PDF gombra.
Eltűntek a beállításaim vagy az elemzéseim
Az adatok böngészőnként és címenként külön tárolódnak: más böngészőben vagy privát ablakban nem látszanak. A böngészőadatok törlése is eltávolítja őket. Fontos elemzést exportálj.
Miért nem futtatható a Mély SEO vizsgálat?
Kézi módban (és így a demóban) nem érhető el, mert több oldal letöltését igényli. URL-ből indított elemzésnél elérhető.
Mit tartalmaz a letöltött csomag?
A sáv Letöltés gombja egy ga4-insights-app.zip fájlt ment: benne az üres eszköz (index.html) és ez az útmutató. Ha ebben a böngészőben már vannak saját elemzéseid és beállításaid, azok is bekerülnek, és a letöltött app első megnyitásakor betöltődnek – az AI kulcs és a mintaelemzés nem kerül bele.
Visszajött a demó elemzés, pedig töröltem
Az online változat minden megnyitáskor visszateszi a mintaelemzést az Előzmények közé. A saját elemzéseidet nem érinti.