Tags

I tag associati al contenitore. I tag sono generalmente associati a una o più regole di attivazione (vedi firingRuleId di seguito) e, facoltativamente, a una o più regole di blocco (vedi blockingRuleId di seguito). Quando almeno una regola di attivazione ha valore true e esattamente zero regole di blocco hanno valore true, il tag si attiva (esecuzione). Utilizza la proprietà facoltativa priority per modificare i tag che vengono attivati prima di altri. Utilizza la proprietà dependencies per specificare quali altri tag devono essere attivati e completati prima dell'attivazione di questo tag. Per informazioni dettagliate sui parametri che possono essere impostati per i tag di Google Tag Manager, consulta la documentazione di riferimento sul dizionario dei tag.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Rappresenta un tag di Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "paused": boolean
}
Nome proprietà Valore Descrizione Note
accountId string ID account GTM.
blockingRuleId[] list ID regole di blocco. Se una delle regole elencate restituisce true, il tag non si attiverà. scrivibile
blockingTriggerId[] list ID trigger di blocco. Se uno degli attivatori elencati restituisce true, il tag non si attiverà. scrivibile
containerId string ID contenitore GTM.
fingerprint string L'impronta del tag GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che il tag viene modificato.
firingRuleId[] list ID delle regole di attivazione. Un tag si attiva quando una qualsiasi delle regole elencate è vera e tutte le sue blockingRuleIds (se specificate) sono false. scrivibile
firingTriggerId[] list ID degli attivatori di attivazione. Un tag si attiva quando uno degli attivatori elencati è true e tutti i relativi blockingTriggerIds (se specificati) sono falso. scrivibile
liveOnly boolean Se è impostato su true, questo tag si attiverà solo nell'ambiente di pubblicazione (ad es. non in modalità di anteprima o debug). scrivibile
name string Nome visualizzato del tag. scrivibile
notes string Note dell'utente su come applicare questo tag nel contenitore. scrivibile
parameter[] list I parametri del tag. scrivibile
parameter[].key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
parameter[].list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
parameter[].map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
parameter[].type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
scrivibile
parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
parentFolderId string ID cartella principale.
paused boolean True se il tag è in pausa. scrivibile
priority nested object Priorità numerica del tag definita dall'utente. I tag vengono attivati in modo asincrono in ordine di priorità. I tag con un valore numerico più alto vengono attivati per primi. La priorità di un tag può essere un valore positivo o negativo. Il valore predefinito è 0. scrivibile
priority.key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
priority.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
priority.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
priority.type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
scrivibile
priority.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
scheduleEndMs long Il timestamp di fine in millisecondi per pianificare un tag. scrivibile
scheduleStartMs long Il timestamp di inizio in millisecondi per pianificare un tag. scrivibile
setupTag[] list L'elenco dei tag di configurazione. Al momento consentiamo solo uno.
setupTag[].stopOnSetupFailure boolean Se il valore è true, attiva il tag principale solo se il tag di configurazione si attiva correttamente. Se il valore è false, attiva il tag principale indipendentemente dallo stato di attivazione del tag di impostazione.
setupTag[].tagName string Il nome del tag di impostazione.
tagFiringOption string Opzione per attivare questo tag.

I valori accettati sono:
  • "oncePerEvent"
  • "oncePerLoad"
  • "unlimited"
tagId string L'ID tag identifica in modo univoco il tag GTM.
teardownTag[] list L'elenco dei tag di disinstallazione. Al momento consentiamo solo uno.
teardownTag[].stopTeardownOnFailure boolean Se true, attiva il tag di disinstallazione solo se e solo se il tag principale si attiva correttamente. Se il valore è false, attiva il tag di eliminazione indipendentemente dallo stato di attivazione del tag principale.
teardownTag[].tagName string Il nome del tag di disinstallazione.
type string Tipo di tag GTM. scrivibile

Metodi

Utilizza i metodi riportati di seguito per creare, modificare, eliminare o recuperare i tag.

creazione
Crea un tag GTM.
elimina
Elimina un tag GTM.
ricevi
Ottene un tag GTM.
list
Elenca tutti i tag GTM di un contenitore.
aggiornamento
Aggiorna un tag GTM.