Despre fragmentul gtag.js și codurile de proprietate
Fragmentele gtag.js pentru o proprietate Google Analytics universal și pentru o proprietate Google Analytics 4 sunt în esență aceleași. Ambele fragmente au 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 1: dacă ați implementat o proprietate Google Analytics universal prin gtag.js, probabil că această linie de cod există deja pe site. În loc de <Codul proprietății A>, va apărea „UA-” urmat de o serie de cifre. Dacă ați implementat gtag.js pentru Google Ads sau pentru un alt produs Google Marketing Platform, este posibil ca această linie de cod să existe pe site, dar <Codul proprietății A> va începe cu „AW-” sau cu „DC-”.
Codul proprietății (sau Codul etichetei în cazul proprietăților Google Analytics 4) indicat în <Codul proprietății A> „controlează” acest fragment gtag.js. Acest lucru este important deoarece:
- dacă linia există deja, aceasta nu trebuie implementată a doua oară. Trebuie doar să adăugați o linie „config” pentru a introduce codul etichetei;
- Codul proprietății de pe această linie este „controlerul” fragmentului gtag.js. Dacă un cod de proprietate Google Analytics universal („UA-XXXXXXXX”) controlează eticheta, veți putea să folosiți etichete de site conectate pentru a trimite date de măsurare la o proprietate Google Analytics 4, fără a fi necesar să adăugați un cod nou în pagină.
Linia 7: directiva gtag „config” permite colectarea datelor în proprietatea asociată <Codului proprietății A>. De exemplu, în cazul unei proprietăți Google Analytics 4, dacă adăugați această directivă cu un cod de etichetă, se vor trimite evenimente page_view la proprietatea respectivă.
Codul proprietății poate reprezenta valori pentru 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>.
Comanda gtag config activează măsurarea standard.
- În cazul unei proprietăți Google Analytics universal, directiva „config” asociată unui cod de proprietate Google Analytics universal trimite o accesare de afișare de pagină.
- În cazul unei proprietăți Google Analytics 4, directiva „config” asociată unui cod de etichetă activează colectarea de evenimente page_view (ca evenimente colectate automat) atunci când se încarcă într-o pagină.
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 UA”.
Fluxurile de date web ale proprietăților Google Analytics 4 folosesc un cod de etichetă cu formatul „G-XXXXXXXX”.
În unele cazuri, 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).
Dacă proprietatea dvs. Google Analytics universal existentă folosește o implementare gtag.js, activați colectarea de bază a datelor pentru proprietatea Google Analytics 4 astfel:
- opțiunea 1: adăugați o nouă directivă „config” cu codul etichetei relevant
SAU - opțiunea 2: activați etichetele de site conectate (dacă implementarea gtag.js existentă este eligibilă).
Indiferent de opțiunea aleasă, proprietatea dvs. Google Analytics universal existentă va rămâne neschimbată și va continua să colecteze date.
Opțiunea 1: adăugați o nouă directivă „config”
Dacă în pagină există un cod gtag.js, adăugați o directivă „config” suplimentară cu codul de măsurare al proprietății Google Analytics 4 relevante. În exemplul de mai jos, linia 8 a fost adăugată la o implementare gtag.js existentă. Aceasta face referire la codul de măsurare al proprietății Google Analytics 4. Linia va trimite evenimentele page_view către proprietatea Google Analytics 4 respectivă. În plus, va activa evenimentele colectate automat și evenimentele de măsurare îmbunătățită (dacă ați activat măsurarea îmbunătățită) în proprietatea Google Analytics 4.1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Codul proprietății A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Codul proprietății A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Opțiunea 2: activați etichetele de site conectate
Puteți folosi o etichetă de site conectată dacă:
- fragmentul gtag.js existent din pagina în care doriți să măsurați interacțiunile utilizatorilor este gestionat de o proprietate Google Analytics universal (de exemplu, codul care apare în această linie a fragmentului gtag.js începe cu „UA-”:
<script async src="https://www.googletagmanager.com/gtag/js?id=<Codul proprietății A>"></script>).
(Etichetele de site conectate vor funcționa și dacă fragmentul gtag.js existent este gestionat de o proprietate Google Analytics 4. Însă această situație va apărea numai dacă a fost deja implementată o proprietate Google Analytics 4.)
- ȘI aveți acces administrativ la proprietatea Google Analytics universal la care face referire codul din fragment.
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 pentru colectarea datelor, cum ar fi anonimizarea adreselor IP, personalizările cookie-urilor și Semnalele Google. Puteți face acest lucru cu ajutorul directivelor „config” sau „set” din gtag.js.
Atât proprietățile Google Analytics universal („UA-XXXXXXXX”), cât și proprietățile Google Analytics 4 („G-XXXXXXXX”) acceptă implementarea setărilor „config” prin gtag.js. Însă există câteva diferențe între aceste setări pentru proprietățile Google Analytics universal și Google Analytics 4.
- Anonimizarea 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”).
- Atunci când trebuie să se aplice setări globale tuturor proprietăților configurate, comanda „set” trebuie aplicată tuturor codurilor de măsurare și/sau codurilor de proprietate, inclusiv celor implementate prin etichete de site conectate.
- Acordați o atenție deosebită funcțiilor de dezactivare a personalizării anunțurilor, care sunt de obicei implementate cu o linie „config”.
- Atunci când folosiți etichete de site conectate: toate configurările pe care le realizați în codul gtag.js folosind directiva „config” se aplică numai proprietății asociate codului de măsurare din linia de cod respectivă. Acestea nu vor fi trimise automat la proprietatea Google Analytics 4 conectată. Dacă doriți să aplicați o configurație proprietății Google Analytics 4 conectate:
- creați o directivă „config” separată și aplicați-o proprietății Google Analytics 4 relevante făcând referire la codul de măsurare;
SAU - configurați setarea folosind o directivă „set”, caz în care configurația va fi aplicată tuturor proprietăților configurate.
- creați o directivă „config” separată și aplicați-o proprietății Google Analytics 4 relevante făcând referire la codul de măsurare;
Exemple de configurare
Activați colectarea de bază a datelor; configurați User-ID
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Configurarea setărilor pentru cookie-uri
gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Evenimente
Consultați Ghidul de migrare a evenimentelor.
Parametri și valori personalizate
Parametrii și valorile personalizate pot fi folosite pentru a completa informațiile și pentru a importa date offline, de exemplu, din sisteme CRM.
Atunci când folosiți eticheta Google (gtag.js), măsurătorile parametrilor și ale valorilor personalizate sunt translatate automat în parametri dacă se folosesc etichete de site conectate sau o proprietate Google Analytics 4 (de exemplu, „G-XXXXXXXX”).
Aflați mai multe despre parametrii personalizați și valorile personalizate.