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 percorso
parent string Percorso relativo dell'API di GTM Workspace. Esempio: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito:

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

Per ulteriori informazioni, consulta la pagina 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 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.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
name string Nome visualizzato del tag. 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
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
type string Tipo di tag GTM. accessibile in scrittura
Proprietà facoltative
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.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.value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
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.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.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
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[].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[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
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.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.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

Risposta

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

Prova

Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.