מסחר אלקטרוני ב-GA4 (Tag Manager): שליחת אירועי GA4

במדריך הזה נסביר איך לעדכן הטמעה קיימת של מסחר אלקטרוני ב-Universal Analytics (Tag Manager) כך שתתבצע שימוש באירועי מסחר אלקטרוני ב-Google Analytics 4.

במרכז ההעברה למפתחים תוכלו למצוא מדריכים ומשאבים נוספים להעברה.

תוצאה

כתוצאה מהיישום המדריך הזה, ההטמעה הקיימת של Universal Analytics תעודכן כך שתשתמש באירועים ובפרמטרים של מסחר אלקטרוני ב-GA4. ההטמעה המעודכנת הזו של מסחר אלקטרוני תשמש גם לשליחת נתוני מסחר אלקטרוני לנכס GA4 חדש. דוחות המסחר האלקטרוני ב-UA ימשיכו להתמלא בנתונים ותתחילו לקבל נתונים בנכס Google Analytics 4 החדש.

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

  1. מומלץ להשתמש בכלי כלי העזר להעברת מסחר אלקטרוני כדי לוודא שהמידע הבא מתאר את ההטמעה הנוכחית שלכם:

    • נעשה שימוש בנכס Universal Analytics
    • האתר שלכם משתמש ב-Tag Manager ומשתמש בשכבת הנתונים כדי לשלוח אירועי מסחר אלקטרוני
  2. במאמר אפשרויות העברה להטמעות של מסחר אלקטרוני תוכלו למצוא מידע על היתרונות של כל אפשרות. ודאו שאתם אכן מעוניינים לפעול לפי המדריך הזה, כדי להשתמש באירועי מסחר אלקטרוני ב-Google Analytics 4 להטמעה הקיימת של Universal Analytics.

  3. בחומר העזר בנושא תאימות לאירועים מוסבר איך אירועי UA מתורגמים כשהם נשלחים לנכס GA4.

פשרות ושיקולים

כדאי לעיין במידע שבהמשך כדי להבין בצורה מלאה את ההשלכות של השימוש באירועי מסחר אלקטרוני ב-Google Analytics 4 עם ההטמעה הקיימת של המסחר האלקטרוני ב-Universal Analytics (Tag Manager).

יתרונות חסרונות
  • מאפשר לראות נתוני מסחר אלקטרוני גם בדוחות של GA4 וגם בדוחות של Universal Analytics.
  • השימוש באירועים ובפרמטרים של GA4 מבטיח שדוחות המסחר האלקטרוני ב-GA4 יהיו מלאים.
  • כדי להציג את המדד הזה צריך לשנות את אירועי המסחר האלקטרוני הקיימים.
  • לא לכל האירועים והפרמטרים של GA4 יש מקבילים ב-Universal Analytics. לפרמטרים shipping_tier, discount, currency, location_id, promotion_name ו-promotion_id אין פרמטרים מקבילים ב-Universal Analytics והם לא יופיעו בדוחות של Universal Analytics.

הטמעה

אחד מהיעדים העיקריים של ההטמעה הוא לעבור משימוש בשכבת הנתונים לשימוש ב-gtag.js API. כדי לוודא שאין הפרעות במדידה בזמן המעבר, לפי ההוראות שבהמשך מומלץ להשלים קודם את כל העדכונים של הגדרת התג, ואחריהם עדכונים בשכבת הנתונים.

1. יצירה והגדרה של נכס GA4 חדש

כדי ליצור ולהגדיר נכס Google Analytics 4 חדש:

  1. יוצרים נכס Google Analytics 4 חדש.
    • אפשר להשתמש בכלי ההגדרה של GA4 כדי ליצור באופן אוטומטי נכס GA4 חדש ולהעתיק את ההגדרות הבאות מנכס Universal Analytics: שם הנכס, כתובת האתר, אזור הזמן והגדרות המטבע. עם זאת, מבטלים את הסימון של האפשרות הפעלת איסוף נתונים באמצעות התגים הקיימים כדי להשבית את התכונה של תג האתר המחובר. לחלופין, אם אתם לא רוצים להעתיק הגדרות מנכס Universal Analytics, יוצרים נכס Google Analytics 4 בלי הכלי להגדרת GA4.
  2. מוסיפים את Google Tag.
    1. פותחים את מאגר התגים של Google Tag Manager עבור ההטמעה הקיימת של Universal Analytics.
    2. לוחצים על תגים > חדש.
    3. לוחצים על Tag Configuration (הגדרת התג) ובוחרים באפשרות Google Tag.
    4. מזינים את מזהה התג של נכס Google Analytics 4.
    5. בוחרים להפעיל את התג ב'כל הדפים' (או בקבוצת המשנה של הדפים שרוצים למדוד).
    6. שומרים ומפרסמים את הגדרת התג.

2. הוספת הגדרה של תג מעקב אירועים של GA4 כדי למדוד אירועי מסחר אלקטרוני

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

  1. יוצרים הגדרת תג חדשה ובוחרים באפשרות אירוע GA4.
  2. ב-Event Name, משתמשים במשתנה המובנה . ייעשה שימוש בשם אירוע המסחר האלקטרוני ב-GA4 שנשלח באמצעות gtag.js API.
  3. בקטע More Settings (הגדרות נוספות) ואז על Ecommerce (מסחר אלקטרוני), מסמנים את האפשרות Send ecommerce data (שליחת נתוני מסחר אלקטרוני).
  4. בקטע מקור נתונים, בוחרים באפשרות שכבת נתונים.
  5. לוחצים על שמירה. טריגרים יתווספו בשלבים מאוחרים יותר, כך שתוכלו להתעלם בבטחה מאזהרות לגבי טריגרים חסרים.

3. צריך לעדכן את ההגדרות של תג המסחר האלקטרוני ב-UA כדי להשתמש באירועים של GA4

בכל הגדרה של תג מסחר אלקטרוני ב-Universal Analytics, צריך להוסיף טריגר להפעלה באירוע המסחר האלקטרוני המקביל ב-GA4, ולהפעיל את האפשרות לקרוא נתונים של אירועי מסחר אלקטרוני ב-GA4.

לגבי כל אירוע מסחר אלקטרוני ב-Universal Analytics, יש לבצע את השלבים הכלליים שיש לבצע כדי לעדכן לאירוע GA4 המתאים:

  1. אם מדובר באירוע המסחר האלקטרוני ב-UA שאתם רוצים לעדכן, צריך להשתמש במידע שזמין בטבלאות תאימות בין אירועים ב-UA וב-GA4 ובטבלאות פרמטרים להשוואה עבור UA ו-GA4 ו/או בכלי העזר להעברת מסחר אלקטרוני כדי לזהות את שם האירוע המתאים ב-GA4. לדוגמה, אם מעדכנים אירוע כדי למדוד קליקים על מוצרים, שם האירוע ב-GA4 יהיה select_item.
  2. מעדכנים את תצורת התג ב-Universal Analytics עבור האירוע:
    1. בקטע More Settings (הגדרות נוספות) ואז על Ecommerce (מסחר אלקטרוני), מסמנים את האפשרות Use GA4 schema (שימוש בסכימת GA4) כדי לוודא שהתגים הקיימים קוראים בצורה נכונה את אירוע המסחר האלקטרוני המעודכן ב-GA4. מותר לבצע את השינוי הזה לפני המעבר משכבת הנתונים ל-API של gtag.js.
    2. בקטע Triggering, מוסיפים טריגר חדש מסוג Custom Event, שבו Event Name הוא אירוע המסחר האלקטרוני ב-GA4 שזוהה למעלה. אחרי שתשלימו את השלב הזה, אמורים להיות לכם לפחות 2 טריגרים: הטריגר המקורי שהפעיל את התג והטריגר החדש שנוסף, שיפעל בסופו של דבר אחרי שתשלימו את המעבר לאירועי GA4. הטריגר הנוסף נועד לוודא שאין שיבושים בנתונים כשעוברים משכבת הנתונים ל-gtag.js API, כפי שמתואר בהמשך המסמך.
    3. שומרים את השינויים.
  3. מוסיפים את הטריגר החדש לתג 'אירוע GA4':
    1. פותחים את התג GA4 Event שהגדרתם בעבר לשליחת אירועי מסחר אלקטרוני ופרמטרים לנכס GA4.
    2. בקטע Triggering, מוסיפים את הטריגר Custom Event שנוצר למעלה (למשל select_item), כדי להבטיח שתג מעקב האירועים ב-GA4 יופעל בהקשר של פעילות המסחר האלקטרוני המשויכת אחרי המעבר לאירועי GA4.
    3. שומרים את השינויים.
  4. חוזרים על השלבים שלמעלה לכל פעילות של מסחר אלקטרוני ב-Universal Analytics. בסיום, מפרסמים את השינויים ב-Tag Manager.

4. הפעלת gtag.js API

כדי לעדכן את הטמעת המסחר האלקטרוני מ-UA ל-GA4, מומלץ לעבור משימוש בשכבת הנתונים לשימוש ב-gtag.js API, שפועל בתיאום עם Tag Manager.

כדי להפעיל את gtag.js API, צריך להוסיף את קטע הקוד הבא לחלק העליון של הדף, מעל לקטע הקוד של מאגר התגים ב-Tag Manager:

<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
</script>

5. מעבר משימוש בשכבת הנתונים לשימוש ב-gtag.js

אחרי שתסיימו את כל העדכונים של הגדרת התגים ותפעילו את gtag.js API, תוכלו לעבור משימוש בשכבת הנתונים לשימוש ב-gtag.js API.

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

  • במדריך למפתחים בנושא מסחר אלקטרוני (GA4) מוסבר איך לשלוח אירועי מסחר אלקטרוני ב-GA4 באמצעות gtag.js API, ולהגדיר את התג והמפעילים של אירוע GA4 ב-Tag Manager.
  • בעזרת הטבלה תאימות בין אירועים ב-UA וב-GA4 תוכלו למצוא את השם המתאים של אירוע GA4 לפעילות מסחר אלקטרוני ב-Universal Analytics. לדוגמה, אם מעדכנים אירוע כדי למדוד חשיפות של מוצרים, שם האירוע ב-GA4 יהיה view_item_list.
  • בעזרת הטבלה פרמטרים להשוואה ב-UA וב-GA4 תוכלו למפות שמות של פרמטרים של מסחר אלקטרוני ב-UA לשמות מקבילים של פרמטרים של מסחר אלקטרוני ב-GA4.
  • כלי העזר להעברת מסחר אלקטרוני כדי לוודא שעדכנתם בצורה נכונה את אירועי המסחר האלקטרוני.

בהמשך מפורטים השלבים הכלליים למעבר משימוש ב-dataLayer.push() API עם אירועי מסחר אלקטרוני ב-UA לכל אירוע של מסחר אלקטרוני ב-Universal Analytics אל השימוש ב-gtag.js API עם אירוע המסחר האלקטרוני התואם ב-GA4:

  1. מעדכנים שמות של אירועים מותאמים אישית עם השם המתאים של האירוע ב-GA4. לדוגמה, אם מעדכנים אירוע כדי למדוד קליק על מוצר שמשתמש בשם האירוע המותאם אישית productClick, שם האירוע המעודכן של GA4 יהיה select_item. שם האירוע ב-GA4 חייב להיות זהה לשם האירוע של טריגר שהגדרתם קודם.

    לדוגמה, האירוע הבא של קליק על מוצר שמשתמש בשכבת הנתונים

    dataLayer.push({'event': 'productClick', 'ecommerce': {<ecommerce_parameters>}});
    

    כאשר עוברים ל-gtag.js API:

    gtag('event', 'select_item', {<ecommerce_parameters>});
    
  2. מעדכנים את הפרמטרים של המסחר האלקטרוני בהתאם לציפיות הצפויות באירוע GA4. חשוב להשתמש בפרמטרים דומים ל-UA ול-GA4 כי בוצעו שינויים בשמות הפרמטרים. מאכלסים את ערך הפרמטר של GA4 בערך הפרמטר של UA התואם.

דוגמה: עדכון אירוע UA ל-GA4

הדוגמה הבאה מראה איך ליצור אירוע GA4 מקביל לפעילות מסחר אלקטרוני מסוג קליק על מוצר שמוטמעת ב-Tag Manager עבור Universal Analytics.

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

ההגדרה הבאה של מדידה של קליק על מוצר ב-Universal Analytics מוטמעת באמצעות שכבת הנתונים. השם של האירוע בהתאמה האישית הוא productClick.

<script>
/**
 * Call this function when a user clicks on a product link. This function uses the event
 * callback datalayer variable to handle navigation after the ecommerce data has been sent
 * to Google Analytics.
 * @param {Object} productObj An object representing a product.
 */
function(productObj) {
  dataLayer.push({
    'event': 'productClick',
    'ecommerce': {
      'click': {
        'actionField': {'list': 'Search Results'},      // Optional list property.
        'products': [{
          'name': productObj.name,                      // Name or ID is required.
          'id': productObj.id,
          'price': productObj.price,
          'brand': productObj.brand,
          'category': productObj.cat,
          'variant': productObj.variant,
          'position': productObj.position
         }]
       }
     },
     'eventCallback': function() {
       document.location = productObj.url
     }
  });
}
</script>

ב-Tag Manager, ההגדרה של תגי Universal Analytics תהיה כך:

סוג תג : Universal Analytics
סוג מעקב : אירוע
קטגוריית אירוע: Ecommerce
פעולת אירוע: Product Click
הפעלת תכונות של מסחר אלקטרוני משופר: true
שימוש בשכבת נתונים: true
טריגר: event שווה productClick

הגדרה של תג Universal Analytics לקליק על מוצר

הגדרת הטריגר מוגדרת להפעיל את התג כשהאירוע productClick מועבר לשכבת הנתונים:

הגדרת טריגר לאירוע המותאם אישית productClick

אחרי: שליחת אירועי GA4 באמצעות gtag.js

עדכונים לגבי הגדרות תגים ב-UA

ב-Tag Manager, ההגדרה של תג Universal Analytics מתעדכנת כך שהאירוע קליק על מוצר יופעל בשם האירוע של GA4, והאפשרות שימוש בסכימת GA4 מופעלת. אלה ההגדרות של התג:

סוג התג : Universal Analytics
סוג מעקב : אירוע
קטגוריית אירוע: Ecommerce
פעולת אירוע: Product Click
הפעלת תכונות של מסחר אלקטרוני משופר: true
שימוש בשכבת נתונים: true
שימוש בסכימת GA4: true
טריגר מס' 1: event שווה productClick
טריגר מס' 2: event שווה select_item

הגדרה של תג Universal Analytics באמצעות GA4 עבור קליק על מוצר

הגדרת הטריגר של הטריגר החדש Custom Event מוגדרת להפעיל את התג ב-select_item Event name:

הגדרת טריגר לאירוע select_item

עדכונים בהגדרות של תגים ב-GA4

אירוע GA4 מוגדר למדידה של פעילויות של מסחר אלקטרוני שהוטמעו באמצעות אירועים ופרמטרים של GA4. התג משתמש במשתנה Event המובנה כדי להעביר עם שם האירוע ל-GA4. אותו טריגר שנוצר עבור תג UA (כלומר select_item) משמש להפעלת תג GA4.

הגדרה של תג מעקב אירועים ב-GA4 לפעילויות מרובות של מסחר אלקטרוני

מעבר משימוש בשכבת הנתונים לשימוש ב-gtag.js

למטה מוצג איך הטמעת UA שלמעלה עוברת משימוש באירוע המותאם אישית productClick עם ה-API dataLayer.push(), לאירוע select_item של GA4 עם ממשק ה-API של gtag.js. ערכי הפרמטרים של select_item מוגדרים בהתאם.

<script>
/**
 * Call this function when a user clicks on a product link.
 * @param {Object} productObj An object representing a product.
 */
function(productObj) {
  gtag('event', 'select_item', {
    'items': [{
      'item_id': productObj.id,
      'item_name': productObj.name,
      'index': productObj.position,
      'item_list_name': 'Search Results',
      'item_brand': productObj.brand,
      'item_category': productObj.cat,
      'item_variant': productObj.variant,
      'price': productObj.price
    }]
  });
}
</script>