A gtag.js kódrészlet
Ha az analytics.js kódot használja a Universal Analytics-tulajdonhoz, akkor hozzá kell adnia a gtag.js kódrészletet az új Google Analytics 4-tulajdonhoz. A gtag.js kódrészlet szerkezete a következő:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></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>
7. sor: A gtag „config” utasítása teszi lehetővé az adatgyűjtést a <Some Property ID A> azonosítóhoz társított tulajdon számára. Ha például egy Google Analytics 4-tulajdonhoz hozzáadja 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ó különféle Google-termékeket jelezhet, például UA-tulajdont („UA-XXXXXXXX”), Google Analytics 4-tulajdont („G-XXXXXXXX”), illetve a Google Ads („AW-XXXXXXXX”) vagy a Floodlight („DC-XXXXXXXX”) rendszerhez tartozót.
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 a különleges paraméter a társított eseményt egy adott tulajdonhoz „irányítja át”. Más szóval: ezt az eseményt csak a <B tulajdonazonosító> jelzéssel ellátott tulajdonnak küldi el a rendszer.
A Google Analytics 4-tulajdonhoz tartozó alapvető adatgyűjtés a gtag „config” utasításával engedélyezhető, és lehetővé teszi a „page_view” események automatikusan gyűjtött eseményként történő gyűjtését, amikor betöltődik az oldalon.
Az oldalmegtekintési lekérés és a page_view esemény adott paraméterekkel módosítható vagy letiltható.
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-tulajdonok webes adatfolyamai egy „G-XXXXXXXX” formátumú címkeazonosítót használnak.
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)
A Google Analytics 4-tulajdon alapvető adatgyűjtésének engedélyezéséhez vegye fel a gtag.js kódrészletet (a Google-címkét) az egyes oldalak <head> szakaszába.
A gtag.js kódrészlet és az analytics.js kódrészlet összehasonlítása
A gtag.js kódrészlet hasonló szerepet játszik a Google Analytics 4-tulajdonok esetében, mint az analytics.js a Universal Analytics-tulajdonoknál.
A két kódrészlet közötti legnagyobb különbség az, hogy az analytics.js külön „oldalmegtekintés küldése” kódot küld, a gtag.js kód pedig nem. A gtag.js kódban az oldalmegtekintés egy olyan, automatikusan gyűjtött esemény, amelyet a rendszer a „config” utasítással együtt küld el.
Universal Analytics-tulajdon (analytics.js)
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
Google Analytics 4-tulajdon (gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
A gtag.js konfigurációs beállításai
Akárcsak az analytics.js esetében, az alapvető gtag.js kódrészlet konfigurálásával felügyelheti az adatgyűjtési beállításokat (például az IP-cím maszkolását, a cookie testreszabásait és a Google-jeleket). Ezt a gtag.js „config” vagy „set” utasításával teheti meg (az analytics.js kódban erre a „set”, a „create” és a „require” utasítás szolgál).
A Google Analytics 4- tulajdonok („G-XXXXXXXX”) támogatják a hasonló konfigurációs beállítások gtag.js kódrészlettel való implementálá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 következőkre ügyeljen:
- A Google Analytics 4-tulajdonokban az IP-cím maszkolá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 gtag.js „set” parancsával kell alkalmazni az összes címkeazonosítót és/vagy tulajdonazonosítót.
- Fordítson különös figyelmet az olyan hirdetési funkciókra, illetve a hirdetések személyre szabására szolgáló olyan funkciókra, amelyek használhatók az analytics.js kódrészletben, és amelyeket általában „set” sorban szoktak implementálni.
Ha az analytics.js aktuális implementációjában „set”, „create” vagy „require” utasítást használ, ellenőrizze, hogy melyik utasításokat állítja be a rendszer automatikusan a Google Analytics 4-tulajdonokban, és melyeket kell meghatározni a Google Analytics 4-tulajdon kódjában (paraméter társításával).
Az alábbi részen az analytics.js (UA-tulajdonokhoz) és a gtag.js (Google Analytics 4-tulajdonokhoz) néhány példabeállítása, illetve a hozzájuk tartozó kódminták láthatók:
Az alapvető adatgyűjtés engedélyezése; a User-ID-beállítása
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
A cookie-beállítások konfigurálása
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.
});
gtag.js
gtag('config', 'TAG_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', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Címkenevek
Ha az analytics.js kódrészletben több Universal Analytics-tulajdonnak szeretne adatokat küldeni, akkor címkeneveket (más néven „követőket”) kell használni. Az analytics.js kódrészletben a követők határozzák meg, hogy melyik tulajdonnak szeretné elküldeni az adatokat. A kezdeti „create” lekérés után következő lekérések esetében elég megadni a követő nevét; a Universal Analytics-tulajdonazonosítót már nem kell.
A gtag.js kódrészletben sem Google Analytics 4-tulajdonokhoz, sem Universal Analytics-tulajdonokhoz nem használhatók követők. Ha több tulajdonnak is (Google Analytics 4-tulajdon esetében különböző adatfolyamoknak) szeretné elküldeni az összes lekérést, akkor a „config” sorban az összes címke- vagy tulajdonazonosítót meg kell adnia.
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 további információkkal bővítik ki a webhelyen végzett méréssel és az offline adatok (például ügyfélkezelési rendszerekből történő) importálásával összeállított adatkészletet. A Universal Analytics-tulajdonokban („UA-XXXXXXXX” ) az egyéni dimenziókat és mutatókat a kezelőfelületen kell létrehozni, és az implementálásuk vagy importálásuk előtt azonosítót kell hozzájuk rendelni. A következő négy hatókörrel hozhatók: lekérés, munkamenet, felhasználó, termék.
A Google Analytics 4-tulajdonokban („G-XXXXXXXX”) az egyéni dimenziók és mutatók használati esetét másképpen kell implementálni. Az UA-tulajdonban az analytics.js kódrészlettel implementált egyéni dimenziók és mutatók mérését a Google Analytics 4-tulajdonban újra kell implementálni.
A Universal Analytics-tulajdonok egyéni dimenziója a következőképpen implementálható az analytics.js kódrészlettel:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
VAGY
ga('set', 'dimension5', 'custom data');
Ezeket az egyéni dimenziókat a következőképpen fordíthatja le a Google Analytics 4-tulajdonok számára a gtag.js segítségével:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
VAGY
gtag('set', {'dimension5': 'custom data'});
Két kikötés van:
- A paraméterek csak akkor jelennek meg a jelentésekben, ha regisztrálja őket a kezelőfelületen. A folyamat hasonló az egyéni dimenziók Universal Analytics rendszerben történő regisztrálásához (bizonyos korlátozások érvényesek). Ha csak megtekinti az exportált adatokat, vagy ha csak közönség aktiválásához szeretné használni a paramétert, nem kell regisztrálnia a paramétereket.
- Az egyéni paraméterek hatóköre (hasonlóan a lekérések hatóköréhez) mindig eseményszintű. Ez az eredeti egyéni dimenzió hatókörének beállításaitól függetlenül azokra az egyéni dimenziókra is vonatkozik, amelyeket a rendszer automatikusan paraméterekre fordít le (a gtag.js „UA-XXXXXXXX” implementációi során).
Az egyéni mutatóknál ugyanez a társítás használatos, illetve ugyanezek a szempontok érvényesek – annyi különbséggel, hogy a jelentéskészítéshez történő regisztráció során az ilyen mutatók a numerikus paraméterekre vonatkozó korlátozásokba számítanak bele, nem a szöveges paraméterekre vonatkozókba.
A Universal Analytics-tulajdonok különféle hatókörű egyéni dimenzióit és mutatóit fogalmilag a következőképpen társítja a rendszer a Google Analytics 4-tulajdonokhoz:
- Lekérés-hatókörű egyéni dimenzió: paraméter (eseményenként összesen legfeljebb 25 naplózott paraméter az adatgyűjtés során; legfeljebb 50 egyéni dimenzió/50 egyéni mutató)
Ügyeljen rá, hogy a rendszer olyan használati esetekben, amelyeknél korábban lekérés-hatókörű egyéni dimenziókat használt volna, automatikusan gyűjtött eseményeket és paramétereket alkalmazhat. - Felhasználó-hatókörű egyéni dimenzió: felhasználói tulajdonságok (a jelentéskészítéshez legfeljebb 25 regisztrálható a kezelőfelületen). Az automatikusan gyűjtött felhasználói tulajdonságok nem számítanak bele ebbe a korlátba.
- Munkamenet-hatókörű egyéni dimenzió: nincs megfelelője a Google Analytics 4-tulajdonokban. Használjon helyettük egyéni paramétereket vagy felhasználói tulajdonságokat.
A felhasználói tulajdonságok használatának bevált módszerei
A felhasználói tulajdonságok úgymond tapadnak egy adott felhasználóhoz a különböző platformokon (pl. az összes adatfolyam-típuson), ezért csak akkor használhatók, ha az adatoknak felhasználói szinten kell érvényesülniük. A felhasználói tulajdonságok nem használhatók munkamenet- vagy eszközszintű adatokhoz (például képernyőmérethez).
Példa egy Google Analytics 4-tulajdonra
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});