Tag Manager API - 매개변수 참조

이 문서에서는 태그 관리자의 용도와 표현을 설명합니다. 매개변수 객체입니다.

소개

태그 관리자 API를 사용하면 태그 관리자 리소스를 만들고 관리할 수 있습니다. 태그, 규칙, 매크로 등입니다.

대부분의 태그와 매크로 유형에는 고유한 추가 매개변수가 있습니다. 를 태그 또는 매크로에 추가하고 리소스를 생성/업데이트할 때 설정할 수 있습니다. 목록 각 태그 및 매크로의 매개변수 (key, type 쌍) 유형은 태그 사전 참조 문서 및 매크로 사전 참조.

이러한 태그 또는 매크로별 매개변수를 구성하려면 매개변수 객체가 parameter의 값으로 정의되고 설정됩니다. 태그의 속성 또는 매크로 리소스에 사용해야 합니다.

매개변수 객체

다음 객체는 매개변수 객체를 나타냅니다.

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

type

구성 중인 태그 또는 매크로의 매개변수 유형입니다.

type 속성이 value, list, map 속성 여부 가 매개변수 객체에 포함되어야 합니다. 참조하세요.

예를 들어 type가 boolean로 설정된 경우 value 속성을 매개변수 객체에 포함하고 true 또는 false로 전송합니다.

값	포함할 추가 속성	추가 속성 설정 대상
template	value	value는 매크로 참조를 포함한 문자열입니다(예: foo{{bar}}입니다.
boolean	value	value는 true 또는 false입니다.
number	value	value는 정수입니다.
list	list	list에 0개 이상의 매개변수가 포함됩니다. 주문은 0개 이상의 매개변수를 포함할 수 있습니다. 중요하지 않습니다. list에 있는 매개변수의 key 무시됩니다.
map	map	map에는 0개 이상의 매개변수가 포함되며 순서에는 포함되지 않습니다. 중요합니다. 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 유형 매개변수와 1개의 매개변수가 있습니다. list 유형 매개변수:

"parameter": [
  {
    "type": "template",
    "key": "input",
    "value": "{{event}}"
  },
  {
    "type": "list",
    "key": "map",
    "list": [
      {
        "type": "map",
        "map": [
          {
            "type": "template",
            "key": "key",
            "value": "EventEqualsThis"
          },
          {
            "type": "template",
            "key": "value",
            "value": "ThenSetToThis"
          }
        ]
      }
    ]
  },
  {
    "type": "template",
    "key": "defaultValue",
    "value": "MyDefaultValue"
  }
]

함수 호출의 매개변수 객체 template 유형 매개변수 1개와 map 1개가 있는 태그 type 매개변수:

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