Tags

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

Rappresentazioni delle risorse

Rappresenta un tag di Google Tag Manager.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    "consentStatus": string,
    "consentType": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": 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
consentSettings nested object Impostazioni relative al consenso di un tag. scrivibile
consentSettings.consentStatus string Lo stato del consenso del tag. Se impostato su NEEDED, il runtime controllerà che i tipi di consenso specificati dal campo consent_type siano stati concessi.

I valori accettati sono:
  • "needed"
  • "notNeeded"
  • "notSet"
consentSettings.consentType nested object Il tipo di consensi da controllare durante l'attivazione del tag se lo stato è NECESSARIO. Questo parametro deve essere di tipo LIST, dove ogni elemento dell'elenco deve essere di tipo STRING.
consentSettings.consentType.isWeakReference boolean Indica se un parametro del tipo di riferimento viene utilizzato in modo forte o debole. Utilizzato solo da Trasformazioni. scrivibile
consentSettings.consentType.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
consentSettings.consentType.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
consentSettings.consentType.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
consentSettings.consentType.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
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
consentSettings.consentType.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. 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
monitoringMetadata nested object Una mappa di coppie chiave-valore dei metadati dei tag da includere nei dati degli eventi per il monitoraggio dei tag. Note:
  • Questo parametro deve essere di tipo MAP.
  • Ogni parametro nella mappa è di tipo TEMPLATE, ma non può contenere riferimenti a variabili.
scrivibile
monitoringMetadata.isWeakReference boolean Indica se un parametro del tipo di riferimento viene utilizzato in modo forte o debole. Utilizzato solo da Trasformazioni. scrivibile
monitoringMetadata.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
monitoringMetadata.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
monitoringMetadata.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
monitoringMetadata.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
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
monitoringMetadata.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
monitoringMetadataTagNameKey string Se il campo non è vuoto, il nome visualizzato del tag verrà incluso nella mappa dei metadati di monitoraggio utilizzando la chiave specificata. 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[].isWeakReference boolean Indica se un parametro del tipo di riferimento viene utilizzato in modo forte o debole. Utilizzato solo da Trasformazioni. 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
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
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.
path string Percorso relativo API del tag GTM.
paused boolean Indica se il tag è in pausa e ciò impedisce l'attivazione del tag. 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.isWeakReference boolean Indica se un parametro del tipo di riferimento viene utilizzato in modo forte o debole. Utilizzato solo da Trasformazioni. 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
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
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"
  • "tagFiringOptionUnspecified"
  • "unlimited"
tagId string L'ID tag identifica in modo univoco il tag GTM.
tagManagerUrl string Link generato automaticamente all'interfaccia utente di Tag Manager
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
workspaceId string ID area di lavoro GTM.

Metodi

creazione
Crea un tag GTM.
elimina
Elimina un tag GTM.
ricevi
Ottene un tag GTM.
list
Elenca tutti i tag GTM di un contenitore.
revert
Ripristina le modifiche a un tag GTM in un'area di lavoro GTM.
aggiornamento
Aggiorna un tag GTM.