Användardefinierade variabeltyper för webben

Skapa egna användardefinierade webbvariabler i Google Taggstyrning som uppfyller specifika krav som inte redan omfattas av inbyggda variabler.

Så här skapar du en användardefinierad variabel:

1. Klicka på Variabler i navigeringsfältet till vänster.
2. Klicka på Ny i avsnittet Användardefinierade variabler.
3. Klicka på Variabelkonfiguration och välj en variabeltyp.
4. Ange konfigurationsalternativ för den valda variabeltypen.
5. Ge variabeln ett namn. Använd ett namnformat som beskriver variabelns funktion, till exempel Datalagervariabel – Produktnamn.
6. Klicka på Spara.

Taggstyrning stöder dessa användardefinierade variabeltyper för webben:

• Navigering
  • HTTP-hänvisningsadress
  • Webbadress
• Sidvariabler
  • Förstapartscookie
  • Anpassat JavaScript
  • Datalager
• Sidelement
  • Variabel för automatisk händelse
  • DOM-element
  • Elementsynlighet
• Verktyg
  • Konstant
  • Anpassad händelse
  • Miljönamn
  • Inställningar i Google Analytics
  • Google-tagg: Konfigurationsinställningar
  • Google-tagg: Händelseinställningar
  • Uppslagstabell
  • Slumptal
  • RegEx-tabell
• Data som tillhandahålls av användaren
• Data för behållare
  • Behållar-id
  • Behållarens versionsnummer
  • Felsökningsläge

Navigering

HTTP-hänvisningsadress

Värdet är inställt på HTTP-hänvisningen som är webbadressen till den sida som personen senast besökte. Om en person till exempel besöker en av dina produktsidor från startsidan, används startsidan som hänvisningsadress. En instans av den här variabeltypen skapas automatiskt av Taggstyrning, men du kan skapa ytterligare instanser om du vill exponera olika delar av hänvisningsadressen.

Webbadress

Med den här variabeltypen kan du tolka och exponera webbadresskomponenter. Du kan skapa ytterligare instanser för att exponera olika delar av webbadressen. De webbadresskomponenter du kan välja mellan är Fullständig webbadress, Protokoll, Värdnamn, Port, Sökväg, Filnamn Tillägg, Sökfråga och Fragment. Indatavärdet på variabler av den här typen är webbadressen till den aktuella sidan som användaren befinner sig på (hämtas från document.location). Ändra Webbadresskälla när du vill ange att Taggstyrning ska använda en annan variabel som källa till webbadressvärdet.

Sidvariabler

Förstapartscookie

Värdet ställs in på värdet i förstapartscookien med samma namn som domänen där användaren för närvarande befinner sig. Om mer än en cookie med samma namn används på samma domän väljs det första värdet. Detta motsvarar att anropa document.cookie på en sida och välja det första resultatet.

Anpassat JavaScript

Värdet ställs in på resultatet av en JavaScript-funktion. JavaScript-funktionen måste utgöras av en anonym funktion som returnerar ett värde. Exempelvis kan en anpassad JavaScript-variabel skapas som konvertering till små bokstäver av alla instanser i den fördefinierade variabeln {{url}}:

function () {
  return {{url}}.toLowerCase();
}

Datalager

Värdet ställs in när data skickas till datalagret via dataLayer.push() anropet
dataLayer.push({"Data Layer Name": "value"}).

Du kan ange hur Taggstyrning ska tolka punkter (”.”') i nyckelnamnet:

• Version 1: punkter är tillåtna i nyckelnamn. Exempel: i dataLayer.push("a.b.c": "value") tolkas namnet på nyckeln som ”a.b.c” (dvs. {"a.b.c": "value"}).
• Version 2: punkter ska tolkas som kapslade värden. Exempel: dataLayer.push({"a.b.c": "value"}) ska tolkas som tre kapslade nivåer: {a: {b: {c: "value"}}}.

JavaScript-variabel

Värdet ställs in på den globala JavaScript-variabel som du anger. Om värdet inte angavs i datalagret (se Datalager-variabel) och inte visas i DOM (se även DOM-elementvariabel), kanske värdet kan hämtas från en JavaScript-variabel. Använd den här variabeltypen om du kan hitta värdet i sidans källkod i form av en JavaScript-variabel.

Sidelement

Variabel för automatisk händelse

Sparar information om ett objekt som utlöste en händelse (t.ex. klick, formulärsändningar, elementsynlighet osv.).

• Element: returnerar elementobjektet. Kan behandlas som ett objekt för anpassad JavaScript, t.ex. {{Element}}.title, eller i CSS-väljare t.ex. {{Element}} matchar CSS-väljare div.foo.
• Element Type: returnerar värdet element.tagName, t.ex. A, BUTTON, IMG.
• Element Attribut: ange ett attributnamn och det här alternativet returnerar värdet på det attributet.
• Element Classes: returnerar listan över klasser i elementets class-attribut.
• Element ID: returnerar värdet på attributet id.
• Element Target: Returnerar värdet på attributet target, t.ex. _blank.
• Element Text: returnerar värdet på textinnehållet i elementet.
• Element URL: returnerar elementets webbadress som har hämtats från attributet href eller action.
• History New URL Fragment: returnerar det nya webbadressfragmentet från webbläsarhistoriken, t.ex. #summary.
• History Old URL Fragment: returnerar det gamla webbadressfragmentet från webbläsarhistoriken, t.ex. #intro.
• History New State: det nya historikobjektet som styrs av webbplatsens anrop till pushState.
• History Old State: det tidigare historikobjektet som styrs av webbplatsens anrop till pushState.
• History Change Source: returnerar händelsen som ledde till en historikändringar, t.ex. pushState, replaceState osv.

DOM-element

Värdet sätts till texten i DOM-elementet (Document Object Model) eller värdet på det angivna DOM-elementattributet. Om önskat värde inte angavs i datalagret (se Datalager-variabel) kanske värdet kan hämtas från DOM. Använd den här variabeltypen om du kan hitta värdet i DOM.

Om det valfria attributnamnet har angetts, returnerar variabeln värdet på attributet (till exempel data-food=”cupcake”). Annars får variabeln värdet texten i DOM-elementet.

Elementsynlighet

Värdet bestäms av det angivna DOM-elementets synlighetstillstånd. Till skillnad från utlösaren elementsynlighet kan en enda variabel för elementsynlighet endast rapportera synligheten för ett enda element. Ange om du vill välja ett element baserat på element-id eller en CSS-väljare. Om flera element matchas med en angiven CSS-väljare används det första matchade elementet.

Du kan välja utmatningstyp för variabeln:

• True/false (sant/falskt): ett booleskt värde som anger om det valda elementet är synligt vid hänvisningar till variabeln. 
• Percent: Ett numeriskt värde mellan 0 och 100 som anger hur mycket av det valda elementet som är synligt på skärmen när variabeln refereras.

Om du väljer true/false som utmatningstyp kan du även ange en minsta synlighetsprocent som anger hur mycket av det valda elementet som måste synas på skärmen för att variabeln ska returnera värdet ”true”.

Verktyg

Konstant

Värdet sätts till den sträng som du anger. Konstanta strängvariabler används vanligen när det finns flera taggar som utnyttjar samma kontonummer. Se även: Google Analytics-inställningar .

Anpassad händelse

Värdet är inställt på namnet på den anpassade händelsen som drevs till datalagret.

Miljönamn

Returnerar namnet på miljön som visas i förhandsgranskningsläge .

Inställningar i Google Analytics

Google Analytics inställningsvariabel används i Universal Analytics-taggar i behållare för webb och mobil (Firebase) för att kunna konfigurera och dela gemensamma Google Analytics-inställningar centralt som finns i flera taggar. När du skapar en Google Analytics-tagg med Universal Analytics får du en uppmaning i Taggstyrning om att välja eller skapa en inställningsvariabel för Google Analytics. Läs mer.

Google-tagg: Konfigurationsinställningar

Med denna variabel kan du ställa in parametrar på konfigurationsnivå när Google-taggen läses in.

Anta till exempel att du publicerar din webbplats på flera språk och vill segmentera målgruppen efter språket de läser på. Då kan du skapa en konfigurationsvariabel med en language-parameter och använda den i alla dina Google-taggar i stället för att uppdatera varje tagg manuellt.

Läs mer om hur du återanvänder konfigurationsinställningar.

Google-tagg: Händelseinställningar

Med denna variabel kan du ställa in parametrar på händelsenivå för att skicka ytterligare data med en GA4-händelse.

Anta till exempel att du äger en onlinebutik och har en rea. Du vill spåra hur många personer som använder rabattkoden du gav dem. I stället för att manuellt lägga till parametern discount i varje tagg kan du återanvända parametern med variabeln Google-tagg: Händelseinställningar.

Läs mer om hur du återanvänder konfigurationsinställningar.

Uppslagstabell

Värdet ställs in enligt anvisningarna i uppslagstabellen. Uppslagstabellen innehåller två kolumner: (Tabellen är tom för att illustrera hur data används senare) :

När [välj variabel] är lika med	Ange [denna variabel] till

Med Uppslagstabell kan du skapa en variabel vars värde varierar beroende på värdet på en annan variabel. Detta är användbart om din webbplats är konfigurerad på ett sådant sätt att det lämpliga värdet (till exempel ett konverterings-id) kan mappas till webbadressen, DOM-elementet eller någon annan del av sidan. I det här exemplet skapas en variabel med namnet Conversion ID. Om webbadressen innehåller /thanks/buy1.html blir värdet 12345. Om webbadressen innehåller thanks/buy2.html blir värdet 34567.

När {{url}} innehåller	Ställ in {{Conversion ID}} på
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Slumptal

Värdet sätts till ett slumptal mellan 0 och 2147483647.

RegEx-tabell

En RegEx-tabellvariabel liknar en variabel för uppslagstabell men den kan också köra reguljära uttryck för de objekt du vill matcha.

För denna RegEx-tabellkonfiguration:

Mall	Utdata
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	bar
.*/page[7-9]\.html.*	baz

Utdatavärdet för variabeln blir då:

Matchat resultat	Värde
http://example.com/page1.html	foo
http://www.example.com/page1.html	foo
http://example.com/page2.html#detail	foo
http://example.com/page5.html	bar
http://example.com/page5.html?status=new	bar
http://example.com/page6.html	bar
https://example.com/page9.html	baz

I regex-tabeller startar uppslagsfunktionen högst upp i listan och söker nedåt. När en matchning hittas returneras motsvarande utdatavärde.

Välj Ange standardvärde för att ställa in ett utdatavärde för när en matchning inte hittas.

Som standard måste mönster matcha hela inmatningssträngen. Mönster är inte skiftlägeskänsliga. Detta beteende kan justeras i Avancerade inställningar:

• Ignorera skiftläge: Mönster matchar versaler och gemener utan att det uttryckligen anges i det reguljära uttrycket.

• Endast fullständiga matchningar: Om du har aktiverat det här alternativet måste mönster matcha hela inmatningen. Detta motsvarar att alltid ha inledande (^) och avslutande ($) ankare runt mönstret. Om du har inaktiverat det här alternativet matchas mönster när de hittas någonstans i inmatningen.

• Funktioner för infångningsgrupper och ersättning: Om du har aktiverat det här alternativet kan du använda syntax och på så vis ersätta variabler med dollartecken för att inkludera delar av inmatningen (t.ex. från infångningsgrupper i det matchade mönstret) i utdatan. Om det matchade reguljära uttrycket till exempel är /(news)/page(2)\.html, kan du använda $1 för att referera till den första infångningsgruppen (news) och $2 för att referera till den andra infångningsgruppen (2).

Om du använder Funktioner för infångningsgrupper och ersättning när alternativet Endast fullständiga matchningar har inaktiverats kan det leda till ett oväntat beteende (dvs. hela indatavärdet returneras med den matchade delen ersatt).

Data som tillhandahålls av användaren

Samlar in information från kontaktformulär, till exempel e-postadress, telefonnummer, namn och adress. Ange vilken information som samlas in med ett av följande lägen:

• Automatisk konfiguration: Formulärfält på webbplatsen och nya poster identifieras automatiskt.
• Manuell konfiguration : Du kan mappa befintliga Taggstyrning-variabler till motsvarande datafält med information från användaren, som e-post, telefonnummer, namn och adress.
• Kod: Du kan ange en datalagervariabel eller en anpassad JavaScript-variabel som returnerar ditt strukturerade objekt med data som tillhandahålls av användare.

Data för behållare

Behållar-id

Returnerar id för Taggstyrning, t.ex. GTM-101010.

Behållarens versionsnummer

När behållaren är i förhandsgranskningsläge returnerar variabeln numret på förhandsgranskningsversionen av behållaren. Annars returnerar den behållarens aktiva versionsnummer.

Felsökningsläge

Värdet är true om behållaren är i förhandsgransknings- och felsökningsläge, annars är värdet false.