Tags

Per un elenco di metodi per questa risorsa, vai alla 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 qualsiasi delle regole elencate restituisce true, il tag non si attiva. accessibile in scrittura
blockingTriggerId[] list Blocco degli ID trigger. Se uno degli attivatori elencati restituisce true, il tag non si attiva. accessibile in scrittura
consentSettings nested object Impostazioni relative al consenso di un tag. accessibile in scrittura
consentSettings.consentStatus string Lo stato del consenso del tag. Se impostato su NEEDED, il runtime verificherà che siano stati concessi i tipi di consenso specificati nel campo consent_type.

I valori accettati sono:
  • "needed"
  • "notNeeded"
  • "notSet"
consentSettings.consentType nested object Il tipo di consensi da verificare durante l'attivazione del tag se lo stato del consenso è NECESSARIO. Questo parametro deve essere di tipo LIST in cui ogni elemento dell'elenco è di tipo STRING.
consentSettings.consentType.isWeakReference boolean Indica se viene fatto riferimento a un parametro del tipo di riferimento in modo forte o debole. Utilizzato solo dalle trasformazioni. accessibile in scrittura
consentSettings.consentType.key string La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. accessibile in scrittura
consentSettings.consentType.list[] list Parametri di questo elenco (le chiavi verranno ignorate). accessibile in scrittura
consentSettings.consentType.map[] list I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). accessibile in scrittura
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 a 64 bit con segno, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa di parametri
  • template: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come nome del tag.
di Gemini Advanced.

I valori accettati sono:
    .
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessibile in scrittura
consentSettings.consentType.value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
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 regole di attivazione. Un tag viene attivato quando una qualsiasi delle regole elencate è vera e tutti i suoi blockingRuleIds (se specificati) sono false. accessibile in scrittura
firingTriggerId[] list ID attivatore in corso. Un tag viene attivato quando uno qualsiasi degli attivatori elencati è vero e tutti i suoi blockingTriggerIds (se specificati) sono falsi. accessibile in scrittura
liveOnly boolean Se impostato su true, questo tag si attiva solo nell'ambiente di pubblicazione (ad es. non in modalità di anteprima o debug). accessibile in scrittura
monitoringMetadata nested object Una mappa di coppie chiave-valore di metadati di tag da includere nei dati sull'evento per il monitoraggio dei tag. Note.
  • Questo parametro deve essere di tipo MAP.
  • Ciascun parametro della mappa è di tipo TEMPLATE, ma non può contenere riferimenti a variabili.
 accessibile in scrittura
monitoringMetadata.isWeakReference boolean Indica se viene fatto riferimento a un parametro del tipo di riferimento in modo forte o debole. Utilizzato solo dalle trasformazioni. accessibile in scrittura
monitoringMetadata.key string La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. accessibile in scrittura
monitoringMetadata.list[] list Parametri di questo elenco (le chiavi verranno ignorate). accessibile in scrittura
monitoringMetadata.map[] list I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). accessibile in scrittura
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 a 64 bit con segno, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa di parametri
  • template: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come nome del tag.
di Gemini Advanced.

I valori accettati sono:
    .
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessibile in scrittura
monitoringMetadata.value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
monitoringMetadataTagNameKey string Se il campo non è vuoto, il nome visualizzato del tag verrà incluso nella mappa dei metadati di monitoraggio utilizzando la chiave specificata. accessibile in scrittura
name string Nome visualizzato del tag. accessibile in scrittura
notes string Note dell'utente su come applicare questo tag nel contenitore. accessibile in scrittura
parameter[] list I parametri del tag. accessibile in scrittura
parameter[].isWeakReference boolean Indica se viene fatto riferimento a un parametro del tipo di riferimento in modo forte o debole. Utilizzato solo dalle trasformazioni. accessibile in scrittura
parameter[].key string La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. accessibile in scrittura
parameter[].list[] list Parametri di questo elenco (le chiavi verranno ignorate). accessibile in scrittura
parameter[].map[] list I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). accessibile in scrittura
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 a 64 bit con segno, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa di parametri
  • template: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come nome del tag.
di Gemini Advanced.

I valori accettati sono:
    .
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessibile in scrittura
parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
parentFolderId string ID cartella principale.
path string Percorso relativo dell'API del tag GTM.
paused boolean Indica se il tag è in pausa, impedendo l'attivazione. accessibile in scrittura
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. accessibile in scrittura
priority.isWeakReference boolean Indica se viene fatto riferimento a un parametro del tipo di riferimento in modo forte o debole. Utilizzato solo dalle trasformazioni. accessibile in scrittura
priority.key string La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. accessibile in scrittura
priority.list[] list Parametri di questo elenco (le chiavi verranno ignorate). accessibile in scrittura
priority.map[] list I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). accessibile in scrittura
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 a 64 bit con segno, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa di parametri
  • template: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come nome del tag.
di Gemini Advanced.

I valori accettati sono:
    .
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessibile in scrittura
priority.value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
scheduleEndMs long Il timestamp di fine in millisecondi per pianificare un tag. accessibile in scrittura
scheduleStartMs long Il timestamp di inizio in millisecondi per pianificare un tag. accessibile in scrittura
setupTag[] list L'elenco dei tag di configurazione. Al momento ne è consentita solo una.
setupTag[].stopOnSetupFailure boolean Nel primo caso, attiva il tag principale soltanto se il tag di configurazione viene attivato correttamente. Se il valore è false, attiva il tag principale indipendentemente dallo stato di attivazione del tag di configurazione.
setupTag[].tagName string Il nome del tag di configurazione.
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 di tag di eliminazione. Al momento ne è consentita solo una.
teardownTag[].stopTeardownOnFailure boolean Nel primo caso, attiva il tag di eliminazione soltanto se il tag principale viene attivato 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 eliminazione.
type string Tipo di tag GTM. accessibile in scrittura
workspaceId string ID area di lavoro GTM.

Metodi

creazione
Crea un tag GTM.
elimina
Elimina un tag GTM.
trova
Ottieni un tag GTM.
list
Elenca tutti i tag GTM di un contenitore.
ripristina
Ripristina le modifiche a un tag GTM in un'area di lavoro GTM.
aggiorna
Aggiorna un tag GTM.