Macros

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

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

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

מייצג מאקרו של Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}

שם הנכס	Value	התיאור	הערות
accountId	string	מספר חשבון GTM.
containerId	string	מזהה מאגר תגים של GTM.
disablingRuleId[]	list	עבור כלים מכילים של מכשירים ניידים בלבד: רשימה של מזהי כללים להשבתת פקודות מאקרו מותנות; המאקרו מופעל אם אחד מכללי ההפעלה מתקיים וכל כללי ההשבתה אינם נכונים. מטופל כקבוצה לא ממוינת.	ניתן לכתיבה
enablingRuleId[]	list	עבור כלים מכילים של מכשירים ניידים בלבד: רשימה של מזהי כללים להפעלת פקודות מאקרו מותנות; המאקרו מופעל אם אחד מכללי ההפעלה מתקיים וכל כללי ההשבתה אינם נכונים. מטופל כקבוצה לא ממוינת.	ניתן לכתיבה
fingerprint	string	טביעת האצבע של המאקרו GTM כפי שמחושב בזמן האחסון. הערך הזה מחושב מחדש בכל פעם שמתבצע שינוי במאקרו.
macroId	string	מזהה המאקרו מזהה באופן ייחודי את המאקרו של GTM.
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: הערך מייצג כל טקסט; הוא יכול לכלול הפניות מאקרו (גם הפניות מאקרו שעשויות להחזיר סוגים שאינם מחרוזות) הערכים הקבילים הם: "boolean" "integer" "list" "map" "template"	ניתן לכתיבה
parameter[].value	string	ערך של פרמטר (עשוי להכיל הפניות מאקרו כגון "") בהתאם לסוג שצוין.	ניתן לכתיבה
parentFolderId	string	המזהה של תיקיית ההורה.
scheduleEndMs	long	חותמת הזמן של הסיום, באלפיות השנייה, לתזמון מאקרו.	ניתן לכתיבה
scheduleStartMs	long	חותמת הזמן של ההתחלה באלפיות השנייה לתזמון מאקרו.	ניתן לכתיבה
type	string	סוג המאקרו GTM.	ניתן לכתיבה

שיטות

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

ליצור

יצירת מאקרו של GTM.

מחיקה

מחיקת מאקרו של GTM.

מקבלים

מקבל מאקרו של GTM.

list

פירוט של כל פקודות המאקרו של GTM של מאגר.

עדכון

מתבצע עדכון של מאקרו ב-GTM.