Om gtag.js-kodestykket
Hvis du bruger analytics.js til din eksisterende Universal Analytics-ejendom, skal du tilføje gtag.js-kodestykket for din nye Google Analytics 4-ejendom. gtag.js-kodestykket har følgende struktur:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Et ejendoms-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', '<Et ejendoms-id A>');
08:
09: gtag('config', '<Et ejendoms-id B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Et ejendoms-id B>' });
14:
15: </script>
Linje 7: gtag-"config"-direktivet aktiverer dataindsamling til den ejendom, der er knyttet til <Et ejendoms-id A>. Hvis du f.eks. tilføjer dette direktiv med et tag-id for en Google Analytics 4-ejendom, sendes der page_view-hændelser til den pågældende ejendom.
Ejendoms-id'et kan repræsentere forskellige Google-produkter, herunder en Universal Analytics-ejendom ("UA-XXXXXXXX"), en Google Analytics 4-ejendom ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") eller Floodlight ("DC-XXXXXXXX).
Linje 11: gtag-hændelsesdirektivet sender en hændelse. I kodestykker, hvor der er flere "config"-direktiver for flere ejendomme, sendes hændelsen til alle ejendomme.
I dette eksempel er parameteren "sign_up" hændelsesnavnet. Den sidste parameter er et objekt, der indeholder et sæt hændelsesparametre. I dette tilfælde er "method" en parameter med værdien "email".
Linje 13: Denne hændelse har "send_to" som en parameter. Dette er en særlig parameter, der "dirigerer" den tilknyttede hændelse til en bestemt ejendom. Denne hændelse sendes med andre ord kun til den ejendom, der er angivet med <Et ejendoms-id B>.
Grundlæggende dataindsamling for en Google Analytics 4-ejendom aktiveres via gtag-"config"-direktivet, og det muliggør indsamling af hændelser af typen page_view som en automatisk indsamlet hændelse, når det indlæses på en side.
Sidevisningshittet eller page_view-hændelsen kan ændres eller blokeres ved hjælp af specifikke parametre.
Ejendoms-id'er
Universal Analytics-ejendoms-id'er har formatet "UA-XXXXXXXX". Dette kaldes nogle gange sporings-id'et. I denne guide henviser vi til det som UA-ejendoms-id'et.
Webdatastrømme for Google Analytics 4-ejendomme bruger et tag-id med formatet "G-XXXXXXXX".
I nogle kodeeksempler og nogle typer dokumentation kaldes de begge for "TAG_ID".
Grundlæggende dataindsamling
Aktivering af grundlæggende dataindsamling for en Google Analytics 4-ejendom gør det muligt at indsamle følgende:
- page_view-hændelser
- automatisk indsamlede hændelser
- hændelser til forbedret måling (hvis disse er aktiveret i brugerfladen)
Hvis du vil aktivere grundlæggende dataindsamling for din Google Analytics 4-ejendom, skal du føje gtag.js-kodestykket (Google-tagget) til <head>-sektionen på alle sider.
gtag.js-kodestykket sammenlignet med analytics.js-kodestykket
Gtag.js-kodestykket for en Google Analytics 4-ejendom har samme formål som analytics.js-kodestykket for en Universal Analytics-ejendom.
Den største forskel på disse to kodestykker er, at analytics.js-koden omfatter et separat "send sidevisning"-kald. I gtag.js er sidevisning en automatisk indsamlet hændelse, der sendes sammen med "config"-direktivet.
Universal Analytics-ejendom (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>
Google Analytics 4-ejendom (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>
Konfigurationsindstillinger for gtag.js
Du kan konfigurere det grundlæggende gtag.js-kodestykke til at styre dataindsamlingsindstillinger såsom IP-maskering, cookietilpasninger og Google-signaler på samme måde som analytics.js. Dette gøres via "config"- eller "set"-direktiverne i gtag.js (og via "set,"- "create"- og "require"-direktiverne i analytics.js.)
Google Analytics 4-ejendomme ("G-XXXXXXXX") understøtter implementering af lignende konfigurationsindstillinger via gtag.js. Der er forskel på disse indstillinger for Universal Analytics- og Google Analytics 4-ejendomme. Vær opmærksom på følgende!
- IP-maskering er som standard indstillet til "true" og kan ikke konfigureres i en Google Analytics 4-ejendom. Derfor maskeres IP-adressen automatisk med standardhændelsen for en Google Analytics 4-ejendom ("G-XXXXXXXX").
- Hvis der skal anvendes globale indstillinger på alle konfigurerede ejendomme, skal "set"-kommandoen i gtag.js bruges, for at indstillingerne kan gælde for alle tag-id'er og/eller ejendoms-id'er.
- Vær særligt opmærksom på annonce- og annoncetilpasningsfunktioner i analytics.js, som oftest implementeres med en "set"-linje.
Hvis du bruger "set"-, "create"- og "require"-direktiver i din nuværende analytics.js-implementering, skal du gennemgå, hvilke der automatisk indstilles i en Google Analytics 4-ejendom, og hvilke der skal angives i Google Analytics 4-ejendomskoden (parametertilknytning).
Herunder finder du nogle eksempler på konfigurationer med deres kodeeksempler i analytics.js (for UA-ejendommen) og gtag.js (for Google Analytics 4-ejendommen):
Aktivér grundlæggende dataindsamling – konfiguration af 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'
});
Konfigurer cookieindstillinger
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 dage, i sekunder
});
Bloker en page_view-hændelse
Hvis du ikke har brug for en page_view-hændelse, når du indlæser konfigurationskoden (hvis du f.eks. indlæser en iframe), kan du justere konfigurationsindstillingen til at blokere page_view-hændelsen. Overvej et scenarie, hvor der sendes en page_view-hændelse, hvorefter der er en bruger, der logger ind på websitet. Du bruger i forbindelse med logininteraktionen et "config"-direktiv til at angive bruger-id'et, men du ønsker ikke at sende en anden page_view-hændelse. Følgende kode viser, hvordan du kan forhindre, at page_view-hændelsen sendes.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Tagnavne
Tagnavne (også kaldet "sporingsfunktioner") bruges, hvis du vil sende data til forskellige Universal Analytics-ejendomme i analytics.js. I analytics.js definerer sporingsfunktionerne, hvilken ejendom du vil sende dataene til. Hits efter det oprindelige "create"-hit behøver ikke længere at angive Universal Analytics-ejendoms-id'et, men kun navnet på sporingsfunktionen.
I gtag.js er sporingsfunktioner ikke tilgængelige for hverken Google Analytics 4- eller Universal Analytics-ejendomme. Hvis du vil sende alle hits til flere ejendomme (forskellige datastrømme i en Google Analytics 4-ejendom), skal du angive alle tag- eller ejendoms-id'er på "config"-linjen.
Hændelser
Se Guide til migrering af hændelser.Tilpassede dimensioner og metrics
Tilpassede dimensioner og metrics kan bruges til at få flere oplysninger, der måles på websitet, og til at importere offlinedata, f.eks. fra CRM-systemer. I en Universal Analytics-ejendom ("UA-XXXXXXXX") skal tilpassede dimensioner og metrics oprettes på brugerfladen og tildeles et id, hvorefter de kan implementeres eller importeres. De kan oprettes med fire forskellige niveauer: Hit, session, bruger, produkt.
I en Google Analytics 4-ejendom ("G-XXXXXXXX") implementeres brugen af tilpassede dimensioner og metrics på en anden måde. Målinger af både tilpassede dimensioner og metrics i en UA-ejendom, der implementeres via analytics.js, skal genimplementeres som parametre i en Google Analytics 4-ejendom.
En tilpasset dimension for en Universal Analytics-ejendom kan implementeres via analytics.js på følgende måde:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ELLER
ga('set', 'dimension5', 'tilpassede data');
Disse tilpassede dimensioner kan overføres til en Google Analytics 4-ejendom via gtag.js på følgende måde:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ELLER
gtag('set', {'dimension5': 'custom data'});
Der er dog to forbehold:
- Parametre skal være registreret på brugerfladen for at blive vist i rapporter. Dette svarer til registrering af tilpassede dimensioner i Universal Analytics (begrænsninger er gældende). Du behøver ikke at registrere dem, hvis du kun ser på eksporterede data eller kun bruger parameteren til aktivering af en målgruppe.
- Omfanget af tilpassede parametre er altid på hændelsesniveau sammenlignet med hitniveau. Dette gælder også for tilpassede dimensioner, der automatisk overføres til parametre (for gtag.js "UA-XXXXXXXX"-implementeringer) uafhængigt af den oprindelige indstilling for tilpassede dimensioner.
Den samme tilknytning og de samme overvejelser gælder for tilpassede metrics. Der er dog den forskel, at de tæller med i grænsen for numeriske parametre i stedet for grænsen for tekstparametre, når de registreres til rapportering.
Konceptuelt overføres tilpassede dimensioner og metrics på forskellige niveauer i en Universal Analytics-ejendom til en Google Analytics 4-ejendom på følgende måde:
- Tilpasset dimension på hitniveau: Parameter (maks. 25 logførte parametre pr. hændelse under dataindsamling og maks. 50 tilpassede dimensioner/50 tilpassede metrics)
Bemærk! Automatisk indsamlede hændelser og parametre dækker muligvis allerede i nogle tilfælde, hvor der tidligere er blevet brugt en tilpassede dimensioner på hitniveau - Tilpasset dimension på brugerniveau: Brugeregenskaber (maks. 25 registreret til rapportering via brugerfladen). Automatisk indsamlede brugeregenskaber tæller ikke med i denne begrænsning.
- Tilpasset dimension på sessionsniveau: Ingen tilsvarende i en Google Analytics 4-ejendom – se i stedet tilpassede parametre eller brugeregenskaber.
Optimale løsninger mht. brugeregenskaber
Brugeregenskaber holder sig til en bruger på tværs af forskellige platforme (f.eks. på tværs af alle datastrømtyper) og derfor kun bør bruges, hvis dataene skal anvendes på brugerniveau. Brugeregenskaber må ikke bruges til data på sessionsniveau eller data på enhedsniveau (f.eks. skærmstørrelse).
Eksempel med Google Analytics 4-ejendom
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'kontrabas',
season_ticketholder: 'true'
});