O delčku kode gtag.js
Če za trenutno znamko Universal Analytics uporabljate delček kode analytics.js, boste morali za svojo novo znamko Google Analytics 4 dodati delček kode gtag.js. Delček kode gtag.js ima naslednjo strukturo:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<ID neke znamke A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<ID neke znamke A>');
08:
09: gtag('config', '<ID neke znamke B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<ID neke znamke B>' });
14:
15: </script>
7. vrstica: Ukaz »config« za gtag omogoča zbiranje podatkov za znamko, povezano z <ID-jem neke znamke A>. Če na primer dodate ta ukaz z ID-jem oznake za znamko Google Analytics 4, se bodo dogodki page_view pošiljali v to znamko.
ID znamke lahko predstavlja različne Googlove izdelke, vključno z znamko UA (»UA-XXXXXXXX«), znamko Google Analytics 4 (»G-XXXXXXXX«), Google Ads (»AW-XXXXXXXX«) ali Floodlight (»DC-XXXXXXXX«).
11. vrstica: Ukaz »event« za gtag pošlje dogodek. V delčkih z več ukazi »config« za več znamk se dogodek pošlje v vse znamke.
V tem primeru je parameter »sign_up« ime dogodka. Zadnji parameter je predmet, ki vsebuje nabor parametrov dogodka. V tem primeru je »method« parameter z vrednostjo »email«.
13. vrstica: Dogodek v tej vrstici ima parameter »send_to«. To je poseben parameter, ki povezani dogodek »usmeri« v določeno znamko. Drugače povedano, ta dogodek bo poslan samo v znamko, ki jo določa <ID neke znamke B>.
Osnovno zbiranje podatkov za znamko Google Analytics 4 je omogočeno prek ukaza »config« za gtag, pri čemer omogoča zbiranje dogodkov »page_view« kot dogodka, ki se zbira samodejno, ko se naloži na strani.
Zadetek ogleda strani ali dogodek »page_view« lahko spremenite ali blokirate z določenimi parametri.
Identifikatorji znamk
ID-ji znamk Universal Analytics imajo obliko »UA-XXXXXXXX«. To se včasih imenuje tudi ID za sledenje. V tem vodniku ga bomo imenovali ID znamke UA.
Podatkovni tokovi spletnega mesta za znamke Google Analytics 4 uporabljajo ID oznake v obliki »G-XXXXXXXX«.
V nekaterih primerih kode in v dokumentaciji se lahko oba imenujeta »TAG_ID«.
Zbiranje osnovnih podatkov
Če omogočite zbiranje osnovnih podatkov za znamko Google Analytics 4, s tem omogočite zbiranje naslednjih podatkov:
- dogodke »page_view«,
- dogodke, ki se zbirajo samodejno,
- dogodke izboljšane meritve (če so omogočeni v uporabniškem vmesniku).
Če želite omogočiti osnovno zbiranje podatkov za znamko Google Analytics 4, dodajte fragment kode gtag.js (Googlovo oznako) v razdelek <head> na vsaki strani.
Primerjava delčkov kode gtag.js in analytics.js
Delček kode gtag.js za znamko Google Analytics 4 ima podoben namen kot delček kode analytics.js za znamko Universal Analytics.
Največja razlika med tema delčkoma kode je, da koda analytics.js vključuje ločen klic »send pageview«, koda gtag.js pa ne. V kodi gtag.js je ogled strani dogodek, ki se zbira samodejno in se pošilja z ukazom »config«.
Znamka Universal Analytics (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>
Znamka Google Analytics 4 (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>
Nastavitve konfiguracije za gtag.js
Konfigurirate lahko osnovni fragment kode gtag.js in s tem upravljate nastavitve zbiranja podatkov, kot so maskiranje IP-jev, prilagoditve piškotkov in signali iz Googla, podobno kot pri kodi analytics.js. V kodi gtag.js to izvedete prek ukaza »config« ali »set« (v kodi analytics.js pa prek ukazov »set«, »create« in »require«).
Znamke Google Analytics 4 (»G-XXXXXXXX«) podpirajo implementacijo podobnih nastavitev konfiguracije prek kode gtag.js. Vendar pa obstaja nekaj razlik med temi nastavitvami za znamke Universal Analytics in znamke Google Analytics 4. Upoštevajte naslednje dejavnike:
- Maskiranje IP-jev je v znamki Google Analytics 4 standardno nastavljeno na »true« in ga ni mogoče konfigurirati. Zato je pri standardnem dogodku za znamko Google Analytics 4 (»G-XXXXXXXX«) naslov IP samodejno maskiran.
- Če je treba globalne nastavitve uveljaviti za vse konfigurirane znamke, v kodi gtag.js uporabite ukaz »set« za uveljavitev pri vseh ID-jih oznak in/ali ID-jih znamk.
- V kodi analytics.js bodite zlasti pozorni na oglaševalske funkcije in funkcije v zvezi s prilagajanjem oglasov, ki se najpogosteje implementirajo prek vrstice »set«.
Če v trenutni implementaciji s kodo analytics.js uporabljate zahteve »set«, »create« in »require«, preglejte, katere so samodejno nastavljene v znamki Google Analytics 4 in katere je treba navesti v kodi znamke Google Analytics 4 (preslikave parametrov).
Nekaj primerov konfiguracij z vzorci kode za analytics.js (za znamko UA) in gtag.js (za znamko Google Analytics 4) je opisanih v nadaljevanju:
Omogočanje osnovnega zbiranja podatkov; konfiguracija za User-ID
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Konfiguracija nastavitev piškotkov
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Čas v sekundah.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 dni, v sekundah
});
Blokiranje dogodka »page_view«
Če pri nalaganju kode »config« ne potrebujete pošiljanja dogodka »page_view« (npr. pri nalaganju iframe), lahko nastavitev »config« prilagodite tako, da blokira dogodek »page_view«. Predstavljajte si scenarij, v katerem se pošlje dogodek »page_view«, čemur sledi prijava uporabnika na spletno mesto. Za interakcijo prijave uporabite ukaz »config« za nastavitev ID-ja uporabnika, pri čemer ne želite poslati še enega dogodka »page_view«. Naslednja koda ponazarja, kako preprečiti pošiljanje dogodka »page_view«.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Imena oznak
Imena oznak (imenovana tudi sledilniki) se uporabljajo, če želite podatke pošiljati v različne znamke Universal Analytics v kodi analytics.js. V kodi analytics.js sledilniki določajo, v katero znamko želite pošiljati podatke. Zadetkom po začetnem zadetku »create« ni več treba navajati ID-ja znamke Universal Analytics, temveč samo ime sledilnika.
V kodi gtag.js niso na voljo sledilniki za znamke Google Analytics 4 ali Universal Analytics. Če želite vse zadetke poslati v več znamk (različni podatkovni tokovi v znamki Google Analytics 4), v vrstici »config« določite vse ID-je oznak ali ID-je znamk.
Dogodki
Več informacij najdete v vodniku za selitev dogodka.Razsežnosti in meritve po meri
Razsežnosti in meritve po meri se uporabljajo za razširitev podatkov, ki se merijo na spletnem mestu, in uvoz podatkov zunaj spleta, npr. iz sistemov CRM. V znamki Universal Analytics (»UA-XXXXXXXX«) je treba razsežnosti in meritve po meri ustvariti v uporabniškem vmesniku, dodeli se jim ID, nato pa jih lahko implementirate ali uvozite. Ustvariti jih je mogoče s štirimi različnimi obsegi – na ravni zadetka, seje, uporabnika in izdelka.
V znamki Google Analytics 4 (»G-XXXXXXXX«) je primer uporabe razsežnosti in meritev po meri implementiran na drugačen način. Razsežnosti in meritve po meri v znamki UA, implementirane prek kode analytics.js, je treba znova implementirati kot parametre v znamki Google Analytics 4.
Razsežnost po meri za znamko Universal Analytics je mogoče implementirati prek kode analytics.js na naslednji način:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ALI
ga('set', 'dimension5', 'custom data');
Te razsežnosti po meri je mogoče v znamko Google Analytics 4 prevesti prek kode gtag.js na naslednji način:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ALI
gtag('set', {'dimension5': 'custom data'});
Opozarjamo na dvoje:
- Parametri morajo biti registrirani v uporabniškem vmesniku, da so prikazani v poročilih. To je primerljivo z registracijo razsežnosti po meri v storitvi Universal Analytics (veljajo omejitve). Če si želite ogledati samo izvožene podatke ali parameter uporabiti samo za aktiviranje ciljne skupine, vam ga ni treba registrirati.
- Obseg parametrov po meri je vedno na ravni dogodka, kar je primerljivo z obsegom na ravni zadetka. To velja tudi za razsežnosti po meri, ki se samodejno prevedejo v parametre (za implementacije znamk »UA-XXXXXXXX« prek kode gtag.js), neodvisno od prvotne nastavitve obsega razsežnosti po meri.
Enake preslikave in dejavniki, ki jih je treba upoštevati, veljajo za meritve po meri, s to razliko, da se upoštevajo pri omejitvi števila številskih parametrov namesto omejitve števila besedilnih parametrov, kadar jih registrirate za poročanje.
Razsežnosti in meritve po meri z različnimi obsegi v znamki Universal Analytics se v znamko Google Analytics 4 preslikajo na naslednji način:
- Razsežnost po meri z obsegom na ravni zadetka: Parameter (skupaj največ 25 parametrov, zabeleženih na dogodek med zbiranjem podatkov; največ 50 razsežnosti po meri/50 meritev po meri).
Upoštevajte, da dogodki in parametri, ki se zbirajo samodejno , morda že zajemajo nekatere primere uporabe, v katerih so se prej uporabljale razsežnosti po meri z obsegom na ravni zadetka. - Razsežnost po meri z obsegom na ravni uporabnika: Lastnosti uporabnikov (največ 25 registriranih za poročanje prek uporabniškega vmesnika). Lastnosti uporabnikov, ki se zbirajo samodejno, se ne upoštevajo pri tej omejitvi.
- Razsežnost po meri z obsegom na ravni seje: Brez enakovredne vrednosti v znamki Google Analytics 4; namesto tega uporabite parametre po meri ali lastnosti uporabnikov.
Najboljši postopki za lastnosti uporabnikov
Lastnosti uporabnikov uporabnika spremljajo na različnih platformah (npr. v vseh vrstah podatkovnih tokov), zato jih uporabljajte samo, če želite podatke uporabiti na ravni uporabnika. Lastnosti uporabnikov ne uporabljajte za podatke na ravni seje ali naprave (npr. velikost zaslona).
Primer znamke Google Analytics 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'kontrabas',
season_ticketholder: 'true'
});