Rules

Các quy tắc của vùng chứa. Các quy tắc sẽ đánh giá là true (đúng) hoặc false (sai) trong thời gian chạy. Bạn có thể sử dụng các công cụ này để kiểm soát thời điểm thẻ kích hoạt hoặc bị chặn kích hoạt, cũng như để kiểm soát thời điểm bật hoặc tắt macro trong vùng chứa trên thiết bị di động. Để biết thêm chi tiết, hãy xem quy tắc kích hoạt và vô hiệu hóa của cấu hình thẻ và quy tắc bật và tắt cấu hình macro, tương ứng.

Để 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 quy tắc Trình quản lý thẻ của 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
}

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
accountId	string	Mã tài khoản GTM.
condition[]	list	Danh sách các điều kiện tạo nên quy tắc này (ngầm ẩn AND giữa các điều kiện).	có thể ghi
condition[].parameter[]	list	Danh sách thông số được đặt tên (khoá/giá trị), tuỳ thuộc vào loại điều kiện. Lưu ý: Đối với toán tử nhị phân, hãy thêm các tham số có tên arg0 và arg1 để chỉ định toán hạng trái và phải tương ứng. Vào thời điểm này, toán hạng bên trái (arg0) phải là tham chiếu đến macro. Để khớp Regex không phân biệt chữ hoa chữ thường, hãy bao gồm một tham số boolean có tên ignore_case và được đặt thành true. Nếu không được chỉ định hoặc đặt thành bất kỳ giá trị nào khác, thì kết quả khớp sẽ phân biệt chữ hoa chữ thường. Để phủ định một toán tử, hãy thêm tham số Boolean có tên negate rồi đặt tham số đó thành true.	có thể ghi
condition[].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
condition[].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
condition[].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
condition[].parameter[].type	string	Loại tham số. Các giá trị hợp lệ là: boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false" integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10 list: Danh sách các thông số phải được chỉ định map: Bản đồ các tham số phải được chỉ định template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm tài liệu tham khảo macro (thậm chí tham chiếu macro có thể trả về các loại không phải chuỗi) Các giá trị được chấp nhận là: "boolean" "integer" "list" "map" "template"	có thể ghi
condition[].parameter[].value	string	Giá trị của thông số (có thể chứa tài liệu tham khảo macro như "") nếu phù hợp với loại được chỉ định.	có thể ghi
condition[].type	string	Loại toán tử cho điều kiện này. Các giá trị có thể chấp nhận là: "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	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 Quy tắc GTM như được tính toán tại thời điểm lưu trữ. Giá trị này được tính toán lại bất cứ khi nào quy tắc được sửa đổi.
name	string	Tên hiển thị của quy tắc.	có thể ghi
notes	string	Ghi chú của người dùng về cách áp dụng quy tắc này trong vùng chứa.	có thể ghi
ruleId	string	Mã quy tắc xác định duy nhất Quy tắc GTM.

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 quy tắc.

tạo

Tạo quy tắc GTM.

xóa

Xoá quy tắc GTM.

nhận

Lấy quy tắc GTM.

list

Liệt kê tất cả các quy tắc Trình quản lý thẻ của Google (GTM) của một vùng chứa.

cập nhật

Cập nhật quy tắc Trình quản lý thẻ của Google (GTM).