נדרשת הרשאה
מעדכן טריגר של GTM. אפשר לנסות עכשיו או לראות דוגמה.
בקשה
בקשת HTTP
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers/triggerId
פרמטרים
שם הפרמטר | Value | התיאור |
---|---|---|
פרמטרים של נתיב | ||
accountId |
string |
מספר החשבון ב-GTM. |
containerId |
string |
מזהה מאגר התגים של GTM. |
triggerId |
string |
מזהה הטריגר ב-GTM. |
פרמטרים אופציונליים של שאילתה | ||
fingerprint |
string |
כשמזינים את טביעת האצבע, היא צריכה להתאים לטביעת האצבע של הטריגר באחסון. |
הרשאות
בקשה זו מחייבת הרשאה בהיקף הבא (למידע נוסף על אימות והרשאה).
היקף |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
גוף הבקשה
בגוף הבקשה, מספקים משאב Triggers (טריגרים) עם המאפיינים הבאים:
שם הנכס | Value | התיאור | הערות |
---|---|---|---|
מאפיינים נדרשים | |||
autoEventFilter[].parameter[] |
list |
רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות:
|
ניתן לכתיבה |
autoEventFilter[].parameter[].type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
autoEventFilter[].type |
string |
סוג האופרטור של התנאי הזה.
הערכים הקבילים הם:
|
ניתן לכתיבה |
checkValidation.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
continuousTimeMinMilliseconds.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
customEventFilter[].parameter[] |
list |
רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות:
|
ניתן לכתיבה |
customEventFilter[].parameter[].type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
customEventFilter[].type |
string |
סוג האופרטור של התנאי הזה.
הערכים הקבילים הם:
|
ניתן לכתיבה |
eventName.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
filter[].parameter[] |
list |
רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות:
|
ניתן לכתיבה |
filter[].parameter[].type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
filter[].type |
string |
סוג האופרטור של התנאי הזה.
הערכים הקבילים הם:
|
ניתן לכתיבה |
horizontalScrollPercentageList.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
interval.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
intervalSeconds.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
limit.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
maxTimerLengthSeconds.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
name |
string |
השם המוצג של הגורם המפעיל. | ניתן לכתיבה |
parameter[].type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
selector.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
totalTimeMinMilliseconds.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
uniqueTriggerId.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
verticalScrollPercentageList.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
visibilitySelector.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
visiblePercentageMax.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
visiblePercentageMin.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
waitForTags.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
waitForTagsTimeout.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
מאפיינים אופציונליים | |||
autoEventFilter[] |
list |
משמש במקרה של מעקב אוטומטי אחר אירועים. | ניתן לכתיבה |
autoEventFilter[].parameter[].key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
autoEventFilter[].parameter[].list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
autoEventFilter[].parameter[].map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
autoEventFilter[].parameter[].value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
checkValidation |
nested object |
מציין אם להפעיל תגים רק אם אירוע שליחת טופס או לחיצה על קישור לא בוטל על ידי גורם אחר לטיפול באירועים (למשל בגלל אימות). תקף רק לטריגרים של שליחת טופס ושל קליקים על קישורים. | ניתן לכתיבה |
checkValidation.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
checkValidation.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
checkValidation.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
checkValidation.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
continuousTimeMinMilliseconds |
nested object |
חשיפה מפעילה זמן מינימלי לצפייה רציפה (באלפיות שנייה). תקף רק לטריגר חשיפה ב-AMP. | ניתן לכתיבה |
continuousTimeMinMilliseconds.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
continuousTimeMinMilliseconds.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
continuousTimeMinMilliseconds.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
continuousTimeMinMilliseconds.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
customEventFilter[] |
list |
משמש במקרה של אירוע מותאם אישית, שמופעל אם כל התנאים מתקיימים. | ניתן לכתיבה |
customEventFilter[].parameter[].key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
customEventFilter[].parameter[].list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
customEventFilter[].parameter[].map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
customEventFilter[].parameter[].value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
eventName |
nested object |
שם האירוע של GTM שמופעל. תקף רק לטריגרים של הטיימר. | ניתן לכתיבה |
eventName.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
eventName.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
eventName.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
eventName.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
filter[] |
list |
הטריגר יופעל רק אם מתקיימים כל התנאים. | ניתן לכתיבה |
filter[].parameter[].key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
filter[].parameter[].list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
filter[].parameter[].map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
filter[].parameter[].value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
horizontalScrollPercentageList |
nested object |
רשימת ערכים באחוזים של מספרים שלמים לטריגרים של גלילה. הטריגר יופעל כשמגיעים לכל אחוז כשגוללים את התצוגה לרוחב. תקף רק לטריגרים של גלילה בגרסת AMP. | ניתן לכתיבה |
horizontalScrollPercentageList.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
horizontalScrollPercentageList.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
horizontalScrollPercentageList.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
horizontalScrollPercentageList.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
interval |
nested object |
משך הזמן בין הפעלת אירועי טיימר חוזרים (באלפיות שנייה). תקף רק לטריגרים של הטיימר. | ניתן לכתיבה |
interval.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
interval.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
interval.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
interval.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
intervalSeconds |
nested object |
משך הזמן בין אירועי טיימר להפעלה (בשניות). תקף רק להפעלת טיימר AMP. | ניתן לכתיבה |
intervalSeconds.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
intervalSeconds.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
intervalSeconds.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
intervalSeconds.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
limit |
nested object |
מגבלת מספר האירועים ב-GTM להפעלת הטיימר הזה. אם לא הוגדרה מגבלה, נמשיך להפעיל אירועים של GTM עד שהמשתמש יעזוב את הדף. תקף רק לטריגרים של הטיימר. | ניתן לכתיבה |
limit.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
limit.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
limit.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
limit.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
maxTimerLengthSeconds |
nested object |
משך הזמן המקסימלי להפעלת אירועי טיימר (בשניות). תקף רק להפעלת טיימר AMP. | ניתן לכתיבה |
maxTimerLengthSeconds.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
maxTimerLengthSeconds.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
maxTimerLengthSeconds.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
maxTimerLengthSeconds.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
parameter[].key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
parameter[].list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
parameter[].map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
parameter[].value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
selector |
nested object |
בורר CSS להפעלת לחיצה (למשל "a", "לחצן" וכו'). תקף רק לטריגר של קליקים מסוג AMP. | ניתן לכתיבה |
selector.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
selector.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
selector.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
selector.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
totalTimeMinMilliseconds |
nested object |
הגדרת חשיפה מפעילה את הזמן הכולל המינימלי לצפייה (באלפיות השנייה). תקף רק לטריגר חשיפה ב-AMP. | ניתן לכתיבה |
totalTimeMinMilliseconds.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
totalTimeMinMilliseconds.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
totalTimeMinMilliseconds.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
totalTimeMinMilliseconds.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
type |
string |
מגדיר את אירוע שכבת הנתונים שגורם לטריגר הזה.
הערכים הקבילים הם:
|
ניתן לכתיבה |
uniqueTriggerId |
nested object |
מזהה ייחודי גלובלי של הטריגר שמפעיל את הפונקציה הזו באופן אוטומטי (שליחת טופס, לחיצה על קישור או טיימר טיימר) אם קיים. ההגדרה הזו משמשת להפעלת אירועים אוטומטיים לא תואמים עם סינון טריגרים על סמך מזהי טריגרים. הערך הזה מאוכלס במהלך יצירת הפלט כי התגים שמשתמעים מטריגרים לא קיימים עד אז. האפשרות תקפה רק לטריגרים מסוג 'שליחת טופס', 'לחיצה על קישור' ו'טיימר'. | ניתן לכתיבה |
uniqueTriggerId.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
uniqueTriggerId.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
uniqueTriggerId.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
uniqueTriggerId.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
verticalScrollPercentageList |
nested object |
רשימת ערכים באחוזים של מספרים שלמים לטריגרים של גלילה. הטריגר יופעל כשמגיעים לכל אחוז כשגוללים את התצוגה לאורך. תקף רק לטריגרים של גלילה בגרסת AMP. | ניתן לכתיבה |
verticalScrollPercentageList.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
verticalScrollPercentageList.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
verticalScrollPercentageList.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
verticalScrollPercentageList.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
visibilitySelector |
nested object |
סלקטור ב-CSS להפעלת חשיפה (למשל "#id"). תקף רק לטריגר חשיפה ב-AMP. | ניתן לכתיבה |
visibilitySelector.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
visibilitySelector.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
visibilitySelector.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
visibilitySelector.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
visiblePercentageMax |
nested object |
חשיפה מפעילה את אחוז החשיפה המקסימלי. תקף רק לטריגר חשיפה ב-AMP. | ניתן לכתיבה |
visiblePercentageMax.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
visiblePercentageMax.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
visiblePercentageMax.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
visiblePercentageMax.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
visiblePercentageMin |
nested object |
חשיפה מובילה לחשיפה מינימלית של אחוזים. תקף רק לטריגר חשיפה ב-AMP. | ניתן לכתיבה |
visiblePercentageMin.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
visiblePercentageMin.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
visiblePercentageMin.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
visiblePercentageMin.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
waitForTags |
nested object |
האם כדאי לעכב את השליחה של הטופס או את פתיחת הקישורים עד שכל התגים יופעלו (על ידי מניעת פעולת ברירת המחדל וסימולציה מאוחרת יותר של פעולת ברירת המחדל). תקף רק לטריגרים של שליחת טופס ושל קליקים על קישורים. | ניתן לכתיבה |
waitForTags.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
waitForTags.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
waitForTags.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
waitForTags.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
waitForTagsTimeout |
nested object |
משך הזמן שצריך להמתין (באלפיות שנייה) עד שהתגים יופעלו כשמתבצעת הערכה של הערך 'waits_for_tags' שלמעלה ל-true . תקף רק לטריגרים של שליחת טופס ושל קליקים על קישורים. |
ניתן לכתיבה |
waitForTagsTimeout.key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
waitForTagsTimeout.list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
waitForTagsTimeout.map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
waitForTagsTimeout.value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Triggers (טריגרים) בגוף התגובה.
דוגמאות
הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).
Java
משתמש בספריית הלקוח של Java.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request updates an existing trigger for the authorized user. */ // Create the condition parameters objects. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("arg0"); arg0.setValue("{{Page URL}}"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("arg1"); arg1.setValue("timed.html"); // Create the auto event condition object. Condition condition = new Condition(); condition.setType("contains"); condition.setParameter(Arrays.asList(arg0, arg1)); // Create the event parameter. Parameter eventName = new Parameter(); eventName.setType("template"); eventName.setValue("gtm.timer"); // Create the interval parameter. Parameter interval = new Parameter(); interval.setType("template"); interval.setValue("10000"); // Create the limit parameter. Parameter limit = new Parameter(); limit.setType("template"); limit.setValue("10"); // Create the trigger object. Trigger trigger = new Trigger(); trigger.setName("Updated Timer Trigger"); trigger.setType("timer"); trigger.setAutoEventFilter(Arrays.asList(condition)); trigger.setEventName(eventName); trigger.setInterval(interval); trigger.setLimit(limit); try { Trigger response = tagmanager.accounts().containers(). triggers().update("123456", "54321", "1", trigger).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the update method are stored in the response object. * The following code shows how to access the updated name and fingerprint. */ System.out.println("Updated Name = " + response.getName()); System.out.println("Updated Fingerprint = " + response.getFingerprint());
Python
עושה שימוש בספריית הלקוח של Python.
# Note: This code assumes you have an authorized tagmanager service object. # This request updates an existing trigger. try: response = tagmanager.accounts().containers().triggers().update( accountId='123456', containerId='54321', triggerId='3', body={ 'name': 'Updated Timed trigger', 'type': 'timer', 'autoEventFilter': [ { 'type': 'contains', 'parameter': [ { 'type': 'template', 'key': 'arg0', 'value': '{{Page URL}}' }, { 'type': 'template', 'key': 'arg1', 'value': 'timed.html' } ] } ], 'eventName': { 'type': 'template', 'value': 'gtm.timer' }, 'interval': { 'type': 'template', 'value': '10000' }, 'limit': { 'type': 'template', 'value': '10' } } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason)) # The results of the update method are stored in the response object. # The following code shows how to access the updated name and fingerprint. print 'Updated Name = %s' % response.get('name') print 'Updated Fingerprint = %s' % response.get('fingerprint')
רוצה לנסות?
ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.