Rules

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

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

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

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

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
שם הנכס Value התיאור הערות
accountId string מספר חשבון GTM.
condition[] list רשימת התנאים שמרכיבים את הכלל הזה (משתמע AND) ביניהם). ניתן לכתיבה
condition[].parameter[] list רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות:
  • באופרטורים בינאריים, כוללים פרמטרים בשם arg0 ו-arg1 לציון האופרנד הימני והשמאלי, בהתאמה.
  • בשלב זה, האופרנד השמאלי (arg0) חייב להיות הפניה למאקרו.
  • לצורך התאמת ביטוי רגולרי (regex) שאינה תלוית-רישיות, יש לכלול פרמטר בוליאני בשם ignore_case שמוגדר ל-true. אם לא מציינים ערך או מוגדר לערך אחר, ההתאמה תהיה תלוית אותיות רישיות.
  • כדי לשלול אופרטור, יש לכלול פרמטר בוליאני בשם negate ולהגדיר אותו ל-true.
ניתן לכתיבה
condition[].parameter[].key string המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. ניתן לכתיבה
condition[].parameter[].list[] list הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). ניתן לכתיבה
condition[].parameter[].map[] list הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). ניתן לכתיבה
condition[].parameter[].type string סוג הפרמטר. הערכים החוקיים הם:
  • boolean: הערך מייצג בוליאני, מיוצג כ-true או כ-false
  • integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10
  • list: יש לציין רשימה של פרמטרים
  • map: יש לציין מפה של פרמטרים
  • template: הערך מייצג כל טקסט; הוא יכול לכלול הפניות מאקרו (גם הפניות מאקרו שעשויות להחזיר סוגים שאינם מחרוזות)


הערכים הקבילים הם:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
 ניתן לכתיבה
condition[].parameter[].value string ערך של פרמטר (עשוי להכיל הפניות מאקרו כגון "") בהתאם לסוג שצוין. ניתן לכתיבה
condition[].type string סוג האופרטור של התנאי הזה.

הערכים הקבילים הם:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 ניתן לכתיבה
containerId string מזהה מאגר תגים של GTM.
fingerprint string טביעת האצבע של כלל GTM, כפי שמחושב בזמן האחסון. הערך הזה יחושב מחדש בכל פעם שהכלל ישתנה.
name string השם המוצג של הכלל. ניתן לכתיבה
notes string המשתמש מציין איך להחיל את הכלל הזה בכלי הקיבול. ניתן לכתיבה
ruleId string מזהה הכלל הוא המזהה הייחודי של כלל GTM.

שיטות

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

ליצור
יצירת כלל GTM.
מחיקה
מחיקת כלל GTM.
מקבלים
המערכת מקבלת כלל GTM.
list
פירוט של כל הכללים ב-GTM של מאגר תגים.
עדכון
מתבצע עדכון של כלל GTM.