A gtag.js kódrészlet és a tulajdonazonosítók
A Universal Analytics-tulajdonok és a Google Analytics 4-tulajdonok gtag.js kódrészletei alapvetően megegyeznek. Mindkét kódrészlet szerkezete a következő:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<A tulajdonazonosító>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<A tulajdonazonosító>');
08:
09: gtag('config', '<B tulajdonazonosító>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<B tulajdonazonosító>' });
14:
15: </script>
1. sor: Ha a Universal Analytics-tulajdont a gtag.js kódrészlettel implementálta, akkor ez a kódsor már valószínűleg megtalálható a webhelyen. Az <A tulajdonazonosító> rész helyett az „UA-” karakterlánc és néhány szám jelenik meg. Ha a gtag.js kódrészletet a Google Ads rendszerhez vagy a Google Marketing Platform másik termékéhez implementálta, akkor ez a kódsor is szerepelhet a webhelyen, de ilyenkor az <A tulajdonazonosító> rész az „AW-” vagy a „DC-” karakterekkel kezdődik.
Ezt a gtag.js kódrészletet az <A tulajdonazonosító> által jelzett tulajdonazonosító (Google Analytics 4-tulajdonok esetében címkeazonosító) „vezérli”. Ez az alábbiak miatt fontos:
- Ha a sor már jelen van, nem kell másodszor is implementálni. Ekkor csak egy „config” sort kell hozzáadnia a címkeazonosító meghatározásához.
- Az ebben a sorban lévő tulajdonazonosító a gtag.js kódrészlet „vezérlője”. Ha a címkét Universal Analytics-tulajdonazonosító („UA-XXXXXXXX”) vezérli, akkor Ön úgy is tud mérési adatokat küldeni az összekapcsolt webhelycímkékkel a Google Analytics 4-tulajdonoknak, hogy nem vesz fel új kódot az oldalra.
7. sor: A gtag „config” utasítása teszi lehetővé az adatgyűjtést az <A tulajdonazonosítóhoz> társított tulajdon számára. Ha például egy Google Analytics 4-tulajdonhoz felveszi ezt az utasítást egy címkeazonosítóval, akkor a rendszer elküldi a page_view eseményeket az adott tulajdonnak.
A tulajdonazonosító mérési megoldásokat jelezhet a különböző Google-termékek esetén – például a Universal Analytics-tulajdonoknál („UA-XXXXXXXX”), a Google Analytics 4-tulajdonoknál („G-XXXXXXXX”), a Google Ads („AW-XXXXXXXX”) vagy a Floodlight („DC-XXXXXXXX”) rendszernél.
11. sor: A gtag „event” utasítása elküld egy eseményt. Az olyan kódrészletekben, amelyekben több tulajdonhoz több „config” utasítás tartozik, a rendszer az összes tulajdonnak elküldi az eseményt.
Ebben a példában a „sign_up” paraméter az esemény neve. Az utolsó paraméter az eseményparaméterek készletét tartalmazó objektum. Ebben az esetben a „method” paraméter értéke „email”.
13. sor: Az itt lévő eseményben a „send_to” szerepel paraméterként. Ez egy különleges paraméter, amely a társított eseményt elküldi egy adott tulajdon részére. Más szóval: ezt az eseményt csak a <B tulajdonazonosító> jelzéssel ellátott tulajdonnak küldi el a rendszer.
A gtag config utasítása lehetővé teszi az alapszintű mérést.
- Universal Analytics-tulajdon esetén a Universal Analytics-tulajdonazonosítóval ellátott „config” utasítás oldalmegtekintési lekérést küld.
- Google Analytics 4-tulajdon esetén a címkeazonosítót tartalmazó „config” utasítás (automatikusan gyűjtött eseményként) lehetővé teszi a „page_view” események gyűjtését, amikor betöltődik az oldalon.
Tulajdonazonosítók
A Universal Analytics-tulajdonazonosítók formátuma a következő: „UA-XXXXXXXX”. Ezt az azonosítót követőazonosítónak is szokták nevezni. Ebben az útmutatóban UA-tulajdonazonosítóként hivatkozunk rá.
A Google Analytics 4-tulajdon internetes adatfolyamai címkeazonosítót használnak. Az azonosító formátuma: „G-XXXXXXXX”.
Bizonyos példakódok és dokumentumok a „TAG_ID” elnevezést használják.
Alapvető adatgyűjtés
Ha a Google Analytics 4-tulajdonhoz engedélyezi az alapvető adatgyűjtést, akkor a rendszer a következőket gyűjti majd:
- page_view események
- automatikusan gyűjtött események
- továbbfejlesztett mérési események (ha engedélyezte a kezelőfelületen)
Ha a meglévő Universal Analytics-tulajdon gtag.js kódot használ az implementációhoz, akkor az alábbi módon engedélyezheti az alapvető adatgyűjtést a Google Analytics 4-tulajdon számára:
- 1. lehetőség: Új „config” utasítást ad hozzá a megfelelő címkeazonosítóval
VAGY - 2. lehetőség: Bekapcsolja az összekapcsolt webhelycímkéket (ha a gtag.js kódhoz használt implementáció lehetővé teszi)
A választott megoldás nincs hatással a meglévő Universal Analytics-tulajdonra, amely továbbra is folytatja az adatgyűjtést.
1. lehetőség: Új „config” utasítás hozzáadása
Ha az oldalon már van gtag.js kód, elég hozzáadni egy, a megfelelő Google Analytics 4-tulajdon mérési azonosítóját tartalmazó „config” utasítást. Az alábbi példában a 8. sort adtuk hozzá a meglévő gtag.js-implementációhoz. A sor a Google Analytics 4-tulajdon mérési azonosítójára hivatkozik. Ez page_view eseményeket küld az adott Google Analytics 4-tulajdonnak. Ezenkívül engedélyezi az automatikusan gyűjtött eseményeket és a továbbfejlesztett mérési eseményeket (ha Ön engedélyezte a továbbfejlesztett mérést) az adott Google Analytics 4-tulajdonban.1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Some Property ID A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
2. lehetőség: Az összekapcsolt webhelycímkék bekapcsolása
Összekapcsolt webhelycímkét a következő esetekben használhat:
- Annak az oldalnak, amelyen mérni szeretné a felhasználói tevékenységeket, egy Universal Analytics-tulajdon „vezérli” a gtag.js kódrészletét (azaz a gtag.js kódrészlet ezen sorában hivatkozott azonosító az „UA-” karakterlánccal kezdődik):
<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
(Az összekapcsolt webhelycímkék akkor is működnek, ha a meglévő gtag.js kódrészletet Google Analytics 4-tulajdon vezérli. Ez azonban csak akkor fordul elő, ha már implementált Google Analytics 4-tulajdont.)
- ÉS adminisztrátori hozzáféréssel rendelkezik a kódrészletben szereplő azonosító által hivatkozott Universal Analytics-tulajdonhoz.
A gtag.js konfigurációs beállításai
Az alapvető gtag.js kódrészlet konfigurálásával adhatja meg az adatgyűjtési beállításokat (például az IP-cím anonimizálását, a cookie-k testreszabásait és a Google-jeleket). Ezt a gtag.js „config” vagy „set” utasításával teheti meg.
A Universal Analytics-tulajdon („UA-XXXXXXXX”) és a Google Analytics 4-tulajdon („G-XXXXXXXX”) egyaránt támogatja a konfigurációs beállítások gtag.js kódrészlettel való megadását. Ezek a beállítások azonban néhány ponton eltérnek a Universal Analytics- és a Google Analytics 4-tulajdonok esetében.
- A Google Analytics 4-tulajdonokban az IP-cím anonimizálásának standardizált értéke „true”; a beállítás nem módosítható. Ennek megfelelően a rendszer automatikusan maszkolja az IP-címet a normál eseménnyel a Google Analytics 4-tulajdonra („G-XXXXXXXX”).
- Ha minden konfigurált tulajdon esetében globális beállításokat kell használni, akkor a „set” paranccsal kell alkalmazni az összes mérési azonosítót és/vagy tulajdonazonosítót (az összekapcsolt webhelycímkékkel implementáltakat is).
- Fordítson különös figyelmet a hirdetések személyre szabásának letiltására szolgáló funkciókra, amelyeket általában egy „config” sorban szoktak implementálni.
- Összekapcsolt webhelycímkék használata esetén: A gtag.js kódban a „config” utasítással megadott beállítások kizárólag az adott kódsorban lévő mérési azonosítóhoz társított tulajdonra vonatkoznak, és a rendszer nem küldi el őket automatikusan az összekapcsolt Google Analytics 4-tulajdonnak. Ha a beállításokat alkalmazni szeretné az összekapcsolt Google Analytics 4-tulajdonra:
- Hozzon létre külön „config” utasítást, és a mérési azonosítóra való hivatkozással alkalmazza a megfelelő Google Analytics 4-tulajdonra.
VAGY - A „set” utasítással konfigurálja a beállításokat. Ebben az esetben a beállítások az összes konfigurált tulajdonra érvényesek lesznek.
- Hozzon létre külön „config” utasítást, és a mérési azonosítóra való hivatkozással alkalmazza a megfelelő Google Analytics 4-tulajdonra.
Konfigurációs példák
Az alapvető adatgyűjtés engedélyezése; a User-ID-beállítása
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
A cookie-beállítások konfigurálása
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
A page_view események letiltása
Ha nem szeretne page_view eseményt küldeni a konfigurációs kód betöltésekor (ha például iframe-betöltést használ), akkor a konfigurációs beállítások között letilthatja a page_view eseményt. Vegyünk példaként egy olyan helyzetet, amikor a rendszer page_view eseményt küld, majd egy felhasználó bejelentkezik a webhelyre. A bejelentkezési művelethez egy „config” utasítással beállítja a User-ID-t, de nem szeretne másik page_view eseményt küldeni. A következő kód azt mutatja be, hogyan lehet megakadályozni a page_view esemény elküldését.
gtag('config', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Események
Tekintse meg az események áttelepítési útmutatóját.
Egyéni dimenziók és mutatók
Az egyéni dimenziók és mutatók az információk bővítésére, illetve az offline adatok (például ügyfélkezelési rendszerekből történő) importálására használhatók.
A Google-címke (gtag.js) használata esetén az egyéni dimenziókat és mutatókat a rendszer automatikusan lefordítja a paraméterekre, amennyiben Ön összekapcsolt webhelycímkéket vagy Google Analytics 4-tulajdonokat (pl. „G-XXXXXXXX”) használ.
További információk az egyéni dimenziókról és mutatókról.