Tag Manager API - 参数参考

本文档介绍了跟踪代码管理器参数对象的用途和表示形式。

简介

借助 Tag Manager API，您可以创建和管理跟踪代码管理器资源，例如 Tags、Triggers 和 Variables。

大多数代码和变量类型都具有专属的额外参数，可在创建/更新资源时加以设置。代码字典参考中列出了每种代码和变量类型的参数（key、type 对）列表。

要配置这些特定于代码或变量的参数，请定义“参数对象”，并将其设置为 Tag 或 Variable 资源的 parameter 属性的值。

参数对象

以下对象表示参数对象：

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

type

要配置的代码或变量的参数类型。

type 属性用于确定需要在参数对象中包含 value、list 还是 map 属性，如下表所述。

例如，如果 type 的设置是 boolean，则参数对象中应包含已设置为 true 或 false 的 value 属性。

值	要包含的额外属性	额外属性的具体设置内容
template	value	value 可为任何字符串，包括变量引用，例如 foo{{bar}}。
boolean	value	value 是 true 或 false。
number	value	value 是一个整数值。
list	list	list 将包含零个或多个参数，顺序可能重要，也可能不重要；list 中的任何参数的 key 均会被忽略。
map	map	map 将包含零个或多个参数，顺序不重要；map 中的任何参数上的 key 均应具有唯一性。

key

要配置的代码或变量的参数键。

key 字段用于标识要设置的特定代码或变量的参数。所有参数类型都需要一个 key 属性（list 参数除外）。

示例

以下是自定义 HTML 代码的参数对象示例，其包含一个 template 类型参数和两个 boolean 类型参数：

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

以下是函数调用代码的参数对象示例，其包含一个 template 类型参数和一个 map 类型参数：

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