Các thẻ được liên kết với vùng chứa. Thẻ thường được liên kết với một hoặc nhiều quy tắc kích hoạt (xem firingRuleId bên dưới) và theo tùy chọn, với một hoặc nhiều quy tắc chặn (xem blockingRuleId bên dưới). Khi ít nhất một quy tắc kích hoạt đánh giá là true (đúng) và quy tắc chặn chính xác bằng 0 được đánh giá là true (đúng), thẻ sẽ kích hoạt (thực thi). Sử dụng thuộc tính priority (không bắt buộc) để điều chỉnh những thẻ sẽ kích hoạt trước các thẻ khác. Sử dụng thuộc tính dependencies để chỉ định những thẻ khác phải kích hoạt và hoàn tất trước khi thẻ này kích hoạt. Để biết thông tin chi tiết về các thông số có thể đặt cho thẻ Trình quản lý thẻ của Google, hãy xem bài viết Tham khảo từ điển thẻ.
Để xem danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang này.
Biểu diễn tài nguyên
Đại diện cho Thẻ Trình quản lý thẻ của 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
}
| Tên tài sản | Giá trị | Nội dung mô tả | Ghi chú |
|---|---|---|---|
accountId |
string |
Mã tài khoản GTM. | |
blockingRuleId[] |
list |
Mã quy tắc chặn. Nếu bất kỳ quy tắc nào được liệt kê đánh giá là đúng, thẻ sẽ không kích hoạt. | có thể ghi |
blockingTriggerId[] |
list |
Chặn mã điều kiện kích hoạt. Nếu bất kỳ điều kiện kích hoạt nào được liệt kê có giá trị là true, thì thẻ này sẽ không kích hoạt. | có thể ghi |
containerId |
string |
Mã vùng chứa Trình quản lý thẻ của Google (GTM). | |
fingerprint |
string |
Vân tay số của Thẻ GTM như được tính toán tại thời gian lưu trữ. Giá trị này được tính toán lại bất cứ khi nào thẻ được sửa đổi. | |
firingRuleId[] |
list |
Mã quy tắc kích hoạt. Thẻ sẽ kích hoạt khi bất kỳ quy tắc nào được liệt kê là true và tất cả blockingRuleIds của thẻ đó (nếu có được chỉ định) là false. |
có thể ghi |
firingTriggerId[] |
list |
Mã điều kiện kích hoạt kích hoạt. Thẻ sẽ kích hoạt khi bất kỳ điều kiện kích hoạt nào được liệt kê là đúng và tất cả blockingTriggerIds của thẻ đó (nếu có bất kỳ được chỉ định) nào là sai. |
có thể ghi |
liveOnly |
boolean |
Nếu bạn đặt chính sách này thành true, thì thẻ này sẽ chỉ kích hoạt trong môi trường trực tiếp (ví dụ: không ở chế độ xem trước hoặc gỡ lỗi). | có thể ghi |
name |
string |
Tên hiển thị của thẻ. | có thể ghi |
notes |
string |
Ghi chú của người dùng về cách áp dụng thẻ này trong vùng chứa. | có thể ghi |
parameter[] |
list |
Thông số của thẻ. | có thể ghi |
parameter[].key |
string |
Khoá được đặt tên xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với giá trị danh sách. | có thể ghi |
parameter[].list[] |
list |
Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). | có thể ghi |
parameter[].map[] |
list |
Tham số của thông số bản đồ này (phải có khoá; các khoá phải là duy nhất). | có thể ghi |
parameter[].type |
string |
Loại tham số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
có thể ghi |
parameter[].value |
string |
Giá trị của thông số (có thể chứa các tham chiếu biến như "") phù hợp với loại được chỉ định. | có thể ghi |
parentFolderId |
string |
Mã thư mục mẹ. | |
paused |
boolean |
Đúng nếu thẻ bị tạm dừng. | có thể ghi |
priority |
nested object |
Mức độ ưu tiên dạng số của thẻ do người dùng xác định. Thẻ được kích hoạt không đồng bộ theo thứ tự ưu tiên. Thẻ có giá trị số cao hơn sẽ kích hoạt trước. Mức độ ưu tiên của thẻ có thể là giá trị dương hoặc âm. Giá trị mặc định là "0". | có thể ghi |
priority.key |
string |
Khoá được đặt tên xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với giá trị danh sách. | có thể ghi |
priority.list[] |
list |
Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). | có thể ghi |
priority.map[] |
list |
Tham số của thông số bản đồ này (phải có khoá; các khoá phải là duy nhất). | có thể ghi |
priority.type |
string |
Loại tham số. Các giá trị hợp lệ là:
Các giá trị được chấp nhận là:
|
có thể ghi |
priority.value |
string |
Giá trị của thông số (có thể chứa các tham chiếu biến như "") phù hợp với loại được chỉ định. | có thể ghi |
scheduleEndMs |
long |
Dấu thời gian kết thúc tính bằng mili giây để lên lịch cho một thẻ. | có thể ghi |
scheduleStartMs |
long |
Dấu thời gian bắt đầu tính bằng mili giây để lên lịch cho một thẻ. | có thể ghi |
setupTag[] |
list |
Danh sách thẻ thiết lập. Hiện tại, chúng tôi chỉ cho phép một chiến dịch. | |
setupTag[].stopOnSetupFailure |
boolean |
Nếu đúng, hãy kích hoạt thẻ chính khi và chỉ khi thẻ thiết lập kích hoạt thành công. Nếu giá trị là false, hãy kích hoạt thẻ chính bất kể trạng thái kích hoạt thẻ thiết lập. | |
setupTag[].tagName |
string |
Tên của thẻ thiết lập. | |
tagFiringOption |
string |
Tuỳ chọn để kích hoạt thẻ này.
Các giá trị có thể chấp nhận là:
|
|
tagId |
string |
Mã thẻ xác định duy nhất Thẻ GTM. | |
teardownTag[] |
list |
Danh sách thẻ phân tách. Hiện tại, chúng tôi chỉ cho phép một chiến dịch. | |
teardownTag[].stopTeardownOnFailure |
boolean |
Nếu đúng, hãy kích hoạt thẻ phân tích khi và chỉ khi thẻ chính kích hoạt thành công. Nếu giá trị là false, hãy kích hoạt thẻ phân tách bất kể trạng thái kích hoạt thẻ chính. | |
teardownTag[].tagName |
string |
Tên của thẻ phân tách. | |
type |
string |
Loại thẻ GTM. | có thể ghi |
Phương thức
Hãy sử dụng các phương thức dưới đây để tạo, sửa đổi, xoá hoặc truy xuất thẻ.