컨테이너와 연결된 태그입니다. 태그는 일반적으로 하나 이상의 실행 규칙 (아래 firingRuleId
참고)과 연결되며, 원하는 경우 하나 이상의 차단 규칙 (아래 blockingRuleId
참고)과 연결됩니다. 하나 이상의 실행 규칙이 true로 평가되고 정확히 0개의 차단 규칙이 true로 평가되면 태그가 실행됩니다 (실행). 선택사항인 priority
속성을 사용하여 다른 태그보다 먼저 실행되는 태그를 조정합니다. dependencies
속성을 사용하여 이 태그가 실행되기 전에 실행 및 완료해야 하는 다른 태그를 지정합니다. Google 태그 관리자 태그에 설정할 수 있는 매개변수에 대한 자세한 내용은 태그 사전 참조를 참고하세요.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
Google 태그 관리자 태그를 나타냅니다.
{ "accountId": string, "containerId": string, "tagId": string, "name": string, "type": string, "firingRuleId": [ string ], "blockingRuleId": [ string ], "firingTriggerId": [ string ], "blockingTriggerId": [ string ], "liveOnly": boolean, "priority": { "type": string, "key": string, "value": string, "list": [ (Parameter) ], "map": [ (Parameter) ] }, "notes": string, "scheduleStartMs": long, "scheduleEndMs": long, "parameter": [ { "type": string, "key": string, "value": string, "list": [ (Parameter) ], "map": [ (Parameter) ] } ], "fingerprint": string, "setupTag": [ { "tagName": string, "stopOnSetupFailure": boolean } ], "teardownTag": [ { "tagName": string, "stopTeardownOnFailure": boolean } ], "parentFolderId": string, "tagFiringOption": string, "paused": boolean }
속성 이름 | 값 | 설명 | Notes |
---|---|---|---|
accountId |
string |
GTM 계정 ID입니다. | |
blockingRuleId[] |
list |
차단 규칙 ID를 클릭합니다. 나열된 규칙 중 하나라도 true로 판정되면 태그가 실행되지 않습니다. | 쓰기 가능 |
blockingTriggerId[] |
list |
차단 트리거 ID 목록에 있는 트리거 중 하나라도 true로 판정되면 태그가 실행되지 않습니다. | 쓰기 가능 |
containerId |
string |
GTM 컨테이너 ID입니다. | |
fingerprint |
string |
저장 시간에 계산된 GTM 태그의 지문입니다. 이 값은 태그가 수정될 때마다 다시 계산됩니다. | |
firingRuleId[] |
list |
규칙 ID를 실행하는 중입니다. 나열된 규칙 중 하나가 true이고 모든 blockingRuleIds (지정된 경우)이 false일 때 태그가 실행됩니다. |
쓰기 가능 |
firingTriggerId[] |
list |
트리거 ID를 실행하는 중입니다. 나열된 트리거 중 하나가 true이고 모든 blockingTriggerIds (지정된 경우)이 false일 때 태그가 실행됩니다. |
쓰기 가능 |
liveOnly |
boolean |
true로 설정하면 이 태그는 실제 환경에서만 실행됩니다 (예: 미리보기 또는 디버그 모드에서는 실행되지 않음). | 쓰기 가능 |
name |
string |
태그 표시 이름입니다. | 쓰기 가능 |
notes |
string |
컨테이너에서 이 태그를 적용하는 방법에 대한 사용자 메모 | 쓰기 가능 |
parameter[] |
list |
태그의 매개변수입니다. | 쓰기 가능 |
parameter[].key |
string |
매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. | 쓰기 가능 |
parameter[].list[] |
list |
이 목록 매개변수의 매개변수입니다 (키는 무시됨). | 쓰기 가능 |
parameter[].map[] |
list |
이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). | 쓰기 가능 |
parameter[].type |
string |
매개변수 유형. 유효한 값은 다음과 같습니다.
사용 가능한 값은 다음과 같습니다.
|
쓰기 가능 |
parameter[].value |
string |
지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) | 쓰기 가능 |
parentFolderId |
string |
상위 폴더 ID입니다. | |
paused |
boolean |
태그가 일시중지 상태인 경우 true입니다. | 쓰기 가능 |
priority |
nested object |
사용자가 정의한 태그의 숫자 우선순위입니다. 태그는 우선순위에 따라 비동기식으로 실행됩니다. 숫자 값이 더 큰 태그가 먼저 실행됩니다. 태그의 우선순위는 양수 또는 음수일 수 있습니다. 기본값은 0입니다. | 쓰기 가능 |
priority.key |
string |
매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. | 쓰기 가능 |
priority.list[] |
list |
이 목록 매개변수의 매개변수입니다 (키는 무시됨). | 쓰기 가능 |
priority.map[] |
list |
이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). | 쓰기 가능 |
priority.type |
string |
매개변수 유형. 유효한 값은 다음과 같습니다.
사용 가능한 값은 다음과 같습니다.
|
쓰기 가능 |
priority.value |
string |
지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) | 쓰기 가능 |
scheduleEndMs |
long |
태그를 예약할 종료 타임스탬프(밀리초)입니다. | 쓰기 가능 |
scheduleStartMs |
long |
태그를 예약할 시작 타임스탬프(밀리초)입니다. | 쓰기 가능 |
setupTag[] |
list |
설정 태그 목록입니다. 현재는 하나만 허용됩니다. | |
setupTag[].stopOnSetupFailure |
boolean |
true인 경우 설정 태그가 성공적으로 실행된 경우에만 기본 태그를 실행합니다. false인 경우 설정 태그 실행 상태에 관계없이 기본 태그를 실행합니다. | |
setupTag[].tagName |
string |
설정 태그의 이름입니다. | |
tagFiringOption |
string |
이 태그를 실행할 옵션입니다.
사용 가능한 값은 다음과 같습니다.
|
|
tagId |
string |
태그 ID로 GTM 태그를 고유하게 식별할 수 있습니다. | |
teardownTag[] |
list |
해제 태그 목록입니다. 현재는 하나만 허용됩니다. | |
teardownTag[].stopTeardownOnFailure |
boolean |
true인 경우 기본 태그가 성공적으로 실행된 경우에만 해제 태그를 실행합니다. false인 경우 기본 태그 실행 상태에 관계없이 해제 태그를 실행합니다. | |
teardownTag[].tagName |
string |
해제 태그의 이름입니다. | |
type |
string |
GTM 태그 유형입니다. | 쓰기 가능 |
방법
아래의 메서드를 사용하여 태그를 생성, 수정, 삭제 또는 가져오세요.