REST Resource: accounts.containers.triggers

Ressource: Trigger

Représente un déclencheur Google Tag Manager

Représentation 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)
    }
  ]
}
Champs
accountId

string

ID de compte GTM

containerId

string

ID du conteneur GTM.

triggerId

string

L'ID de déclencheur identifie de manière unique le déclencheur GTM.

name

string

Nom à afficher du déclencheur.

type

enum (EventType)

Définit l'événement de la couche de données qui déclenche ce déclencheur.

customEventFilter[]

object (Condition)

Utilisé dans le cas d'un événement personnalisé, qui se déclenche si toutes les conditions sont remplies.

filter[]

object (Condition)

Le déclencheur ne s'active que si toutes les conditions sont remplies.

autoEventFilter[]

object (Condition)

Utilisé pour le suivi automatique des événements.

waitForTags

object (Parameter)

Indique si nous devons retarder l'envoi du formulaire ou l'ouverture du lien jusqu'à ce que toutes les balises se déclenchent (en empêchant l'action par défaut et en la simulant par la suite). Uniquement valide pour les déclencheurs d'envoi de formulaire et de clic sur un lien.

checkValidation

object (Parameter)

Indique si les balises doivent être déclenchées uniquement si l'événement d'envoi du formulaire ou de clic sur le lien n'est pas annulé par un autre gestionnaire d'événements (par exemple, en raison d'une validation). Uniquement valide pour les déclencheurs d'envoi de formulaire et de clic sur un lien.

waitForTagsTimeout

object (Parameter)

Délai d'attente (en millisecondes) avant le déclenchement des balises lorsque "waits_for_tags" ci-dessus est évalué à

true

. Valide uniquement pour les déclencheurs d'envoi de formulaire et de clic sur un lien.

uniqueTriggerId

object (Parameter)

Identifiant unique global du déclencheur qui génère automatiquement cette valeur (un écouteur de soumission de formulaire, de clic sur un lien ou de minuteur), le cas échéant. Permet de faire fonctionner des événements automatiques incompatibles avec le filtrage des déclencheurs en fonction des ID de déclencheur. Cette valeur est renseignée lors de la génération de la sortie, car les balises implicites des déclencheurs n'existent qu'à ce moment-là. Valide uniquement pour les déclencheurs d'envoi de formulaire, de clic sur un lien et de minuteur.

eventName

object (Parameter)

Nom de l'événement GTM déclenché. Uniquement valide pour les déclencheurs de minuteur.

interval

object (Parameter)

Intervalle entre le déclenchement des événements de minuteur récurrents (en millisecondes). Uniquement valide pour les déclencheurs de minuteur.

limit

object (Parameter)

Limite du nombre d'événements GTM que ce déclencheur de minuteur déclenchera. Si aucune limite n'est définie, nous continuerons de déclencher des événements GTM jusqu'à ce que l'utilisateur quitte la page. Uniquement valide pour les déclencheurs de minuteur.

fingerprint

string

Empreinte digitale du déclencheur GTM calculée au moment du stockage. Cette valeur est recalculée chaque fois que le déclencheur est modifié.

parentFolderId

string

ID du dossier parent.

selector

object (Parameter)

Un sélecteur CSS de déclencheur de clic (par exemple, "a", "button", etc.). Uniquement valide pour le déclencheur de clic AMP.

intervalSeconds

object (Parameter)

Intervalle entre les événements de minuteur à déclencher (en secondes). Uniquement valide pour le déclencheur de minuteur AMP.

maxTimerLengthSeconds

object (Parameter)

Durée maximale de déclenchement des événements de minuteur (en secondes). Uniquement valide pour le déclencheur de minuteur AMP.

verticalScrollPercentageList

object (Parameter)

Liste des valeurs de pourcentage entier pour les déclencheurs de défilement. Le déclencheur se déclenchera lorsque chaque pourcentage sera atteint lorsque la vue défilera verticalement. Uniquement valide pour les déclencheurs de défilement AMP.

horizontalScrollPercentageList

object (Parameter)

Liste des valeurs de pourcentage entier pour les déclencheurs de défilement. Le déclencheur se déclenche lorsque chaque pourcentage est atteint lorsque la vue est défilée horizontalement. Uniquement valide pour les déclencheurs de défilement AMP.

visibilitySelector

object (Parameter)

Sélecteur CSS du déclencheur de visibilité (par exemple, "#id"). Uniquement valide pour le déclencheur de visibilité AMP.

visiblePercentageMin

object (Parameter)

Un déclencheur de visibilité définit un pourcentage de visibilité minimal. Uniquement valide pour le déclencheur de visibilité AMP.

visiblePercentageMax

object (Parameter)

Un déclencheur de visibilité définit un pourcentage de visibilité maximal. Uniquement valide pour le déclencheur de visibilité AMP.

continuousTimeMinMilliseconds

object (Parameter)

Durée minimale de visibilité continue d'un déclencheur de visibilité (en millisecondes). Uniquement valide pour le déclencheur de visibilité AMP.

totalTimeMinMilliseconds

object (Parameter)

Durée totale de visibilité minimale (en millisecondes) pour un déclencheur de visibilité. Uniquement valide pour le déclencheur de visibilité AMP.

parameter[]

object (Parameter)

Paramètres supplémentaires.

EventType

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

Condition

Représente un prédicat.

Représentation JSON
{
  "type": enum (ConditionType),
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Champs
type

enum (ConditionType)

Type d'opérateur pour cette condition.

parameter[]

object (Parameter)

Liste de paramètres nommés (clé/valeur), en fonction du type de condition. Remarques :

  • Pour les opérateurs binaires, incluez les paramètres nommés

    arg0

    et

    arg1

    pour spécifier les opérandes gauche et droite, respectivement.

  • À ce stade, l'opérande de gauche (

    arg0

    ) doit être une référence à une variable.

  • Pour une correspondance avec expression régulière non sensible à la casse, incluez un paramètre booléen nommé

    ignore_case

    qui est défini sur

    true

    . Si aucune valeur n'est spécifiée ou si une autre valeur est définie, la correspondance sera sensible à la casse.

  • Pour inverser un opérateur, incluez un paramètre booléen nommé

    negate

    Paramètre booléen défini sur

    true

    .

ConditionType

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

Méthodes

create

Crée un déclencheur GTM.

delete

Supprime un déclencheur GTM.

get

Récupère un déclencheur GTM.

list

Répertorie tous les déclencheurs GTM d'un conteneur.

update

Met à jour un déclencheur GTM.