[UA→GA4] Ako sa gtag.js pre UA mapuje k službe GA4

Toto je príručka implementácie pre vlastníkov webov, ktorí používajú knižnicu gtag.js a chcú pochopiť, ako sa gtag.js pre Universal Analytics (UA) mapuje k službe Google Analytics 4. Predpokladá sa, že už máte vytvorené vlastníctvo v službe Google Analytics 4. Ak len potrebujete na svoj web pridať základný kód merania, prečítajte si tento článok.
Obsah tohto článku:

Útržok gtag.js a identifikátory vlastníctiev

Útržky gtag.js pre vlastníctvo služby Universal Analytics a vlastníctvo služby Google Analytics 4 sú v zásade rovnaké. Oba útržky majú nasledujúcu štruktúru:

01: <script async src="https://www.googletagmanager.com/gtag/js?id=<identifikátor nejakého vlastníctva A>"></script>

02: <script>

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

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

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

06:

07: gtag('config', '<identifikátor nejakého vlastníctva A>');

08:

09: gtag('config', '<identifikátor nejakého vlastníctva B>');

10:

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

12:

13: gtag('event', 'view_video', { 'send_to': '<identifikátor nejakého vlastníctva B>' });

14:

15: </script>

1. riadok: Ak ste implementovali vlastníctvo v službe Universal Analytics pomocou značky gtag.js, pravdepodobne už tento riadok kódu máte na webe. Namiesto hodnoty <identifikátor nejakého vlastníctva A> uvidíte text „UA-“, za ktorým nasleduje sled čísel. Ak ste implementovali značku gtag.js pre Google Ads alebo inú službu zo súpravy služieb Google Marketing Platform, možno budete mať na webe aj tento riadok kódu, ale <identifikátor nejakého vlastníctva A> sa bude začínať reťazcom „AW-“ alebo „DC-“.

Identifikátor vlastníctva (alebo identifikátor značky pre vlastníctva v službe Google Analytics 4) s označením <identifikátor nejakého vlastníctva A> ovláda tento útržok gtag.js. Je to dôležité z týchto dôvodov:

  1. Ak je tento riadok už uvedený, nemusíte ho implementovať druhýkrát. Budete len musieť pridať riadok „config“, v ktorom uvediete identifikátor značky.
  2. Identifikátor vlastníctva v tomto riadku funguje ako riadiaci prvok útržku gtag.js. Ak ovláda značku identifikátor vlastníctva v službe Universal Analytics (UA-XXXXXXXX), budete môcť použiť pripojené značky webu na odosielanie údajov merania do služby Google Analytics 4 bez toho, aby ste na stránku museli pridávať nový kód.

7. riadok: Príkaz „config“ gtag povolí zhromažďovanie údajov v prospech vlastníctva uvedeného v časti <identifikátor nejakého vlastníctva A>. Napríklad v prípade vlastníctva v službe Google Analytics 4 sa pridaním tohto príkazu s identifikátorom značky budú danému vlastníctvu odosielať udalosti page_view.

Identifikátor vlastníctva môže predstavovať meranie pre rôzne služby Googlu vrátane vlastníctva v službe Universal Analytics (UA-XXXXXXXX), vlastníctva v službe Google Analytics 4 (G-XXXXXXXX), Google Ads (AW-XXXXXXXX) alebo Floodlight (DC-XXXXXXXX).

11. riadok: Príkaz „event“ gtag odošle udalosť. V prípade útržkov obsahujúcich viacero príkazov „config“ pre viaceré vlastníctva sa udalosť odošle všetkým vlastníctvam.

V tomto príklade označuje parameter „sign_up“ názov udalosti. Posledný parameter je objekt, ktorý obsahuje skupinu parametrov udalosti. V tomto prípade je „method“ parameter s hodnotou „email“.

13. riadok: Uvedená udalosť má „send_to“ ako parameter. Ide o špeciálny parameter, ktorý odosiela súvisiacu udalosť konkrétnemu vlastníctvu. Inými slovami, táto udalosť sa odošle iba vlastníctvu uvedenému v časti <identifikátor nejakého vlastníctva B>.

Príkaz config značky gtag umožňuje základné meranie.

  • V prípade vlastníctva v službe Universal Analytics odosiela „config“ s identifikátorom vlastníctva v službe Universal Analytics prístup typu zobrazenie stránky.
  • V prípade vlastníctva v službe Google Analytics 4 povolí príkaz „config“ s identifikátorom značky takéhoto vlastníctva zhromažďovanie udalostí page_view (ako automaticky zhromažďovanú udalosť) pri načítaní na stránke.

Identifikátory vlastníctiev

Identifikátory vlastníctiev v službe Universal Analytics majú formát UA-XXXXXXXX. Niekedy sa tento identifikátor označuje ako identifikátor sledovania. V tomto sprievodcovi ho budeme označovať ako identifikátor vlastníctva UA.

Streamy webových údajov v službe Google Analytics 4 používajú identifikátor merania vo formáte G-XXXXXXXX.

V niektorých príkladoch kódu a dokumentácii môžete vidieť oba s označením TAG_ID.

Základné zhromažďovanie údajov

Ak povolíte základné zhromažďovanie údajov pre vlastníctvo v službe Google Analytics 4, bude možné zhromažďovať tieto údaje:

Ak vaše existujúce vlastníctvo v službe Universal Analytics používa implementáciu značky gtag.js, pre vlastníctvo v službe Google Analytics 4 môžete povoliť základné zhromažďovanie údajov týmito spôsobmi:

  • 1. možnosť: pridanie nového príkazu „config“ s relevantným identifikátorom značky
    ALEBO
  • 2. možnosť: zapnutie pripojených značiek webu (ak je vaša existujúca implementácia značky gtag.js vhodná).

Bez ohľadu na zvolenú možnosť zostane vaše existujúce vlastníctvo v službe Universal Analytics nezmenené a bude naďalej zhromažďovať údaje.

1. možnosť: pridanie nového príkazu „config“

Ak sa na stránke nachádza kód gtag.js, jednoducho pridajte príkaz „config“ s relevantným identifikátorom merania vlastníctva v službe Google Analytics 4. V príklade nižšie bol 8. riadok pridaný do existujúcej implementácie značky gtag.js. Odkazuje na identifikátor merania v službe Google Analytics 4. Táto akcia odošle udalosti page_view do tohto vlastníctva v službe Google Analytics 4. V tomto vlastníctve typu aplikácia a web tiež povolí automaticky zhromažďované udalosti a udalosti rozšíreného merania (ak ste povolili rozšírené meranie).

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<identifikátor nejakého vlastníctva A>"></script>

2: <script>

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

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

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

6:

7: gtag('config', '<identifikátor nejakého vlastníctva A>');

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

9: </script>

2. možnosť: zapnutie pripojených značiek webu

Pripojenú značku webu môžete použiť, ak:

  • Je existujúci útržok gtag.js na stránke, na ktorej chcete merať interakcie používateľov, „ovládaný“ vlastníctvom v službe Universal Analytics (t. j. identifikátor uvedený v tomto riadku útržku gtag.js sa začína reťazcom „UA-“):

<script async src="https://www.googletagmanager.com/gtag/js?id=<identifikátor nejakého vlastníctva A>"></script>

(Pripojené značky webu budú fungovať aj vtedy, ak existujúci útržok gtag.js ovláda vlastníctvo v službe Google Analytics 4. Táto situácia by však nastala len v prípade, že vlastníctvo v službe Google Analytics 4 už bolo implementované.)

  • A máte prístup pre správcu k vlastníctvu v službe Universal Analytics, na ktoré odkazuje identifikátor v útržku.
Ak máte na stránke implementovanú značku gtag.js aj kontajner Správcu značiek Google, značka gtag.js musí byť umiestnená nad kontajnerom Správcu značiek Google, aby pripojené značky webu fungovali.

Nastavenia konfigurácie pre gtag.js

Môžete konfigurovať základný útržok gtag.js na ovládanie nastavení zhromažďovania údajov, ako sú anonymizácia adries IP, prispôsobenia súborov cookie a signály Googlu. Môžete to dosiahnuť použitím príkazov „config“ alebo „set“ v značke gtag.js.

Vlastníctva v službe Universal Analytics (UA-XXXXXXXX) aj Google Analytics 4 (G-XXXXXXXX) podporujú implementáciu týchto nastavení konfigurácie prostredníctvom značky gtag.js. Medzi týmito nastaveniami vlastníctiev v službe Universal Analytics a Google Analytics 4 však existuje niekoľko rozdielov. 

  • Anonymizácia adries IP je štandardizovaná na hodnotu „true“ a nedá sa konfigurovať vo vlastníctve v službe Google Analytics 4. Adresa IP sa ako taká automaticky maskuje pomocou štandardnej udalosti k vlastníctvu v službe Google Analytics 4 (G-XXXXXXXX).
  • Keď treba použiť globálne nastavenia pre všetky konfigurované vlastníctva, mal by sa použiť príkaz „set“ pre všetky identifikátory merania alebo identifikátory vlastníctiev vrátane tých, ktoré sú implementované prostredníctvom pripojených značiek webu.
  • Osobitnú pozornosť venujte funkciám deaktivácie prispôsobenia reklám, ktoré sa najčastejšie implementujú pomocou riadka „config“.
  • Keď používate pripojené značky webu: konfigurácie vykonané v kóde gtag.js pomocou príkazu „config“ sa týkajú iba vlastníctva spojeného s identifikátorom merania v danom riadku kódu. Nebudú sa automaticky posielať do prepojeného vlastníctva v službe Google Analytics 4. Ak chcete konfiguráciu použiť pre prepojené vlastníctvo v službe Google Analytics 4,
    • vytvorte samostatný príkaz „config“ a použite ho v relevantnom vlastníctve v službe Google Analytics 4 uvedením identifikátora merania,
      ALEBO
    • konfigurujte nastavenie pomocou príkazu „set“. V takom prípade bude konfigurácia použitá pre všetky konfigurované vlastníctva.

Príklady konfigurácie

Povolenie základného zhromažďovania údajov; konfigurácia identifikátora používateľa

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

Konfigurácia nastavení súborov cookie

gtag('config', 'GA_MEASUREMENT_ID', {

'cookie_prefix': 'MyCookie',

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

'cookie_expires': 28 * 24 * 60 * 60 // 28 dní, v sekundách

});

Blokovanie udalosti page_view

Ak nepotrebujete odosielať udalosť page_view pri načítaní konfiguračného kódu (ak máte napríklad načítavanie prvku iframe), môžete upraviť nastavenie konfigurácie tak, aby sa blokovala udalosť page_view. Pouvažujte nad scenárom, kedy sa odošle udalosť page_view a následne sa používateľ prihlási na webe. Pre interakciu prihlásenia použijete príkaz „config“ na nastavenie identifikátora používateľa, ale nechcete odoslať ďalšiu udalosť page_view. Nasledujúci kód znázorňuje, ako zabrániť odosielaniu udalosti page_view.

gtag('config', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

Udalosti

Pozrite si sprievodcu migráciou udalostí.

Vlastné dimenzie a metriky

Vlastné dimenzie a metriky možno použiť na rozšírenie informácií a import offline údajov, napr. zo systémov riadenia vzťahov so zákazníkmi.

Pri používaní značky Google (gtag.js) sú merania vlastných dimenzií a metrík automaticky prevedené do parametrov, ak sa používajú pripojené značky webu alebo vlastníctvo v službe Google Analytics 4 (napr. G-XXXXXXXX).

Prečítajte si viac o vlastných dimenziách a metrikách.

 

Pomohlo vám to?

Ako ju môžeme zlepšiť?
Vyhľadávanie
Vymazať vyhľadávanie
Zavrieť vyhľadávanie
Hlavná ponuka
6816936724925139258
true
Vyhľadávanie v Centre pomoci
true
true
true
true
true
69256
false
false