מידע על קטע הקוד gtag.js
אם אתם משתמשים ב-analytics.js בנכס Universal Analytics הנוכחי, תצטרכו להוסיף את קטע הקוד של gtag.js לנכס החדש מסוג Google Analytics 4. לקטע הקוד של gtag.js יש את המבנה הבא:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
שורה 7: ההנחיה "config" ב-gtag מאפשרת איסוף נתונים אל הנכס המשויך ל-<Some Property ID A>. לדוגמה, הוספת ההנחיה הזו עם מזהה תג עבור נכס Google Analytics 4 תשלח אירועי page_view לנכס הזה.
מזהה הנכס יכול לייצג מוצרי Google שונים, כולל נכס Universal Analytics ("UA-XXXXXXXX"), נכס Google Analytics 4 ("G-XXXXXXXX"), Ads ("AW-XXXXXXXX") או Floodlight ("DC-XXXXXXXX").
שורה 11: ההנחיה "event" ב-gtag תשלח אירוע. בקטעי קוד שכוללים מספר הנחיות "config" עבור מספר נכסים, האירוע יישלח אל כל הנכסים.
בדוגמה הזו, הפרמטר "sign_up" הוא שם האירוע. הפרמטר האחרון הוא אובייקט שמכיל קבוצה של פרמטרי אירועים. במקרה זה, "method" הוא פרמטר עם הערך "email".
שורה 13: לאירוע הזה יש פרמטר בשם "send_to". זהו פרמטר מיוחד ש"מנתב" את האירוע המשויך לנכס ספציפי. במילים אחרות, האירוע הזה יישלח רק לנכס שמצוין על-ידי <Some Property ID B>.
איסוף נתונים בסיסי עבור נכס Google Analytics 4 מופעל באמצעות ההנחיה "config" של gtag. ההפעלה הזו מאפשרת איסוף אוטומטי של אירוע page_view כשהוא נטען בדף.
ניתן לשנות או לחסום את ההיט 'צפייה בדף' או את האירוע page_view באמצעות פרמטרים ספציפיים.
מזהי נכסים
פורמט מזהי הנכסים של Universal Analytics הוא "UA-XXXXXXXX". מזהה זה נקרא לפעמים 'מזהה לצורכי מעקב'. במדריך זה הוא נקרא מזהה נכס UA.
מקורות נתוני אתר של נכסי Google Analytics 4 משתמשים במזהה תג בפורמט "G-XXXXXXXX".
בדוגמאות קוד מסוימות ובחלק מחומרי התיעוד ייתכן ששניהם ייקראו "TAG_ID".
איסוף נתונים בסיסי
הפעלה של איסוף נתונים בסיסי בנכס Google Analytics 4 מאפשרת לאסוף את הנתונים הבאים:
- אירועי page_view
- אירועים שנאספים באופן אוטומטי
- אירועי מדידה משופרת (אם הם מופעלים בממשק המשתמש)
כדי להפעיל איסוף נתונים בסיסי בנכס Google Analytics 4 צריך להוסיף את קטע הקוד gtag.js (Google Tag) לקטע <head> בכל דף.
השוואה בין קטע הקוד של gtag.js לבין קטע הקוד של analytics.js
קטע הקוד של gtag.js עבור נכס Google Analytics 4 נועד למטרה דומה לזו של קטע הקוד של analytics.js עבור נכס Universal Analytics.
ההבדל הגדול ביותר בין שני קטעי הקוד האלה הוא שהקוד של analytics.js כולל קריאה נפרדת מסוג "send pageview", ואין קריאה כזו בקוד של gtag.js. ב-gtag.js, הצפייה בדף היא אירוע שנאסף באופן אוטומטי ונשלח יחד עם ההנחיה "config".
נכס Universal Analytics (analytics.js)
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
נכס Google Analytics 4 (gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
הגדרות התצורה של gtag.js
בדומה ל-analytics.js, אפשר לקבוע את התצורה של קטע הקוד הבסיסי של gtag.js כדי לשלוט בהגדרות של איסוף נתונים, כמו אנונימיזציה של כתובות IP, התאמה אישית של קובצי cookie ו-Google Signals. ניתן לעשות זאת בעזרת הנחיות 'config' או 'set' ב-gtag.js (לעומת ההנחיות 'set', 'create' ו-'require' ב-analytics.js).
נכסי Google Analytics 4 ("G-XXXXXXXX") תומכים בהטמעה של הגדרות config דומות דרך gtag.js. יש הבדלים בהגדרות האלה בין נכסי Universal Analytics לבין נכסי Google Analytics 4. שימו לב לשיקולים הבאים:
- אנונימיזציה של כתובות IP קבועה כ-"true" ולא ניתן להגדיר את התצורה שלה בנכס Google Analytics 4. מסיבה זו, המערכת מבצעת באופן אוטומטי אנונימיזציה של כתובת ה-IP עם האירוע הסטנדרטי בנכס Google Analytics 4 ("G-XXXXXXXX").
- כשצריך להחיל הגדרות גלובליות על כל הנכסים שהתצורה שלהם נקבעה, יש להשתמש בפקודה "set" ב-gtag.js כדי שיחולו על כל מזהי התג ו/או מזהי הנכסים.
- יש לשים לב במיוחד לתכונות 'פרסום והתאמה אישית של מודעות' ב-analytics.js. ברוב המקרים, הן מוטמעות באמצעות שורת "set".
אם אתם משתמשים בהנחיות "set", "create" ו-"require" בהטמעה הנוכחית של analytics.js, בדקו אילו מהן מוגדרות באופן אוטומטי בנכס Google Analytics 4 ואילו מהן צריך לציין בקוד של נכס Google Analytics 4 (מיפוי פרמטרים).
למטה תוכלו לראות חלק מהתצורות לדוגמה עם דוגמאות הקוד ב-analytics.js (לנכס UA) וב-gtag.js (לנכס 'Google Analytics 4'):
הפעלה של איסוף נתונים בסיסי; הגדרת User-ID
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
קביעת תצורה של קובצי cookie
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 ימים, מצוינים בשניות
});
חסימה של אירוע page_view
אם אין צורך לשלוח אירוע page_view בזמן טעינת קוד config (לדוגמה, אם יש טעינה של iframe), אפשר לשנות את ההגדרה של config כך שתחסום את האירוע page_view. ניקח לדוגמה תרחיש שבו נשלח אירוע page_view ולאחר מכן משתמש מתחבר לאתר. עבור אינטראקציית ההתחברות, אתם משתמשים בהנחיה "config" כדי להגדיר את מזהה המשתמש, אבל אתם לא רוצים לשלוח אירוע page_view נוסף. דוגמת הקוד הבאה מראה איך למנוע שליחה של אירוע page_view.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
שמות תגים
שמות תגים (נקראים "כלי מעקב") משמשים לשליחת נתונים לנכסי Universal Analytics שונים ב-analytics.js. ב-analytics.js, כלי המעקב מגדירים את הנכס שאליו רוצים לשלוח את הנתונים. היטים שמתרחשים לאחר היט "create" הראשון כבר לא צריכים לציין את מזהה הנכס ב-Universal Analytics, אלא רק את שם כלי המעקב.
ב-gtag.js, כלי מעקב אינם זמינים לנכסי Google Analytics 4 או לנכסי Universal Analytics. אם אתם רוצים לשלוח את כל ההיטים למספר נכסים (מקורות נתונים שונים בנכס Google Analytics 4), עליכם לציין את כל מזהי התגים או מזהי הנכסים בשורה "config".
אירועים
יש לעיין במדריך להעברת אירועים.מאפיינים ומדדים מותאמים אישית
מאפיינים ומדדים מותאמים אישית משמשים להרחבת המידע שנמדד באתר ולייבוא נתונים אופליין, כמו ממערכות של ניהול קשרי לקוחות (CRM). בנכס של Universal Analytics ("UA-XXXXXXXX" ) יש ליצור מאפיינים ומדדים מותאמים אישית בממשק המשתמש, המערכת מקצה להם מזהה ולאחר מכן אפשר להטמיע או לייבא אותם. ניתן ליצור אותם באמצעות ארבע רמות היקף שונות: היט, סשן, משתמש ומוצר.
בנכס Google Analytics 4 ("G-XXXXXXXX") התרחיש לדוגמה של שימוש במאפיינים ובמדדים מותאמים אישית מוטמע בדרך אחרת. אם הטמעתם באמצעות analytics.js מאפיינים מותאמים אישית ומדידות של מדדים בנכס UA, יש להטמיע אותם כפרמטרים בנכס Google Analytics 4.
אפשר להטמיע מאפיין מותאם אישית עבור נכס Universal Analytics באמצעות analytics.js באופן הבא:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
או
ga('set', 'dimension5', 'custom data');
את המאפיינים המותאמים אישית האלה אפשר ליצור מחדש כנכס Google Analytics 4 באמצעות gtag.js באופן הבא:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
או
gtag('set', {'dimension5': 'custom data'});
יש שתי נקודות שחשוב לשים לב אליהן:
- צריך לרשום את הפרמטרים בממשק המשתמש כדי שיופיעו בדוחות. זהו תהליך דומה לרישום מאפיינים מותאמים אישית ב-Universal Analytics (בכפוף להגבלות). אין צורך לרשום אותם אם אתם בוחנים רק נתונים מיוצאים, או משתמשים בפרמטר רק להפעלת קהל.
- ההיקף של הפרמטרים המותאמים אישית נמצא תמיד ברמת האירוע, בדומה לרמת ההיט. הדבר נכון גם לגבי מאפיינים מותאמים אישית שנוצרים מחדש באופן אוטומטי כפרמטרים (בהטמעות מסוג gtag.js "UA-XXXXXXXX"), ללא קשר להגדרה המקורית של היקף המאפיינים המותאמים אישית.
מדדים מותאמים אישית ממופים באותה צורה וכפופים לאותם שיקולים. ההבדל היחיד הוא שברישום לדיווח הם נספרים במערכת כפרמטרים מספריים ולא כפרמטרים טקסטואליים לצורך חישוב העמידה במגבלות מספר הפרמטרים.
באופן עקרוני, מאפיינים ומדדים מותאמים אישית ברמות היקף שונות בנכס Universal Analytics ממופים אל נכס Google Analytics 4 בתור:
- מאפיין מותאם אישית ברמת ההיט: פרמטר (עד 25 פרמטרים בסה"כ נרשמים לכל אירוע במהלך איסוף הנתונים; עד 50 מאפיינים מותאמים אישית או 50 מדדים מותאמים אישית)
חשוב לדעת: ייתכן שאירועים ופרמטרים שנאספים באופן אוטומטי כבר מכסים חלק מהתרחישים לדוגמה שבעבר צריך היה להגדיר מאפיינים מותאמים אישית ברמת ההיט כדי לכסות אותם - מאפיין מותאם אישית עם היקף ברמת המשתמש: מאפייני משתמש (עד 25 פרמטרים נרשמים לדיווח דרך ממשק המשתמש). מאפייני משתמשים שנאספים באופן אוטומטי אינם נספרים כחלק מההגבלה הזו.
- מאפיין מותאם אישית עם היקף ברמת הסשן: אין מאפיין מקביל בנכס Google Analytics 4; השתמשו במקום זאת בפרמטרים מותאמים אישית או במאפייני משתמשים.
שיטות מומלצות למאפייני משתמשים
מאפייני משתמשים משויכים למשתמש בפלטפורמות שונות (למשל בכל הסוגים של מקורות נתונים) ולכן יש להשתמש בהם רק אם הנתונים רלוונטיים ברמת המשתמש. אין להשתמש במאפייני משתמשים עבור נתונים ברמת הסשן או נתונים ברמת המכשיר (כמו גודל המסך).
דוגמה עבור נכס Google Analytics 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});