Acest document oferă o imagine de ansamblu asupra bibliotecii de colectare a datelor Analytics.js.
JavaScript Fragment
Pentru a activa Google Analytics pe site-ul dvs., trebuie să adăugați un fragment JavaScript înainte de închiderea iv ID = „728727602C” . Aceasta este o parte a fragmentului:
(function(i,s,o,g,r,a,m){i=r;i=i||function(){(i.q=i.q||).push(arguments)},i.l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o);a.async=1;a.src=g;m.parentNode.insertBefore(a,m)})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
Când fragmentul este executat, creează mai întâi o nouă funcție globală numită Apoi, fragmentul se încarcă asynchron în Biblioteca Analytics.js de pe pagină.
Funcția globală este modul principal de interacțiune cu Biblioteca Analytics .js Funcția acceptă o secvență de parametri, unde prima reprezintă o comandă Google Analytics. De exemplu, în fragmentul implicit:
ga('create', 'UA-XXXX-Y', 'auto'); // Creates a tracker.ga('send', 'pageview'); // Sends a pageview.
prima linie numește comanda create și, al doilea, send.
Deși codul JavaScript încarcă Biblioteca Analytics.js Asynchron, a fost conceput pentru a fi utilizate înainte de încărcarea bibliotecii. Când începeți să rulați comenzile pentru prima dată, fiecare este adăugat la o coadă. Când biblioteca se termină încărcarea, toate comenzile de coadă și noile comenzi sunt executate imediat. În acest fel, programatorii pot ignora natura asincronă Google Analytics și se concentrează asupra utilizării funcției .
Modificați numele obiectului global
În unele cazuri, este posibil ca un obiect pe pagină să utilizeze deja numele variabilei . Pentru a împiedica anularea obiectului, puteți schimba numele funcției , de exemplu, la __gaTracker. Pentru aceasta, trebuie doar să înlocuiți parametrul în fragmentul anterior:
(function(i,s,o,g,r,a,m){i=r;i=i||function(){(i.q=i.q||).push(arguments)},i.l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o);a.async=1;a.src=g;m.parentNode.insertBefore(a,m)})(window,document,'script','//www.google-analytics.com/analytics.js','__gaTracker');
După aceea, puteți Utilizați __gaTracker în loc de pentru a apela comenzile:
__gaTracker('create', 'UA-XXXX-Y', 'auto');__gaTracker('send', 'pageview');
Fragment Referință JavaScript
În următoarea referință, se arată fragmentul de bază JavaScript, la care au fost adăugate comentarii și spații goale:
<!-- Google Analytics --><script>/** * Creates a temporary global ga object and loads analy tics.js. * Paramenters o, a, and m are all used internally. They could have been declared using 'var', * instead they are declared as parameters to save 4 bytes ('var '). * * @param {Window} i The global context object. * @param {Document} s The DOM document object. * @param {string} o Must be 'script'. * @param {string} g URL of the analytics.js script. Inherits protocol from page. * @param {string} r Global name of analytics object. Defaults to 'ga'. * @param {DOMElement?} a Async script tag. * @param {DOMElement?} m First script tag in document. */(function(i, s, o, g, r, a, m){ i = r; // Acts as a pointer to support renaming. // Creates an initial ga() function. The queued commands will be executed once analytics.js loads. i = i || function() { (i.q = i.q || ).push(arguments) }, // Sets the time (as an integer) this tag was executed. Used for timing hits. i.l = 1 * new Date(); // Insert the script tag asynchronously. Inserts above current tag to prevent blocking in // addition to using the async attribute. a = s.createElement(o), m = s.getElementsByTagName(o); a.async = 1; a.src = g; m.parentNode.insertBefore(a, m)})(window, document, 'script', '//www.google-analytics.com/analytics.js', 'ga');ga('create', 'UA-XXXX-Y', 'auto'); // Creates the tracker with default parameters.ga('send', 'pageview'); // Sends a pageview hit.</script><!-- End Google Analytics -->
Fragmentul asincron alternativ
Deși fragmentul de analiză canonică, descris mai sus garantează că scriptul va fi încărcat și executat asincron în toate browserele, are dezavantajul de a nu permite browserele moderne să facă o sarcină anterioară a scriptului .
Următorul fragment alternativ adaugă compatibilitatea încărcăturii anterioare, care oferă un impuls de performanță mic în browserele moderne, dar Acesta poate fi deteriorat în sarcina sincronă și execuția în IE9 și în browsere pentru dispozitivele mobile anterioare, care nu recunosc atributul async. Vă sugerăm să utilizați acest fragment dacă vizitatorii dvs. utilizează în principal browsere moderne pentru a accesa site-ul dvs.
<!-- Google Analytics --><script async src='//www.google-analytics.com/analytics.js'></script><script>window.ga=window.ga||function(){(ga.q=ga.q||).push(arguments)};ga.l=+new Date;ga('create', 'UA-XXXX-Y', 'auto');ga('send', 'pageview');</script><!-- End Google Analytics -->
Creați obiecte de urmărire
pentru trimiterea datelor La Google Analytics, trebuie să creați un obiect de urmărire. Fiecare dintre aceste obiecte poate trimite date către o singură proprietate Google Analytics Web. Pentru a crea un obiect de urmărire, fragmentul implicit utilizează următorul cod:
ga('create', 'UA-XXXX-Y', 'auto');
unde primul parametru al funcției este comanda create și al doilea este ID-ul proprietății web la care vor fi trimise datele.
Personalizați obiectele de urmărire
Personalizarea obiectului de urmărire trebuie efectuată atunci când este inițial creată, trecând la funcția un obiect de configurare ca ultimul parametru. De exemplu, pentru a anula unele dintre opțiunile de configurare a cookie-urilor, se utilizează:
ga('create', 'UA-12345-6', { 'cookieDomain': 'foo.example.com', 'cookieName': 'myNewName', 'cookieExpires': 20000});
în exemplul anterior, domeniul, numele și timpul de expirare a cookie-urilor au fost modificate Utilizarea obiectului de configurare opțional.
Verificați secțiunea Numai a câmpului Creare câmp de comandă pentru a obține informații complete despre toate câmpurile care pot fi configurate în comanda Creare.
Testarea la localhost
În unele cazuri, puteți încerca Analytics.js de la un server web care rulează pe localhost. Pentru a configura cookie-urile de analiză.JS, trebuie să dezactivați domeniul cookie implicit prin:
ga('create', 'UA-XXXX-Y', { 'cookieDomain': 'none'});
Trimiteți date
Odată ce un obiect de urmărire a fost creat și asociat Cu o proprietate web, puteți utiliza comanda send pentru a trimite date la acea proprietate web. Datele trimise către Google Analytics vor fi numite hit și biblioteca Analytics.js vă permit să trimiteți diferite tipuri de date prin specificarea unui tip de lovitură (hitType). Când utilizați comanda send, trebuie să specificați, de asemenea, valoarea al datelor pe care doriți să le trimiteți.
Prin exemplu, pentru a trimite un video lovit Vista, se utilizează:
ga('send', 'pageview');
În acest mod, datele sunt trimise pentru adresa URL implicită către Google Analytics.
Obiect de nume de câmp
În unele cazuri, puteți anula mai multe valori care sunt trimise ca o vizualizare a paginii. Biblioteca Analytics.js vă permite să trimiteți un obiect de nume de câmp ca ultimul parametru al comenzii send. Acest lucru este util deoarece vă permite să setați multe proprietăți suplimentare ale paginii, de exemplu, titlul său:
ga('send', 'pageview', { 'page': '/my-new-page', 'title': 'My New Page Title'});
Verificați referința câmpului pentru a obține Informații complete cu privire la toate modurile în care un obiect de urmărire poate fi configurat.
Configurați inversarea apelului
în unele cazuri, de exemplu, atunci când urmăriți legăturile de ieșire, puteți ști Când obiectul de urmărire al trimiterii datelor sa terminat. În acest fel, puteți trimite un utilizator destinației dvs. numai după ce faceți clic pe Google Analytics. Pentru a rezolva această situație, comanda send vă permite să specificați o funcție hitCallback în câmpul Nume câmp care va fi executat ca analitică. Js a terminat trimiterea datelor. Apoi, vă arătăm cum să configurați funcția hitCallback:
ga('send', 'pageview', { 'page': '/my-new-page', 'hitCallback': function() { alert('analytics.js done sending data'); }});
În acest exemplu, obiectul câmpului Nume Setați parametrul page și funcția hitCallback. După ce obiectul de urmărire a terminat trimiterea datelor, o casetă de alertă va fi afișată utilizatorului.
Configurați parametrii în mai multe comenzi SEND
În unele cazuri, se recomandă setați Parametru și că valoarea este menținută în mai multe comenzi send. De exemplu, dacă aveți o pagină web, doriți să urmăriți o vizualizare a paginii și două evenimente. Dacă doriți să anulați calea fiecărei lovituri pentru una, puteți seta noul traseu în fiecare comandă send sau utilizați metoda set După cum urmează:
ga('set', 'page', '/my-custom-page');ga('send', 'pageview');ga('send', 'event', 'image1', 'clicked');ga('send', 'event', 'image2', 'clicked');
Când acest cod este executat, pagina substituită /my-custom-page va fi trimis la toate cele trei Trimiteți comenzi div> ca true. Metoda navigator.sendBeacon asigură că datele sunt transmise chiar dacă utilizatorul lasă pagina dvs. sau închide browserul înainte de a fi terminat solicitarea. Acest lucru este foarte util în cazurile în care doriți să urmăriți un eveniment înainte ca un utilizator să iasă din site-ul dvs., fără a întârzia navigarea.
ga('send', 'event', 'click', 'download-me', {useBeacon: true});
funcții de transmisie
Uneori, codul este executat numai după ce biblioteca Analytics.js a fost încărcată. Pentru a face acest lucru, puteți trimite o funcție ca parametru la funcția .
iv id = „AAE4D65673”
când ați terminat încărcarea Biblioteca, utilizatorul va vedea o casetă de alertă.
Obțineți parametri
cu analytics.js, puteți recupera oricare dintre valorile care au fost configurate în obiectul de urmărire Mijloace de comandă get. Deoarece obiectul de urmărire este creat numai atunci când biblioteca a fost încărcată, trebuie să obțineți parametri dintr-o funcție trimisă.
ga(function(tracker) { var defaultPage = tracker.get('page');});
În acest exemplu, stația SUA a Parametrul numit tracker. Când se termină sarcina bibliotecii, funcția este executată și valoarea tracker va fi obiectul de urmărire implicit care a fost creat ca rezultat al primei comenzi create. Apoi, obiectul tracker este utilizat pentru a obține valoarea paginii implicite.
Aplicați SSL (https)
„în mod implicit, Google Analytics va fi ajustat la protocolul paginii gazdă la trimiterea cererilor de ieșire.Pentru a forța Google Analytics Trimiteți întotdeauna date prin SSL, chiar și din pagini nesigure (http), configurați câmpul pe teren ca true:
ga('create', 'UA-XXXX-Y', 'auto');ga('set', 'forceSSL', true); // Send all data using SSL, even from insecure (HTTP) pages.ga('send', 'pageview');
Lucrul cu mai multe obiecte de urmărire
În unele cazuri este recomandabil să trimiteți datele la mai multe proprietăți web dintr-o singură pagină. Acest lucru este util pentru site-urile care au mai mulți proprietari care supraveghează anumite secțiuni ale unui site; Fiecare proprietar putea să-și vadă proprietatea web.
Pentru a rezolva această problemă, trebuie să creați un obiect de urmărire pentru fiecare proprietate web pe care doriți să o trimiteți:
ga('create', 'UA-XXXX-Y', 'auto');ga('create', 'UA-12345-6', 'auto', {'name': 'newTracker'}); // New tracker.
Când sunt executate, vor fi create două obiecte de urmărire. Primul va fi implicit și nu va avea un nume. A doua va fi numită newTracker.
Pentru a trimite o vizualizare a paginii cu ambele obiecte de urmărire, trebuie să setați numele obiectului de urmărire la comandă, urmat de un punct. De exemplu:
ga('send', 'pageview');ga('newTracker.send', 'pageview'); // Send page view for new tracker.
O pagină de vizualizare va fi trimisă atât obiectului de urmărire implicit, cât și la cel nou.
pentru a accesa urmărirea obiect după nume dintr-o funcție, utilizați metoda :
ga(function() { var newTracker = ga.getByName('newTracker');});
pentru a obține o matrice de toate obiectele din Urmărirea care a fost configurată, utilizați metoda getAll:
iv id = „119F93AD18”
Alocarea legăturilor îmbunătățite
Cu atribuirea legăturii îmbunătățite, precizia raportului analitic este mărită de diferențierea automată a mai multor legături cu aceeași adresă URL a paginii cu ID-urile elementului de legătură.
Pentru a activa atribuirea legăturii îmbunătățite: /p>
- permite atribuirea legăturii îmbunătățite în interfața utilizatorului Google Analytics Administration.
- upgrade codul de pe fiecare pagină pentru a încărca pluginul de atribuire îmbunătățit După cum se arată în acest exemplu:
ga('create', 'UA-XXXX-Y', 'auto');ga('require', 'linkid'); // Load the plug-in. Note: this call will block until the plug-in is loaded.ga('send', 'pageview');
Personalizați atribuirea legăturii îmbunătățite
Plug-ul de atribuire a link-ului îmbunătățește distinge între legăturile către Aceeași adresă URL utilizând ID-urile elementului dintr-un link sau un element principal, precum și un modul cookie. Puteți personaliza cât de departe veți căuta pluginul în ID-ul DOM un element, precum și comportamentul acestui modul cookie, oferind opțiunile de configurare la încărcarea pluginului:
ga('create', 'UA-XXXX-Y', 'auto');ga('require', 'linkid', { 'cookieName': '_ela', // Cookie name. _gali by default. 'duration': 45, // Cookie duration. 30 seconds by default. 'levels': 5}); // Max DOM levels from link to look for element ID. 3 by default.ga('send', 'pageview');
Conversia IPS în anonim
În unele cazuri, este posibil să fie necesar să deveniți o adresă IP anonimă a HIT (solicitarea HTTP) care este trimisă către Google Analytics. Puteți converti în adrese IP anonime ale tuturor hit-urilor trimise de pe o pagină (durata obiectului de urmărire) utilizând comanda set și setări de câmp :
ga('set', 'anonymizeIp', true);
Pentru a converti adresa IP a unui individ a lovit anonim, puteți configura Câmpul anonymizeIp în obiectul de configurare opțional a spus:
ga('send', 'pageview', { 'anonymizeIp': true});
Pentru mai multe informații despre funcționarea Conversia IP în anonim, a se vedea articolul Conversia IPS în anonim în Google Analytics la centrul de ajutor.
Descalificare utilizator
În unele cazuri, este necesar să dezactivați Google Analytics Codul de urmărire pe o pagină fără a fi nevoie să ștergeți fragmentul JavaScript. De exemplu, puteți să o faceți dacă Politica de confidențialitate a site-ului dvs. include posibilitatea ca un utilizator să dezactiveze urmărirea Google Analytics.
Biblioteca Analytics.js include o proprietate de fereastră care, atunci când este configurată ca true, dezactivează trimiterea datelor Analytics.js către Google Analytics. Când Google Analytics încearcă să configureze un cookie sau să returneze date la serverele Google Analytics, verificați dacă această proprietate a fost configurată ca true. Dacă da, va avea același efect ca și cum utilizatorul a instalat pluginul de dezactivare pentru browserele Google Analytics.
Pentru a dezactiva urmărirea, configurarea următoarei proprietăți de fereastră ca true:
window = true;
unde valoarea UA-XXXX-Y corespunde ID-ului de proprietate web în care doriți să dezactivați urmărirea .
Această proprietate de fereastră trebuie să fie configurată înainte de a apela codul de urmărire. Această proprietate trebuie să fie configurată pe fiecare pagină unde doriți să dezactivați urmărirea Google Analytics. Dacă proprietatea nu este configurată sau a fost configurată ca falsă, urmărirea va funcționa în mod obișnuit.
Exemplu
Apoi, un exemplu simplu al codului pe care îl puteți utiliza este afișat pentru a oferi utilizatorilor funcționalitatea dezactivată.
În primul rând, adaugă o nouă legătură HTML La site-ul pentru a rula logica de dezactivare:
<a href="javascript:gaOptout()">Click here to opt-out of Google Analytics</a>
adăugați următorul fragment de cod înainte de fragmentul de cod Analytics.js. Nu uitați să înlocuiți valoarea UA-XXXX-Y al de către proprietatea utilizată pe site. Este aceeași valoare care este transmisă comenzii create.
<script>// Set to the same value as the web property used on the sitevar gaProperty = 'UA-XXXX-Y';// Disable tracking if the opt-out cookie exists.var disableStr = 'ga-disable-' + gaProperty;if (document.cookie.indexOf(disableStr + '=true') > -1) { window = true;}// Opt-out functionfunction gaOptout() { document.cookie = disableStr + '=true; expires=Thu, 31 Dec 2099 23:59:59 UTC; path=/'; window = true;}</script>
Când un utilizator face clic pe link HTML dezactivarea, funcția . Un cookie va fi configurat cu o durată lungă și colectarea datelor Analytics.js va fi dezactivată. Când un utilizator revine la acest site, cu scriptul anterior, acesta va fi verificat dacă cookie-ul de descalificare a fost configurat. Dacă da, colecția de date Analytics.js va fi, de asemenea, dezactivată.
Debugging
Puteți activa versiunea de depanare a DIV id = „b4895048ee”> :
ar trebui să fie utilizate temporar sau în timpul dezvoltării, deoarece analytics_debug.js<. pentru a permite acest tip de depanare utiliza>https://www.google-analytics.com/analytics_debug.js și această linie de cod înainte de fragment:
iv id = „b40bc5e5f9”