REST Resource: accounts.containers.workspaces.triggers

Tài nguyên: Điều kiện kích hoạt

Biểu thị một Trình kích hoạt 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,
  "triggerId": string,
  "name": string,
  "type": enum (EventType),
  "customEventFilter": [
    {
      object (Condition)
    }
  ],
  "filter": [
    {
      object (Condition)
    }
  ],
  "autoEventFilter": [
    {
      object (Condition)
    }
  ],
  "waitForTags": {
    object (Parameter)
  },
  "checkValidation": {
    object (Parameter)
  },
  "waitForTagsTimeout": {
    object (Parameter)
  },
  "uniqueTriggerId": {
    object (Parameter)
  },
  "eventName": {
    object (Parameter)
  },
  "interval": {
    object (Parameter)
  },
  "limit": {
    object (Parameter)
  },
  "fingerprint": string,
  "parentFolderId": string,
  "selector": {
    object (Parameter)
  },
  "intervalSeconds": {
    object (Parameter)
  },
  "maxTimerLengthSeconds": {
    object (Parameter)
  },
  "verticalScrollPercentageList": {
    object (Parameter)
  },
  "horizontalScrollPercentageList": {
    object (Parameter)
  },
  "visibilitySelector": {
    object (Parameter)
  },
  "visiblePercentageMin": {
    object (Parameter)
  },
  "visiblePercentageMax": {
    object (Parameter)
  },
  "continuousTimeMinMilliseconds": {
    object (Parameter)
  },
  "totalTimeMinMilliseconds": {
    object (Parameter)
  },
  "tagManagerUrl": string,
  "notes": string,
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
Trường
path

string

Đường dẫn tương đối của API của Trình kích hoạt 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.

triggerId

string

Mã điều kiện kích hoạt giúp nhận dạng riêng biệt Điều kiện kích hoạt GTM.

name

string

Tên hiển thị của điều kiện kích hoạt.

type

enum (EventType)

Xác định sự kiện lớp dữ liệu gây ra điều kiện kích hoạt này.

customEventFilter[]

object (Condition)

Được dùng trong trường hợp sự kiện tuỳ chỉnh, được kích hoạt nếu tất cả các Điều kiện đều đúng.

filter[]

object (Condition)

Điều kiện kích hoạt sẽ chỉ kích hoạt nếu tất cả các Điều kiện đều đúng.

autoEventFilter[]

object (Condition)

Dùng trong trường hợp theo dõi sự kiện tự động.

waitForTags

object (Parameter)

Chúng ta có nên trì hoãn việc gửi biểu mẫu hoặc mở đường liên kết cho đến khi tất cả thẻ đã kích hoạt hay không (bằng cách ngăn hành động mặc định và sau đó mô phỏng hành động mặc định). Chỉ áp dụng cho các trình kích hoạt Gửi biểu mẫu và Lượt nhấp vào đường liên kết.

checkValidation

object (Parameter)

Chúng ta có nên chỉ kích hoạt thẻ nếu sự kiện gửi biểu mẫu hoặc nhấp vào đường liên kết không bị một số trình xử lý sự kiện khác huỷ (ví dụ: do xác thực) hay không. Chỉ áp dụng cho các trình kích hoạt Gửi biểu mẫu và Lượt nhấp vào đường liên kết.

waitForTagsTimeout

object (Parameter)

Thời gian chờ (tính bằng mili giây) để các thẻ kích hoạt khi "waits_for_tags" ở trên đánh giá là

true

. Chỉ hợp lệ đối với các điều kiện kích hoạt Gửi biểu mẫu và Lượt nhấp vào đường liên kết.

uniqueTriggerId

object (Parameter)

Mã nhận dạng duy nhất trên toàn cầu của trình kích hoạt tự động tạo sự kiện này (trình nghe Gửi biểu mẫu, Nhấp vào đường liên kết hoặc Hẹn giờ) nếu có. Dùng để giúp các sự kiện tự động không tương thích hoạt động cùng với tính năng lọc điều kiện kích hoạt dựa trên mã điều kiện kích hoạt. Giá trị này được điền trong quá trình tạo đầu ra vì các thẻ ngụ ý của trình kích hoạt sẽ không tồn tại cho đến thời điểm đó. Chỉ áp dụng cho các trình kích hoạt Gửi biểu mẫu, Lượt nhấp vào đường liên kết và Hẹn giờ.

eventName

object (Parameter)

Tên của sự kiện GTM được kích hoạt. Chỉ hợp lệ cho điều kiện kích hoạt Timer (Hẹn giờ).

interval

object (Parameter)

Khoảng thời gian giữa các lần kích hoạt Sự kiện hẹn giờ định kỳ (tính bằng mili giây). Chỉ hợp lệ cho điều kiện kích hoạt Timer (Hẹn giờ).

limit

object (Parameter)

Giới hạn số lượng sự kiện GTM mà điều kiện kích hoạt Bộ hẹn giờ này sẽ kích hoạt. Nếu không đặt giới hạn, chúng tôi sẽ tiếp tục kích hoạt các sự kiện GTM cho đến khi người dùng rời khỏi trang. Chỉ hợp lệ cho điều kiện kích hoạt Timer (Hẹn giờ).

fingerprint

string

Vân tay của Trình kích hoạt 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 điều kiện kích hoạt được sửa đổi.

parentFolderId

string

Mã thư mục mẹ.

selector

object (Parameter)

Bộ chọn CSS của trình kích hoạt lượt nhấp (tức là "a", "button", v.v.). Chỉ áp dụng cho điều kiện kích hoạt Lượt nhấp AMP.

intervalSeconds

object (Parameter)

Khoảng thời gian giữa các lần kích hoạt Sự kiện hẹn giờ (tính bằng giây). Chỉ hợp lệ cho điều kiện kích hoạt Bộ hẹn giờ AMP.

maxTimerLengthSeconds

object (Parameter)

Thời gian tối đa để kích hoạt Sự kiện hẹn giờ (tính bằng giây). Chỉ hợp lệ cho điều kiện kích hoạt Bộ hẹn giờ AMP.

verticalScrollPercentageList

object (Parameter)

Danh sách các giá trị tỷ lệ phần trăm số nguyên cho trình kích hoạt cuộn. Trình kích hoạt sẽ kích hoạt khi đạt đến từng tỷ lệ phần trăm khi thành phần hiển thị được cuộn theo chiều dọc. Chỉ hợp lệ cho trình kích hoạt cuộn AMP.

horizontalScrollPercentageList

object (Parameter)

Danh sách các giá trị tỷ lệ phần trăm số nguyên cho trình kích hoạt cuộn. Trình kích hoạt sẽ kích hoạt khi đạt đến mỗi tỷ lệ phần trăm khi cuộn thành phần hiển thị theo chiều ngang. Chỉ hợp lệ cho trình kích hoạt cuộn AMP.

visibilitySelector

object (Parameter)

Bộ chọn CSS của trình kích hoạt chế độ hiển thị (tức là "#id"). Chỉ hợp lệ cho điều kiện kích hoạt Chế độ hiển thị AMP.

visiblePercentageMin

object (Parameter)

Phần trăm hiển thị tối thiểu của điều kiện kích hoạt chế độ hiển thị. Chỉ hợp lệ cho điều kiện kích hoạt Chế độ hiển thị AMP.

visiblePercentageMax

object (Parameter)

Trình kích hoạt chế độ hiển thị có tỷ lệ phần trăm hiển thị tối đa. Chỉ hợp lệ cho điều kiện kích hoạt Chế độ hiển thị AMP.

continuousTimeMinMilliseconds

object (Parameter)

Thời gian hiển thị liên tục tối thiểu của điều kiện kích hoạt chế độ hiển thị (tính bằng mili giây). Chỉ hợp lệ cho điều kiện kích hoạt Chế độ hiển thị AMP.

totalTimeMinMilliseconds

object (Parameter)

Tổng thời gian hiển thị tối thiểu của điều kiện kích hoạt chế độ hiển thị (tính bằng mili giây). Chỉ hợp lệ cho điều kiện kích hoạt Chế độ hiển thị AMP.

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ẻ

notes

string

Ghi chú của người dùng về cách áp dụng điều kiện kích hoạt này trong vùng chứa.

parameter[]

object (Parameter)

Các tham số bổ sung.

EventType

Enum
eventTypeUnspecified
pageview
domReady
windowLoaded
customEvent
triggerGroup
init
consentInit
serverPageview
always
firebaseAppException
firebaseAppUpdate
firebaseCampaign
firebaseFirstOpen
firebaseInAppPurchase
firebaseNotificationDismiss
firebaseNotificationForeground
firebaseNotificationOpen
firebaseNotificationReceive
firebaseOsUpdate
firebaseSessionStart
firebaseUserEngagement
formSubmission
click
linkClick
jsError
historyChange
timer
ampClick
ampTimer
ampScroll
ampVisibility
youTubeVideo
scrollDepth
elementVisibility

Phương thức

create

Tạo điều kiện kích hoạt GTM.

delete

Xoá điều kiện kích hoạt trong Trình quản lý thẻ của Google.

get

Lấy một Trình kích hoạt GTM.

list

Liệt kê tất cả các Trình kích hoạt GTM của một Vùng chứa.

revert

Huỷ bỏ các thay đổi đối với một Điều kiện kích hoạt trong Google Workspace.

update

Cập nhật điều kiện kích hoạt GTM.