שליחת תבנית לגלריית תבניות הקהילה

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

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

התהליך לשליחת תבנית חדשה לגלריית התבניות בקהילה כולל את השלבים העיקריים הבאים:

1. בניית התבנית
2. הכנת קובצי הפרויקט
3. העלאת הקבצים אל GitHub
4. שליחת תבנית

יצירת התבנית

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

תנאים והגבלות

כל תבנית חדשה ששולחים חייבת להסכים לתנאים ולהגבלות של תבנית הקהילה של Google Tag Manager. כדי לאשר את התנאים וההגבלות של התבנית:

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

ייצוא התבנית

לאחר השלמת התבנית, מייצאים את קובץ התבנית למכונה המקומית ומשנים את שם הקובץ template.tpl.

מכינים את קובצי הפרויקט

השלב הבא הוא הכנת המאגר שלך לפרסום ב-GitHub. כל מאגר צריך להכיל את הקבצים הבאים:

1. קובץ תבנית שיוצא שנקרא template.tpl. צריך לעדכן את הקובץ הזה כדי להוסיף רשומה ב-categories.
2. קובץ metadata.yaml.
3. קובץ LICENSE. שם הקובץ חייב להיות באותיות רישיות בלבד והתוכן של קובץ הרישיון חייב להיות רק Apache 2.0.
4. הוספת קובץ README.md (אופציונלי, אבל מומלץ).

הערה: השתמשו במאגר התבניות לדוגמה ב-GitHub כמודל. יש להעתיק את הקובץ LICENSE מהתבנית לדוגמה לפרויקט כדי להיות בטוחים שאין שגיאות בתוכן. חשוב להקפיד לעדכן את השורה 'זכויות יוצרים' במקום שבו כתוב "Copyright [yyyy] [name of copyright owner]" בגרסה לדוגמה. מחליפים את yyyy בשנה של זכויות היוצרים, ו-[name of copyright owner] בשם של הבעלים של זכויות היוצרים.

הוספת קטגוריות אל template.tpl

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

הערה: הערכים של הרשומה categories צריכים להיות בפורמט של מערך.

דוגמה:

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

טבלה של ערכי קטגוריות נתמכות:

קטגוריה	תיאור
פרסום	פרסום
AFFILIATE_MarketETING	שיווק שותפים
ניתוח נתונים	Analytics
ייחוס	שיוך (Attribution)
צ'אט	צ'אט
לאחר אופטימיזציה	מדידת המרות
חבילת גלישה	אחסון נתונים
אימייל	שיווק באימייל
ניסוי	ניסויי A/B ואופטימיזציה של תוכן
HEAT_MAP	מפות חום
LEAD_דור שני	יצירת לידים
שיווק	שיווק
התאמה אישית	התאמה אישית
שיווק מחדש	רימרקטינג
מבצעים	מכירות וניהול קשרי לקוחות (CRM)
SESSION_recordING	הקלטות של סשנים
ברשתות חברתיות	רשתות חברתיות
סקר	סקרים
TAG_ניהול	מערכות לניהול תגים
כלי עזר	כלי ניהול של Google Tag Manager

מטא נתונים

הקובץ metadata.yaml מכיל מידע על התבנית שלך, כולל קישורים לדף הבית של הארגון שלך, למסמכי תבנית ולפרטי גרסה. כל גרסה מסומנת במספר שינוי, המכונה גם מספר SHA, שהוא מספר השינוי המשויך להסדר Git. השדה changeNotes הוא אופציונלי, אך מומלץ ליידע את המשתמשים לגבי השינויים הכלולים בגרסה.

כדי להגדיר את הקובץ metadata.yaml:

1. צריך להוסיף רשומה homepage. כתובת ה-URL צריכה להיות של דף הבית של הארגון.
2. צריך להוסיף רשומה עבור documentation. זו צריכה להיות כתובת URL שמפנה לתיעוד של התבנית.
3. ב-GitHub, מאתרים את ההתחייבות שכוללת את השינויים שרוצים לדחוף לגרסה הראשונית של התבנית ומעתיקים את מספר ה-SHA. דרך קלה לקבלת מספר ה-SHA ב-GitHub היא לעבור אל תצוגת מחויבות וללחוץ על סמל הלוח (). פעולה זו תעתיק את מספר ה-SHA כולו ללוח. מדביקים את המספר הזה כערך של הרשומה sha כצאצא של הצומת versions, כפי שמוצג בהמשך.
4. אפשר להוסיף ערך changeNotes לצומת versions כדי לתאר בקצרה את השינויים הכלולים בגרסה החדשה.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

חשוב: sha ו-changeNotes צריכים להיות תואמים כפי שמוצג בדוגמה שלמעלה.

הערה: הערך של sha חייב להפנות לקובץ ה-template.tpl הספציפי שרוצים לפרסם. אל תשכחו לעדכן את הערך הזה בצורה נכונה בכל גרסה חדשה!

העלאה אל GitHub

השלב הבא הוא להעלות את הקבצים שלך ל-GitHub. יוצרים מאגר GitHub עם הקבצים והמבנה המתאימים, כפי שמתואר למעלה.

במאגרים של התבניות חובה למצוא את הקבצים * template.tpl, metadata.yaml ו-LICENSE ברמת הבסיס של מאגר Git. כל מאגר Git צריך להכיל קובץ template.tpl אחד בלבד. כל המשאבים חייבים להיות בסניף הראשי של מאגר GitHub. כל מאגר תבניות שלא תואם למבנה הזה יוסר מהגלריה.

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

שליחת התבנית

אחרי שמאגר התבניות שלכם מתארח ב-GitHub, אתם יכולים להמשיך לשלוח את התבנית שלכם לגלריית התבניות של הקהילה. כדי לשלוח את התבנית, פועלים לפי השלבים הבאים:

1. ודאו שאתם מחוברים ל-GitHub עם חשבון שיש לו גישה למאגר התבניות שאתם רוצים להוסיף לגלריה.
2. נכנסים לגלריית התבניות של הקהילה בכתובת tagmanager.google.com/gallery.
3. לוחצים על ובוחרים באפשרות שליחת תבנית.
4. מציינים את כתובת ה-URL של המאגר בשדה שמוצג ולוחצים על שליחה.

עדכון התבנית

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

הקובץ metadata.yaml משמש לקביעת הגרסה של התבנית שבה יש להשתמש בגלריה. כדי לפרסם גרסאות חדשות, צריך להוסיף את מספר השינוי (מספר SHA) לקטע versions בקובץ metadata.yaml.

1. מאתרים את ההתחייבות שכוללת את השינויים שרוצים לדחוף, ומעתיקים את מספר ה-SHA. דרך קלה לעשות זאת היא ב-GitHub לעבור לתצוגת מחויבות וללחוץ על סמל הלוח (). הפעולה הזו תעתיק את כל מספר ה-SHA ללוח.
2. יש להוסיף רשומה חדשה מסוג sha לראש רשימת הversions ב-metadata.yaml. (ראו דוגמה בהמשך).
3. צריך להוסיף את changeNotes כדי לתאר בקצרה את השינויים בגרסה החדשה. אם רוצים, אפשר ליצור תגובות מרובות שורות. (ראו דוגמה בהמשך).
4. מבצעים את השינוי ב-metadata.yaml והעדכון יופיע בגלריה בדרך כלל בתוך יומיים עד שלושה ימים.

הדוגמה הבאה מראה איך להוסיף פרטי גרסה חדשים, כולל מספר SHA ומספרי שינוי:

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  # Latest version
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874c
    changeNotes: |2
      Fix bug with the whatsamajig.
      Improve menu options.
      Update API calls.
  # Older versions
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874b
    changeNotes: Adds eject button.
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

חשוב: יש לכלול כל גרסה שפורסמה של התבנית בקטע versions שממוינת בסדר כרונולוגי הפוך (העדכני ביותר) לישן ביותר.

הערה: אין לכלול כל התחייבות מצטברת בתור שינוי גרסה בגלריית התבניות של הקהילה. לדוגמה, אם מבצעים שינויים מצטברים בהתחייבות 1, 2 ו-3, והגרסה הסופית היא התחייבות 4, צריך להיות רק ערך אחד להתחייבות 4 שכולל את כל השינויים ממחויבויות 1, 2 ו-3.