REST Resource: accounts.containers.workspaces.triggers

משאב: טריגר

מייצג טריגר של Google Tag Manager

ייצוג ב-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)
    }
  ]
}
שדות
path

string

הנתיב היחסי של ה-API של הטריגר ב-GTM.

accountId

string

מזהה חשבון GTM.

containerId

string

מזהה מאגר התגים של GTM.

workspaceId

string

מזהה סביבת העבודה ב-GTM.

triggerId

string

מזהה הטריגר מזהה באופן ייחודי את הטריגר ב-GTM.

name

string

השם המוצג של הטריגר.

type

enum (EventType)

מגדיר את האירוע בשכבת הנתונים שגורם לטריגר הזה.

customEventFilter[]

object (Condition)

משמש במקרה של אירוע מותאם אישית, שמופעל רק אם כל התנאים מתקיימים.

filter[]

object (Condition)

הטריגר יופעל רק אם כל התנאים יהיו נכונים.

autoEventFilter[]

object (Condition)

משמש במקרה של מעקב אוטומטי אחרי אירועים.

waitForTags

object (Parameter)

אם כדאי לדחות את שליחת הטפסים או פתיחת הקישורים עד שכל התגים יופעלו (על ידי מניעת פעולת ברירת המחדל ובהמשך סימולציה של פעולת ברירת המחדל). ההגדרה הזו תקפה רק לטריגרים מסוג שליחת טופס ולחיצה על קישור.

checkValidation

object (Parameter)

האם להפעיל תגים רק אם אירוע שליחת הטופס או אירוע הלחיצה על הקישור לא בוטל על ידי גורם אחר לטיפול באירועים (למשל, בגלל אימות). ההגדרה הזו תקפה רק לטריגרים מסוג שליחת טופס ולחיצה על קישור.

waitForTagsTimeout

object (Parameter)

משך הזמן (באלפיות שנייה) להמתנה להפעלת התגים כאשר הערך של 'waits_for_tags' למעלה הוא

true

. תקף רק לטריגרים מסוג 'שליחת טופס' ו'לחיצה על קישור'.

uniqueTriggerId

object (Parameter)

מזהה ייחודי גלובלי של הטריגר שיוצר את האירוע הזה באופן אוטומטי (מאזין של שליחת טופס, של לחיצה על קישור או של טיימר), אם קיים. משמש כדי לאפשר לאירועים אוטומטיים לא תואמים לפעול יחד עם סינון טריגרים על סמך מזהי טריגרים. הערך הזה מאוכלס במהלך יצירת הפלט, כי התגים שהטריגרים מניחים לא קיימים עד אז. התכונה הזו תקפה רק לטריגרים מסוג שליחת טופס, לחיצה על קישור וטימר.

eventName

object (Parameter)

השם של האירוע ב-GTM שמופעל. תקף רק לטריגרים של טיימר.

interval

object (Parameter)

הזמן שחולף בין הפעלות חוזרות של אירועי טיימר (באלפיות השנייה). תקף רק לטריגרים של טיימר.

limit

object (Parameter)

הגבלת מספר האירועים ב-GTM שתופעל על ידי הטריגר הזה. אם לא תגדירו מגבלה, נמשיך להפעיל אירועי GTM עד שהמשתמש ייצא מהדף. תקף רק לטריגרים של טיימר.

fingerprint

string

טביעת האצבע של הטריגר ב-GTM כפי שחושב בזמן האחסון. הערך הזה מחושב מחדש בכל פעם שמבצעים שינוי בטריגר.

parentFolderId

string

מזהה התיקייה ההורה.

selector

object (Parameter)

בורר CSS לטריגר של קליק (כלומר 'a', 'button' וכו'). התכונה תקפה רק לטריגר קליקים ב-AMP.

intervalSeconds

object (Parameter)

הזמן שחולף בין הפעלות של אירועי טיימר (בשניות). תקף רק לטריגר של טיימר AMP.

maxTimerLengthSeconds

object (Parameter)

הזמן המקסימלי להפעלת אירועי טיימר (בשניות). תקף רק לטריגר של טיימר AMP.

verticalScrollPercentageList

object (Parameter)

רשימה של ערכים של אחוזים שלמים לטריגרים של גלילה. הטריגר יופעל כשמגיעים לכל אחוז בזמן הגלילה האנכית של התצוגה. התכונה תקפה רק לטריגרים של גלילה ב-AMP.

horizontalScrollPercentageList

object (Parameter)

רשימה של ערכים של אחוזים שלמים לטריגרים של גלילה. הטריגר יופעל כשהגלילה של התצוגה תגיע לכל אחוז. התכונה תקפה רק לטריגרים של גלילה ב-AMP.

visibilitySelector

object (Parameter)

בורר CSS של טריגר חשיפה (למשל, ‎#id). תקף רק לטריגר של חשיפה ב-AMP.

visiblePercentageMin

object (Parameter)

טריגר של ראות עם אחוז חשיפה מינימלי. תקף רק לטריגר של חשיפה ב-AMP.

visiblePercentageMax

object (Parameter)

טריגר של חשיפה מגדיר את אחוז החשיפה המקסימלי. תקף רק לטריגר של חשיפה ב-AMP.

continuousTimeMinMilliseconds

object (Parameter)

משך הזמן המינימלי (באלפיות השנייה) שבו הטריגר של החשיפה גלוי ברציפות. תקף רק לטריגר של חשיפה ב-AMP.

totalTimeMinMilliseconds

object (Parameter)

משך הזמן הכולל המינימלי של חשיפה ניתנת לצפייה (באלפיות שנייה) של טריגר חשיפה. תקף רק לטריגר של חשיפה ב-AMP.

tagManagerUrl

string

קישור שנוצר באופן אוטומטי לממשק המשתמש של Tag Manager

notes

string

הערות של משתמשים לגבי האופן שבו מחילים את הטריגר הזה בקונטיינר.

parameter[]

object (Parameter)

פרמטרים נוספים.

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

Methods

create

יצירת טריגר ב-GTM.

delete

מחיקה של טריגר ב-GTM.

get

הפונקציה מקבלת טריגר של GTM.

list

רשימה של כל הטריגרים של GTM בקונטיינר.

revert

החזרת השינויים בטריגר GTM בסביבת עבודה ב-GTM למצב הקודם.

update

עדכון של טריגר ב-GTM.