Informace o fragmentu gtag.js
Pokud používáte kód analytics.js pro svou stávající službu Universal Analytics, budete muset přidat fragment gtag.js pro novou službu Google Analytics 4. Fragment gtag.js má tuto strukturu:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID 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 7: Direktiva gtag „config“ umožňuje shromažďovat data do přidružené služby s <ID služby A>. Když například přidáte tuto direktivu s ID značky pro službu v Google Analytics 4, budou se do této služby odesílat události page_view
.
Číslo služby může představovat různé služby Google, včetně služby UA (UA-XXXXXXXX), Google Analytics 4 (G-XXXXXXXX), 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 nasměruje do konkrétní služby. Tato událost tedy bude odeslána jen do služby určené pomocí <ID služby B>.
Základní shromažďování dat pro službu Google Analytics 4 se aktivuje direktivou gtag „config“ a umožňuje shromažďovat události page_view při načtení stránky (v podobě automaticky shromažďovaných událostí).
Požadavek na server na zobrazení stránky nebo událost page_view lze upravit nebo zablokovat použitím specifických parametrů.
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 pro 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.
Základní shromažďování dat
Po aktivaci základního shromažďování dat ve službě v Google Analytics 4 bude možné shromažďovat tyto údaje:
- události page_view,
- automaticky shromažďované události,
- události s vylepšeným měřením (pokud jsou v uživatelském rozhraní povoleny).
Pokud chcete aktivovat základní shromažďování dat pro službu v Google Analytics 4, přidejte do sekce <head>
na každé stránce fragment gtag.js (značku Google).
Fragment gtag.js ve srovnání s fragmentem analytics.js
Fragment gtag.js pro službu v Google Analytics 4 má podobnou funkci jako fragment analytics.js v Universal Analytics.
Největší rozdíl spočívá v tom, že fragment analytics.js obsahuje samostatný příkaz „send pageview“, zatímco gtag.js nikoli. Ve fragmentu gtag.js se zobrazení stránky odesílá direktivou „config“ jako automaticky shromažďovaná událost.
Služba v Universal Analytics (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>
Služba v 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>
Konfigurace fragmentu gtag.js
Základní fragment kódu gtag.js můžete nakonfigurovat tak, aby řídil shromažďování údajů, například maskování IP adres, přizpůsobení cookies a signály Google, podobně jako fragment analytics.js. Využít k tomu můžete direktivy „config“ nebo „set“ (v analytics.js to jsou „set“, „create“ a „require“).
Služby v Google Analytics 4 (G-XXXXXXXX) podporují implementaci podobného nastavení prostřednictvím fragmentu gtag.js. Mezi těmito nastaveními pro služby v Universal Analytics a v Google Analytics 4 jsou určité rozdíly. Berte v úvahu následující skutečnosti:
- Maskování IP adres je standardizováno jako „true“ a ve službě v Google Analytics 4 je nelze konfigurovat. U standardní události pro službu v Google Analytics 4 (G-XXXXXXXX) je proto IP adresa automaticky maskována.
- Pokud potřebujete použít globální nastavení na všechny konfigurované služby, měli byste k tomu využít příkaz „set“, aby se nastavení použila na všechna ID značek i ID služeb.
- Ve fragmentu analytics.js věnujte pozornost zejména inzertním funkcím a personalizaci reklam, které jsou řádkem „set“ implementovány nejčastěji.
Pokud ve stávající implementaci kódu analytics.js používáte direktivy „set“, „create“ a „require“, zjistěte, které z nich se ve službě v Google Analytics 4 nastaví automaticky a které bude potřeba zadat do kódu služby v Google Analytics 4 (mapování parametrů).
Níže najdete příklady konfigurace s ukázkami kódu v analytics.js (pro službu UA) a gtag.js (pro službu v Google Analytics 4):
Aktivace shromažďování základních dat, konfigurace 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'
});
Konfigurace nastavení souborů cookie
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Čas v sekundách.
});
gtag.js
gtag('config', 'TAG_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 které 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 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', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Názvy značek
Názvy značek (tzv. měřicí prvky) se používají v případě, že chcete odesílat data do různých služeb Universal Analytics prostřednictvím analytics.js. Názvy značek v analytics.js definují, do které služby chcete data odeslat. Po zadání úvodního požadavku na server „create“ už není potřeba uvádět ID služby Universal Analytics, stačí název značky.
Ve fragmentu gtag.js nejsou měřicí prvky k dispozici pro služby v Google Analytics 4 ani pro služby v Universal Analytics. Pokud chcete všechny požadavky na server odesílat do více služeb (různé datové streamy ve službě v Google Analytics 4), zadejte všechna ID značek a ID služeb do řádku „config“.
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í získávaných z webu a k importu offline dat, např. ze systémů řízení vztahů se zákazníky. Ve službě v Universal Analytics (UA-XXXXXXXX) je třeba vlastní dimenze a metriky vytvořit v uživatelském rozhraní, kde je jim přiřazeno ID. Pak je můžete implementovat nebo importovat. Lze je vytvořit se čtyřmi různými rozsahy: požadavek na server, návštěva, uživatel a produkt.
Ve službě v Google Analytics 4 (G-XXXXXXXX) se vlastní dimenze a metriky implementují jiným způsobem. Vlastní dimenze a metriky ve službě UA implementované prostřednictvím fragmentu analytics.js je třeba ve službě v Google Analytics 4 znovu implementovat jako parametry.
Vlastní dimenze ve službě v Universal Analytics lze implementovat fragmentem analytics.js takto:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
NEBO
ga('set', 'dimension5', 'custom data');
Tyto vlastní dimenze je možné převést do služby v Google Analytics 4 prostřednictvím fragmentu gtag.js takto:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
NEBO
gtag('set', {'dimension5': 'custom data'});
Dávejte nicméně pozor na dvě skutečnosti:
- Aby se parametry v přehledech zobrazovaly, musí být registrovány v uživatelském rozhraní. Podobně se registrují i vlastní dimenze v Universal Analytics (platí určitá omezení). Pokud chcete mít k dispozici jen exportovaná data nebo daný parametr používat jenom k aktivaci publika, parametry registrovat nemusíte.
- Rozsah vlastních parametrů je vždy na úrovni události, která je srovnatelná s úrovní požadavku na server. Týká se to i vlastních dimenzí, které se automaticky převádí na parametry (v případě implementace fragmentem gtag.js UA-XXXXXXXX), a to nezávisle na původním nastavení rozsahu dané dimenze.
Podobné je to i u mapování vlastních metrik. Na ty se ale po registraci do přehledů vztahují limity na číselné parametry, nikoli limity na textové parametry.
Vlastní dimenze a metriky různých rozsahů ze služby Universal Analytics se do služby Google Analytics 4 v principu mapují takto:
- Vlastní dimenze na úrovni požadavku na server: parametr (na jednu událost lze při shromažďování dat zaznamenat nejvýše 25 parametrů; nejvýše 50 vlastních dimenzí / 50 vlastních metrik)
Upozorňujeme, že pro některé případy použití, kdy se dřív používaly vlastní dimenze na úrovni požadavku na server, mohou nyní dostačovat automaticky shromažďované události a parametry. - Vlastní dimenze s rozsahem na úrovni uživatele: charakteristiky uživatele (v uživatelském rozhraní lze u přehledů zaregistrovat maximálně 25 parametrů). Automaticky shromažďované charakteristiky uživatele se do tohoto limitu nezapočítávají.
- Vlastní dimenze s rozsahem na úrovni návštěvy: ve službě Google Analytics 4 nemají žádný ekvivalent. Využijte místo nich vlastní parametry nebo charakteristiky uživatele.
Doporučené postupy pro charakteristiky uživatele
Charakteristiky uživatele se přiřazují k jednomu uživateli na různých platformách (např. ve všech typech datových streamů), a proto by se měly používat pouze v případě, že se data mají vztahovat na úroveň uživatele. Charakteristiky uživatele by se neměly používat pro data na úrovni návštěv ani data na úrovni zařízení (např. velikost obrazovky).
Příklad služby Google Analytics 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});