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

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

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

בדף הזה מוסבר איך:

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

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

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

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

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

מה זה מזהה תג ואיפה הוא נמצא? מזהה התג או מזהה מאגר התגים מציין את מאגר התגים של Google Tag Manager או את הגדרת היעד ב-Google שנטענים על ידי קטע הקוד של Google Tag. בהתקנות חדשות, מזהה מאגר התגים של Google Tag Manager‏ (GTM-) משמש כברירת מחדל, ומזהים ספציפיים ליעד משמשים לזיהוי מוצרים ספציפיים של Google. בטבלה הבאה מפורטות התחיליות הנתמכות של המזהים:
תחילית סוג המזהה תיאור
GTM-XXXXXX מזהה מאגר התגים ב-Google Tag Manager (ברירת מחדל) מזהה ברירת המחדל של מאגרי התגים ב-Google Tag Manager. תומך בכל התגים של Google, של צדדים שלישיים ובהתאמה אישית.
G-XXXXXX מזהה ספציפי ליעד מזהה יעד ב-Google Analytics (מזהה מדידה).
AW-XXXXXX מזהה ספציפי ליעד מזהה יעד מודעה ב-Google Ads (מזהה המרה).
DC-XXXXXX מזהה ספציפי ליעד מזהה יעד ב-Floodlight (מזהה מפרסם).
MC-XXXXXX מזהה ספציפי ליעד מזהה יעד ב-Google Merchant Center.
GT-XXXXXX מזהה Google Tag מזהה Google Tag שנוצר בגרסאות קודמות.

איך מוצאים את מזהה התג:

שלב 1: מקשרים מוצרי Google לתג

משתמשים בפקודה 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 ו-Google Analytics.

בדוגמה הבאה אפשר לראות איך לעדכן את הקוד כדי לטעון 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 להפעיל אירוע צפייה בדף.

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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה

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

<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: בודקים את הטבלה Conversion actions (פעולות המרה) ומסתכלים על העמודה Status (סטטוס) (יכול להיות שיעברו עד 24 שעות לפני שהיא תתעדכן).
    • ‫Floodlight: משתמשים ב-Tag Assistant כדי לוודא שתגי Floodlight מופעלים.

השלבים הבאים

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

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