Apie gtag.js fragmentą
Jei dabartinėje „Universal Analytics“ nuosavybėje naudojate analytics.js, naujoje „Google Analytics 4“ nuosavybėje turėsite pridėti gtag.js fragmentą. gtag.js fragmento struktūra yra tokia:
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', '<Tam tikros A nuosavybės ID>');
08:
09: gtag('config', '<Tam tikros B nuosavybės ID>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Tam tikros B nuosavybės ID>' });
14:
15: </script>
7 eilutė: „gtag“ direktyva „config“ įgalina duomenų rinkimą nuosavybėje, susietoje su <Tam tikros A nuosavybės ID>. Pavyzdžiui, pridėjus šią direktyvą su žymos ID „Google Analytics 4“ nuosavybėje, į tą nuosavybę bus siunčiami įvykiai page_view
.
Nuosavybės ID gali nurodyti skirtingus „Google“ produktus, įskaitant UA nuosavybę (UA-XXXXXXXX), „Google Analytics 4“ nuosavybę (G-XXXXXXXX), „Ads“ (AW-XXXXXXXX) arba „Floodlight“ (DC-XXXXXXXX).
11 eilutė: „gtag“ direktyva „event“ išsiųs įvykį. Fragmentuose, kuriuose yra kelių nuosavybių kelios direktyvos „config“, įvykis bus siunčiamas visoms nuosavybėms.
Šiame pavyzdyje parametras „sign_up“ yra įvykio pavadinimas. Paskutinis parametras yra objektas, kuriame yra įvykio parametrų rinkinys. Šiuo atveju „method“ yra parametras, kurio vertė yra „email“.
13 eilutė: čia įvykio parametras yra „send_to“. Tai yra specialus parametras, kuris nukreipia susijusį įvykį į konkrečią nuosavybę. Kitaip tariant, šis įvykis bus nusiųstas tik nuosavybei, kurią nurodo <Tam tikros B nuosavybės ID>.
„Google Analytics 4“ nuosavybės pagrindinių duomenų rinkimas įgalintas naudojant „gtag“ direktyvą „config“ ir įgalina įvykių „page_view“ (kaip automatiškai renkamų įvykių) rinkimą, kai įkeliama puslapyje.
Puslapio peržiūros įvykį arba įvykį „page_view“ galima keisti arba blokuoti naudojant konkrečius parametrus.
Nuosavybių identifikatoriai
„Universal Analytics“ nuosavybių ID formatas yra UA-XXXXXXXX. Jis kartais vadinamas stebėjimo ID. Šiame vadove pateikiame jį kaip UA nuosavybės ID.
„Google Analytics 4“ nuosavybių žiniatinklio duomenų srautuose naudojamas žymos ID, kurio formatas yra G-XXXXXXXX.
Kai kuriuose kodo pavyzdžiuose ir dokumentuose galite matyti, kad jie vadinami TAG_ID.
Pagrindinių duomenų rinkimas
Įgalinus „Google Analytics 4“ nuosavybės pagrindinių duomenų rinkimą galima rinkti:
- įvykius „page_view“;
- automatiškai renkamus įvykius;
- patobulinto įvertinimo įvykius (jei įgalinta NS).
Jei norite įgalinti „Google Analytics 4“ nuosavybės pagrindinių duomenų rinkimą, pridėkite gtag.js fragmentą („Google“ žymą) prie kiekvieno puslapio skilties <head>
.
gtag.js fragmentas, palyginti su analytics.js fragmentu
„Google Analytics 4“ nuosavybės gtag.js fragmentas veikia panašiai kaip „Universal Analytics“ nuosavybės analytics.js fragmentas.
Didžiausias šių dviejų fragmentų skirtumas yra tai, kad į analytics.js kodą įtraukiamas atskiras puslapio peržiūros siuntimo iškvietimas, o gtag.js kode jo nėra. Naudojant gtag.js puslapio peržiūra yra automatiškai renkamas įvykis, siunčiamas kartu su direktyva „config“.
„Universal Analytics“ nuosavybė (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“ nuosavybė (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>
gtag.js konfigūracijos nustatymai
Galite konfigūruoti pagrindinį gtag.js fragmentą, kad galėtumėte valdyti duomenų rinkimo nustatymus, pvz., IP maskavimo, slapukų tinkinimo priemones ir „Google Signals“, panašiai kaip analytics.js. Tai galite atlikti naudodami gtag.js direktyvas „config“ ir „set“ (palyginti su analytics.js direktyvomis „set“, „create“ ir „require“).
„Google Analytics 4“ (G-XXXXXXXX) nuosavybėse palaikomas panašių konfigūracijos nustatymų diegimas naudojant gtag.js. „Universal Analytics“ ir „Google Analytics 4“ nuosavybėse šie nustatymai skiriasi. Atminkite toliau nurodytus dalykus.
- Standartizuota IP maskavimo nustatymo vertė yra „true“ ir jo negalima konfigūruoti „Google Analytics 4“ nuosavybėje. Todėl IP adresas automatiškai maskuojamas taikant standartinį įvykį „Google Analytics 4“ nuosavybėje (G-XXXXXXXX).
- Kai bendruosius nustatymus reikia pritaikyti visoms sukonfigūruotoms nuosavybėms, gtag.js komanda „set“ turėtų būti naudojama norint taikyti visiems žymos ID ir (arba) nuosavybių ID.
- Atkreipkite dėmesį į reklamavimo ir skelbimų suasmeninimo funkcijas analytics.js, kurios paprastai įdiegiamos naudojant eilutę „set“.
Jei dabartiniame analytics.js diegime naudojate direktyvas „set“, „create“ ir „require“, peržiūrėkite, kurios automatiškai nustatomos „Google Analytics 4“ nuosavybėje, o kurias reikia nurodyti „Google Analytics 4“ nuosavybės kode (parametrų susiejimas).
Toliau pateiktos kelios pavyzdinės konfigūracijos su analytics.js (skirta UA nuosavybei) ir gtag.js (skirta „Google Analytics 4“ nuosavybei) kodo pavyzdžiais.
Pagrindinių duomenų rinkimo įgalinimas; „User ID“ konfigūravimas
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Slapukų nustatymų konfigūravimas
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Laikas sekundėmis.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 dienos sekundėmis
});
Įvykio „page_view“ blokavimas
Jei įkėlus konfigūravimo kodą nereikia siųsti įvykio „page_view“ (pvz., jei įkeliate „iframe“), galite koreguoti konfigūracijos nustatymą, kad įvykis „page_view“ būtų blokuojamas. Apsvarstykite scenarijų, pagal kurį siunčiamas įvykis „page_view“ ir naudotojas prisijungia prie svetainės. Vykdydami prisijungimo sąveiką turėtumėte naudoti direktyvą „config“, kad nustatytumėte naudotojo ID, bet tikriausiai nenorite siųsti kito įvykio „page_view“. Toliau pateiktame kode nurodoma, kaip apsaugoti įvykį „page_view“, kad nebūtų siunčiamas.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Žymų pavadinimai
Žymų pavadinimai (vadinami stebėjimo priemonėmis) naudojami, jei norite siųsti duomenis į skirtingas „Universal Analytics“ nuosavybes analytics.js. Kode analytics.js stebėjimo priemonės apibrėžia, į kurią nuosavybę norite siųsti duomenis. Įvykiams po pradinio įvykio „create“ nebereikia nurodyti „Universal Analytics“ nuosavybės ID, tik stebėjimo priemonės pavadinimą.
gtag.js fragmente stebėjimo priemonių negalima naudoti nei „Google Analytics 4“, nei „Universal Analytics“ nuosavybėse. Jei norite visus įvykius siųsti į kelias nuosavybes (skirtingus duomenų srautus „Google Analytics 4“ nuosavybėje), eilutėje „config“ reikia nurodyti visus žymos arba nuosavybių ID.
Įvykiai
Žr. įvykių perkėlimo vadovą.Tinkinti aspektai ir metrika
Tinkinti aspektai ir metrika naudojami norint išplėsti informaciją, kuri vertinama svetainėje, ir importuoti neprisijungus pasiekiamus duomenis, pvz., iš RSKV sistemų. „Universal Analytics“ nuosavybėje (UA-XXXXXXXX) tinkintus aspektus ir metriką reikia sukurti naudotojo sąsajoje, priskirti jiems ID ir tada galima įdiegti arba importuoti. Juos galima sukurti naudojant keturias skirtingas apimtis: įvykio, seanso, naudotojo, produkto.
„Google Analytics 4“ nuosavybėje (G-XXXXXXXX) tinkintų aspektų ir metrikos naudojimo atvejis diegiamas kitaip. Tinkintų aspektų ir metrikos įvertinimus UA nuosavybėje, įdiegtoje naudojant analytics.js, reikia iš naujo įdiegti kaip „Google Analytics 4“ nuosavybės parametrus.
Tinkintą „Universal Analytics“ nuosavybės aspektą galima įdiegti naudojant analytics.js, kaip nurodyta toliau.
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ARBA
ga('set', 'dimension5', 'custom data');
Šiuos tinkintus aspektus galima paversti į „Google Analytics 4“ nuosavybę naudojant gtag.js, kaip nurodyta toliau.
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ARBA
gtag('set', {'dimension5': 'custom data'});
Yra du įspėjimai.
- Parametrus reikia užregistruoti naudotojo sąsajoje, kad jie būtų rodomi ataskaitose. Tai panašu į tinkintų aspektų registravimo sistemoje „Universal Analytics“ procesą (taikomi apribojimai). Nereikia jų užregistruoti, jei peržiūrite tik eksportuotus duomenis arba naudojate tik auditorijos suaktyvinimo parametrą.
- Tinkintų parametrų apimtis visada yra įvykio lygio, palyginti su įvykio apimtimi. Tai taip pat taikoma tinkintiems aspektams, kurie automatiškai verčiami į parametrus (diegiant gtag.js UA-XXXXXXXX), neatsižvelgiant į pradinį tinkintų aspektų apimties nustatymą.
Tas pats susiejimas ir sąlygos taikomi tinkintai metrikai, išskyrus atvejus, kai jie skaičiuojami naudojant skaitinius parametrų apribojimus, o ne teksto parametrų apribojimus, kai užregistruojama teikiant ataskaitas.
Konkrečiai kalbant, įvairios apimties tinkinti aspektai ir metrika „Universal Analytics“ nuosavybėje susiejami su „Google Analytics 4“ nuosavybe kaip:
- įvykio apimties tinkintas aspektas: parametras (daugiausia galima užregistruoti iš viso 25 įvykio parametrus renkant duomenis; daugiausia 50 tinkintų aspektų ir (ar) 50 tinkintų metrikų).
Turėkite omenyje, kad automatiškai renkami įvykiai ir parametrai jau gali būti įtraukti į kai kuriuos naudojimo atvejus, jei anksčiau buvo naudojami įvykio apimties tinkinti aspektai; - naudotojo apimties tinkintas aspektas: naudotojo ypatybės (daugiausia užregistruota 25 teikiant ataskaitas per NS). Automatiškai renkamos naudotojų ypatybės neįskaičiuojamos į šį apribojimą;
- seanso apimties tinkintas aspektas: nėra atitinkamo parametro „Google Analytics 4“ nuosavybėje; žr. tinkintus parametrus arba naudotojo ypatybes.
Geriausia naudotojų ypatybių praktika
Tai reiškia, kad naudotojo nuosavybės siejamos su naudotoju skirtingose platformose (pvz., visų tipų duomenų srautuose), todėl turėtų būti naudojamos, tik jei duomenys turėtų būti taikomi naudotojo lygiu. Naudotojo ypatybės neturėtų būti naudojamos seanso lygio ar įrenginio lygio duomenims (pvz., ekrano dydžiui).
„Google Analytics 4“ nuosavybės pavyzdys
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});