[UA→GA4] Padomi par taga analytics.js mainīšanu pret tagu gtag.js

Šis raksts ir paredzēts vietņu īpašniekiem, kuri vēlas izprast, kā Universal Analytics (UA) īpašumam paredzētais tags analytics.js ir saistīts ar Google Analytics 4 īpašumam paredzēto tagu gtag.js, kā arī vēlas saņemt detalizētus ieviešanas norādījumus. Šajā rakstā tiek pieņemts, ka jau esat izveidojis Google Analytics 4 īpašumu. Ja savai lapai vēlaties pievienot pamata novērtēšanas kodu, skatiet šos norādījumus.
Šajā rakstā ietvertās tēmas

Par gtag.js fragmentu

Ja pašreizējā Universal Analytics īpašumā izmantojat analytics.js, jaunajam Google Analytics 4 īpašumam būs jāpievieno gtag.js fragments. Tālāk ir redzama gtag.js fragmenta struktūra.

01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Īpašuma 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', '<Īpašuma ID A>');

08:

09: gtag('config', '<Īpašuma ID B>');

10:

11: gtag('event', 'sign_up', { 'method': 'email' });

12:

13: gtag('event', 'view_video', { 'send_to': '<Īpašuma ID B>' });

14:

15: </script>

7. rindiņa. Taga gtag direktīva “config” iespējo datu vākšanu īpašumam, kas ir saistīts ar <Īpašuma ID A>. Piemēram, pievienojot šo direktīvu ar taga ID Google Analytics 4 īpašumam, uz šo īpašumu tiks nosūtīti notikumi page_view.

Īpašuma ID var attēlot dažādus Google produktus, tostarp UA īpašumu (“UA-XXXXXXXX”), Google Analytics 4 īpašumu (“G-XXXXXXXX”), Google Ads (“AW-XXXXXXXX”) vai Floodlight (“DC-XXXXXXXX”).

11. rindiņa. Taga gtag direktīva “event” nosūtīs notikumu. Fragmentos, kuros vairākiem īpašumiem ir vairākas direktīvas “config”, notikums tiks nosūtīts uz visiem īpašumiem.

Šajā piemērā parametrs “sign_up” ir notikuma nosaukums. Pēdējais parametrs ir objekts, kas ietver notikumu parametru kopu. Šajā gadījumā “method” ir parametrs ar vērtību “email”.

13. rindiņa. Šeit notikumam kā parametrs ir “send_to”. Šis ir īpašs parametrs, kas tiek izmantots saistītā notikuma novirzīšanai uz noteiktu īpašumu. Citiem vārdiem sakot, šis notikums tiks nosūtīts tikai uz īpašumu, ko norāda <Īpašuma ID B>.

Pamatdatu vākšana Google Analytics 4 īpašumam ir iespējota, izmantojot gtag direktīvu “config”, un ļauj notikumus “page_view” vākt kā automātiski vāktus notikumus, kad tie tiek ielādēti lapā.

Lapas skatījuma trāpījumu vai notikumu “page_view” var pārveidot vai bloķēt, izmantojot konkrētus parametrus.

Īpašumu identifikatori

Universal Analytics īpašumu ID formāts ir “UA-XXXXXXXX”. Dažkārt tas tiek dēvēts par izsekošanas ID. Šajā ceļvedī mēs to dēvēsim par UA īpašuma ID.

Google Analytics 4 īpašumu tīmekļa datu straumēs tiek izmantots taga ID formātā “G-XXXXXXXX”.

Dažos koda piemēros un dokumentācijā abi var tikt dēvēti par “TAG_ID”.

Pamatdatu vākšana

Iespējojot pamatdatu vākšanu Google Analytics 4 īpašumam, kļūst iespējama tālāk minēto datu vākšana.

Lai iespējotu pamatdatu vākšanu savam Google Analytics 4 īpašumam, katras lapas sadaļā <head> pievienojiet taga gtag.js fragmentu (Google tagu).

Taga gtag.js fragmenta salīdzinājums ar taga analytics.js fragmentu

Taga gtag.js fragments Google Analytics 4 īpašumam ir paredzēts līdzīgam mērķim kā taga analytics.js fragments Universal Analytics īpašumam.

Vislielākā atšķirība starp šiem diviem fragmentiem ir tāda, ka analytics.js kodā ir ietverts atsevišķs izsaucējs “send pageview”, taču gtag.js kodā tāda nav. Taga gtag.js kodā lapas skatījums ir automātiski vākts notikums, kas tiek nosūtīts kopā ar direktīvu “config”.

 

Universal Analytics īpašums (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 īpašums (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>

Taga gtag.js konfigurācijas iestatījumi

Varat konfigurēt gtag.js pamata fragmentu, lai kontrolētu datu vākšanas iestatījumus, piemēram, IP maskēšanu, sīkfailu pielāgojumus un Google signālus (līdzīgi kā analytics.js). To varat izdarīt, gtag.js kodā izmantojot direktīvas “config” vai “set” (savukārt analytics.js kodā — direktīvas “set”, “create” un “require”).

Google Analytics 4 (“G-XXXXXXXX”) īpašumos tiek atbalstīta līdzīgu konfigurācijas iestatījumu ieviešana, izmantojot gtag.js. Starp šiem Universal Analytics īpašuma un Google Analytics 4 īpašuma iestatījumiem ir atšķirības. Ņemiet vērā tālāk minētos apsvērumus.

  • Google Analytics 4 īpašumā IP maskēšana ir standartizēta uz vērtību “true” un nav konfigurējama. Tādēļ IP adrese tiek automātiski maskēta, izmantojot standarta notikumu, pirms nosūtīšanas uz Google Analytics 4 īpašumu (“G-XXXXXXXX”).
  • Ja vispārējie iestatījumi ir jālieto visiem konfigurētajiem īpašumiem, gtag.js kodā ir jāizmanto komanda “set”, lai tos lietotu visiem tagu ID un/vai īpašumu ID.
  • Pievērsiet īpašu uzmanību tām reklamēšanas un reklāmu personalizēšanas funkcijām analytics.js kodā, kuras parasti tiek ieviestas kopā ar “set” rindiņu.

Ja pašlaik ievietotajā tagā analytics.js izmantojat direktīvas “set”, “create” un “require”, pārskatiet, kuras direktīvas tiek automātiski iestatītas Google Analytics 4 īpašumā un kuras ir jānorāda Google Analytics 4 īpašuma kodā (parametru saistīšana).

Tālāk ir aprakstīti daži konfigurācijas piemēri ar to kodu paraugiem tagos analytics.js (UA īpašumam) un gtag.js (Google Analytics 4 īpašumam).

Pamatdatu vākšanas iespējošana; User-ID konfigurēšana

analytics.js

ga('create', 'TAG_ID', 'auto', {

userId: USER_ID

});

ga('send', 'pageview');

gtag.js

gtag('config', 'TAG_ID', {

'user_id': 'USER_ID'

});

Sīkfailu iestatījumu konfigurēšana

analytics.js

ga('create', 'TAG_ID', {

'cookieName': 'gaCookie',

'cookieDomain': 'blog.example.co.lv',

'cookieExpires': 60 * 60 * 24 * 28 // Laiks sekundēs.

});

gtag.js

gtag('config', 'TAG_ID', {

'cookie_prefix': 'MyCookie',

'cookie_domain': 'blog.example.com',

'cookie_expires': 28 * 24 * 60 * 60 // 28 dienas, izteiktas sekundēs

});

Notikuma “page_view” bloķēšana

Ja jums nav jāsūta notikums “page_view”, ielādējot “config” kodu (piemēram, ja izmantojat iframe ielādi), varat koriģēt “config” iestatījumu tā, lai bloķētu notikumu “page_view”. Apsveriet scenāriju, kurā tiek nosūtīts notikums “page_view”, un tam seko lietotāja pieteikšanās vietnē. Pieteikšanās mijiedarbībai jūs izmantojat direktīvu “config”, lai iestatītu lietotāja ID, taču jūs nevēlaties nosūtīt vēl vienu notikumu “page_view”. Tālāk norādītajā kodā ir parādīts, kā novērst notikuma “page_view” sūtīšanu.

gtag('config', 'TAG_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

Tagu nosaukumi

Tagu nosaukumi (dēvēti par “izsekotājiem”) tiek izmantoti, ja analytics.js kodā vēlaties nosūtīt datus uz dažādiem Universal Analytics īpašumiem. Izsekotāji analytics.js kodā nosaka to, kuram īpašumam vēlaties nosūtīt datus. Trāpījumiem pēc sākotnējā trāpījuma “create” vairs nav jānorāda Universal Analytics īpašuma ID, bet tikai izsekotāja nosaukums.

Izsekotāji gtag.js kodā nav pieejami ne Google Analytics 4, ne Universal Analytics īpašumiem. Ja vēlaties nosūtīt visus trāpījumus uz vairākiem īpašumiem (dažādām datu straumēm Google Analytics 4 īpašumā), “config” rindiņā norādiet visus tagu vai īpašumu ID.

Notikumi

Skatiet notikumu migrēšanas ceļvedi.

Pielāgotas kategorijas un metrika

Pielāgotas kategorijas un metrika tiek izmantota, lai paplašinātu vietnē novērtēto informāciju un importētu bezsaistes datus, piemēram, no CRM sistēmām. Universal Analytics īpašumā (“UA-XXXXXXXX”) pielāgotas kategorijas un metrika ir jāizveido lietotāja saskarnē, tām jāpiešķir ID un pēc tam tās var ievietot vai importēt. Tās var izveidot ar četriem dažādiem tvērumiem: trāpījuma, sesijas, lietotāja, produkta.

Google Analytics 4 īpašumā (G-XXXXXXXX) pielāgoto kategoriju un metrikas lietošanas piemērs tiek ievietots atšķirīgi. Pielāgotās kategorijas un metrikas mērījumi UA īpašumā, kas ievietoti, izmantojot analytics.js, ir atkārtoti jāievieto kā parametri Google Analytics 4 īpašumā.

Pielāgotu kategoriju Universal Analytics īpašumā var ievietot, izmantojot analytics.js, kā norādīts tālāk.

ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'

});

VAI

ga('set', 'dimension5', 'custom data');

 

Šīs pielāgotās kategorijas var izveidot no jauna Google Analytics 4 īpašumā, izmantojot gtag.js, kā norādīts tālāk.

gtag('event', 'action_name', {'eventCategory': 'category_value',

'dimension5': 'custom data'

});

VAI

gtag('set', {'dimension5': 'custom data'});

Ņemiet vērā divus tālāk minētos brīdinājumus.

  1. Lai parametri tiktu rādīti pārskatos, tie ir jāreģistrē lietotāja saskarnē. Tas ir līdzīgs process kā pielāgoto kategoriju reģistrēšana Universal Analytics īpašumā (tiek piemēroti ierobežojumi). Ja skatāt tikai eksportētos datus vai parametru izmantojat tikai auditorijas aktivizēšanai, parametri nav jāreģistrē.
  2. Pielāgoto parametru tvērums vienmēr ir notikuma līmenī līdzīgi kā trāpījuma tvērums. Tas attiecas arī uz pielāgotajām kategorijām, kurām automātiski tiek no jauna izveidoti parametri (gtag.js “UA-XXXXXXXX” ieviešanas gadījumiem) neatkarīgi no sākotnējās pielāgotās kategorijas tvēruma iestatījuma.

Tāda pati saistīšana un apsvērumi attiecas arī uz pielāgoto metriku, izņemot to, ka, reģistrējot pārskatu veidošanai, to uzskaite tuvojas skaitlisko parametru ierobežojumiem, nevis teksta parametru ierobežojumiem.

Konceptuāli pielāgotās kategorijas un metrika ar atšķirīgu tvērumu Universal Analytics īpašumos tiek saistīta ar Google Analytics 4 īpašumu, kā aprakstīts tālāk.

  • Trāpījumus aptveroša pielāgotā kategorija: parametrs (datu vākšanas laikā katrā notikumā reģistrēti ne vairāk kā 25 parametri; maksimums 50 pielāgotās dimensijas/50 pielāgotās metrikas veidu.)
    Ņemiet vērā, ka automātiski vāktie notikumi un parametri jau var attiekties uz dažiem lietošanas piemēriem, kam iepriekš būtu izmantotas trāpījumus aptverošas pielāgotās kategorijas.
  • Lietotājus aptveroša pielāgotā kategorija: lietotāja parametri (reģistrēti ne vairāk kā 25 parametri pārskatu sniegšanai, izmantojot lietotāja saskarni). Automātiski vāktās lietotāju kategorijas šajā ierobežojumā netiek ieskaitītas.
  • Sesijas aptverošas pielāgotās kategorijas: Google Analytics 4 īpašumā nav ekvivalentu; to vietā meklējiet pielāgotos parametrus vai lietotāja parametrus.

Lietotāja parametru izmantošanas paraugprakse

Lietotāja parametri ir saistīti ar lietotāju dažādās platformās (piemēram, visus veidu datu plūsmās), un tāpēc tie jāizmanto tikai tad, kad dati jāpiemēro lietotāja līmenī. Lietotāja parametrus nav paredzēts izmantot sesijas līmeņa datiem vai ierīces līmeņa datiem (piemēram, ekrāna lieluma datiem).

Google Analytics 4 īpašuma piemērs

gtag('set', 'user_properties', {

favorite_composer: 'Mahler',

favorite_instrument: 'double bass',

season_ticketholder: 'true'

});

Vai tas bija noderīgs?

Kā varam to uzlabot?
Meklēšana
Notīrīt meklēšanu
Aizvērt meklēšanas lodziņu
Galvenā izvēlne
13291887420465612972
true
Meklēšanas palīdzības centrs
true
true
true
true
true
69256
false
false