Tags

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Đại diện cho một Thẻ Trình quản lý thẻ của 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
    }
  }
}
Tên tài sản Giá trị 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à true, thì 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ỳ trình kích hoạt nào được liệt kê đánh giá là true, thì thẻ sẽ không kích hoạt. có thể ghi
consentSettings nested object Chế độ cài đặt lấy sự đồng ý của một thẻ. có thể ghi
consentSettings.consentStatus string Trạng thái đồng ý của thẻ. Nếu bạn đặt thành CẦN, thì môi trường thời gian chạy sẽ kiểm tra để đảm bảo bạn đã cấp các loại đồng ý mà trường consent_type chỉ định.

Các giá trị được chấp nhận là:
  • "needed"
  • "notNeeded"
  • "notSet"
consentSettings.consentType nested object Loại đồng ý cần kiểm tra trong quá trình kích hoạt thẻ nếu ở trạng thái CẦN phải có sự đồng ý. Tham số này phải thuộc loại LIST, trong đó mỗi mục trong danh sách phải thuộc loại STRING.
consentSettings.consentType.isWeakReference boolean Liệu tham số loại tham chiếu được tham chiếu mạnh hay yếu. Chỉ có Quy tắc chuyển đổi sử dụng. có thể ghi
consentSettings.consentType.key string Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các giá trị danh sách. có thể ghi
consentSettings.consentType.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
consentSettings.consentType.map[] list Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). có thể ghi
consentSettings.consentType.type string Loại thông 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ị đại diện cho giá trị số nguyên 64 bit đã ký, trong cơ số 10
  • list: Bạn cần chỉ định danh sách các tham số
  • map: Cần chỉ định sơ đồ liên kết các tham số
  • template: Giá trị đại diện cho văn bản bất kỳ; điều này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho thẻ, được biểu thị dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
có thể ghi
consentSettings.consentType.value string Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. có thể ghi
containerId string Mã vùng chứa Trình quản lý thẻ của Google (GTM).
fingerprint string Tệp tham chiếu của Thẻ GTM như được tính tại thời điểm lưu trữ. Giá trị này được tính toán lại mỗi khi 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ó) là false. có thể ghi
firingTriggerId[] list Mã 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à true và tất cả blockingTriggerIds của thẻ đó (nếu có) là false. có thể ghi
liveOnly boolean Nếu bạn đặt thành true, thẻ này sẽ chỉ kích hoạt trong môi trường hoạt động (ví dụ: không ở chế độ xem trước hoặc gỡ lỗi). có thể ghi
monitoringMetadata nested object Liên kết các cặp khoá-giá trị của siêu dữ liệu thẻ sẽ được đưa vào dữ liệu sự kiện để theo dõi thẻ. Lưu ý:
  • Tham số này phải thuộc loại MAP.
  • Mỗi tham số trong tệp ánh xạ đều thuộc loại TEMPLATE, tuy nhiên không được chứa các biến tham chiếu.
có thể ghi
monitoringMetadata.isWeakReference boolean Liệu tham số loại tham chiếu được tham chiếu mạnh hay yếu. Chỉ có Quy tắc chuyển đổi sử dụng. có thể ghi
monitoringMetadata.key string Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các giá trị danh sách. có thể ghi
monitoringMetadata.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
monitoringMetadata.map[] list Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). có thể ghi
monitoringMetadata.type string Loại thông 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ị đại diện cho giá trị số nguyên 64 bit đã ký, trong cơ số 10
  • list: Bạn cần chỉ định danh sách các tham số
  • map: Cần chỉ định sơ đồ liên kết các tham số
  • template: Giá trị đại diện cho văn bản bất kỳ; điều này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho thẻ, được biểu thị dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
có thể ghi
monitoringMetadata.value string Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. có thể ghi
monitoringMetadataTagNameKey string Nếu không để trống thì tên hiển thị thẻ sẽ được đưa vào bản đồ siêu dữ liệu giám sát bằng cách sử dụng khoá đã chỉ định. 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[].isWeakReference boolean Liệu tham số loại tham chiếu được tham chiếu mạnh hay yếu. Chỉ có Quy tắc chuyển đổi sử dụng. có thể ghi
parameter[].key string Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các 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 Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). có thể ghi
parameter[].type string Loại thông 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ị đại diện cho giá trị số nguyên 64 bit đã ký, trong cơ số 10
  • list: Bạn cần chỉ định danh sách các tham số
  • map: Cần chỉ định sơ đồ liên kết các tham số
  • template: Giá trị đại diện cho văn bản bất kỳ; điều này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho thẻ, được biểu thị dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
có thể ghi
parameter[].value string Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã chỉ định. có thể ghi
parentFolderId string Mã thư mục mẹ.
path string Đường dẫn tương đối của API của Thẻ GTM.
paused boolean Cho biết liệu thẻ có bị tạm dừng hay không, ngăn thẻ kích hoạt. 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. Những 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.isWeakReference boolean Liệu tham số loại tham chiếu được tham chiếu mạnh hay yếu. Chỉ có Quy tắc chuyển đổi sử dụng. có thể ghi
priority.key string Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các 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 Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). có thể ghi
priority.type string Loại thông 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ị đại diện cho giá trị số nguyên 64 bit đã ký, trong cơ số 10
  • list: Bạn cần chỉ định danh sách các tham số
  • map: Cần chỉ định sơ đồ liên kết các tham số
  • template: Giá trị đại diện cho văn bản bất kỳ; điều này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt
  • tag_reference: Giá trị đại diện cho thẻ, được biểu thị dưới dạng tên thẻ


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
có thể ghi
priority.value string Giá trị của thông số (có thể chứa các biến tham chiếu như "") phù hợp với loại đã 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.
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 của thẻ thiết lập.
setupTag[].tagName string Tên của thẻ thiết lập.
tagFiringOption string Tùy chọn để kích hoạt thẻ này.

Các giá trị được chấp nhận là:
  • "oncePerEvent"
  • "oncePerLoad"
  • "tagFiringOptionUnspecified"
  • "unlimited"
tagId string Mã thẻ xác định duy nhất Thẻ GTM.
tagManagerUrl string Đường liên kết được tạo tự động đến giao diện người dùng của trình quản lý thẻ
teardownTag[] list Danh sách thẻ phân tách. Hiện tại, chúng tôi chỉ cho phép một.
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 sai, 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
workspaceId string Mã không gian làm việc của Trình quản lý thẻ của Google (GTM).

Phương thức

tạo
Tạo thẻ GTM.
xóa
Xoá thẻ GTM.
nhận
Nhận thẻ GTM.
list
Liệt kê tất cả thẻ GTM của một vùng chứa.
huỷ bỏ
Huỷ bỏ nội dung thay đổi đối với Thẻ GTM trong Không gian làm việc của GTM.
cập nhật
Cập nhật thẻ GTM.