Crea un attivatore GTM. Prova subito.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/tagmanager/v2/+parent/triggers
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 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:
|
scrivibile |
autoEventFilter[].parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
autoEventFilter[].type |
string |
Il tipo di operatore per questa condizione.
I valori accettati sono:
|
scrivibile |
checkValidation.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
continuousTimeMinMilliseconds.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
customEventFilter[].parameter[] |
list |
Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note:
|
scrivibile |
customEventFilter[].parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
customEventFilter[].type |
string |
Il tipo di operatore per questa condizione.
I valori accettati sono:
|
scrivibile |
eventName.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
filter[].parameter[] |
list |
Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note:
|
scrivibile |
filter[].parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
filter[].type |
string |
Il tipo di operatore per questa condizione.
I valori accettati sono:
|
scrivibile |
horizontalScrollPercentageList.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
interval.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
intervalSeconds.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
limit.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
maxTimerLengthSeconds.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
name |
string |
Nome visualizzato dell'attivatore. | scrivibile |
parameter[].type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
selector.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
totalTimeMinMilliseconds.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
type |
string |
Definisce l'evento del livello dati che causa questo attivatore.
I valori accettati sono:
|
scrivibile |
uniqueTriggerId.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
verticalScrollPercentageList.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
visibilitySelector.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
visiblePercentageMax.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
visiblePercentageMin.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
waitForTags.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
scrivibile |
waitForTagsTimeout.type |
string |
Il tipo di parametro. I valori validi sono:
I valori accettati sono:
|
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 |
notes |
string |
Note dell'utente su come applicare questo attivatore nel contenitore. | scrivibile |
parameter[] |
list |
Parametri aggiuntivi. | 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 |
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.
Prova.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.