מסמך עזר בנושא תאימות ותרגום של אירועי מסחר אלקטרוני (gtag.js)

במאמר הזה מתוארות תאימות ותרגום של אירועי מסחר אלקטרוני בין Universal Analytics (UA) לבין Google Analytics 4 (GA4).

רקע

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

מטרה

תרגום של אירועי מסחר אלקטרוני ב-UA וב-GA4 עוזר לכם:

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

הפתעות

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

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

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

הסבר על התרגום

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

פרמטרים להשוואה ב-UA וב-GA4

בטבלה הבאה מוצגים פרמטרים דומים של מסחר אלקטרוני ל-Universal Analytics ול-Google Analytics 4.

הערה: תא ריק בטבלה מציין שאין פרמטר דומה.

שם הפרמטר של Universal Analytics	שם הפרמטר ב-Google Analytics 4	הערות
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	כששולחים אירוע UA לנכס GA4, ערך המטבע הזה ישמש עבור הפרמטר items[].currency של GA4.
	location_id
	payment_type
shipping	shipping
shipping_tier
tax	tax
transaction_id	transaction_id
value	value
items[]	items[]
items[].name	items[].item_name
items[].id	items[].item_id
	items[].affiliation
items[].brand	items[].item_brand
items[].category	items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5	הקטגוריה של הפריט. אפשר לציין עד 5 רמות של היררכיה. במאמר תרגום פרמטרים של קטגוריה יש פרטים נוספים על אופן הטיפול בתרגום קטגוריות בין אירועים ב-UA וב-GA4.
	items[].currency
items[].coupon	items[].coupon
	items[].discount
items[].list_name	items[].item_list_name
items[].list_position	items[].index
	items[].location_id
items[].price	items[].price
items[].quantity	items[].quantity
items[].variant	items[].item_variant
promotions[]		עבור GA4, נעשה שימוש בפרמטר items[] עם פרמטרים ספציפיים לקידום כמו items[].promotion_id.
promotions[].id	items[].promotion_id	הפרמטרים האלה לא מתורגמים כששולחים אירוע UA אל GA4 או להפך.
promotions[].name	items[].promotion_name	הפרמטרים האלה לא מתורגמים כששולחים אירוע UA אל GA4 או להפך.
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	הפרמטרים האלה לא מתורגמים כששולחים אירוע UA אל GA4 או להפך.

תרגום פרמטרים של קטגוריה

תרגום של פרמטר הקטגוריה מטופל כמקרה מיוחד כששולחים אירועי GA4 ל-UA או להפך.

ב-Universal Analytics, כשמגדירים את הפרמטר items[].category, משתמשים ב-/ כתו מפריד כדי לציין עד חמש רמות היררכיה. ב-Google Analytics 4, משתמשים בפרמטרים של קטגוריות כדי לציין עד חמש רמות של היררכיה: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4 ו-items[].item_category5.

כך יתבצע תרגום של קטגוריה:

• באירועים של GA4 שתורגמו ל-UA, הקטגוריות שצוינו ישולבו לפרמטר category יחיד, וכל קטגוריה מופרדת באמצעות /.
• באירועים ב-UA שתורגמו ל-GA4, הערך של פרמטר הקטגוריה יפוצל כדי לאכלס את הקטגוריות המתאימות שצוינו ב-GA4.
• אם אתם מתכוונים לשלוח אירועי GA4 ל-UA, מומלץ לא להשתמש בתו / בערכי הקטגוריות, כי זה יפורש כתו מפריד בין קטגוריות בתרגום ל-UA.
• המערכת תשתמש רק ב-5 רמות הקטגוריות הראשונות, לא משנה כמה הוגדרו.

דוגמה לתרגום קטגוריה

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

אירוע UA עם קטגוריה שמגדירה 5 רמות היררכיה:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

האירוע ב-UA שתורגם לאירוע של GA4, עם סיכום הקטגוריות:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

תאימות בין אירועים ב-UA וב-GA4

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

עבור כל שורה בטבלה, כל עמודה מספקת את המידע הבא:

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

אירוע של UA	אירוע GA4	פרמטרים	התנהגות התרגום (שליחת UA אל GA4)	התנהגות התרגום (שליחת GA4 ל-UA)
view_item_list	view_item_list	ב-GA4 בלבד: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים. פרמטרים של GA4 בלבד לא נשלחים. המערכת מתעלמת מהפרמטר item_list_name ברמת האירוע. יישלח רק item_list_name ברמת הפריט. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו.
select_content (items)	select_item	ב-GA4 בלבד: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id UA בלבד: content_type	לא תואם. אירועים מותאמים אישית מסוג select_content ופרמטר מותאם אישית content_type נשלחים. לא נשלחים נתוני items.	לא תואם. היט אירוע של UA נשלח עם General בתור event_category ו-select_item בתור event_action. לא נשלחים נתוני items.
select_content (promotions)	select_promotion	ב-GA4 בלבד: creative_name creative_slot location_id promotion_id promotion_name items UA בלבד: content_type promotions	לא תואם. אירוע select_content בהתאמה אישית נשלח עם content_type ו-promotions בתור פרמטרים מותאמים אישית. הפרמטר המותאם אישית promotions לא מכיל נתונים שימושיים.	לא תואם. היט אירוע של UA נשלח עם כללי בתור event_category ו-select_promotion בתור event_action. לא נשלחים נתוני promotions.
view_item	view_item	ב-GA4 בלבד: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים. יוצא הדופן הוא item_list_name, שלא נשלח. מתוך הפרמטרים GA4 בלבד, הערכים currency ו-value נשלחים עם ההתאמה בתור currency ו- הכנסה מעסקאות, בהתאמה. event_value גם מוגדר לפרמטר value, כמספר שלם. חשוב לשים לב שהתרגום מ-GA4 ל-UA כולל event_value, אבל בדרך כלל ההגדרה הזו לא מוגדרת להיטים של UA. דוחות UA שכוללים נתונים מ-GA4 יהיו ברובם מלאים או לא ישתנו. יש לציין את השם של רשימת הפריטים.
add_to_wishlist* *נתוני items לא נתמכים ב-UA.	add_to_wishlist	ב-GA4 בלבד: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. היט אירוע מקביל נשלח עם ecommerce בתור event_category, add_to_wishlist בתור event_action והפרמטר value כ-event_value. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו. האירוע הזה לא נתמך באופן כללי בדוחות המסחר האלקטרוני ב-UA, ולכן לא תהיה לו כל השפעה יוצאת דופן.
add_to_cart	add_to_cart	ב-GA4 בלבד: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים.* פרמטרים של GA4 בלבד לא נשלחים. *item_list_name לא נשלח, אבל ההתנהגות הזו תואמת ל-gtag.js (UA), שאינו שולח list_name. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו.
remove_from_cart	remove_from_cart	ב-GA4 בלבד: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים.* פרמטרים של GA4 בלבד לא נשלחים. *item_list_name לא נשלח, אבל ההתנהגות הזו תואמת ל-gtag.js (UA), שלא שולח list_name. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו.
לא רלוונטי	view_cart	מומלץ להשתמש באירוע רק ב-GA4.	לא תואמת*. *לא סביר להניח שהאירוע הזה נשלח על ידי הטמעת UA כי זה לא אירוע מומלץ. כדי לוודא שהדוחות של GA4 יהיו מלאים, אפשר להטמיע את האירוע הזה ב-UA באמצעות פורמט GA4. אם תטמיעו את אירוע GA4 עבור UA, הוא יופיע כאירוע בלי נתוני items, ויכול להיות שזה לא יהיה מועיל במיוחד. היא לא תשפיע על דיווח המסחר האלקטרוני ב-UA.	לא תואמת. היט אירוע נשלח עם General בתור event_category, view_cart בתור event_action והפרמטר value כ-event_value. הנתונים של items לא נשלחו. האירוע הזה לא נתמך באופן כללי בדוחות המסחר האלקטרוני ב-UA, ולכן לא תהיה לו כל השפעה יוצאת דופן.
begin_checkout	begin_checkout	ב-GA4 בלבד: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים.* פרמטרים של GA4 בלבד לא נשלחים. *item_list_name לא נשלח, אבל ההתנהגות הזו תואמת ל-gtag.js (UA), שלא שולח list_name. הפונקציה begin_checkout מקבילה בפועל לשליחת אירוע checkout_progress שבו checkout_step מוגדר כ-1. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו.
add_payment_info	add_payment_info	ב-GA4 בלבד: currency value coupon payment_type items UA: לא רלוונטי: פרמטרים לא נתמכים.	לא תואמת*. *מערכת UA לא תומכת בפרמטרים עבור האירוע הזה, ולכן אף אחד מהם לא נשלח. זה יעבוד אבל כנראה לא יהיה מועיל במיוחד. דוחות GA4 שמחייבים פרמטרים של אירועים יהיו חלקיים.	תאימות. היט אירוע מקביל נשלח עם ecommerce בתור event_category, add_to_wishlist בתור event_action, והפרמטר value (משודר למספר שלם) כ-event_value. חשוב לשים לב שהתרגום מ-GA4 ל-UA כולל event_value, אבל בדרך כלל ההגדרה הזו לא מוגדרת להיטים של UA. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו. האירוע הזה לא נתמך באופן כללי בדוחות המסחר האלקטרוני ב-UA, ולכן לא תהיה לו כל השפעה יוצאת דופן.
לא רלוונטי	add_shipping_info	מומלץ להשתמש באירוע רק ב-GA4.	לא תואמת*. *לא סביר להניח שהאירוע הזה נשלח על ידי הטמעת UA כי זה לא אירוע מומלץ. כדי לוודא שהדוחות של GA4 יהיו מלאים, אפשר להטמיע את האירוע הזה ב-UA באמצעות פורמט GA4. אם תטמיעו את אירוע GA4 עבור UA, הוא יופיע כאירוע בלי נתוני items, ויכול להיות שזה לא יהיה מועיל במיוחד. היא לא תשפיע על דיווח המסחר האלקטרוני ב-UA.	לא תואמת*. היט אירוע נשלח עם General בתור event_category, add_shipping_info בתור event_action והפרמטר value (העברה למספר שלם) בתור event_value. הפרמטר currency של GA4 נשלח עם ההתאמה בתור currency. האירוע הזה לא נתמך באופן כללי בדוחות המסחר האלקטרוני ב-UA, ולכן לא תהיה לו כל השפעה יוצאת דופן.
checkout_progress set_checkout_option	לא רלוונטי	מומלץ להשתמש באירועים רק ב-UA.	האירוע יתייחס לאירוע כ אירוע מותאם אישית. רק פרמטרים ברמת האירוע יישלחו, ולא יישלחו נתוני items. האירועים האלה לא נתמכים בדרך כלל בדוחות המסחר האלקטרוני ב-GA4, ולכן לא תהיה להם השפעה יוצאת דופן.	לא רלוונטי
view_promotion	view_promotion	ב-GA4 בלבד: creative_name creative_slot location_id promotion_id promotion_name items UA בלבד: promotions	לא תואם. אירוע view_promotion בהתאמה אישית נשלח עם promotions כפרמטר מותאם אישית. הפרמטר המותאם אישית promotions לא מכיל נתונים שימושיים.	לא תואם. היט אירוע של UA נשלח עם אינטראקציה בתור event_category ועם view_promotion בתור event_action. לא נשלחים נתוני promotions. האירוע יסומן כ אירוע ללא אינטראקציה.
purchase	purchase	ב-GA4 בלבד: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. נעשה שימוש ב-currency ברמת האירוע כי אין תמיכה ב-currency ברמת הפריט. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים.* פרמטרים של GA4 בלבד לא נשלחים. *item_list_name לא נשלח, אבל ההתנהגות הזו תואמת ל-gtag.js (UA), שלא שולח list_name. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו.
refund	refund	ב-GA4 בלבד: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	תאימות. כל הפרמטרים של UA מתורגמים לפרמטרים שווי ערך ב-GA4 ונשלחים. נעשה שימוש ב-currency ברמת האירוע כי אין תמיכה ב-currency ברמת הפריט. דוחות GA4 שדורשים פרמטרים של GA4 בלבד יהיו חלקיים.	תאימות. פרמטרים של GA4 עם פרמטר UA מקביל מתורגמים ונשלחים.* פרמטרים של GA4 בלבד לא נשלחים. *item_list_name לא נשלח, אבל ההתנהגות הזו תואמת ל-gtag.js (UA), שלא שולח list_name. דוחות UA שאוכלסו בנתונים מאירוע GA4 יושלמו או לא ישתנו.