REST Resource: accounts.containers.triggers

משאב: טריגר

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

ייצוג ב-JSON 
{
  "accountId": string,
  "containerId": 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)
  },
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
שדות
accountId

string

מזהה החשבון ב-GTM.
containerId

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.
parameter[]

object (Parameter)

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

EventType

טיפוסים בני מנייה (enum)
pageview
domReady
windowLoaded
customEvent
triggerGroup
always
formSubmission
click
linkClick
jsError
historyChange
timer
ampClick
ampTimer
ampScroll
ampVisibility
youTubeVideo
scrollDepth
elementVisibility

תנאי

מייצג תנאי.

ייצוג ב-JSON 
{
  "type": enum (ConditionType),
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
שדות
type

enum (ConditionType)

סוג המפעיל של התנאי הזה.
parameter[]

object (Parameter)

רשימה של פרמטרים עם שמות (מפתח/ערך), בהתאם לסוג התנאי. הערות:

  • באופרטורים בינאריים, צריך לכלול פרמטרים בשמות

    arg0

    וגם

    arg1

    כדי לציין את האופרטורים השמאלי והימני, בהתאמה.

  • בשלב הזה, המשתנה הימני (

    arg0

    ) חייבת להיות הפניה למשתנה.

  • להתאמה לביטוי רגולרי (regex) ללא התחשבות ברישיות, צריך לכלול פרמטר בוליאני בשם

    ignore_case

    שמוגדר כ-

    true

    . אם לא צוין ערך או שהוגדר ערך אחר, ההתאמה תהיה תלוית-אותיות רישיות.

  • כדי לבטל אופרטורים, צריך לכלול פרמטר בוליאני בשם

    negate

    פרמטר בוליאני שמוגדר לערך

    true

    .

ConditionType

טיפוסים בני מנייה (enum)
equals
contains
startsWith
endsWith
matchRegex
greater
greaterOrEquals
less
lessOrEquals
cssSelector
urlMatches

Methods

create

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

delete

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

get

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

list

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

update

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