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

גלריית תבניות הקהילה של 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 (אופציונלי, אבל מומלץ).

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

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

דוגמה:

___INFO___

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

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

קטגוריה תיאור
פרסום פרסום
AFFILIATE_MARKETING שיווק בעזרת שותפים
ניתוח נתונים ניתוח נתונים
ייחוס שיוך (Attribution)
צ'אט צ'אט
לאחר אופטימיזציה מעקב המרות
DATA_WAREHOUSING אחסון נתונים
EMAIL_MARKETING שיווק באימייל
ניסוי ניסויי A/B ואופטימיזציה של תוכן
HEAT_MAP מפות חום
LEAD_GENERATION יצירת לידים
שיווק שיווק
התאמה אישית התאמה אישית
שיווק מחדש רימרקטינג
מבצעים מכירות וניהול קשרי לקוחות
SESSION_RECORDING הקלטות של סשנים
SOCIAL רשתות חברתיות
סקר סקרים
TAG_MANAGEMENT מערכות ניהול תגים
יעילות כלי תחזוקה של Google Tag Manager

metadata.yaml

הקובץ 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.

העלאה ל-GitHub

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

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

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

שליחת התבנית

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

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

עדכון התבנית

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

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

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

הדוגמה הזו ממחישה איך להוסיף פרטי גרסה חדשה, כולל מספר 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.