Triggers: update

Richiede l'autorizzazione

Aggiorna un attivatore GTM. Prova subito o guarda un esempio.

Richiesta

Richiesta HTTP

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers/triggerId

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
accountId string L'ID account GTM.
containerId string L'ID contenitore GTM.
triggerId string L'ID attivatore GTM.
Parametri di query facoltativi
fingerprint string Se fornita, questa impronta deve corrispondere a quella del trigger nello spazio di archiviazione.

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).

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

Corpo della richiesta

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

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
autoEventFilter[].parameter[] list Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note:
  • Per gli operatori binari, includi i parametri denominati arg0 e arg1 per specificare rispettivamente gli operandi sinistro e destro.
  • Al momento, l'operando sinistro (arg0) deve essere un riferimento a una variabile.
  • Per la corrispondenza con espressioni regolari senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato ignore_case impostato su true. Se non viene specificato o impostato su un altro valore, la corrispondenza sarà sensibile alle maiuscole.
  • Per escludere un operatore, includi un parametro booleano denominato negate parametro booleano impostato su true.
scrivibile
autoEventFilter[].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
autoEventFilter[].type string Il tipo di operatore per questa condizione.

I valori accettati sono:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 scrivibile
checkValidation.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
continuousTimeMinMilliseconds.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
customEventFilter[].parameter[] list Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note:
  • Per gli operatori binari, includi i parametri denominati arg0 e arg1 per specificare rispettivamente gli operandi sinistro e destro.
  • Al momento, l'operando sinistro (arg0) deve essere un riferimento a una variabile.
  • Per la corrispondenza con espressioni regolari senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato ignore_case impostato su true. Se non viene specificato o impostato su un altro valore, la corrispondenza sarà sensibile alle maiuscole.
  • Per escludere un operatore, includi un parametro booleano denominato negate parametro booleano impostato su true.
scrivibile
customEventFilter[].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
customEventFilter[].type string Il tipo di operatore per questa condizione.

I valori accettati sono:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 scrivibile
eventName.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
filter[].parameter[] list Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note:
  • Per gli operatori binari, includi i parametri denominati arg0 e arg1 per specificare rispettivamente gli operandi sinistro e destro.
  • Al momento, l'operando sinistro (arg0) deve essere un riferimento a una variabile.
  • Per la corrispondenza con espressioni regolari senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato ignore_case impostato su true. Se non viene specificato o impostato su un altro valore, la corrispondenza sarà sensibile alle maiuscole.
  • Per escludere un operatore, includi un parametro booleano denominato negate parametro booleano impostato su true.
scrivibile
filter[].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
filter[].type string Il tipo di operatore per questa condizione.

I valori accettati sono:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 scrivibile
horizontalScrollPercentageList.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
interval.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
intervalSeconds.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
limit.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
maxTimerLengthSeconds.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
name string Nome visualizzato dell'attivatore. 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
selector.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
totalTimeMinMilliseconds.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
uniqueTriggerId.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
verticalScrollPercentageList.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
visibilitySelector.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
visiblePercentageMax.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
visiblePercentageMin.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
waitForTags.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
waitForTagsTimeout.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
Proprietà facoltative
autoEventFilter[] list Utilizzato nel caso del monitoraggio automatico degli eventi. scrivibile
autoEventFilter[].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
autoEventFilter[].parameter[].list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
autoEventFilter[].parameter[].map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
autoEventFilter[].parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
checkValidation nested object Indica se attivare o meno i tag solo se l'evento di invio del modulo o clic sul link non viene annullato da un altro gestore di eventi (ad es. a causa della convalida). Valido solo per gli attivatori Invio modulo e Clic sui link. scrivibile
checkValidation.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
checkValidation.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
checkValidation.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
checkValidation.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
continuousTimeMinMilliseconds nested object Un trigger di visibilità per tempo di visibilità continua minimo (in millisecondi). Valido solo per l'attivatore Visibilità AMP. scrivibile
continuousTimeMinMilliseconds.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
continuousTimeMinMilliseconds.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
continuousTimeMinMilliseconds.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
continuousTimeMinMilliseconds.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
customEventFilter[] list Utilizzato nel caso di un evento personalizzato, che viene attivato se tutte le condizioni sono vere. scrivibile
customEventFilter[].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
customEventFilter[].parameter[].list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
customEventFilter[].parameter[].map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
customEventFilter[].parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
eventName nested object Nome dell'evento GTM che è stato attivato. Valido solo per gli attivatori Timer. scrivibile
eventName.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
eventName.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
eventName.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
eventName.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
filter[] list L'attivatore si attiva solo se tutte le condizioni sono vere. scrivibile
filter[].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
filter[].parameter[].list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
filter[].parameter[].map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
filter[].parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
horizontalScrollPercentageList nested object Elenco di valori percentuali interi per gli attivatori di scorrimento. L'attivatore si attiva quando viene raggiunta ogni percentuale con lo scorrimento orizzontale della visualizzazione. Valido solo per gli attivatori di scorrimento delle pagine AMP. scrivibile
horizontalScrollPercentageList.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
horizontalScrollPercentageList.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
horizontalScrollPercentageList.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
horizontalScrollPercentageList.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
interval nested object Tempo in millisecondi tra l'attivazione di eventi timer ricorrenti. Valido solo per gli attivatori Timer. scrivibile
interval.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
interval.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
interval.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
interval.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
intervalSeconds nested object Tempo tra l'attivazione degli eventi timer (in secondi). Valido solo per l'attivatore Timer AMP. scrivibile
intervalSeconds.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
intervalSeconds.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
intervalSeconds.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
intervalSeconds.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
limit nested object Limite del numero di eventi GTM attivati da questo attivatore del timer. Se non viene impostato alcun limite, continueremo ad attivare gli eventi GTM finché l'utente non abbandona la pagina. Valido solo per gli attivatori Timer. scrivibile
limit.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
limit.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
limit.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
limit.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
maxTimerLengthSeconds nested object Tempo massimo per attivare gli eventi timer (in secondi). Valido solo per l'attivatore Timer AMP. scrivibile
maxTimerLengthSeconds.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
maxTimerLengthSeconds.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
maxTimerLengthSeconds.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
maxTimerLengthSeconds.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. 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
selector nested object Un selettore CSS per l'attivatore di clic (ad es. "a", "pulsante" e così via). Valido solo per l'attivatore Clic per AMP. scrivibile
selector.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
selector.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
selector.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
selector.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
totalTimeMinMilliseconds nested object Un tempo di visibilità totale minimo (in millisecondi) per attivare la visibilità. Valido solo per l'attivatore Visibilità AMP. scrivibile
totalTimeMinMilliseconds.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
totalTimeMinMilliseconds.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
totalTimeMinMilliseconds.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
totalTimeMinMilliseconds.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
type string Definisce l'evento del livello dati che causa questo attivatore.

I valori accettati sono:
  • "always"
  • "ampClick"
  • "ampScroll"
  • "ampTimer"
  • "ampVisibility"
  • "click"
  • "customEvent"
  • "domReady"
  • "elementVisibility"
  • "formSubmission"
  • "historyChange"
  • "jsError"
  • "linkClick"
  • "pageview"
  • "scrollDepth"
  • "timer"
  • "triggerGroup"
  • "windowLoaded"
  • "youTubeVideo"
 scrivibile
uniqueTriggerId nested object ID univoco a livello globale dell'attivatore che lo genera automaticamente (invio modulo, clic sul link o listener del timer), se disponibile. Utilizzato per fare in modo che gli eventi automatici non compatibili interagiscano con i filtri degli attivatori in base agli ID degli attivatori. Questo valore viene compilato durante la generazione dell'output, poiché i tag associati agli attivatori non esistono fino a quel momento. Valido solo per gli attivatori Invio modulo, Clic sui link e Timer. scrivibile
uniqueTriggerId.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
uniqueTriggerId.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
uniqueTriggerId.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
uniqueTriggerId.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
verticalScrollPercentageList nested object Elenco di valori percentuali interi per gli attivatori di scorrimento. L'attivatore si attiva quando viene raggiunta ogni percentuale con lo scorrimento della visualizzazione in verticale. Valido solo per gli attivatori di scorrimento delle pagine AMP. scrivibile
verticalScrollPercentageList.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
verticalScrollPercentageList.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
verticalScrollPercentageList.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
verticalScrollPercentageList.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
visibilitySelector nested object Un selettore CSS dell'attivatore di visibilità (ad es. "#id"). Valido solo per l'attivatore Visibilità AMP. scrivibile
visibilitySelector.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
visibilitySelector.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
visibilitySelector.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
visibilitySelector.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
visiblePercentageMax nested object Una visibilità attiva la percentuale di visibilità massima. Valido solo per l'attivatore Visibilità AMP. scrivibile
visiblePercentageMax.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
visiblePercentageMax.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
visiblePercentageMax.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
visiblePercentageMax.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
visiblePercentageMin nested object Una visibilità attiva la percentuale minima di visibilità. Valido solo per l'attivatore Visibilità AMP. scrivibile
visiblePercentageMin.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
visiblePercentageMin.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
visiblePercentageMin.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
visiblePercentageMin.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
waitForTags nested object Indica se dobbiamo ritardare o meno l'invio del modulo o l'apertura dei link fino all'attivazione di tutti i tag (impedendo l'azione predefinita e simulando in seguito l'azione predefinita). Valido solo per gli attivatori Invio modulo e Clic sui link. scrivibile
waitForTags.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
waitForTags.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
waitForTags.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
waitForTags.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
waitForTagsTimeout nested object Tempo di attesa (in millisecondi) per l'attivazione dei tag quando "waits_for_tags" riportato sopra restituisce true. Valido solo per gli attivatori Invio modulo e Clic sui link. scrivibile
waitForTagsTimeout.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
waitForTagsTimeout.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
waitForTagsTimeout.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
waitForTagsTimeout.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile

Risposta

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

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request updates an existing trigger for the authorized user.
 */

// Create the condition parameters objects.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("arg0");
arg0.setValue("{{Page URL}}");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("arg1");
arg1.setValue("timed.html");

// Create the auto event condition object.
Condition condition = new Condition();
condition.setType("contains");
condition.setParameter(Arrays.asList(arg0, arg1));

// Create the event parameter.
Parameter eventName = new Parameter();
eventName.setType("template");
eventName.setValue("gtm.timer");

// Create the interval parameter.
Parameter interval = new Parameter();
interval.setType("template");
interval.setValue("10000");

// Create the limit parameter.
Parameter limit = new Parameter();
limit.setType("template");
limit.setValue("10");

// Create the trigger object.
Trigger trigger = new Trigger();
trigger.setName("Updated Timer Trigger");
trigger.setType("timer");
trigger.setAutoEventFilter(Arrays.asList(condition));
trigger.setEventName(eventName);
trigger.setInterval(interval);
trigger.setLimit(limit);

try {
  Trigger response = tagmanager.accounts().containers().
      triggers().update("123456", "54321", "1", trigger).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Utilizza la libreria client Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request updates an existing trigger.
try:
  response = tagmanager.accounts().containers().triggers().update(
      accountId='123456',
      containerId='54321',
      triggerId='3',
      body={
          'name': 'Updated Timed trigger',
          'type': 'timer',
          'autoEventFilter': [
              {
                  'type': 'contains',
                  'parameter': [
                      {
                          'type': 'template',
                          'key': 'arg0',
                          'value': '{{Page URL}}'
                      },
                      {
                          'type': 'template',
                          'key': 'arg1',
                          'value': 'timed.html'
                      }
                  ]
              }
          ],
          'eventName': {
              'type': 'template',
              'value': 'gtm.timer'
          },
          'interval': {
              'type': 'template',
              'value': '10000'
          },
          'limit': {
              'type': 'template',
              'value': '10'
          }
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Prova.

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