גלריית התבניות של קהילת 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_MarketETING | שיווק שותפים |
ניתוח נתונים | Analytics |
ייחוס | שיוך (Attribution) |
צ'אט | צ'אט |
לאחר אופטימיזציה | מדידת המרות |
חבילת גלישה | אחסון נתונים |
אימייל | שיווק באימייל |
ניסוי | ניסויי A/B ואופטימיזציה של תוכן |
HEAT_MAP | מפות חום |
LEAD_דור שני | יצירת לידים |
שיווק | שיווק |
התאמה אישית | התאמה אישית |
שיווק מחדש | רימרקטינג |
מבצעים | מכירות וניהול קשרי לקוחות (CRM) |
SESSION_recordING | הקלטות של סשנים |
ברשתות חברתיות | רשתות חברתיות |
סקר | סקרים |
TAG_ניהול | מערכות לניהול תגים |
כלי עזר | כלי ניהול של Google Tag Manager |
מטא נתונים
הקובץ 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
ברמת הבסיס של מאגר Git. כל מאגר Git צריך להכיל קובץ template.tpl
אחד בלבד. כל המשאבים חייבים להיות בסניף הראשי של מאגר GitHub. כל מאגר תבניות שלא תואם למבנה הזה יוסר מהגלריה.
כל רשומה בגלריית תבניות הקהילה תכלול קישור לקטע בעיות במאגר GitHub בתבנית, כדי שהמשתמשים יוכלו להודיע לכם אם הם מוצאים באג. כדי שתוכלו לבדוק את הבעיות שגורמות לבעיות, אתם לא צריכים להשבית את מאגר הנתונים של GitHub בתבנית.
שליחת התבנית
אחרי שמאגר התבניות שלכם מתארח ב-GitHub, אתם יכולים להמשיך לשלוח את התבנית שלכם לגלריית התבניות של הקהילה. כדי לשלוח את התבנית, פועלים לפי השלבים הבאים:
- ודאו שאתם מחוברים ל-GitHub עם חשבון שיש לו גישה למאגר התבניות שאתם רוצים להוסיף לגלריה.
- נכנסים לגלריית התבניות של הקהילה בכתובת tagmanager.google.com/gallery.
- לוחצים על more_vert ובוחרים באפשרות שליחת תבנית.
- מציינים את כתובת ה-URL של המאגר בשדה שמוצג ולוחצים על שליחה.
עדכון התבנית
לאחר פרסום תבנית, ייתכן שתרצו לעדכן את התבנית שלכם מדי פעם. המשתמשים בתבנית יקבלו הודעה אם יש עדכון בתבנית, ותהיה להם אפשרות לעדכן את התבנית לגרסה האחרונה.
הקובץ metadata.yaml
משמש לקביעת הגרסה של התבנית שבה יש להשתמש בגלריה. כדי לפרסם גרסאות חדשות, צריך להוסיף את מספר השינוי (מספר SHA) לקטע versions
בקובץ metadata.yaml
.
- מאתרים את ההתחייבות שכוללת את השינויים שרוצים לדחוף, ומעתיקים את מספר ה-SHA. דרך קלה לעשות זאת היא ב-GitHub לעבור לתצוגת מחויבות וללחוץ על סמל הלוח (
). הפעולה הזו תעתיק את כל מספר ה-SHA ללוח.
- יש להוסיף רשומה חדשה מסוג
sha
לראש רשימת הversions
ב-metadata.yaml
. (ראו דוגמה בהמשך). - צריך להוסיף את
changeNotes
כדי לתאר בקצרה את השינויים בגרסה החדשה. אם רוצים, אפשר ליצור תגובות מרובות שורות. (ראו דוגמה בהמשך). - מבצעים את השינוי ב-
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.