Tags

התגים שמשויכים למאגר התגים. תגים משויכים בדרך כלל לכלל הפעלה אחד או יותר (ראו firingRuleId בהמשך), ובאופן אופציונלי גם לכלל חסימה אחד או יותר (ראו blockingRuleId בהמשך). כאשר לפחות כלל הפעלה אחד מקבל את הערך True ואפס כללי חסימה מוערכים כ-true, התג יופעל (הפעלה). אפשר להשתמש במאפיין האופציונלי priority כדי לקבוע אילו תגים יופעלו לפני האחרים. אפשר להשתמש במאפיין dependencies כדי לציין אילו תגים אחרים צריכים להיות מופעלים ולהשלים לפני ההפעלה של התג. לפרטים על הפרמטרים שניתן להגדיר לתגים של Google Tag Manager, אפשר לעיין בחומר העזר בנושא מילון תגים.

רשימה של שיטות למשאב הזה מופיעה בסוף הדף.

ייצוגים של משאבים

מייצג תג של Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "paused": boolean
}

שם הנכס	Value	התיאור	הערות
accountId	string	מספר חשבון GTM.
blockingRuleId[]	list	חסימה של מזהי כללים. אם אחד מהכללים ברשימה הוא True, התג לא יופעל.	ניתן לכתיבה
blockingTriggerId[]	list	חסימה של מזהי טריגרים. אם גורם כלשהו מהטריגרים שמופיעים ברשימה מקבל את הערך True, התג לא יופעל.	ניתן לכתיבה
containerId	string	מזהה מאגר תגים של GTM.
fingerprint	string	טביעת האצבע של תג ה-GTM, כפי שמחושב בזמן האחסון. הערך הזה מחושב מחדש בכל פעם שהתג משתנה.
firingRuleId[]	list	מזהים של כללי הפעלה. תג יופעל כאשר אחד מהכללים ברשימה מתקיים וכל blockingRuleIds שלו (אם צוין) שגוי.	ניתן לכתיבה
firingTriggerId[]	list	הפעלת מזהים של טריגרים. תג יופעל כשכל אחד מהטריגרים שמופיעים ברשימה יהיה TRUE וכל ה-blockingTriggerIds שלו (אם צוין) false.	ניתן לכתיבה
liveOnly	boolean	אם המדיניות מוגדרת כ-True, התג יופעל רק בסביבה הפעילה (למשל, לא במצב תצוגה מקדימה או ניפוי באגים).	ניתן לכתיבה
name	string	השם המוצג של התג.	ניתן לכתיבה
notes	string	משתמש הערות לגבי אופן ההחלה של התג הזה בכלי הקיבול.	ניתן לכתיבה
parameter[]	list	הפרמטרים של התג.	ניתן לכתיבה
parameter[].key	string	המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה.	ניתן לכתיבה
parameter[].list[]	list	הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות).	ניתן לכתיבה
parameter[].map[]	list	הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים).	ניתן לכתיבה
parameter[].type	string	סוג הפרמטר. הערכים החוקיים הם: boolean: הערך מייצג בוליאני, מיוצג כ-true או כ-false integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10 list: יש לציין רשימה של פרמטרים map: יש לציין מפה של פרמטרים template: הערך מייצג כל טקסט. הוא יכול לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות) trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר הערכים הקבילים הם: "boolean" "integer" "list" "map" "template" "triggerReference"	ניתן לכתיבה
parameter[].value	string	ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין.	ניתן לכתיבה
parentFolderId	string	המזהה של תיקיית ההורה.
paused	boolean	הערך יהיה True אם התג מושהה.	ניתן לכתיבה
priority	nested object	עדיפות מספרית בהגדרת המשתמש של התג. התגים מופעלים באופן אסינכרוני לפי סדר העדיפות שלהם. תגים עם ערך מספרי גבוה יותר מופעלים קודם. עדיפות התג יכולה להיות ערך חיובי או שלילי. ערך ברירת המחדל הוא 0.	ניתן לכתיבה
priority.key	string	המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה.	ניתן לכתיבה
priority.list[]	list	הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות).	ניתן לכתיבה
priority.map[]	list	הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים).	ניתן לכתיבה
priority.type	string	סוג הפרמטר. הערכים החוקיים הם: boolean: הערך מייצג בוליאני, מיוצג כ-true או כ-false integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10 list: יש לציין רשימה של פרמטרים map: יש לציין מפה של פרמטרים template: הערך מייצג כל טקסט. הוא יכול לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות) trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר הערכים הקבילים הם: "boolean" "integer" "list" "map" "template" "triggerReference"	ניתן לכתיבה
priority.value	string	ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין.	ניתן לכתיבה
scheduleEndMs	long	חותמת הזמן של הסיום באלפיות השנייה לתזמון תג.	ניתן לכתיבה
scheduleStartMs	long	חותמת הזמן של ההתחלה באלפיות השנייה לתזמון תג.	ניתן לכתיבה
setupTag[]	list	רשימת תגי ההגדרה. בשלב זה אנו מאפשרים אחד בלבד.
setupTag[].stopOnSetupFailure	boolean	אם התג הראשי הוא True, התג הראשי יופעל רק אם ורק אם תג ההגדרה מופעל בהצלחה. אם הערך הוא False, יש להפעיל את התג הראשי ללא קשר לסטטוס ההפעלה של התג.
setupTag[].tagName	string	השם של תג ההגדרה.
tagFiringOption	string	אפשרות להפעיל את התג הזה. הערכים הקבילים הם: "oncePerEvent" "oncePerLoad" "unlimited"
tagId	string	מזהה התג מזהה באופן ייחודי את תג ה-GTM.
teardownTag[]	list	רשימה של תגי ניתוק. בשלב זה אנו מאפשרים אחד בלבד.
teardownTag[].stopTeardownOnFailure	boolean	אם הערך הוא true, אפשר להפעיל את תג הניתוק אם ורק אם התג הראשי מופעל בהצלחה. אם הערך הוא False, הפעלת תג הניתוק ללא קשר לסטטוס ההפעלה של התג הראשי.
teardownTag[].tagName	string	שם תג הניתוק.
type	string	סוג התג ב-GTM.	ניתן לכתיבה

שיטות

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

ליצור

יצירת תג GTM.

מחיקה

מחיקת תג GTM.

מקבלים

מקבל תג GTM.

list

פירוט של כל תגי GTM של מאגר תגים.

עדכון

מעדכן תג GTM.