Macros

Các macro của vùng chứa. Macro đại diện cho các giá trị được đánh giá trong thời gian chạy. Bạn có thể tham chiếu macro khi định cấu hình quy tắc và thẻ. Để biết chi tiết các thuộc tính có thể được đặt cho macro Trình quản lý thẻ của Google, hãy xem Tham khảo từ điển macro. Để biết thông tin về cách người dùng thiết lập và sử dụng macro, hãy xem phần Macro trong Trung tâm trợ giúp Trình quản lý thẻ của Google.

Để 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 macro Trình quản lý thẻ của Google.

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
accountId string Mã tài khoản GTM.
containerId string Mã vùng chứa Trình quản lý thẻ của Google (GTM).
disablingRuleId[] list Chỉ đối với vùng chứa trên thiết bị di động: Danh sách ID quy tắc để tắt macro có điều kiện; macro được bật nếu một trong các quy tắc bật là đúng trong khi tất cả các quy tắc vô hiệu hóa là sai. Được coi là một tập hợp không theo thứ tự. có thể ghi
enablingRuleId[] list Chỉ dành cho vùng chứa di động: Danh sách ID quy tắc để bật macro có điều kiện; macro được bật nếu một trong các quy tắc bật là đúng trong khi tất cả các quy tắc vô hiệu hóa là sai. Được coi là một tập hợp không theo thứ tự. có thể ghi
fingerprint string Vân tay số của Macro GTM đượ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 macro được sửa đổi.
macroId string ID Macro xác định duy nhất Macro GTM.
name string Tên hiển thị macro. có thể ghi
notes string Ghi chú của người dùng về cách áp dụng macro này trong vùng chứa. có thể ghi
parameter[] list Tham số của macro. 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à:
  • 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
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
parentFolderId string Mã thư mục mẹ.
scheduleEndMs long Dấu thời gian kết thúc tính bằng mili giây để lên lịch macro. có thể ghi
scheduleStartMs long Dấu thời gian bắt đầu tính bằng mili giây để lên lịch macro. có thể ghi
type string Loại macro của Trình quản lý thẻ của Google (GTM). có thể ghi

Phương thức

Hãy sử dụng các phương thức bên dưới để tạo, sửa đổi, xóa hoặc truy xuất macro.

tạo
Tạo macro GTM.
xóa
Xoá macro của Trình quản lý thẻ của Google (GTM).
nhận
Lấy macro GTM.
list
Liệt kê tất cả các macro GTM của một vùng chứa.
cập nhật
Cập nhật macro GTM.