מידע על קטע הקוד gtag.js ועל מזהי נכסים
במהותם, קטעי הקוד של gtag.js עבור נכס Universal Analytics ונכס Google Analytics 4 הם זהים. לשני קטעי הקוד יש את המבנה הבא:
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>
שורה 1: אם הטמעתם נכס Universal Analytics דרך gtag.js, סביר להניח ששורת הקוד הזו כבר קיימת באתר. במקום <Some Property ID A>, תראו "UA-" ולאחר מכן סדרת מספרים. אם הטמעתם את gtag.js ב-Google Ads או במוצר אחר של Google Marketing Platform, ייתכן שגם במקרה זה שורת הקוד קיימת באתר, אבל <Some Property ID A> יתחיל עם "AW-" או "DC-".
מזהה הנכס (או מזהה התג במקרה של נכסי Google Analytics 4) שמציינת אותו המחרוזת <Some Property ID A> "שולט" בקטע הקוד הזה של gtag.js. נקודה זו חשובה מהסיבות הבאות:
- אם השורה הזו כבר קיימת, אין צורך להטמיע אותה שוב. תצטרכו להוסיף רק שורת "config" כדי לציין את מזהה התג.
- מזהה הנכס בשורה הזו "שולט" בקטע הקוד gtag.js. אם מזהה של נכס Universal Analytics ("UA-XXXXXXXX") שולט בתג, תוכלו להשתמש בתגי אתרים מחוברים כדי לשלוח נתוני מדידה אל נכס Google Analytics 4 בלי שתצטרכו להוסיף לדף קוד חדש.
שורה 7: ההנחיה "config" ב-gtag מאפשרת איסוף נתונים בנכס המשויך ל-<Some Property ID A>. לדוגמה, בנכס Google Analytics 4 , הוספת ההנחיה הזו עם מזהה תג תשלח לאותו נכס אירועי page_view.
מזהה הנכס יכול לייצג מדידה עבור מוצרי Google שונים, כולל נכס Universal Analytics ("UA-XXXXXXXX"), נכס Google Analytics 4 ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") או Floodlight ("DC-XXXXXXXX").
שורה 11: ההנחיה "event" ב-gtag תשלח אירוע. בקטעי קוד שכוללים מספר הנחיות "config" עבור מספר נכסים, האירוע יישלח אל כל הנכסים.
בדוגמה הזו, הפרמטר "sign_up" הוא שם האירוע. הפרמטר האחרון הוא אובייקט שמכיל קבוצה של פרמטרי אירועים. במקרה זה, "method" הוא פרמטר עם הערך "email".
שורה 13: לאירוע הזה יש פרמטר בשם "send_to". זהו פרמטר מיוחד ששולח את האירוע המשויך לנכס ספציפי. במילים אחרות, האירוע הזה יישלח רק לנכס שצוין על-ידי <Some Property ID B>.
הפקודה config ב-gtag מאפשרת מדידה בסיסית.
- עבור נכס Universal Analytics, ההנחיה "config" עם מזהה של נכס Universal Analytics שולחת היט של צפייה בדף.
- עבור נכס Google Analytics 4, ההנחיה "config" עם מזהה תג מאפשרת לאסוף אירועי page_view (כאירוע שנאסף באופן אוטומטי) כשהוא נטען בדף.
מזהי נכסים
פורמט מזהי הנכסים של Universal Analytics הוא "UA-XXXXXXXX". מזהה זה נקרא לפעמים 'מזהה לצורכי מעקב'. במדריך זה הוא נקרא מזהה נכס UA.
מקורות נתוני אתר של נכסי Google Analytics 4 משתמשים במזהה תג בפורמט "G-XXXXXXXX".
בדוגמאות קוד מסוימות ובחלק מחומרי התיעוד ייתכן ששניהם ייקראו "TAG_ID".
איסוף נתונים בסיסי
הפעלה של איסוף נתונים בסיסי בנכס Google Analytics 4 מאפשרת לאסוף את הנתונים הבאים:
- אירועי page_view
- אירועים שנאספים באופן אוטומטי
- אירועי מדידה משופרת (אם הם מופעלים בממשק המשתמש)
אם הגדרתם בנכס Universal Analytics הקיים הטמעה של gtag.js, אתם יכולים להפעיל איסוף נתונים בסיסי לנכס Google Analytics 4 בשתי שיטות:
- אפשרות 1: הוספה של הנחיית "config" חדשה עם מזהה התג הרלוונטי
או - אפשרות 2: הפעלה של תגי אתר מחוברים (אם ההטמעה הקיימת של gtag.js עומדת בקריטריונים)
ללא קשר לאפשרות שבה תבחרו, נכס Universal Analytics הקיים לא יושפע, וימשיך לאסוף נתונים.
אפשרות 1: הוספה של הנחיית "config" חדשה
אם יש בדף קוד gtag.js, כל מה שצריך לעשות הוא להוסיף עוד הנחיית "config" עם מזהה המדידה של הנכס הרלוונטי מסוג Google Analytics 4. בדוגמה הבאה, השורה 8 נוספה אל הטמעת gtag.js קיימת. מצוין בה מזהה המדידה של הנכס מסוג Google Analytics 4. פקודה זו תשלח אירועי page_view לנכס Google Analytics 4 הזה. היא גם מאפשרת איסוף אוטומטי של אירועים ואירועי מדידה משופרת (אם הפעלתם מדידה משופרת) בנכס Google Analytics 4 הזה.ֺ1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Some Property ID A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
אפשרות 2: הפעלה של תגי אתרים מחוברים
תוכלו להשתמש בתג אתר מחובר אם:
- קטע קוד gtag.js שקיים בדף שבו רוצים למדוד את האינטראקציות של המשתמשים "נשלט" על-ידי נכס Universal Analytics (כלומר, המזהה המצוין בשורה זו של קטע קוד gtag.js מתחיל עם "UA-"):
<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
(תגי אתר מחוברים יפעלו גם אם קטע קוד gtag.js הקיים נשלט על-ידי נכס Google Analytics 4. עם זאת, תיתקלו במצב הזה רק אם כבר הוטמע נכס Google Analytics 4).
- וגם יש לכם הרשאת אדמין אל הנכס ב-Universal Analytics שמצוין במזהה שבקטע הקוד.
הגדרות התצורה של gtag.js
אתם יכולים לקבוע את התצורה של קטע הקוד הבסיסי של gtag.js כדי לשלוט בהגדרות של איסוף נתונים, כמו אנונימיזציה של כתובות IP, התאמה אישית של קובצי cookie ו-Google Signals. ניתן לעשות זאת בעזרת הנחיות "config" או "set" ב-gtag.js.
ההטמעה של הגדרות config האלה בעזרת gtag.js נתמכת גם בנכסי Universal Analytics ("UA-XXXXXXXX") וגם בנכסי Google Analytics 4 ("G-XXXXXXXX"). עם זאת, יש כמה הבדלים בהגדרות האלה עבור Universal Analytics ועבור נכסי Google Analytics 4.
- אנונימיזציה של כתובות IP קבועה כ-"true" ולא ניתן להגדיר את התצורה שלה בנכס Google Analytics 4. מסיבה זו, המערכת מבצעת באופן אוטומטי אנונימיזציה של כתובת ה-IP עם האירוע הסטנדרטי בנכס Google Analytics 4 ("G-XXXXXXXX").
- כשצריך להחיל הגדרות גלובליות על כל הנכסים שהתצורה שלהם נקבעה, יש להשתמש בפקודה "set" כדי להחיל את כל מזהי המדידה ו/או מזהי הנכסים, כולל אלה המוטמעים באמצעות תגי אתר מחוברים.
- יש לשים לב במיוחד לתכונות מסוג 'השבתת התאמה אישית של מודעות'. ברוב המקרים הן מוטמעות באמצעות שורת "config".
- כשמשתמשים בתגי אתרים מחוברים: כל ההגדרות שנקבעו בקוד gtag.js באמצעות "config" חלות רק על הנכס המשויך למזהה המדידה שמצוין בשורת הקוד הזו; הן לא יישלחו באופן אוטומטי לנכס Google Analytics 4 המקושר. אם אתם רוצים שההגדרה תחול על נכס Google Analytics 4 המקושר,
- צרו הנחיית "config" נפרדת וציינו בה את מזהה המדידה כדי להחיל אותה על נכס Google Analytics 4 הרלוונטי
או - קבעו את ההגדרה באמצעות הנחיית "set". במקרה כזה ההגדרה תחול על כל הנכסים שהוגדרו.
- צרו הנחיית "config" נפרדת וציינו בה את מזהה המדידה כדי להחיל אותה על נכס Google Analytics 4 הרלוונטי
תצורות לדוגמה
הפעלה של איסוף נתונים בסיסי; קביעת תצורה של User-ID
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
קביעת תצורה של קובצי cookie
gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
אירועים
יש לעיין במדריך להעברת אירועים.
מאפיינים ומדדים מותאמים אישית
מאפיינים ומדדים מותאמים אישית יכולים לשמש להרחבת המידע ולייבוא נתונים אופליין – לדוגמה, ממערכות לניהול קשרי לקוחות (CRM).
כאשר המאפיינים והמדדים המותאמים אישית עושים שימוש ב-Google Tag (gtag.js), המדידות שלהם יתורגמו באופן אוטומטי לפרמטרים, אם נעשה שימוש בתגי אתר מחוברים או בנכס Google Analytics 4 (למשל, "G-XXXXXXXX").
מידע נוסף על מאפיינים ומדדים מותאמים אישית