Despre fragmentul gtag.js
Dacă folosiți analytics.js pentru proprietatea Google Analytics universal actuală, va trebui să adăugați fragmentul gtag.js pentru noua proprietate Google Analytics 4. Fragmentul gtag.js are următoarea structură:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Codul proprietății A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Codul proprietății A>');
08:
09: gtag('config', '<Codul proprietății B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Codul proprietății B>' });
14:
15: </script>
Linia 7: directiva gtag „config” permite colectarea datelor în proprietatea asociată <Codului proprietății A>. De exemplu, dacă adăugați această directivă cu un cod de etichetă pentru o proprietate Google Analytics 4, se vor trimite evenimente page_view la proprietatea respectivă.
Codul proprietății poate reprezenta diferite produse Google, inclusiv o proprietate Google Analytics universal („UA-XXXXXXXX”), o proprietate Google Analytics 4 („G-XXXXXXXX”), Google Ads („AW-XXXXXXXX”) sau Floodlight („DC-XXXXXXXX”).
Linia 11: directiva gtag „event” va trimite un eveniment. În cazul fragmentelor care conțin mai multe instrucțiuni „config” pentru mai multe proprietăți, evenimentul va fi trimis la toate proprietățile.
În acest exemplu, parametrul „sign_up” este numele evenimentului. Ultimul parametru este un obiect care conține un set de parametri de eveniment. În acest caz, „method” este un parametru cu valoarea „email”.
Linia 13: acest eveniment are parametrul „send_to”. Acesta este un parametru special care trimite evenimentul asociat la o anumită proprietate. Cu alte cuvinte, evenimentul va fi trimis numai proprietății indicate de <Codul proprietății B>.
Colectarea de bază a datelor pentru o proprietate Google Analytics 4 este activată prin directiva gtag „config” și activează colectarea de evenimente page_view ca evenimente colectate automat atunci când se încarcă într-o pagină.
Accesarea de afișare a paginii sau evenimentul „page_view” poate fi modificat sau blocat folosind anumiți parametri.
Identificatorii proprietății
Codul de proprietate Google Analytics universal are formatul „UA-XXXXXXXX”. Uneori, acesta se numește și „cod de urmărire”. În acest ghid, îl vom numi „cod de proprietate AU”.
Fluxurile de date web pentru proprietățile Google Analytics 4 folosesc un cod de etichetă cu formatul „G-XXXXXXXX”.
În unele exemple de coduri și în unele documente, este posibil să fie folosită denumirea de „TAG_ID”.
Colectarea de bază a datelor
Dacă activați colectarea de bază a datelor pentru o proprietate Google Analytics 4, pot fi colectate următoarele elemente:
- evenimente page_view;
- evenimente colectate automat;
- evenimente de măsurare îmbunătățită (dacă sunt activate în interfața de utilizare).
Pentru a activa colectarea de bază a datelor pentru proprietatea Google Analytics 4, adăugați fragmentul gtag.js (eticheta Google) în secțiunea <head> a fiecărei pagini.
Comparație între fragmentul gtag.js și fragmentul analytics.js
Fragmentul gtag.js pentru o proprietate Google Analytics 4 are un scop similar cu fragmentul analytics.js pentru o proprietate Google Analytics universal.
Cea mai mare diferență dintre aceste două fragmente este faptul că analytics.js include un apel separat „send pageview”, iar codul gtag.js nu. În fragmentul gtag.js, afișarea de pagină este un eveniment colectat automat, trimis împreună cu directiva „config”.
Proprietate Google Analytics universal (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>
Proprietate 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>
Setări de configurare pentru gtag.js
Puteți să configurați fragmentul gtag.js de bază astfel încât să gestionați setările privind colectarea datelor, cum ar fi mascarea adreselor IP, personalizările cookie-urilor și Semnalele Google, în mod similar cu analytics.js. Puteți face acest lucru cu ajutorul directivelor „config” sau „set” din gtag.js (echivalente cu directivele „set”, „create” și „require” din analytics.js).
Proprietățile Google Analytics 4 („G-XXXXXXXX”) acceptă implementarea unor setări de configurare similare prin gtag.js. Există diferențe între aceste setări pentru proprietățile Google Analytics universal și Google Analytics 4. Rețineți următoarele aspecte:
- mascarea adreselor IP este setată în mod prestabilit la „true” și nu poate fi configurată într-o proprietate Google Analytics 4. Prin urmare, adresa IP este mascată automat de evenimentul standard în proprietatea Google Analytics 4 („G-XXXXXXXX”).
- când trebuie să se aplice setări globale tuturor proprietăților configurate, comanda „set” din gtag.js trebuie aplicată tuturor codurilor de etichetă și/sau codurilor de proprietate;
- acordați o atenție deosebită funcțiilor de personalizare a reclamelor și anunțurilor din analytics.js, care sunt de obicei implementate cu o linie „set”.
dacă folosiți directivele „set”, „create” și „require” în implementarea analytics.js actuală, verificați-le pe cele care sunt setate automat într-o proprietate Google Analytics 4 și pe cele care trebuie incluse în codul de proprietate Google Analytics 4 (maparea parametrilor).
Mai jos sunt oferite câteva exemple de configurații cu exemple de cod în analytics.js (pentru proprietatea Google Analytics universal) și gtag.js (pentru proprietatea Google Analytics 4):
Activați colectarea de bază a datelor; configurați 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'
});
Configurarea setărilor pentru cookie-uri
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // timpul în secunde.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 de zile, în secunde
});
Blocați un eveniment page_view
Dacă nu doriți ca un eveniment page_view să fie trimis la încărcarea codului de configurare (de exemplu, dacă se încarcă un iframe), puteți ajusta setarea de configurare pentru a bloca evenimentul page_view. Să presupunem un scenariu în care este trimis un eveniment page_view, după care un utilizator se conectează la site. Pentru interacțiunea de conectare, folosiți o directivă „config” pentru a seta codul de utilizator, dar nu vreți să trimiteți alte evenimente page_view. Următorul cod ilustrează modul în care puteți bloca trimiterea evenimentului page_view.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Numele de etichete
Numele de etichete (cunoscute ca „instrumente de urmărire”) se folosesc dacă vreți să trimiteți date la diferite proprietăți Google Analytics universal în analytics.js. În analytics.js, instrumentele de urmărire definesc proprietatea la care doriți să trimiteți datele. Nu este necesar ca accesările înregistrate după accesarea „create” inițială să specifice codul proprietății Google Analytics universal, ci doar numele instrumentului de urmărire.
În gtag.js, instrumentele de urmărire nu sunt disponibile pentru proprietățile Google Analytics 4 sau Google Analytics universal. Dacă vreți să trimiteți toate accesările la mai multe proprietăți (diferite fluxuri de date dintr-o proprietate Google Analytics 4), includeți toate codurile de etichetă sau de proprietate în linia „config”.
Evenimente
Consultați Ghidul de migrare a evenimentelor.Parametri și valori personalizate
Parametrii și valorile personalizate sunt folosite pentru a completa informațiile măsurate pe site și pentru a importa date offline, de exemplu, de pe sisteme CRM. Într-o proprietate Google Analytics universal („UA-XXXXXXXX”), parametrii și valorile personalizate trebuie să fie create în interfața de utilizare, li se atribuie un cod, după care pot fi implementate sau importate. Acestea pot fi create cu patru arii de acoperire diferite: accesare, sesiune, utilizator, produs.
Într-o proprietate Google Analytics 4 („G-XXXXXXXX”), situația de folosire a parametrilor și a valorilor personalizate se implementează altfel. Măsurătorile pentru parametrii și valorile personalizate dintr-o proprietate Google Analytics universal, implementate prin analytics.js, trebuie să fie implementate din nou ca parametri într-o proprietate Google Analytics 4.
Un parametru personalizat pentru o proprietate Google Analytics universal poate fi implementat prin analytics.js astfel:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
SAU
ga('set', 'dimension5', 'custom data');
Acești parametri personalizați pot fi translatați în proprietatea Google Analytics 4 prin gtag.js astfel:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
SAU
gtag('set', {'dimension5': 'custom data'});
Rețineți două lucruri:
- parametrii trebuie să fie înregistrați în interfața de utilizare ca să apară în rapoarte. Acesta este un proces comparabil cu înregistrarea parametrilor personalizați în Google Analytics universal (se aplică limite). Nu este necesar să-i înregistrați dacă analizați numai date exportate sau dacă folosiți parametrul numai pentru activarea publicului.
- aria de acoperire a parametrilor personalizați este întotdeauna la nivel de eveniment și este comparabilă cu cea la nivel de accesare. Acest lucru este valabil și pentru parametrii personalizați care se translatează automat în parametri (pentru implementările gtag.js „UA-XXXXXXXX”), independent de setarea inițială pentru aria de acoperire a parametrilor personalizați.
Aceeași mapare și aceleași considerente sunt valabile și pentru valorile personalizate, cu excepția faptului că sunt incluse în limitele parametrilor numerici, nu în limitele parametrilor text atunci când sunt înregistrate pentru raportare.
Din punct de vedere conceptual, parametrii și valorile personalizate cu arii de acoperire variate dintr-o proprietate Google Analytics universal sunt mapate la o proprietate Google Analytics 4 astfel:
- parametru personalizat la nivel de accesare: parametru (maximum 25 de parametri înregistrați pentru fiecare eveniment în timpul colectării datelor, maximum 50 de parametri personalizați/50 de valori personalizate)
Rețineți că este posibil ca evenimentele și parametrii colectați automat să fie deja folosiți în unele situații în care au fost folosiți anterior parametri personalizați la nivel de accesare - parametru personalizat la nivel de utilizator: proprietăți ale utilizatorului (maximum 25 înregistrate pentru raportare prin interfața de utilizare). Proprietățile utilizatorului colectate automat nu sunt incluse în această limită.
- parametru personalizat la nivel de sesiune: nu are echivalent în proprietatea Google Analytics 4. Folosiți parametri personalizați sau proprietăți ale utilizatorului.
Recomandări pentru proprietățile utilizatorului
Proprietățile utilizatorului aparțin unui anumit utilizator de pe mai multe platforme (de exemplu, toate tipurile de fluxuri de date) și, prin urmare, trebuie folosite numai dacă datele trebuie să fie aplicate la nivel de utilizator. Proprietățile utilizatorului nu trebuie folosite pentru date la nivel de sesiune sau la nivel de dispozitiv (de exemplu, dimensiunea ecranului).
Exemplu de proprietate Google Analytics 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});