API Tag Manager - Riferimento dizionario delle macro

Questo documento descrive le proprietà che possono essere impostate per le macro di Google Tag Manager.

Introduzione

Ogni macro di Google Tag Manager ha un codice type per identificarla. Inoltre, la maggior parte delle macro ha parametri (key, type coppie) che puoi impostare come parte di un "oggetto parametro" quando crei o aggiorni una macro. Per scoprire di più su come impostare questi parametri utilizzando un oggetto parametro, consulta la Riferimento parametri.

Nella parte restante di questo documento sono elencati i dettagli di tutte le macro supportate.

Cookie proprietari

Inserisci il codice

k

Parametri

Chiave	Tipo	Note
name	template	Nome del cookie.

Esempio

 {
   "name": "Sample 1st Party Cookie Macro",
   "type": "k",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "myCookieName"
    }
   ]
 }

Variabile evento automatico

Inserisci il codice

aev

Parametri

Chiave	Tipo	Note
varType	template	Uno tra ELEMENT,CLASSES, ID, TARGET, TEXT, URL, HISTORY_NEW_URL_FRAGMENT, HISTORY_OLD_URL_FRAGMENT, HISTORY_NEW_STATE, HISTORY_OLD_STATE, HISTORY_CHANGE_SOURCE.
defaultValue	template	Campo facoltativo.

Esempio

  {
   "name": "Sample AutoEvent Variable",
   "type": "aev",
   "parameter": [
    {
     "type": "template",
     "key": "varType",
     "value": "CLASSES"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefault"
    }
   ]
  }

Stringa costante

Inserisci il codice

c

Parametri

Chiave	Tipo
value	template

Esempio

  {
   "name": "Sample Constant String",
   "type": "c",
   "parameter": [
    {
     "type": "template",
     "key": "value",
     "value": "MyString"
    }
   ]
  }

Numero versione contenitore

Inserisci il codice

ctv

Parametri

N/A

Esempio

  {
   "name": "Sample Container Version Number",
   "type": "ctv"
  }

Evento personalizzato

Inserisci il codice

Parametri

N/A

Esempio

  {
   "name": "Custom Event Name",
   "type": "e"
  }

JavaScript personalizzato

Inserisci il codice

jsm

Parametri

Chiave	Tipo
javascript	template

Esempio

  {
   "name": "Sample Custom Javascript",
   "type": "jsm",
   "parameter": [
    {
     "type": "template",
     "key": "javascript",
     "value": "function() {\n return \"Hello World\";\n}"
    }
   ]
  }

Variabile di livello dati

Inserisci il codice

v

Parametri

Chiave	Tipo	Note
name	template	Nome variabile livello dati.
defaultValue	template
dataLayerVersion	integer	1 o 2.

Esempio

  {
   "name": "Sample Data Layer Variable",
   "type": "v",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "DL Variable Name"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "DEFAULT"
    },
    {
     "type": "integer",
     "key": "dataLayerVersion",
     "value": "2"
    }
   ]
  }

Modalità di debug

Inserisci il codice

dbg

Parametri

N/A

Esempio

  {
   "name": "Sample Debug Mode Macro",
   "type": "dbg"
  }

Elemento DOM

Inserisci il codice

d

Parametri

Chiave	Tipo	Note
elementId	template
attributeName	template	Campo facoltativo.

Esempio

  {
   "name": "Sample DOM Element Macro",
   "type": "d",
   "parameter": [
    {
     "type": "template",
     "key": "elementId",
     "value": "MyElementId"
    },
    {
     "type": "template",
     "key": "attributeName",
     "value": "MyAttributeName"
    }
   ]
  }

Referrer HTTP

Inserisci il codice

f

Parametri

Chiave	Tipo	Note
component	template	Uno di: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
stripWww	boolean	Per il componente = HOST
queryKey	template	Per il componente = QUERY

Esempio

  {
   "name": "Sample HTTP Referrer Macro",
   "type": "f",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    }
   ]
  }

Variabile JavaScript

Inserisci il codice

j

Parametri

Chiave	Tipo	Note
name	template	Nome della variabile globale.

Esempio

  {
   "name": "Sample Javascript Variable",
   "type": "j",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "MyGlobalVarName"
    }
   ]
  }

Tabella di ricerca

Inserisci il codice

smm

Parametri

Chiave	Tipo	Note
input	template	Il valore utilizzato per la ricerca deve essere un riferimento macro.
map	list	Un elenco di mappe, ciascuna con una singola coppia [key, value].
map[].key	template
map[].value	template
defaultValue	template	Campo facoltativo.

Esempio

  {
   "name": "Sample Lookup Table Macro",
   "type": "smm",
   "parameter": [
    {
     "type": "template",
     "key": "input",
     "value": "{{event}}"
    },
    {
     "type": "list",
     "key": "map",
     "list": [
      {
       "type": "map",
       "map": [
        {
         "type": "template",
         "key": "key",
         "value": "EventEqualsThis"
        },
        {
         "type": "template",
         "key": "value",
         "value": "ThenSetToThis"
        }
       ]
      }
     ]
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefaultValue"
    }
   ]
  }

Numero casuale

Inserisci il codice

r

Parametri

N/A

Esempio

  {
   "name": "Sample Random Number Macro",
   "type": "r"
  }

URL

Inserisci il codice

u

Parametri

Chiave	Tipo	Note
component	template	Uno di: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
customUrlSource	template	Campo facoltativo.
stripWww	boolean	Per il componente = HOST.
queryKey	template	Per il componente = QUERY.

Esempio

  {
   "name": "Sample URL Macro",
   "type": "u",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    },
    {
     "type": "template",
     "key": "customUrlSource",
     "value": "{{element}}"
    }
   ]
  }