Tags

Les balises associées au conteneur Les balises sont généralement associées à une ou plusieurs règles de déclenchement (voir firingRuleId ci-dessous) et, éventuellement, à une ou plusieurs règles de blocage (voir la règle blockingRuleId ci-dessous). Lorsqu'au moins une règle de déclenchement est définie sur "true" et qu'aucune règle de blocage ne renvoie la valeur "true", la balise est déclenchée. Utilisez la propriété facultative priority pour définir quelles balises se déclenchent avant d'autres. Utilisez la propriété dependencies pour spécifier les autres balises qui doivent se déclencher et se terminer avant le déclenchement de cette balise. Pour en savoir plus sur les paramètres pouvant être définis pour les balises Google Tag Manager, consultez l'article Référence du dictionnaire de balises.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Représente une balise Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "paused": boolean
}
Nom de propriété Valeur Description Remarques
accountId string ID de compte GTM.
blockingRuleId[] list Blocage d'ID de règles Si l'une des règles listées renvoie la valeur "true", la balise ne se déclenche pas. accessible en écriture
blockingTriggerId[] list Blocage des ID de déclencheurs Si l'un des déclencheurs listés renvoie la valeur "true", la balise ne se déclenchera pas. accessible en écriture
containerId string ID de conteneur GTM.
fingerprint string Empreinte numérique de la balise GTM calculée au moment du stockage. Cette valeur est recalculée à chaque modification du tag.
firingRuleId[] list ID des règles de déclenchement Une balise se déclenche lorsque l'une des règles listées est vraie et que tous ses blockingRuleIds (le cas échéant) sont faux. accessible en écriture
firingTriggerId[] list ID des déclencheurs d'activation. Une balise se déclenche lorsque l'un des déclencheurs listés est vrai et que tous ses blockingTriggerIds (le cas échéant) sont définis sur "false". accessible en écriture
liveOnly boolean Si elle est définie sur "True", cette balise ne se déclenchera que dans l'environnement réel (par exemple, pas en mode aperçu ni en mode débogage). accessible en écriture
name string Nom à afficher du tag. accessible en écriture
notes string Notes de l'utilisateur sur la manière d'appliquer cette balise dans le conteneur accessible en écriture
parameter[] list Paramètres de la balise. accessible en écriture
parameter[].key string Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
parameter[].list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
parameter[].map[] list Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). accessible en écriture
parameter[].type string Type de paramètre. Voici les valeurs possibles:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits en base 10
  • list: une liste de paramètres doit être spécifiée.
  • map: un mappage des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références de variables (même des références de variables pouvant renvoyer des types autres que des chaînes)
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
accessible en écriture
parameter[].value string Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. accessible en écriture
parentFolderId string ID du dossier parent.
paused boolean "True" si la balise est mise en veille. accessible en écriture
priority nested object Priorité numérique du tag définie par l'utilisateur. Les balises sont déclenchées de manière asynchrone, par ordre de priorité. Les balises ayant la valeur numérique la plus élevée sont déclenchées en premier. La priorité d'une balise peut être une valeur positive ou négative. La valeur par défaut est 0. accessible en écriture
priority.key string Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
priority.list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
priority.map[] list Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). accessible en écriture
priority.type string Type de paramètre. Voici les valeurs possibles:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits en base 10
  • list: une liste de paramètres doit être spécifiée.
  • map: un mappage des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références de variables (même des références de variables pouvant renvoyer des types autres que des chaînes)
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
accessible en écriture
priority.value string Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. accessible en écriture
scheduleEndMs long Code temporel de fin, en millisecondes, de la programmation d'une balise. accessible en écriture
scheduleStartMs long Code temporel de début, en millisecondes, pour programmer une balise. accessible en écriture
setupTag[] list Liste des balises de configuration. Pour le moment, nous n'en autorisons qu'un seul.
setupTag[].stopOnSetupFailure boolean Si la valeur est "true", déclenchez la balise principale si et seulement si la balise de configuration se déclenche correctement. Si la valeur est "false", déclenchez la balise principale, quel que soit l'état de déclenchement de la balise de configuration.
setupTag[].tagName string Nom de la balise de configuration.
tagFiringOption string Option permettant de déclencher cette balise.

Valeurs acceptées :
  • "oncePerEvent"
  • "oncePerLoad"
  • "unlimited"
tagId string L'ID de la balise identifie la balise GTM de manière unique.
teardownTag[] list Liste des balises de suppression. Pour le moment, nous n'en autorisons qu'un seul.
teardownTag[].stopTeardownOnFailure boolean Si la valeur est "true", déclenchez la balise teardown si et seulement si la balise principale a bien été déclenchée. Si la valeur est "false", déclenchez la balise de suppression, quel que soit l'état de déclenchement de la balise principale.
teardownTag[].tagName string Nom de la balise teardown.
type string Type de balise GTM. accessible en écriture

Méthodes

Utilisez les méthodes ci-dessous pour créer, modifier, supprimer ou récupérer des balises.

créer
Crée une balise GTM.
supprimer
Supprime une balise GTM.
get
Récupère une balise GTM.
liste
Liste toutes les balises GTM d'un conteneur.
mise à jour
Met à jour une balise GTM.