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

גלריית תבניות הקהילה של 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_MARKETING	שיווק בעזרת שותפים
ניתוח נתונים	ניתוח נתונים
ייחוס	שיוך (Attribution)
צ'אט	צ'אט
לאחר אופטימיזציה	מעקב המרות
DATA_WAREHOUSING	מחסן נתונים (data warehouse)
EMAIL_MARKETING	שיווק בדוא"ל
ניסוי	ניסויי A/B ואופטימיזציה של תוכן
HEAT_MAP	מפות חום
LEAD_GENERATION	יצירת לידים
שיווק	שיווק
התאמה אישית	התאמה אישית
שיווק מחדש	רימרקטינג
מכירות	מכירות וניהול קשרי לקוחות (CRM)
SESSION_RECORDING	הקלטות של סשנים
חברתי	רשתות חברתיות
SURVEY	סקרים
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.

חשוב: 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. כדי לעשות את זה בקלות, אפשר להיכנס ל-Commit view וללחוץ על סמל הלוח (). הפעולה הזו תעתיק את מספר ה-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.