Tags: create

Crea un tag GTM. Prova subito.

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
parent string Percorso relativo dell'API GTM Workspace. Esempio: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorizzazione

Questa richiesta richiede un'autorizzazione con il seguente ambito:

Ambito
https://www.googleapis.com/auth/tagmanager.edit.containers

Per ulteriori informazioni, consulta la pagina relativa all'autenticazione e autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci una risorsa Tag con le seguenti proprietà:

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
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
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
name string Nome visualizzato del tag. 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
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
type string Tipo di tag GTM. scrivibile
Proprietà facoltative
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.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.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
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.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.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
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[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
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.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.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

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Tag nel corpo della risposta.

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.