Rules

컨테이너의 규칙입니다. 규칙은 런타임 중에 참 또는 거짓으로 평가됩니다. 태그가 실행되는 시점 또는 실행이 차단되는 시점과 모바일 컨테이너의 매크로가 사용 설정 또는 사용 중지되는 시점을 관리하는 데 사용할 수 있습니다. 자세한 내용은 각각 태그 구성의 실행 및 사용 중지 규칙과 매크로 구성의 사용 설정 및 사용 중지 규칙을 참고하세요.

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

Google 태그 관리자 규칙을 나타냅니다.

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
속성 이름 설명 Notes
accountId string GTM 계정 ID입니다.
condition[] list 이 규칙을 구성하는 조건의 목록 (규칙 간 암시적 AND) 쓰기 가능
condition[].parameter[] list 조건 유형에 따라 이름이 지정된 매개변수 (키/값) 목록. 참고:
  • 바이너리 연산자의 경우 왼쪽 및 오른쪽 피연산자를 각각 지정하기 위해 arg0arg1라는 매개변수를 포함합니다.
  • 이때 왼쪽 피연산자 (arg0)는 매크로 참조여야 합니다.
  • 대소문자를 구분하지 않는 정규식 일치의 경우 true로 설정된 ignore_case이라는 부울 매개변수를 포함합니다. 지정하지 않거나 다른 값으로 설정하면 일치 항목이 대소문자를 구분합니다.
  • 연산자를 무효화하려면 negate라는 부울 매개변수를 포함하고 true로 설정합니다.
쓰기 가능
condition[].parameter[].key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
condition[].parameter[].list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
condition[].parameter[].map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
condition[].parameter[].type string 매개변수 유형. 유효한 값은 다음과 같습니다.
  • boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다.
  • list: 매개변수 목록을 지정해야 함
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값은 모든 텍스트를 나타냅니다. 여기에는 매크로 참조 (문자열이 아닌 유형을 반환할 수 있는 매크로 참조도 포함)가 포함될 수 있습니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
쓰기 가능
condition[].parameter[].value string 지정된 유형에 적합한 매개변수의 값('"와 같은 매크로 참조를 포함할 수 있음) 쓰기 가능
condition[].type string 이 조건의 연산자 유형입니다.

사용 가능한 값은 다음과 같습니다.
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
쓰기 가능
containerId string GTM 컨테이너 ID입니다.
fingerprint string 저장 시점에 계산된 GTM 규칙의 지문입니다. 이 값은 규칙이 수정될 때마다 다시 계산됩니다.
name string 규칙 표시 이름입니다. 쓰기 가능
notes string 사용자가 컨테이너에서 이 규칙을 적용하는 방법에 대한 메모 쓰기 가능
ruleId string 규칙 ID는 GTM 규칙을 고유하게 식별합니다.

방법

아래 메서드를 사용하여 규칙을 생성, 수정, 삭제 또는 가져오세요.

만들기
GTM 규칙을 만듭니다.
삭제
GTM 규칙을 삭제합니다.
get
GTM 규칙을 가져옵니다.
list
컨테이너의 모든 GTM 규칙을 나열합니다.
업데이트
GTM 규칙을 업데이트합니다.