[UA→GA4] Jak se kód gtag.js pro UA mapuje na službu GA4

V tomto článku najdete pokyny pro implementaci určené vlastníkům webových stránek, kteří používají knihovnu gtag.js a chtějí vědět, jak se kód gtag.js pro Universal Analytics (UA) mapuje na službu Google Analytics 4. Předpokládá se, že jste již vytvořili službu Google Analytics 4. Pokud jen potřebujete přidat na web základní měřicí kód, přečtěte si místo něj tento článek.

Obsah tohoto článku:

• Informace o fragmentu gtag.js
• Shromažďování základních dat
• Konfigurace fragmentu gtag.js
• Události
• Vlastní dimenze a metriky

Fragment gtag.js a ID služeb

Fragmenty gtag.js pro službu Universal Analytics a pro službu Google Analytics 4 jsou v zásadě stejné. Oba mají následující strukturu:

01: <script async src="https://www.googletagmanager.com/gtag/js?id=<ID služby A>"></script>

02: <script>

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

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

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

06:

07: gtag('config', '<ID služby A>');

08:

09: gtag('config', '<ID služby B>');

10:

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

12:

13: gtag('event', 'view_video', { 'send_to': '<ID služby B>' });

14:

15: </script>

Řádek 1: Pokud jste službu Universal Analytics implementovali pomocí fragmentu gtag.js, tento řádek už nejspíš na webu máte. Místo <ID služby A> uvidíte řetězec „UA-“ následovaný řadou čísel. Pokud jste fragmentem gtag.js implementovali Google Ads nebo jinou službu ze sady Google Marketing Platform, tento řádek kódu se na vašem webu může vyskytovat také. V takovém případě se ale místo <ID služby A> bude řada čísel s předponou „AW-“ nebo „DC-“.

ID služby (nebo ID značky pro služby Google Analytics 4) uvedené místo řetězce <ID služby A> funguje jako řídicí prvek fragmentu gtag.js. To je důležité z následujících důvodů:

1. Pokud je tento řádek už přítomen, nemusíte ho implementovat znovu. Bude potřeba přidat jen řádek „config“ pro zadání ID značky.
2. ID služby v tomto řádku funguje jako řídicí prvek fragmentu gtag.js. Pokud značku řídí ID služby Universal Analytics (UA-XXXXXXXX), můžete měřená data odesílat do služby Google Analytics 4 prostřednictvím připojených značek webu a na stránku nemusíte přidávat nový kód.

Řádek 7: Direktiva gtag „config“ umožňuje shromažďovat data do přidružené služby s <ID služby A>. Ve službě Google Analytics 4 lze přidáním této direktivy s ID značky například odesílat do služby události page_view.

ID služby může odkazovat na měření pro různé služby Google včetně služby Universal Analytics (UA-XXXXXXXX), služby v Google Analytics 4 (G-XXXXXXXX), Google Ads (AW-XXXXXXXX) nebo Floodlight (DC-XXXXXXXX).

Řádek 11: Direktiva gtag „event“ odešle událost. Pokud se v kódu nachází několik direktiv „config“ pro různé služby, bude událost odeslána všem službám.

V tomto příkladu je názvem události parametr „sign_up“. Poslední parametr je objekt obsahující sadu parametrů událostí. V našem případě má parametr „method“ hodnotu „email“.

Řádek 13: Tato událost má jako parametr „send_to“. Jedná se o speciální parametr, který událost odešle do konkrétní služby. Tato událost tedy bude odeslána jen do služby s označením <ID služby B>.

Příkaz gtag config aktivuje základní měření.

• U služby Universal Analytics odesílá příkaz config s ID služby Universal Analytics požadavek na server typu zobrazení stránky.
• U služby v Google Analytics 4 umožňuje direktiva „config“ s ID značky shromažďovat události page_view (jako automaticky shromažďované události) při načtení stránky.

Identifikátory služby

ID služeb Universal Analytics mají formát UA-XXXXXXXX. Někdy se také označují jako ID měření. V tomto průvodci je budeme označovat jako ID služby UA.

Webové datové streamy služby v Google Analytics 4 používají ID značky ve formátu G-XXXXXXXX.

V některých ukázkách kódů a dokumentaci mohou být oba tyto typy ID označeny jako TAG_ID.

Shromažďování základních dat

Po aktivaci shromažďování základních dat ve službě Google Analytics 4 bude možné shromažďovat tyto údaje:

• události page_view,
• automaticky shromažďované události,
• události vylepšeného měření (pokud jsou v uživatelském rozhraní povoleny).

Pokud vaše stávající služba Universal Analytics používá implementaci gtag.js, můžete základní shromažďování dat pro službu v Google Analytics 4 aktivovat následujícími způsoby:

• 1. možnost: Přidání nové direktivy „config“ s příslušným ID značky
  NEBO
• 2. možnost: Zapnutí připojených značek webů (pokud vaše stávající implementace gtag.js splňuje podmínky).

U obou možností zůstane stávající služba Universal Analytics nedotčena a bude dál shromažďovat data.

Možnost 1: Přidání nové direktivy „config“

Pokud na stránce kód gtag.js už existuje, jednoduše přidejte další direktivu „config“ s relevantním ID měření služby Google Analytics 4. V ukázkovém kódu níže byl ke stávající implementaci gtag.js přidán řádek 8. Odkazuje na ID měření služby Google Analytics 4. To do dané služby Google Analytics 4 odešlete události page_view. Aktivuje to také automaticky shromažďované události a události vylepšeného měření (pokud jste v dané službě Google Analytics 4 povolili vylepšené měření).

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<ID služby A>"></script>

2: <script>

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

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

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

6:

7: gtag('config', '<ID služby A>');

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

9: </script>

Možnost 2: Aktivace připojených značek webů

Připojenou značku webu můžete použít v těchto případech:

• Stávající fragment gtag.js na stránce, na které chcete měřit interakce uživatelů, je řízen službou Universal Analytics (ID uvedené v tomto řádku fragmentu začíná „UA-“):

<script async src="https://www.googletagmanager.com/gtag/js?id=<ID služby A>"></script>

(Připojené značky webu budou fungovat i v případě, že stávající fragment kódu gtag.js je řízen službou Google Analytics 4. S tím se však setkáte jen za předpokladu, že jste službu Google Analytics 4 už implementovali.)

• A ZÁROVEŇ máte přístup pro administrátora ke službě Universal Analytics, na kterou odkazuje ID ve fragmentu kódu.

Pokud máte na stránce implementovanou značku gtag.js i kontejner Správce značek Google, značka gtag.js musí být umístěna nad kontejnerem Správce značek Google, jinak připojené značky webu nebudou fungovat.

Konfigurace fragmentu gtag.js

Základní fragment kódu gtag.js můžete nakonfigurovat tak, aby řídil shromažďování údajů, například anonymizaci IP adres, přizpůsobení souborů cookie nebo signály Google. Využít k tomu můžete direktivy „config“ nebo „set“.

Implementaci těchto konfiguračních nastavení prostřednictvím fragmentu gtag.js podporují služby Universal Analytics (UA-XXXXXXXX) i Google Analytics 4 (G-XXXXXXXX). Mezi těmito nastaveními pro služby Universal Analytics a Google Analytics 4 však existuje několik rozdílů. 

• Anonymizace IP adres je standardizována jako „true“ a ve službě Google Analytics 4 ji nelze konfigurovat. U standardní události pro službu Google Analytics 4 (G-XXXXXXXX) je proto IP adresa automaticky maskována.

• Pokud potřebujete použít globální nastavení na všechny nakonfigurované služby, měli byste k tomu využít příkaz „set“, aby se nastavení použila na všechna ID měření i ID služeb včetně těch implementovaných prostřednictvím připojených značek webu.
• Zvláštní pozornost věnujte deaktivaci funkcí personalizace reklam, které jsou nejčastěji implementovány řádkem s direktivou „config“.
• Pokud používáte připojené značky webu: Nastavení ve fragmentu gtag.js v direktivě „config“ se týkají jen služby, jejíž ID měření je v daném řádku kódu uvedeno, a nebudou se automaticky odesílat do připojené služby Google Analytics 4. Pokud chcete, aby byla konfigurace použita na připojenou službu Google Analytics 4,
  • vytvořte samostatnou direktivu „config“ a použijte ji na příslušnou službu Google Analytics 4 uvedením jejího ID měření
    NEBO
  • zadejte požadované nastavení pomocí direktivy „set“, která konfiguraci použije na všechny nakonfigurované služby.

Příklady konfigurací

Aktivace shromažďování základních dat, konfigurace User-ID

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

Konfigurace nastavení souborů 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

});

Zablokování události page_view

Pokud při načítání konfiguračního kódu nechcete odesílat událost page_view (načítání probíhá například prostřednictvím prvku iframe), můžete nastavení direktivy „config“ upravit tak, abyste událost page_view zablokovali. Představte si situaci s odesláním události page_view, po níž následuje přihlášení uživatele na web. Pro interakci přihlášení používáte direktivu „config“ k nastavení User-ID, ale nechcete tím odesílat další událost page_view. V následujícím ukázkovém kódu můžete vidět, jak lze odeslání události page_view zabránit.

gtag('config', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

Události

Přečtěte si průvodce migrací událostí.

Vlastní dimenze a metriky

Vlastní dimenze a metriky lze použít k rozšíření informací a k importu offline dat, např. ze systémů řízení vztahů se zákazníky.

Pokud používáte připojené značky webu nebo službu Google Analytics 4 (např. G-XXXXXXXX), hodnoty vlastních dimenzí a metrik se značkou Google (gtag.js) se automaticky převedou na parametry.

Další informace o vlastních dimenzích a metrikách