REST Resource: accounts.containers.workspaces.tags

Tài nguyên: Thẻ

Biểu thị một Thẻ Trình quản lý thẻ của Google.

Biểu diễn dưới dạng JSON
{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "liveOnly": boolean,
  "priority": {
    object (Parameter)
  },
  "notes": string,
  "scheduleStartMs": string,
  "scheduleEndMs": string,
  "parameter": [
    {
      object (Parameter)
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      object (SetupTag)
    }
  ],
  "teardownTag": [
    {
      object (TeardownTag)
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": enum (TagFiringOption),
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    object (Parameter)
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    object (ConsentSetting)
  }
}
Trường
path

string

Đường dẫn tương đối của API của Thẻ GTM.

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).

workspaceId

string

Mã Workspace của GTM.

tagId

string

Mã thẻ giúp nhận dạng duy nhất Thẻ GTM.

name

string

Tên hiển thị của thẻ.

type

string

Loại thẻ Trình quản lý thẻ của Google.

liveOnly

boolean

Nếu được đặt thành true, 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).

priority

object (Parameter)

Mức độ ưu tiên dạng số do người dùng xác định của thẻ. Các 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".

notes

string

Ghi chú của người dùng về cách áp dụng thẻ này trong vùng chứa.

scheduleStartMs

string (int64 format)

Dấu thời gian bắt đầu tính bằng mili giây để lên lịch gắn thẻ.

scheduleEndMs

string (int64 format)

Dấu thời gian kết thúc tính bằng mili giây để lên lịch gắn thẻ.

parameter[]

object (Parameter)

Các thông số của thẻ.

fingerprint

string

Vân tay của Thẻ 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 mỗi khi thẻ được sửa đổi.

firingTriggerId[]

string

Mã của điều kiện kích hoạt đang kích hoạt. Thẻ sẽ kích hoạt khi bất kỳ điều kiện kích hoạt nào trong danh sách đều đúng và tất cả các

blockingTriggerIds

(nếu có) là sai.

blockingTriggerId[]

string

Mã của trình kích hoạt chặn. Nếu bất kỳ điều kiện kích hoạt nào trong danh sách được đánh giá là đúng, thì thẻ sẽ không kích hoạt.

setupTag[]

object (SetupTag)

Danh sách thẻ thiết lập. Hiện tại, chúng tôi chỉ cho phép một.

teardownTag[]

object (TeardownTag)

Danh sách thẻ teardown. Hiện tại, chúng tôi chỉ cho phép một.

parentFolderId

string

Mã thư mục mẹ.

tagFiringOption

enum (TagFiringOption)

Tuỳ chọn kích hoạt thẻ này.

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ẻ

paused

boolean

Cho biết liệu thẻ có bị tạm dừng hay không, điều này sẽ ngăn thẻ kích hoạt.

monitoringMetadata

object (Parameter)

Bản đồ 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 là loại

    MAP

    .

  • Mỗi tham số trong bản đồ đều thuộc loại

    TEMPLATE

    , tuy nhiên không được chứa tham chiếu biến.

monitoringMetadataTagNameKey

string

Nếu không trống, tên hiển thị của thẻ sẽ được đưa vào bản đồ siêu dữ liệu giám sát bằng khoá đã chỉ định.

consentSettings

object (ConsentSetting)

Chế độ cài đặt về sự đồng ý của một thẻ.

SetupTag

Biểu thị một tệp đối chiếu đến một thẻ kích hoạt trước một thẻ khác để thiết lập các phần phụ thuộc.

Biểu diễn dưới dạng JSON
{
  "tagName": string,
  "stopOnSetupFailure": boolean
}
Trường
tagName

string

Tên của thẻ thiết lập.

stopOnSetupFailure

boolean

Nếu là true, hãy kích hoạt thẻ chính nếu 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.

TeardownTag

Biểu thị một thẻ kích hoạt sau một thẻ khác để loại bỏ các phần phụ thuộc.

Biểu diễn dưới dạng JSON
{
  "tagName": string,
  "stopTeardownOnFailure": boolean
}
Trường
tagName

string

Tên của thẻ teardown.

stopTeardownOnFailure

boolean

Nếu là true, hãy kích hoạt thẻ teardown (hủy bỏ) nếu 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ẻ gỡ bỏ bất kể trạng thái kích hoạt thẻ chính là gì.

TagFiringOption

Enum
tagFiringOptionUnspecified
unlimited Thẻ có thể được kích hoạt nhiều lần cho mỗi sự kiện.
oncePerEvent Thẻ chỉ có thể được kích hoạt cho mỗi sự kiện nhưng có thể được kích hoạt nhiều lần cho mỗi lượt tải (ví dụ: tải ứng dụng hoặc tải trang).
oncePerLoad Thẻ chỉ có thể được kích hoạt cho mỗi lượt tải (ví dụ: tải ứng dụng hoặc tải trang).

ConsentSetting

Biểu diễn dưới dạng JSON
{
  "consentStatus": enum (ManualConsentOption),
  "consentType": {
    object (Parameter)
  }
}
Trường
consentStatus

enum (ManualConsentOption)

Trạng thái đồng ý của thẻ. Nếu bạn đặt thành NEEDED, thời gian chạy sẽ kiểm tra để đảm bảo rằng các loại sự đồng ý do

consentType

đã được cấp.

consentType

object (Parameter)

Loại sự đồng ý cần kiểm tra trong quá trình kích hoạt thẻ nếu ở trạng thái CẦN CÓ sự đồng ý. Tham số này phải thuộc loại

LIST

trong đó mỗi mục trong danh sách thuộc loại

STRING

.

ManualConsentOption

Enum
notSet Giá trị mặc định mà người dùng chưa chỉ định bất kỳ chế độ cài đặt nào.
notNeeded Thẻ không yêu cầu chế độ cài đặt sự đồng ý bổ sung.
needed Thẻ này yêu cầu chế độ cài đặt bổ sung về sự đồng ý.

Phương thức

create

Tạo Thẻ GTM.

delete

Xoá một Thẻ GTM.

get

Lấy thẻ GTM.

list

Liệt kê tất cả Thẻ GTM của một Vùng chứa.

revert

Huỷ bỏ các thay đổi đối với Thẻ GTM trong một Không gian làm việc của GTM.

update

Cập nhật thẻ GTM.