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

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

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

2. בכרטיסייה Info (מידע), מגדירים את הערכים Name ו-Description של המשתנה.

   שם הוא מה שיוצג למשתמשים כשהם ייכנסו לתוקף משתנה בכל ממשק המשתמש של Tag Manager.

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

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

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

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

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

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

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

6. לוחצים על הכרטיסייה קוד ומזינים JavaScript בארגז חול (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. בכרטיסייה תצוגה מקדימה של התבנית, מוסיפים ערכים ל'ערכים'. קלט, לחיצה Run Code ומעיינים במסוף כדי לראות את הפלט של המשתנה.

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

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

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