גלריית תבניות הקהילה של Google Tag Manager מאפשרת לארגון שלך ליצור ולנהל תבניות של תגים ומשתנים שמשתלבות באופן טבעי עם Google Tag Manager. הארגון שלכם יכול ליצור תבנית, לפרסם את מאגר התבניות ב-GitHub, ואז לשלוח את התבנית לגלריית התבניות לקהילה כדי שהיא תהיה זמינה למשתמשים בכל העולם. היתרונות לארגון שלכם כוללים:
- הלקוחות שלכם יוכלו להוסיף את התבניות שלכם ולהשתמש בהן בקלות.
- משתמשי Tag Manager ייחשפו למותג של הארגון.
- הלקוחות יוכלו לפרוס את התגים בתוך דקות, ולא חודשים.
- אפשר לפרסם עדכונים בתבניות ולהפוך אותם לזמינים באופן אוטומטי עבור הלקוחות שלכם.
התהליך של שליחת תבנית חדשה לגלריית תבניות הקהילה כולל את השלבים העיקריים הבאים:
יצירת התבנית
כדי להתחיל, יוצרים את התבנית ב-Google Tag Manager כתבנית מותאמת אישית. ודאו שהתבנית נבדקה באופן יסודי, שהתוכן שלה תואם למדריך הסגנון ושיש לכם תוכנית או תהליך לתחזוקה ולעדכון של התבנית, למקרה שיהיה צורך לעשות זאת בעתיד.
תנאים והגבלות
כל שליחה של תבנית חדשה חייבת להסכים לתנאים ולהגבלות של גלריית תבניות הקהילה של Google Tag Manager. כדי לאשר את ההסכמה לתנאים ולהגבלות של התבנית:
- קראו את התנאים וההגבלות של גלריית תבניות הקהילה של Google Tag Manager.
- בעורך התבניות, פותחים את התבנית לעריכה, ומסמנים את התיבה בכרטיסייה מידע עם התווית 'הסכמה לתנאים ולהגבלות של גלריית תבניות הקהילה'.
ייצוא התבנית
לאחר השלמת התבנית, מייצאים את קובץ התבנית למחשב המקומי ומשנים את שם הקובץ template.tpl
.
הכנת קובצי הפרויקט
השלב הבא הוא הכנת המאגר לפרסום ב-GitHub. כל מאגר צריך להכיל את הקבצים הבאים:
- קובץ תבנית שיוצא בשם
template.tpl
. צריך לעדכן את הקובץ הזה כדי להוסיף את הערךcategories
. - קובץ
metadata.yaml
. - קובץ
LICENSE
. שם הקובץ חייב להיות באותיות רישיות בלבד והתוכן של קובץ הרישיון חייב להיות בלבד Apache 2.0. - מוסיפים קובץ
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
:
- הוספת רשומה
homepage
. זו צריכה להיות כתובת URL שמפנה לדף הבית של הארגון. - הוסף רשומה עבור
documentation
. כתובת ה-URL צריכה להפנות אל תיעוד של התבנית. - מאתרים ב-GitHub את השמירה שכוללת את השינויים שרוצים ליישם בגרסה הראשונית של התבנית, ומעתיקים את מספר ה-SHA. דרך קלה למצוא את מספר ה-SHA ב-GitHub היא להיכנס לתצוגת התחייבות וללחוץ על סמל הלוח (). פעולה זו תעתיק את מספר ה-SHA במלואו ללוח שלך. מדביקים את המספר הזה בתור הערך של רשומת
sha
כצאצא של הצומתversions
, כפי שמוצג בהמשך. - הוספה של רשומת
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, תוכלו להמשיך ולשלוח את התבנית לגלריית התבניות של הקהילה. כדי לשלוח את התבנית, פועלים לפי השלבים הבאים:
- ודא שאתה מחובר ל-GitHub עם חשבון שיש לו גישה למאגר התבניות שברצונך להוסיף לגלריה.
- נכנסים לגלריית תבניות הקהילה בכתובת tagmanager.google.com/gallery.
- לוחצים על more_vert ובוחרים באפשרות Submit Template (שליחת תבנית).
- מזינים את כתובת ה-URL של המאגר בשדה המתאים ולוחצים על שליחה.
עדכון התבנית
לאחר פרסום תבנית, כדאי לעדכן את התבנית מעת לעת. משתמשי התבנית יקבלו הודעה אם יהיה עדכון לתבנית ותהיה להם אפשרות לעדכן את התבנית לגרסה האחרונה.
הקובץ metadata.yaml
משמש כדי לקבוע באיזו גרסה של התבנית להשתמש בגלריה. כדי לפרסם גרסאות חדשות, עליך להוסיף את מספר השינוי (מספר SHA) לקטע versions
בקובץ metadata.yaml
.
- מאתרים את השמירה שכוללת את השינויים שרוצים להחיל ומעתיקים את מספר ה-SHA. דרך קלה לעשות זאת ב-GitHub היא להיכנס לתצוגת התחייבות וללחוץ על סמל הלוח (). פעולה זו תעתיק את מספר ה-SHA במלואו ללוח שלך.
- הוסף ערך
sha
חדש לראש הרשימה שלversions
ב-metadata.yaml
. (דוגמה בהמשך). - צריך להוסיף
changeNotes
כדי לתאר בקצרה את השינויים שכלולים בגרסה החדשה הזו. אם צריך, אפשר ליצור כמה תגובות לכמה שורות. (דוגמה בהמשך). - יש לרשום את השינוי ל-
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.