יצירת משתנה מותאם אישית

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

1. כדי להתחיל את תבנית המשתנה הראשונה, לוחצים על 'תבניות' בחלונית הניווט הימנית ולוחצים על הלחצן חדש בקטע תבניות משתנים.

2. בכרטיסייה מידע, מגדירים את השם ואת התיאור של המשתנה.

   שם הוא מה שיוצג למשתמשים כשהם יטמיעו את המשתנה הזה דרך ממשק המשתמש של Tag Manager.

   תיאור הוא בדיוק מה שנשמע – תיאור קצר (200 תווים או פחות) של המשתנה.

3. לוחצים על רענון כדי להציג תצוגה מקדימה של התבנית.

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

4. לוחצים על שדות כדי להוסיף שדות לתבנית המשתנה.

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

5. לוחצים על הוספת שדה ובוחרים טבלה פשוטה. מחליפים את שם ברירת המחדל (למשל, "SimpleTable1") ב-"list". בתצוגה המקדימה של התבנית, לוחצים על רענון.

   חוזרים על השלב הזה עבור קלט טקסט וקוראים לו "מערך", שתי תיבות סימון שנקראות "use_array" ו-"sort", ו-קלט קלט שנקרא "delimiter". בשדה "delimiter", מגדירים את ערך ברירת המחדל "," בלחיצה על סמל גלגל השיניים, מעבירים את הלחצן "ערך ברירת מחדל" למצב 'מופעל' ולאחר מכן ממלאים את שדה הקלט החדש 'ערך ברירת מחדל'.

6. לוחצים על הכרטיסייה Code ומזינים ב-Sandbox ארגז חול בעורך:

   var input = data.array;
   
   if (!data.use_array) {
     input = [];
     for (var i = 0; i < data.list.length; i++) {
       input.push(data.list[i].values);
     }
   }
   
   if (data.sort) {
     input.sort();
   }
   
   return input.join(data.delimiter || ',');
   

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

   • data שדות.

     יש מספר שדות שניתן לגשת אליהם מתוך ההיקף הגלובלי של data. data תכיל את הערכים שהגדרת בשלב הקודם. לכן אנחנו יכולים לגשת אל data.use_array, data.sort, data.list ואל data.delimiter.

   • delimiter מוגדר לערך ברירת המחדל "," אם לא מספקים data.delimiter. מומלץ להגדיר ערכי ברירת מחדל לשדה מסוים, אם זה מתאים. כך המשתמשים יוכלו להשתמש בתבנית המשתנה בקלות, כי הם לא צריכים למלא את כל השדות כדי להשתמש במשתנה.

7. לוחצים על Save (שמירה) כדי לשמור את ההתקדמות. ההרשאה הזו תטען את כל ההרשאות שזוהו בעורך התבניות.

   לחלק מממשקי ה-API של התבניות משויכות הרשאות שמגדירות מה הם יכולים או לא יכולים לעשות. כשמשתמשים בממשק API של תבניות כמו sendPixel בקוד, Tag Manager מציג הרשאות רלוונטיות בכרטיסייה הרשאות.

8. בכרטיסייה תצוגה מקדימה של התבנית, מוסיפים כמה ערכים לקלט ה"ערכים", לוחצים על הרצת קוד ובוחנים את המסוף כדי לראות את הפלט של המשתנה.

   אם יש שגיאות, הן יופיעו בחלון Console.

9. לוחצים על שמירה וסוגרים את עורך התבניות.

   תבנית המשתנה אמורה להיות מוכנה לשימוש.