API de Tag Manager - Referencia de parámetros

En este documento se describe el objetivo y la representación del objeto de parámetro de Tag Manager.

Introducción

La API de Tag Manager te permite crear y gestionar recursos de esta plataforma, como Tag, Trigger o Variable.

La mayoría de los tipos de recursos Tag y Variable incluyen parámetros adicionales específicos que se pueden configurar al crear o al actualizar el recurso. La lista de parámetros (pares key/type) de cada tipo de recurso Tag y Variable se incluye en la Referencia del diccionario del recurso Tag.

Para configurar estos parámetros específicos Tag o Variable, se define un objeto de parámetro que a su vez se define como valor de la propiedad parameter del recurso Tag o del recurso Variable.

Objeto de parámetro

El siguiente objeto representa un objeto de parámetro:

[
  {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  }
]

type

Tipo de parámetro del recurso Tag o Variable que se configura.

La propiedad type determinará si una propiedad value, list o map debe incluirse en el objeto de parámetro, como se describe en la tabla que se muestra a continuación.

Por ejemplo, si se elige boolean como valor de la propiedad type, se debe incluir una propiedad value en el objeto de parámetro y especificar true o false como su valor.

Valor Propiedad adicional que se debe incluir Valor que debe tener la propiedad adicional
template value La propiedad value es cualquier cadena, incluidas las referencias del recurso Variable, por ejemplo, foo{{bar}}.
boolean value La propiedad value es true o false.
number value La propiedad value es un número entero.
list list La propiedad list incluirá cero o más parámetros (en cualquier orden o bien en un orden concreto); la propiedad key de cualquier parámetro de la lista (list) se ignorará.
map map La propiedad map incluirá cero o más parámetros (en cualquier orden); la propiedad key de cualquier parámetro del mapa (map) debe ser única.

key

Clave del parámetro del recurso Tag o Variable que se configura.

El campo key se utiliza para identificar el parámetro de los recursos Tag o Variable que se están configurando. Todos los tipos de parámetro necesitan una propiedad key (excepto los parámetros list).

Ejemplos

Un objeto de parámetro de un recurso Tag HTML personalizado, que tiene un parámetro de tipo template y dos parámetros de tipo boolean:

"parameter": [
  {
    "key": "html",
    "type": "template",
    "value": "<script>alert('hello world')</script>"
  },
  {
    "key": "supportDocumentWrite",
    "type": "boolean",
    "value": "false"
  }
]

Un objeto de parámetro de un recurso Tag de llamada de función, que tiene un parámetro de tipo template y un parámetro de tipo map:

"parameter": [
  {
    "key": "functionName",
    "type": "template",
    "value": "fn"
  },
  {
    "key": "functionArgument",
    "map": [
      {
        "key": "argkey1",
        "type": "template",
        "value": "argval1"
      }
    ],
    "type": "map"
  }
]