REST Resource: accounts.containers.triggers

Risorsa: trigger

Rappresenta un attivatore di Google Tag Manager

Rappresentazione JSON
{
  "accountId": string,
  "containerId": string,
  "triggerId": string,
  "name": string,
  "type": enum (EventType),
  "customEventFilter": [
    {
      object (Condition)
    }
  ],
  "filter": [
    {
      object (Condition)
    }
  ],
  "autoEventFilter": [
    {
      object (Condition)
    }
  ],
  "waitForTags": {
    object (Parameter)
  },
  "checkValidation": {
    object (Parameter)
  },
  "waitForTagsTimeout": {
    object (Parameter)
  },
  "uniqueTriggerId": {
    object (Parameter)
  },
  "eventName": {
    object (Parameter)
  },
  "interval": {
    object (Parameter)
  },
  "limit": {
    object (Parameter)
  },
  "fingerprint": string,
  "parentFolderId": string,
  "selector": {
    object (Parameter)
  },
  "intervalSeconds": {
    object (Parameter)
  },
  "maxTimerLengthSeconds": {
    object (Parameter)
  },
  "verticalScrollPercentageList": {
    object (Parameter)
  },
  "horizontalScrollPercentageList": {
    object (Parameter)
  },
  "visibilitySelector": {
    object (Parameter)
  },
  "visiblePercentageMin": {
    object (Parameter)
  },
  "visiblePercentageMax": {
    object (Parameter)
  },
  "continuousTimeMinMilliseconds": {
    object (Parameter)
  },
  "totalTimeMinMilliseconds": {
    object (Parameter)
  },
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Campi
accountId

string

ID account GTM.

containerId

string

ID contenitore GTM.

triggerId

string

L'ID attivatore identifica in modo univoco l'attivatore GTM.

name

string

Nome visualizzato dell'attivatore.

type

enum (EventType)

Definisce l'evento del livello dati che causa questo trigger.

customEventFilter[]

object (Condition)

Utilizzato nel caso di evento personalizzato, che viene attivato se e solo se tutte le condizioni sono vere.

filter[]

object (Condition)

L'attivatore si attiverà solo se tutte le condizioni sono vere.

autoEventFilter[]

object (Condition)

Utilizzato nel caso del monitoraggio evento automatico.

waitForTags

object (Parameter)

Se è necessario ritardare l'invio dei moduli o l'apertura dei link fino all'attivazione di tutti i tag (impedendo l'azione predefinita e simulando in un secondo momento l'azione predefinita). Valido solo per gli attivatori Invio modulo e Clic sui link.

checkValidation

object (Parameter)

Se è necessario attivare i tag solo se l'evento di invio del modulo o di clic sul link non viene annullato da un altro gestore eventi (ad es. a causa della convalida). Valido solo per gli attivatori Invio modulo e Clic sui link.

waitForTagsTimeout

object (Parameter)

Tempo di attesa (in millisecondi) per l'attivazione dei tag quando "waits_for_tags" sopra valuta

true

. Valido solo per gli attivatori Invio modulo e Clic sui link.

uniqueTriggerId

object (Parameter)

ID univoco globale dell'attivatore che lo genera automaticamente (un Listener di invio modulo, clic sul link o timer), se presente. Viene utilizzato per consentire il funzionamento di eventi automatici incompatibili con il filtro degli attivatori in base agli ID attivatore. Questo valore viene inserito durante la generazione dell'output, poiché i tag impliciti degli attivatori non esistono fino a quel momento. Valido solo per gli attivatori Invio del modulo, Clic sui link e Timer.

eventName

object (Parameter)

Nome dell'evento GTM attivato. Valido solo per gli attivatori timer.

interval

object (Parameter)

Tempo tra l'attivazione di eventi timer ricorrenti (in millisecondi). Valido solo per gli attivatori timer.

limit

object (Parameter)

Limite del numero di eventi GTM che verranno attivati da questo attivatore timer. Se non viene impostato alcun limite, continueremo ad attivare gli eventi GTM finché l'utente non esce dalla pagina. Valido solo per gli attivatori timer.

fingerprint

string

L'impronta dell'attivatore GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che l'attivatore viene modificato.

parentFolderId

string

ID cartella principale.

selector

object (Parameter)

Un selettore CSS per l'attivatore dei clic (ad es. "a", "button" e così via). Valido solo per l'attivatore di clic AMP.

intervalSeconds

object (Parameter)

Tempo tra gli eventi del timer da attivare (in secondi). Valido solo per l'attivatore timer AMP.

maxTimerLengthSeconds

object (Parameter)

Tempo massimo per l'attivazione degli eventi timer (in secondi). Valido solo per l'attivatore timer AMP.

verticalScrollPercentageList

object (Parameter)

Elenco di valori percentuali interi per gli attivatori di scorrimento. L'attivatore viene attivato quando viene raggiunta ogni percentuale durante lo scorrimento verticale della visualizzazione. Valido solo per gli attivatori di scorrimento AMP.

horizontalScrollPercentageList

object (Parameter)

Elenco di valori percentuali interi per gli attivatori di scorrimento. L'attivatore viene attivato quando viene raggiunta ogni percentuale durante lo scorrimento orizzontale della visualizzazione. Valido solo per gli attivatori di scorrimento AMP.

visibilitySelector

object (Parameter)

Un selettore CSS di attivazione della visibilità (ad es. "#id"). Valido solo per l'attivatore Visibilità AMP.

visiblePercentageMin

object (Parameter)

Un attivatore di visibilità con una percentuale minima di visibilità. Valido solo per l'attivatore Visibilità AMP.

visiblePercentageMax

object (Parameter)

Un attivatore di visibilità con una percentuale massima di visibilità. Valido solo per l'attivatore Visibilità AMP.

continuousTimeMinMilliseconds

object (Parameter)

Un tempo di visibilità continua minima dell'attivatore di visibilità (in millisecondi). Valido solo per l'attivatore Visibilità AMP.

totalTimeMinMilliseconds

object (Parameter)

Un tempo di visibilità totale minimo dell'attivatore della visibilità (in millisecondi). Valido solo per l'attivatore Visibilità AMP.

parameter[]

object (Parameter)

Parametri aggiuntivi.

EventType

Enum
pageview
domReady
windowLoaded
customEvent
triggerGroup
always
formSubmission
click
linkClick
jsError
historyChange
timer
ampClick
ampTimer
ampScroll
ampVisibility
youTubeVideo
scrollDepth
elementVisibility

Condizione

Rappresenta un predicato.

Rappresentazione JSON
{
  "type": enum (ConditionType),
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Campi
type

enum (ConditionType)

Il tipo di operatore per questa condizione.

parameter[]

object (Parameter)

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 gli operandi sinistro e destro, rispettivamente.

  • A questo punto, l'operando sinistro (

    arg0

    ) deve essere un riferimento a una variabile.

  • Per la corrispondenza regex senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato

    ignore_case

    impostato su

    true

    . Se non specificato o impostato su un altro valore, la corrispondenza sarà sensibile alle maiuscole.

  • Per negare un operatore, includi un parametro booleano denominato

    negate

    parametro booleano impostato su

    true

    .

ConditionType

Enum
equals
contains
startsWith
endsWith
matchRegex
greater
greaterOrEquals
less
lessOrEquals
cssSelector
urlMatches

Metodi

create

Crea un trigger GTM.

delete

Consente di eliminare un trigger GTM.

get

Recupera un attivatore GTM.

list

Elenca tutti gli attivatori GTM di un contenitore.

update

Aggiorna un attivatore GTM.