Tipus de variables definides per l'usuari per al web

Creeu variables web personalitzades definides per l'usuari a Google Tag Manager per tal de respondre a requisits específics que podrien no estar coberts per les variables integrades.

Per crear una variable definida per l'usuari:

1. Al menú de navegació de l'esquerra, feu clic a Variables.
2. A la secció Variables definides per l'usuari, feu clic a Nova.
3. Feu clic a Configuració de la variable i seleccioneu el tipus de variable que vulgueu.
4. Introduïu les opcions de configuració del tipus de variable que heu seleccionat.
5. Poseu un nom a la variable. Feu servir una nomenclatura que descrigui la funció de la variable, p. ex. "Variable de capa de dades: nom del producte".
6. Feu clic a Desa.

Tag Manager admet aquests tipus de variables definides per l'usuari per al web:

• Navegació
  • URL de referència d'HTTP
  • URL
• Variables de pàgina
  • Galeta pròpia
  • JavaScript personalitzat
  • Capa de dades
• Elements de pàgina
  • Variable d'esdeveniment automàtic
  • Element DOM
  • Visibilitat de l'element
• Utilitats
  • Constant
  • Esdeveniment personalitzat
  • Nom de l'entorn
  • Configuració de Google Analytics
  • Etiqueta de Google: opcions de configuració
  • Etiqueta de Google: configuració d'esdeveniments
  • Taula de cerca
  • Nombre aleatori
  • Taula d'expressions regulars
• Dades proporcionades per l'usuari
• Dades del contenidor
  • Identificador de contenidor
  • Número de versió del contenidor
  • Mode de depuració

Navegació

URL de referència d'HTTP

El valor s'estableix en l'URL de referència d'HTTP, que és l'URL de la pàgina anterior que l'usuari hagi visitat. Per exemple, si una persona accedeix a una de les pàgines de producte des de la pàgina d'inici, l'URL de referència serà la pàgina d'inici. Tag Manager crea de manera automàtica una instància d'aquest tipus de variable, però podeu crear més instàncies si voleu exposar diferents parts de l'URL de referència.

URL

Amb aquest tipus de variable podeu analitzar i exposar els components de l'URL. Podeu crear instàncies addicionals per exposar diferents parts de l'URL. Podeu triar entre els components d'URL següents: URL complet, protocol, nom d'amfitrió, port, camí, extensió del nom del fitxer, consulta i fragment. El valor d'entrada que s'estableix per a les variables d'aquest tipus és l'URL de la pàgina en què l'usuari es trobi (recuperat de document.location). Ajusteu l'opció Font de l'URL per indicar a Tag Manager que utilitzi una altra variable com a font del valor de l'URL.

Variables de pàgina

Galeta pròpia

Aquest valor s'estableix en el valor de la galeta pròpia amb el nom del domini en què es trobi l'usuari. Si s'implementa més d'una galeta amb el mateix nom en un mateix domini, es triarà el primer valor. Això també succeeix si heu cridat document.cookie des d'una pàgina i heu triat el primer resultat.

JavaScript personalitzat

El valor s'estableix en el resultat d'una funció de JavaScript. El format del JavaScript ha de ser una funció anònima que torni un valor. Per exemple, podeu crear una variable de JavaScript personalitzada per convertir totes les instàncies de la variable "{{url}}" predefinida a minúscules:

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

Capa de dades

El valor s'estableix quan les dades s'envien a la capa de dades a través de la crida dataLayer.push():
dataLayer.push({"Data Layer Name": "value"}).

Podeu especificar la manera com Tag Manager interpreta els punts (".") al nom de la clau:

• Versió 1: permetre punts als noms de la clau. Per exemple, a la variable dataLayer.push("a.b.c": "value"), el nom de la clau s'interpreta com a "a.b.c" (és a dir, {"a.b.c": "value"}).
• Versió 2: interpretar els punts com a valors imbricats. Per exemple, s'interpreta dataLayer.push({"a.b.c": "value"}) com a tres nivells imbricats: {a: {b: {c: "value"}}}.

Variable de JavaScript

El valor s'estableix en la variable global de JavaScript que especifiqueu. Si el valor necessari no s'ha configurat a la capa de dades (consulteu l'apartat sobre la variable de capa de dades), ni es mostra al DOM (vegeu també l'apartat sobre la variable d'element DOM), és probable que es pugui obtenir el valor d'una variable de JavaScript. Feu servir aquest tipus de variable si podeu trobar el valor al codi font de la pàgina en forma de variable global de JavaScript.

Elements de pàgina

Variable d'esdeveniment automàtic

Captura informació sobre un element que ha activat un esdeveniment (p. ex. clics, enviaments de formularis o visibilitat de l'element, entre d'altres).

• Element: torna l'objecte de l'element. Es pot tractar com un objecte per a JavaScript personalitzat, p. ex., {{Element}}.title, o en selectors CSS. Per exemple: {{Element}} coincideix amb el selector CSS div.foo.
• Tipus d'element: torna el valor element.tagName, p. ex., "A", "BUTTON" o "IMG".
• Atribut d'element: en especificar un nom d'atribut, aquesta opció tornarà el valor de l'atribut.
• Classes d'element: torna la llista de classes trobades a l'atribut class de l'element.
• Identificador d'element: torna el valor de l'atribut id.
• Objectiu d'element: torna el valor de l'atribut target, p. ex., "_blank".
• Text de l'element: torna el valor del contingut de text de l'element.
• URL de l'element: torna l'URL de l'element, obtingut a partir dels atributs href o action.
• Fragment nou d'URL de l'historial: torna el fragment nou d'URL des de l'historial del navegador, p. ex., "#summary".
• Fragment antic d'URL de l'historial: torna el fragment antic d'URL des de l'historial del navegador, p. ex., "#intro".
• Estat nou de l'historial: l'objecte d'estat de l'historial nou, controlat per les crides del lloc web a pushState.
• Estat antic de l'historial: l'objecte d'estat de l'historial anterior, controlat per les crides del lloc web a pushState.
• Font del canvi de l'historial: torna l'esdeveniment que ha provocat un canvi en l'historial, p. ex., "pushState", "replaceState", etc.

Element DOM

El valor el defineix el text de l'element DOM (model d'objectes del document) o bé el valor de l'atribut de l'element DOM que s'hagi especificat. Si el valor que voleu no s'ha configurat a la capa de dades (consulteu l'apartat sobre la variable de capa de dades), és possible que el valor es pugui recuperar del DOM. Utilitzeu aquest tipus de variable si trobeu el valor al DOM.

Si el nom de l'atribut opcional s'ha definit, el valor de la variable tornarà el valor que s'hagi especificat en aquest atribut (p. ex., data-food="cupcake"); si no és així, el valor de la variable és el text de l'element DOM.

Visibilitat de l'element

El valor es defineix segons l'estat de visibilitat de l'element DOM especificat. A diferència de l'activador Visibilitat de l'element, una variable del tipus Visibilitat de l'element només pot informar de la visibilitat d'un sol element. Trieu si voleu seleccionar un element segons l'identificador de l'element o un selector de CSS. Si el selector de CSS definit coincideix amb diversos elements, només s'utilitzaran els primers.

Podeu triar el tipus de sortida d'aquesta variable:

• True/False: és un valor booleà que indica si l'element seleccionat és visible quan es fa referència a la variable. 
• Percentatge: és un valor de percentatge del 0 al 100 que indica quina porció de l'element seleccionat és visible a la pantalla quan es fa referència a la variable.

Si seleccioneu "True"/"False" com a tipus de sortida, també podeu definir un percentatge mínim de visibilitat per indicar quina part de l'element seleccionat ha de ser visible a la pantalla perquè la variable torni "true".

Utilitats

Constant

El valor el defineix la cadena que proporcioneu. Les variables de cadena constant se solen fer servir quan hi ha diverses etiquetes que utilitzen el mateix número de compte. Consulteu també: Configuració de Google Analytics.

Esdeveniment personalitzat

El valor el defineix el nom de l'esdeveniment personalitzat que es va enviar a la capa de dades.

Nom de l'entorn

Torna el nom de l'entorn que es veu en mode de previsualització.

Configuració de Google Analytics

La variable Configuració de Google Analytics s'utilitza a les etiquetes de Universal Analytics de contenidors web i contenidors mòbils (Firebase) per definir i compartir les opcions de configuració de Google Analytics que es fan servir en diverses etiquetes. Quan creeu una etiqueta de Google Analytics mitjançant Universal Analytics, Tag Manager us demanarà que seleccioneu o creeu una variable del tipus Configuració de Google Analytics. Obteniu més informació.

Etiqueta de Google: opcions de configuració

Aquesta variable us permet definir els paràmetres al nivell de configuració quan es carrega l'etiqueta de Google.

Per exemple, suposem que publiqueu el lloc web en diversos idiomes i voleu segmentar el públic segons l'idioma en què llegeix. Podeu crear una variable de configuració amb un paràmetre language i utilitzar-la en totes les etiquetes de Google en lloc d'actualitzar manualment cada etiqueta.

Obteniu informació sobre com podeu reutilitzar les opcions de configuració.

Etiqueta de Google: configuració d'esdeveniments

Aquesta variable us permet definir els paràmetres al nivell d'esdeveniment per enviar dades addicionals amb un esdeveniment de GA4.

Per exemple, suposem que teniu una botiga en línia en què oferiu una promoció i voleu fer un seguiment del nombre de persones que utilitzen el codi de descompte que els heu proporcionat. En lloc d'afegir manualment el paràmetre discount a cada etiqueta, podeu reutilitzar el paràmetre amb una variable Etiqueta de Google: configuració d'esdeveniments.

Obteniu informació sobre com podeu reutilitzar les opcions de configuració.

Taula de cerca

El valor es defineix d'acord amb les instruccions de la taula de cerca. La taula de cerca conté dues columnes (en aquest primer exemple, la taula és buida perquè més endavant ja s'il·lustra com s'utilitzen les dades):

Quan [seleccioneu la variable] és igual a	Estableix [aquesta variable] en

La taula de cerca us permet crear una variable amb un valor que variï segons el valor d'una altra variable. És una opció útil si el lloc web està configurat de tal manera que es pot mapar el valor pertinent (per exemple, un identificador de conversió) a l'URL, a l'element DOM o a una altra part de la pàgina. En aquest exemple s'hi crea una variable anomenada Identificador de conversions. Si l'URL conté "/thanks/buy1.html", el valor s'estableix en "12345"; si l'URL conté "thanks/buy2.html", el valor s'estableix en "34567".

Si {{url}} conté	Estableix {{Identificador de conversions}} en
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Nombre aleatori

El valor s'estableix en un nombre aleatori comprès entre 0 i 2.147.483.647.

Taula d'expressions regulars

La variable Taula d'expressions regulars és similar a la variable Taula de cerca, però, a més, pot executar patrons d'expressions regulars per als elements que voleu que coincideixin.

Suposem que tenim una taula d'expressions regulars amb la configuració següent:

Patró	Sortida
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	bar
.*/page[7-9]\.html.*	baz

El valor de sortida de la variable serà el següent:

Resultat coincident	Valor
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

Les consultes de taula d'expressions regulars s'executen de la part superior a la part inferior de la llista. Quan es troba una coincidència, s'obté el valor de sortida corresponent.

Seleccioneu Defineix el valor predeterminat per establir un valor de sortida quan no hi hagi cap coincidència.

De manera predeterminada, els patrons han de coincidir amb la cadena d'entrada completa i no distingeixen entre majúscules i minúscules. Aquest comportament es pot ajustar a Configuració avançada:

• No distingeixis entre majúscules i minúscules: els patrons trobaran coincidències independentment de les majúscules i les minúscules sense que calgui incloure-ho a l'expressió regular de manera explícita.

• Només les coincidències exactes: si s'activa aquesta opció, els patrons han de coincidir amb l'entrada completa. Això equival a incloure implícitament les àncores d'entrada (^) i de sortida ($) al patró. Si l'opció està desactivada, els patrons coincidiran quan es trobin en qualsevol punt de l'entrada.

• Funcions de grups de captura i substitució: si l'activeu, podeu utilitzar la sintaxi de substitució del símbol de dòlar per incloure porcions de l'entrada (procedents, per exemple, de capturar grups al patró coincident) dins de la sortida. Per exemple, si l'expressió regular coincident és /(news)/page(2)\.html, podeu utilitzar $1 per referir-vos al primer grup de captura ("news") i $2 per referir-vos al segon ("2").

Si utilitzeu "Funcions de grups de captura i substitució" amb l'opció "Només les coincidències exactes" desactivada, es pot produir un comportament inesperat (com ara que es torni el valor d'entrada complet i que la porció coincident s'hagi substituït).

Dades proporcionades per l'usuari

Recull informació del formulari de contacte, com ara l'adreça electrònica, el telèfon, el nom i l'adreça. Especifiqueu la informació que voleu capturar mitjançant un dels modes següents:

• Configuració automàtica: detecta automàticament els camps de formulari del vostre lloc web i les entrades noves.
• Configuració manual: us permet mapar les variables de Tag Manager existents als camps de dades proporcionades per l'usuari, com ara l'adreça electrònica, el número de telèfon i el nom i l'adreça.
• Codi: us permet especificar una variable de capa de dades o una variable de JavaScript personalitzat que torna l'objecte de dades estructurades proporcionades per l'usuari.

Dades del contenidor

Identificador del contenidor

Torna l'identificador del contenidor de Tag Manager, p. ex. "GTM-101010".

Número de versió del contenidor

Quan el contenidor està en mode de previsualització, aquesta variable torna el número de la versió de previsualització del contenidor. En cas contrari, torna el número de la versió publicada del contenidor.

Mode de depuració

El valor s'estableix en true si el contenidor està en mode de previsualització i de depuració, i false si no està en aquest mode.