Tags

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

리소스 표현

Google 태그 관리자 태그를 나타냅니다.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    "consentStatus": string,
    "consentType": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  }
}
속성 이름 설명 Notes
accountId string GTM 계정 ID입니다.
blockingRuleId[] list 차단 규칙 ID를 클릭합니다. 나열된 규칙 중 하나라도 true로 판정되면 태그가 실행되지 않습니다. 쓰기 가능
blockingTriggerId[] list 차단 트리거 ID 목록에 있는 트리거 중 하나라도 true로 판정되면 태그가 실행되지 않습니다. 쓰기 가능
consentSettings nested object 태그의 동의 설정 쓰기 가능
consentSettings.consentStatus string 태그의 동의 상태입니다. NEEDED로 설정하면 런타임이 consent_type 필드로 지정된 동의 유형이 부여되었는지 확인합니다.

사용 가능한 값은 다음과 같습니다.
  • "needed"
  • "notNeeded"
  • "notSet"
consentSettings.consentType nested object 동의가 필요한 상태인 경우 태그 실행 중에 확인할 동의 유형입니다. 이 매개변수는 LIST 유형이어야 하며, 여기서 각 목록 항목은 STRING 유형이어야 합니다.
consentSettings.consentType.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
consentSettings.consentType.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
consentSettings.consentType.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
consentSettings.consentType.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
consentSettings.consentType.type string 매개변수 유형. 유효한 값은 다음과 같습니다.
  • boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다.
  • list: 매개변수 목록을 지정해야 함
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다.
  • trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다.
  • tag_reference: 값은 태그 이름으로 표시되는 태그를 나타냅니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
consentSettings.consentType.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
containerId string GTM 컨테이너 ID입니다.
fingerprint string 저장 시간에 계산된 GTM 태그의 지문입니다. 이 값은 태그가 수정될 때마다 다시 계산됩니다.
firingRuleId[] list 규칙 ID를 실행하는 중입니다. 나열된 규칙 중 하나가 true이고 모든 blockingRuleIds (지정된 경우)이 false일 때 태그가 실행됩니다. 쓰기 가능
firingTriggerId[] list 트리거 ID를 실행하는 중입니다. 나열된 트리거 중 하나가 true이고 모든 blockingTriggerIds (지정된 경우)이 false일 때 태그가 실행됩니다. 쓰기 가능
liveOnly boolean true로 설정하면 이 태그는 실제 환경에서만 실행됩니다 (예: 미리보기 또는 디버그 모드에서는 실행되지 않음). 쓰기 가능
monitoringMetadata nested object 태그 모니터링을 위해 이벤트 데이터에 포함될 태그 메타데이터의 키-값 쌍 맵입니다. 참고:
  • 이 매개변수는 MAP 유형이어야 합니다.
  • 맵의 각 매개변수는 TEMPLATE 유형이지만 변수 참조를 포함할 수 없습니다.
쓰기 가능
monitoringMetadata.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
monitoringMetadata.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
monitoringMetadata.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
monitoringMetadata.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
monitoringMetadata.type string 매개변수 유형. 유효한 값은 다음과 같습니다.
  • boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다.
  • list: 매개변수 목록을 지정해야 함
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다.
  • trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다.
  • tag_reference: 값은 태그 이름으로 표시되는 태그를 나타냅니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
monitoringMetadata.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
monitoringMetadataTagNameKey string 비어 있지 않으면 지정된 키를 사용하여 태그 표시 이름이 모니터링 메타데이터 맵에 포함됩니다. 쓰기 가능
name string 태그 표시 이름입니다. 쓰기 가능
notes string 컨테이너에서 이 태그를 적용하는 방법에 대한 사용자 메모 쓰기 가능
parameter[] list 태그의 매개변수입니다. 쓰기 가능
parameter[].isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
parameter[].key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
parameter[].list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
parameter[].map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
parameter[].type string 매개변수 유형. 유효한 값은 다음과 같습니다.
  • boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다.
  • list: 매개변수 목록을 지정해야 함
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다.
  • trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다.
  • tag_reference: 값은 태그 이름으로 표시되는 태그를 나타냅니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
parameter[].value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
parentFolderId string 상위 폴더 ID입니다.
path string GTM 태그의 API 상대 경로입니다.
paused boolean 태그가 일시중지되어 태그가 실행되지 않는지 여부를 나타냅니다. 쓰기 가능
priority nested object 사용자가 정의한 태그의 숫자 우선순위입니다. 태그는 우선순위에 따라 비동기식으로 실행됩니다. 숫자 값이 더 큰 태그가 먼저 실행됩니다. 태그의 우선순위는 양수 또는 음수일 수 있습니다. 기본값은 0입니다. 쓰기 가능
priority.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
priority.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
priority.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
priority.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
priority.type string 매개변수 유형. 유효한 값은 다음과 같습니다.
  • boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다.
  • list: 매개변수 목록을 지정해야 함
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다.
  • trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다.
  • tag_reference: 값은 태그 이름으로 표시되는 태그를 나타냅니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
priority.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
scheduleEndMs long 태그를 예약할 종료 타임스탬프(밀리초)입니다. 쓰기 가능
scheduleStartMs long 태그를 예약할 시작 타임스탬프(밀리초)입니다. 쓰기 가능
setupTag[] list 설정 태그 목록입니다. 현재는 하나만 허용됩니다.
setupTag[].stopOnSetupFailure boolean true인 경우 설정 태그가 성공적으로 실행된 경우에만 기본 태그를 실행합니다. false인 경우 설정 태그 실행 상태에 관계없이 기본 태그를 실행합니다.
setupTag[].tagName string 설정 태그의 이름입니다.
tagFiringOption string 이 태그를 실행할 옵션입니다.

사용 가능한 값은 다음과 같습니다.
  • "oncePerEvent"
  • "oncePerLoad"
  • "tagFiringOptionUnspecified"
  • "unlimited"
tagId string 태그 ID로 GTM 태그를 고유하게 식별할 수 있습니다.
tagManagerUrl string 자동 생성된 태그 관리자 UI 링크
teardownTag[] list 해제 태그 목록입니다. 현재는 하나만 허용됩니다.
teardownTag[].stopTeardownOnFailure boolean true인 경우 기본 태그가 성공적으로 실행된 경우에만 해제 태그를 실행합니다. false인 경우 기본 태그 실행 상태에 관계없이 해제 태그를 실행합니다.
teardownTag[].tagName string 해제 태그의 이름입니다.
type string GTM 태그 유형입니다. 쓰기 가능
workspaceId string GTM 작업공간 ID입니다.

방법

만들기
GTM 태그를 만듭니다.
삭제
GTM 태그를 삭제합니다.
get
GTM 태그를 가져옵니다.
list
컨테이너의 모든 GTM 태그를 나열합니다.
revert
GTM 작업공간에서 GTM 태그 변경사항을 되돌립니다.
업데이트
GTM 태그를 업데이트합니다.