הגדרת מוצרי Google ושליחת נתוני אירועים

הדף הזה מיועד למפתחים שצריכים להגדיר את Google Tag באמצעות gtag.js. בנוסף, Google Tag מאפשר לכם לשנות חלק מההגדרות בממשק המשתמש. כאן מוסבר איך מגדירים את Google Tag.

אחרי שמתקינים את Google Tag, אפשר להפעיל פקודות של gtag() בכל מקום בקוד אחרי קוד התג של Google Tag.

בדף הזה נסביר איך:

  1. הגדרת זרימת נתונים בין האתר לבין מוצרי Google באמצעות הפקודה config
  2. שליחת אירועים למוצרי Google באמצעות הפקודה event
  3. הגדרת ערכים שנשלחים עם כל אירוע באמצעות הפקודה set

לפני שמתחילים

במדריך הזה אנחנו יוצאים מנקודת הנחה שביצעתם את הפעולות הבאות:

כדי להגדיר את זרימת הנתונים, צריך:

  • גישה לקוד האתר שבו הטמעתם את Google Tag
  • מזהה התג של מוצר Google שרוצים לקשר ל-Google Tag

מה זה מזהה תג ואיפה הוא נמצא? מזהה תג מזהה Google Tag. ל-Google Tag אחד יכולים להיות מספר מזהי תג. לדוגמה, אם אתם משתמשים ב-Google Ads, לתג שלכם יש עכשיו שני מזהים: מזהה מדור קודם (AW) ומזהה Google Tag‏ (GT). מסך שבו מוצג Google Tag ב-Google Ads עם שני מזהי תגים. מזהי התגים ניתנים להחלפה. בטבלה הבאה מוצגת סקירה כללית של התגים שתואמים ל-Google Tag.
תחילית סוג המזהה תיאור
‫GT-XXXXXX Google Tag לכל Google Tag חדש שנוצר מוקצה קידומת GT ומזהה ייחודי.
‫G-XXXXXX Google Tag (קידומת מדור קודם) תגי Google Analytics 4 הם תגי Google עם קידומת G ומזהה ייחודי.
AW-XXXXXX Google Tag (קידומת מדור קודם) תגי Google Ads הם Google Tags עם התחילית AW ומזהה ייחודי.
DC-XXXXXX Google Tag (קידומת מדור קודם) תגי Google Floodlight הם תגי Google עם קידומת DC ומזהה ייחודי.
תגי Universal Analytics ‏ (UA) לא תואמים ל-Google Tag ‏ (GT).

איך מאתרים את מזהה התג:

שלב 1: מקשרים את מוצרי Google ל-Tag

משתמשים בפקודה config כדי ליצור זרימת נתונים למוצרי Google.

מידע על הפקודה config

הפקודה config מציינת את מוצרי Google שאליהם רוצים לשלוח נתוני אירועים. הפורמט של הפקודה הוא:

gtag('config', 'TAG_ID', {<additional_config_params>});

פרמטרים נוספים להגדרה

אפשר לשנות ולהרחיב פקודה של config על ידי ציון פרמטרים באובייקט האופציונלי {<additional_config_params>}. לדוגמה, הוספת הפרמטר הבא תמנע שליחה אוטומטית של צפייה בדף ב-Google Analytics:

gtag('config', 'TAG_ID', {'send_page_view': false});

הגדרה של איסוף נתונים

כדי להגדיר איסוף נתונים למוצר של Google, מוסיפים את הפקודה config עם מזהה תג.

דוגמה

‫Google Tag ‏ (GT-XXXXXX) שולח נתונים ליעדים שהגדרתם לו, למשל Google Ads ו-GA4.

בדוגמה הבאה אפשר לראות איך מעדכנים את הקוד כדי לטעון Google Tag שני שמחובר ליעד Floodlight.

כדי לשלוח נתונים אל Floodlight (מזהה התג DC-ZZZZZZ), מוסיפים עוד פקודה config אחרי הפעלת Google Tag הראשון (מזהה התג GT-XXXXXX):

<head>
 ...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'GT-XXXXXX');
  gtag('config', 'DC-ZZZZZZ');
</script>
</head>

התנהגות ספציפית למוצר config

בהתאם למוצר שצוין ב-TAG_ID, הפקודה config עשויה גם להפעיל התנהגות מסוימת עבור המוצר הזה. לדוגמה, במקרים מסוימים הפקודה config אומרת ל-gtag.js להתחיל אירוע page_view.

כדי לקבל מידע נוסף על אופן הפעולה של הפקודה config ביחס למוצרים ספציפיים, אפשר לקרוא את מאמרי העזרה שקשורים למוצר:

שלב 2: שליחת נתונים באמצעות event

אחרי שמגדירים את החיבורים למוצרי Google, צריך להשתמש בפקודה event כדי לשלוח נתונים.

מידע על הפקודה event

הפקודה event מאפשרת לשלוח נתוני אירועים למוצרים שצוינו באמצעות config. הפורמט של הפקודה הוא:

gtag('event', 'event_name', {
  'key': 'value',
});

מידע על שמות של אירועים ועל צמדי מפתח/ערך

אירועים מומלצים: אירועים מומלצים הם אירועים שאתם מטמיעים, אבל יש להם צמדי מפתח/ערך מוגדרים מראש. אירועים מומלצים נותנים לכם גישה ליכולות דיווח קיימות ועתידיות.

אירועים מותאמים אישית: כדי להגדיר אירועים ומבני נתונים משלכם, אתם יכולים להזין ערכים מותאמים אישית כדי לשלוח אירוע מותאם אישית.

הגדרת אירועים

אפשר לקרוא לשיטה event בכל מקום בקוד אחרי שמפעילים את Google Tag.

  1. מגדירים אירוע. אם אתם משתמשים באירוע מומלץ, הקפידו להשתמש בשמות אירועים סטנדרטיים ובצמדי מפתח/ערך מוגדרים מראש.

  2. מגדירים מתי האירוע יופעל, למשל אם הוא יישלח עם טעינת דף או כשמישהו לוחץ על לחצן.

דוגמה

בדוגמה הבאה מוצגת אחת מהדרכים האפשריות למדוד הרשמות לניוזלטר כשמשתמש לוחץ על לחצן. בדוגמה נעשה שימוש באירוע מותאם אישית והוא נשלח לנכס Google Analytics 4.

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (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>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onclick="newsletterSignup()">Sign me up!</button>
   ...
</body>

אופציונלי: שולחים נתונים עם כל אירוע באמצעות set

הפקודה set מאפשרת להגדיר פרמטרים שישויכו לכל אירוע שיתרחש בהמשך בדף.

לדוגמה, אפשר לשתף פרמטרים של קמפיין כדי שכמה תגים באותו דף יוכלו לגשת אליהם.

הפורמט של הפקודה הוא:

gtag('set', 'parameterName');

שלב 3: מאמתים את ההגדרה

כדי לוודא שנתוני האירועים נשלחים בצורה תקינה:

  1. פותחים את מוצר Google שבו אמורים להופיע הנתונים.
  2. בודקים אם הנתונים מגיעים. לכל מוצר יש מקום אחר שבו אפשר לבדוק אם הנתונים מתקבלים:
    • ‫Google Analytics: בודקים את הדוח בזמן אמת.
    • ‫Google Ads: בודקים את הטבלה פעולות המרה ומסתכלים על העמודה סטטוס (יכול להיות שיחלפו עד 24 שעות עד שהסטטוס יתעדכן).
    • ‫Floodlight: משתמשים ב-Tag Assistant כדי לוודא שתגי Floodlight מופעלים.

השלבים הבאים

אחרי שמגדירים את מוצרי Google ואת האירועים, מסיימים את ההגדרה הבסיסית של Google Tag.

אם אתם מנהלים כמה מוצרים ורוצים לנהל את זרימת הנתונים שלהם בצורה מפורטת יותר, כדאי לעיין במאמר בנושא קיבוץ נתונים והעברתם.