O isječku gtag.js
Ako upotrebljavate analytics.js za svoj trenutačni Universal Analytics entitet, morat ćete dodati isječak gtag.js za novi Google Analytics 4 entitet. Isječak gtag.js ima sljedeću strukturu:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<ID nekog entiteta 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 nekog entiteta A>');
08:
09: gtag('config', '<ID nekog entiteta B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<ID nekog entiteta B>' });
14:
15: </script>
7. redak: gtag smjernica "config" omogućuje prikupljanje podataka za entitet povezan s <ID-jem nekog entiteta A>. Na primjer, dodavanje te smjernice s ID-jem oznake za Google Analytics 4 entitet poslat će događaje page_view u taj entitet.
ID entiteta može predstavljati različite Googleove proizvode, uključujući UA entitet ("UA-XXXXXXXX"), Google Analytics 4 entitet ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") ili Floodlight ("DC-XXXXXXXXX").
11. redak: gtag uputa "event" poslat će događaj. U isječcima u kojima postoji više uputa "config" za više entiteta, događaj će se poslati u sve entitete.
U ovom je primjeru parametar "sign_up" naziv događaja. Zadnji parametar objekt je koji sadrži skup parametara događaja. U ovom slučaju "method" je parametar koji ima vrijednost "email".
13. redak: ovdje je "send_to" parametar događaja. To je poseban parametar koji "usmjerava" povezani događaj na određeni entitet. Drugim riječima, taj će se događaj poslati samo u entitet koji je naveo <ID nekog entiteta B>.
Prikupljanje osnovnih podataka za Google Analytics 4 entitet omogućeno je putem gtag upute "config" i omogućuje prikupljanje događaja page_view kao automatski prikupljenog događaja prilikom učitavanja na stranici.
Učitavanje prikaza stranice ili događaj page_view moguće je izmijeniti ili blokirati pomoću određenih parametara.
Identifikatori entiteta
ID-jevi Universal Analytics entiteta imaju format "UA-XXXXXXXX". To se ponekad naziva ID-jem praćenja. U ovom ćemo ih vodiču navoditi kao ID UA entiteta.
Streamovi podataka web-lokacije za Google Analytics 4 entitete upotrebljavaju ID oznake u formatu "G-XXXXXXXX".
U nekim primjerima koda i dokumentaciji možete vidjeti da se oboje navodi kao "TAG_ID".
Prikupljanje osnovnih podataka
Omogućivanje prikupljanja osnovnih podataka za Google Analytics 4 entitet omogućuje prikupljanje sljedećih događaja:
- događaja page_view
- automatski prikupljenih događaja
- događaja poboljšanog mjerenja (ako su omogućeni na korisničkom sučelju).
Da biste omogućili prikupljanje osnovnih podataka za svoj Google Analytics 4 entitet, dodajte isječak gtag.js (Google oznaku) u odjeljak <head> na svakoj stranici.
Isječak gtag.js u usporedbi s isječkom analytics.js
Isječak gtag.js za Google Analytics 4 entitet ima sličnu svrhu kao i isječak analytics.js za Universal Analytics entitet.
Najveća razlika između ta dva isječka je u tome što kôd isječka analytics.js uključuje zasebni poziv "send pageview", a kôd isječka gtag.js ne. U isječku gtag.js prikaz stranice automatski je prikupljen događaj koji se šalje zajedno s uputom "config".
Universal Analytics entitet (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 entitet (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>
Postavke konfiguracije za gtag.js
Možete konfigurirati osnovni isječak gtag.js za upravljanje postavkama prikupljanja podataka kao što su prikrivanje IP-ja, prilagodbe kolačića i Google signali slični isječku analytics.js. To radite putem uputa "config" ili "set" u isječku gtag.js (za razliku od uputa "set", "create" i "require" u isječku analytics.js.).
Google Analytics 4 entiteti ("G-XXXXXXXX") podržavaju implementaciju sličnih postavki config putem isječka gtag.js. Postoje razlike između tih postavki za Universal Analytics i Google Analytics 4 entitete. Uzmite u obzir sljedeće:
- Prikrivanje IP-ja standardizirano je na "true" i ne može se konfigurirati u Google Analytics 4 entitetu. Zbog toga se IP adresa automatski prikriva standardnim događajem za Google Analytics 4 entitet ("G-XXXXXXXX").
- Kada se globalne postavke trebaju primijeniti na sve konfigurirane entitete, naredbu "set" u isječku gtag.js treba upotrijebiti za primjenu na sve ID-jeve oznaka i/ili ID-jeve entiteta.
- Posebnu pozornost obratite na značajke Oglašavanje i Prilagodba oglasa u isječku analytics.js, koje se najčešće implementiraju pomoću retka "set".
Ako u trenutačnoj implementaciji isječka analytics.js upotrebljavate upute "set", "create" i "require", pregledajte koje se automatski postavljaju u Google Analytics 4 entitetu, a koje treba navesti u kodu Google Analytics 4 entiteta (mapiranje parametra).
Neki primjeri konfiguracija s uzorcima koda u isječku analytics.js (za UA entitet) i isječku gtag.js (za Google Analytics 4 entitet) navedeni su u nastavku:
Omogućivanje prikupljanja osnovnih podataka; konfiguracija User-ID-ja
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Konfiguriranje postavki kolačića
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // vrijeme u sekundama.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 dana, u sekundama
});
Blokiranje događaja page_view
Ako vam slanje događaja page_view prilikom učitavanja koda config nije potrebno (npr. ako imate učitavanje iframea), postavku config možete prilagoditi tako da blokira događaj page_view. Razmislite o scenariju u kojem je događaj page_view poslan, a zatim se korisnik prijavi na web-lokaciju. Za interakciju prijave upotrijebili biste uputu "config" kako biste postavili ID korisnika, no ne želite poslati drugi događaj page_view. Sljedeći kôd pokazuje kako spriječiti slanje događaja page_view.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Nazivi oznaka
Nazivi oznaka (poznati i kao "alati za praćenje") upotrebljavaju se ako podatke želite slati u različite Universal Analytics entitete u isječku analytics.js. U isječku analytics.js alati za praćenje definiraju entitet kojem želite poslati podatke. Učitavanja nakon početnog učitavanja "create" više ne moraju navoditi ID Universal Analytics entiteta, već samo naziv alata za praćenje.
U isječku gtag.js alati za praćenje nisu dostupni za Google Analytics 4 i Universal Analytics entitete. Ako želite poslati sva učitavanja u više entiteta (različiti streamovi podataka u Google Analytics 4 entitetu), morate navesti sve ID-jeve oznaka ili entiteta u retku "config".
Događaji
Pogledajte Vodič za migraciju događaja.Prilagođene dimenzije i mjerni podaci
Prilagođene dimenzije i mjerni podaci upotrebljavaju se za proširivanje opsega informacija koje se mjere na web-lokaciji i za uvoz izvanmrežnih podataka iz, primjerice, CRM sustava. U Universal Analytics entitetu ("UA-XXXXXXXX" ) prilagođene dimenzije i mjerni podaci trebaju se izraditi na korisničkom sučelju, dodjeljuje im se ID, a zatim ih je moguće implementirati ili uvesti. Mogu se izraditi s četiri različita opsega: učitavanje, sesija, korisnik i proizvod.
U Google Analytics 4 entitetu ("G-XXXXXXXX") scenarij upotrebe prilagođenih dimenzija i mjernih podataka implementiran je na drugačiji način. Prilagođene dimenzije i mjerenja mjernih podataka u UA entitetu koja su implementirana putem isječka gtag.js trebaju se ponovno implementirati kao parametri u Google Analytics 4 entitetu.
Prilagođena dimenzija za Universal Analytics entitet može se implementirati putem isječka analytics.js na sljedeći način:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ILI
ga('set', 'dimension5', 'custom data');
Te se prilagođene dimenzije mogu prenijeti na Google Analytics 4 entitet putem isječka gtag.js na sljedeći način:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ILI
gtag('set', {'dimension5': 'custom data'});
Potrebno je obratiti pozornost na sljedeće dvije stvari:
- Parametri moraju biti registrirani na korisničkom sučelju kako bi se prikazivali u izvješćima. To je postupak usporediv s registracijom prilagođenih dimenzija u Universal Analyticsu (primjenjuju se ograničenja). Ako samo pregledavate izvezene podatke ili samo upotrebljavate parametar za aktivaciju publike, ne morate ih registrirati.
- Opseg prilagođenih parametara uvijek je na razini događaja, usporediv s opsegom učitavanja. To se primjenjuje i na prilagođene dimenzije koje se automatski prenose u parametre (za implementacije isječka gtag.js "UA-XXXXXXXX"), neovisno o izvornoj postavci opsega prilagođenih dimenzija.
Za prilagođene mjerne podatke primjenjuju se ista mapiranja i razmatranja, no, kada su registrirana za izvješćivanje, ubrajaju se u ograničenja numeričkih parametara umjesto u ograničenja tekstualnih parametara.
Konceptualno, prilagođene dimenzije i mjerni podaci različitog opsega u Universal Analytics entitetu mapiraju se u Google Analytics 4 entitet kao:
- Prilagođena dimenzija s opsegom učitavanja: parametar (maksimalno 25 ukupnih parametara zabilježenih po događaju tijekom prikupljanja podataka; maksimalno 50 prilagođenih dimenzija/50 prilagođenih mjernih podataka)
Napominjemo da automatski prikupljeni događaji i parametri možda već obuhvaćaju neke scenarije upotrebe u kojima su se prethodno upotrebljavale prilagođene dimenzije s opsegom učitavanja - Prilagođena dimenzija opsega korisnika: korisnički entiteti (maksimalno 25 registriranih za izvješćivanje putem korisničkog sučelja). Automatski prikupljeni korisnički entiteti ne ubrajaju se u to ograničenje.
- Prilagođena dimenzija opsega sesije: ne postoji ekvivalent u Google Analytics 4 entitetu; umjesto toga pogledajte prilagođene parametre ili korisničke entitete.
Najbolji primjeri iz prakse za korisničke entitete
Korisnički entiteti pridržavaju se korisnika na različitim platformama (npr. na svim vrstama streama podataka) i stoga se trebaju upotrebljavati samo ako se podaci trebaju primjenjivati na razini korisnika. Korisnički entiteti ne smiju se upotrebljavati za podatke na razini sesije ili podatke na razini uređaja (npr. veličina zaslona).
Primjer Google Analytics 4 entiteta
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});