[UA→GA4] Kaip gtag.js, skirta UA, susiejama su GA4

Tai yra diegimo vadovas, skirtas svetainių savininkams, naudojantiems gtag.js biblioteką ir norintiems suprasti, kaip gtag.js, skirta „Universal Analytics“ (UA), priskiriama „Google Analytics 4“. Tarkime, kad jau sukūrėte „Google Analytics 4“ nuosavybę. Jei tiesiog norite svetainėje pridėti pagrindinį vertinimo kodą, skaitykite šį straipsnį.

Šiame straipsnyje

• Apie gtag.js fragmentą
• Pagrindinių duomenų rinkimas
• gtag.js konfigūracijos nustatymai
• Įvykiai
• Tinkinti aspektai ir metrika

Apie gtag.js fragmentą ir nuosavybių ID

„Universal Analytics“ nuosavybės ir „Google Analytics 4“ nuosavybės gtag.js fragmentai iš esmės yra vienodi. Abiejų fragmentų struktūra yra tokia:

01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Tam tikros A nuosavybės ID>"></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>

1 eilutė: jei įdiegėte „Universal Analytics“ nuosavybę naudodami gtag.js, ši kodo eilutė tikriausiai jau yra svetainėje. Vietoj <Tam tikros A nuosavybės ID> matysite „UA-“ ir skaičių seką. Jei įdiegėte gtag.js, skirtą „Google Ads“ ar kitam „Google Marketing Platform“ produktui, svetainėje taip pat gali būti pateikta ši kodo eilutė, bet <Tam tikros A nuosavybės ID> prasidės „AW-“ arba „DC-“.

Nuosavybės ID (arba žymos ID, skirtas „Google Analytics 4“ nuosavybėms), kurį nurodo <Tam tikros A nuosavybės ID>, valdo šį gtag.js fragmentą. Tai svarbu dėl toliau nurodytų priežasčių.

1. Jei ši eilutė jau rodoma, nebūtina jos įdiegti antrą kartą. Turėsite pridėti tik eilutę „config“, kad nurodytumėte žymos ID.
2. Šios eilutės nuosavybės ID yra gtag.js fragmento valdiklis. Jei „Universal Analytics“ nuosavybės ID (UA-XXXXXXXX) valdo žymą, naudodami prijungtas svetainės žymas galėsite nusiųsti duomenis į „Google Analytics 4“ nuosavybę, prie puslapio nepridėję jokio naujo kodo.

7 eilutė: „gtag“ direktyva „config“ įgalina duomenų rinkimą nuosavybėje, susietoje su <Tam tikros A nuosavybės ID>. Pavyzdžiui, „Google Analytics 4“ nuosavybėje pridėjus šią direktyvą su žymos ID, į tą nuosavybę bus siunčiami įvykiai „page_view“.

Nuosavybės ID gali nurodyti skirtingus „Google“ produktus, įskaitant „Universal Analytics“ nuosavybę (UA-XXXXXXXX), „Google Analytics 4“ nuosavybę (G-XXXXXXXX), „Google 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 specialus parametras, kurį naudojant susijęs įvykis siunčiamas į konkrečią nuosavybę. Kitaip tariant, šis įvykis bus nusiųstas tik nuosavybei, kurią nurodo <Tam tikros B nuosavybės ID>.

Pagal „gtag“ komandą config įgalinamas pagrindinis vertinimas.

• Naudojant „Universal Analytics“ nuosavybės konfigūraciją su „Universal Analytics“ nuosavybės ID, siunčiamas puslapio peržiūros įvykis.
• „Google Analytics 4“ nuosavybės konfigūracija su žymos ID įgalina įvykių „page_view“ (kaip automatiškai renkamų įvykių) rinkimą, kai įkeliama puslapyje.

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“ nuosavybės ž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 esamoje „Universal Analytics“ nuosavybėje naudojamas gtag.js diegimas, turite įgalinti „Google Analytics 4“ nuosavybės pagrindinių duomenų rinkimą atlikdami toliau nurodytus veiksmus.

• 1 parinktis: naujos direktyvos „config“ pridėjimas su atitinkamu žymos ID
  ARBA
• 2 parinktis: prijungtų svetainių žymų įjungimas (jei tinkamas esamas gtag.js diegimas)

Neatsižvelgiant į pasirinktą parinktį, esama „Universal Analytics“ nuosavybė liks nepakeista ir joje bus toliau renkami duomenys.

1 parinktis: naujos direktyvos „config“ pridėjimas

Jei puslapyje yra gtag.js kodas, tiesiog pridėkite papildomą direktyvą „config“ su atitinkamu „Google Analytics 4“ nuosavybės įvertinimo ID. Toliau pateiktame pavyzdyje 8 eilutė pridėta prie esamo gtag.js diegimo. Jame pateikiamas „Google Analytics 4“ nuosavybės įvertinimo ID. Įvykiai „page_view“ bus siunčiami į šią „Google Analytics 4“ nuosavybę. Be to, bus įgalinti automatiškai renkami įvykiai ir patobulinto įvertinimo įvykiai (jei įgalinote patobulintą įvertinimą) toje „Google Analytics 4“ nuosavybėje.

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Tam tikros A nuosavybės ID>"></script>

2: <script>

3: window.dataLayer = window.dataLayer || [];

4: function gtag(){dataLayer.push(arguments);}

5: gtag('js', new Date());

6:

7: gtag('config', '<Tam tikros A nuosavybės ID>');

8: gtag('config', 'G-XXXXXXXX');

9: </script>

2 parinktis: prijungtų svetainės žymų įjungimas

Prijungtą svetainės žymą galite naudoti, jei:

• puslapyje, kuriame norite įvertinti naudotojo sąveikas, esantis fragmentas gtag.js valdomas naudojant „Universal Analytics“ nuosavybę (t. y. šioje gtag.js fragmento eilutėje nurodytas ID prasideda UA-:

<script async src="https://www.googletagmanager.com/gtag/js?id=<Tam tikros A nuosavybės ID>"></script>)

(Prijungtos svetainės žymos taip pat veiks, jei esamą gtag.js fragmentą valdo „Google Analytics 4“ nuosavybė. Tačiau šią situaciją matysite tik tuo atveju, jei „Google Analytics 4“ nuosavybė jau įdiegta.)

• IR turite administratoriaus prieigą prie „Universal Analytics“ nuosavybės, kurią nurodo fragmento ID.

Jei puslapyje įdiegta ir gtag.js žyma, ir GTM sudėtinis failas, gtag.js žyma turi būti įdėta virš GTM sudėtinio failo, kad prijungtos svetainės žymos veiktų.

gtag.js konfigūracijos nustatymai

Galite konfigūruoti pagrindinį gtag.js fragmentą, kad galėtumėte valdyti duomenų rinkimo nustatymus, pvz., IP anonimizavimą, slapukų tinkinimą ir „Google Signals“. Tai galite atlikti naudodami direktyvas „config“ arba „set“ gtag.js fragmente.

Ir „Universal Analytics“ (UA-XXXXXXXX), ir „Google Analytics 4“ (G-XXXXXXXX) nuosavybėse galima diegti šiuos konfigūravimo nustatymus naudojant „gtag.js“. Tačiau šie „Universal Analytics“ ir „Google Analytics 4“ nuosavybių nustatymai šiek tiek skiriasi. 

• Standartizuota IP anonimizavimo 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, komanda „set“ turėtų būti naudojama norint taikyti visiems įvertinimo ID ir (arba) nuosavybių ID, įskaitant tuos, kurie įdiegti naudojant prijungtas svetainės žymas.
• Atkreipkite ypatingą dėmesį į skelbimų suasmeninimo išjungimo funkcijas, kurios paprastai įdiegiamos naudojant eilutę „config“.
• Kai naudojamos prijungtos svetainės žymos: visos konfigūracijos, sukurtos gtag.js kode naudojant „config“, taikomos tik nuosavybei, susijusiai su įvertinimo ID toje kodo eilutėje; jos nebus automatiškai siunčiamos į prijungtą „Google Analytics 4“ nuosavybę. Jei norite, kad konfigūracija būtų taikoma prijungtai „Google Analytics 4“ nuosavybei:
  • sukurkite atskirą direktyvą „config“ ir pritaikykite ją atitinkamai „Google Analytics 4“ nuosavybei nurodydami įvertinimo ID
    ARBA
  • konfigūruokite nustatymą naudodami direktyvą „set“. Tokiu atveju konfigūracija bus taikoma visoms sukonfigūruotoms nuosavybėms.

Konfigūracijos pavyzdžiai

Pagrindinių duomenų rinkimo įgalinimas; „User ID“ konfigūravimas

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

Slapukų nustatymų konfigūravimas

gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

Įvykiai

Žr. įvykių perkėlimo vadovą.

Tinkinti aspektai ir metrika

Tinkinti aspektai ir metrika gali būti naudojami informacijai išplėsti ir neprisijungus naudojamiems duomenims importuoti, pvz., iš RSKV sistemų.

Tinkintų aspektų ir metrikos įvertinimai naudojant „Google“ žymą („gtag.js“) automatiškai verčiami į parametrus, jei naudojamos prijungtos svetainės žymos arba „Google Analytics 4“ nuosavybė (pvz., G-XXXXXXXX).

Sužinokite daugiau apie tinkintus aspektus ir metriką.