מסחר אלקטרוני משופר

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

פעולות וסוגים של נתונים של מסחר אלקטרוני משופר

יש כמה סוגים של נתוני מסחר אלקטרוני שאפשר לשלוח:

נתוני חשיפות

מייצג מידע על המוצר שצפו בו. הוא נקרא impressionFieldObject ומכיל את הערכים הבאים:

מפתח סוג הערך חובה תיאור
id טקסט *כן

מזהה המוצר או המק"ט (למשל P67890).

* יש להגדיר את אחד מהערכים id או name.

name טקסט *כן

שם המוצר (למשל, טישרט של Android).

* יש להגדיר את אחד מהערכים id או name.

list טקסט לא הרשימה או האוסף שאליהם המוצר שייך (למשל, תוצאות חיפוש)
list_name טקסט לא הרשימה או האוסף שאליהם המוצר שייך (למשל, תוצאות חיפוש)
brand טקסט לא המותג המשויך למוצר (למשל, Google).
category טקסט לא הקטגוריה שאליה משתייך המוצר (למשל, 'ביגוד'). אפשר להשתמש במאפיין / כתו מפריד כדי לציין עד 5 רמות של היררכיה (למשל: ביגוד/גברים/חולצות טי).
variant טקסט לא הווריאציה של המוצר (למשל, שחור).
position מספר שלם לא מיקום המוצר ברשימה או באוסף (למשל 2).
list_position מספר שלם לא מיקום המוצר ברשימה או באוסף (למשל 2).
price number לא מחיר המוצר (למשל 29.20).

נתוני המוצר

נתוני מוצרים מייצגים מוצרים בודדים שנצפו, נוספו לעגלת הקניות וכו'. הם נקראים productFieldObject ומכילים את הערכים הבאים:

מפתח סוג הערך חובה תיאור
id טקסט *כן

מזהה המוצר או המק"ט (למשל P67890).

* יש להגדיר אחד מהמזהים או name.

name טקסט *כן

שם המוצר (למשל, טישרט של Android).

* יש להגדיר אחד מהמזהים או name.

brand טקסט לא המותג המשויך למוצר (למשל, Google).
category טקסט לא הקטגוריה שאליה משתייך המוצר (למשל, 'ביגוד'). אפשר להשתמש / כתו מפריד כדי לציין עד 5 רמות של היררכיה (למשל: ביגוד/גברים/חולצות טי).
variant טקסט לא הווריאציה של המוצר (למשל, שחור).
price number לא מחיר המוצר (למשל 29.20).
quantity מספר שלם לא כמות המוצר (למשל 2).
coupon טקסט לא קוד השובר המשויך למוצר (למשל SUMMER_SALE13).
position מספר שלם לא מיקום המוצר ברשימה או באוסף (למשל 2).
list_position מספר שלם לא מיקום המוצר ברשימה או באוסף (למשל 2).

נתוני מבצע

מייצג מידע על מבצע שצפו בו. הוא נקרא promoFieldObject ומכיל את הערכים הבאים:

מפתח סוג הערך חובה תיאור
id טקסט *כן

מזהה קידום המכירות (למשל PROMO_1234).

* יש להגדיר את אחד מהערכים id או name.

name טקסט *כן

שם המבצע (למשל, 'מבצע קיץ').

* יש להגדיר את אחד מהערכים id או name.

creative טקסט לא הקריאייטיב שמשויך לקידום המכירות (למשל, summer_banner2).
creative_name טקסט לא שם הקריאייטיב (למשל: summer_banner2).
position טקסט לא מיקום הקריאייטיב (למשל,banner_slot_1).
creative_slot טקסט לא השם של משבצת הקריאייטיב (למשל,banner_slot_1).

נתוני פעולה

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

מפתח סוג הערך חובה תיאור
id טקסט *כן

מזהה העסקה (למשל T1234).

* חובה אם סוג הפעולה הוא purchase או refund

affiliation טקסט לא החנות או הנתונים המשויכים שמהם העסקה הזו התרחשה (למשל, Google Store).
revenue number לא

הנתון הזה מציין את ההכנסה הכוללת או את הסכום הכולל המשויכים לעסקה (למשל 11.99). אפשר לכלול בערך הזה עלויות משלוח, מס או התאמות אחרות של ההכנסה הכוללת שרוצים לכלול כחלק מחישובי ההכנסות.

value number לא הערך (כלומר הכנסה) שמשויך לאירוע.
tax number לא המס הכולל שמשויך לעסקה.
shipping number לא עלות המשלוח שמשויכת לעסקה.
coupon טקסט לא שובר העסקה שמומש בעסקה.
list טקסט לא הרשימה שאליה שייכים המוצרים המשויכים. זה שינוי אופציונלי.
items מערך לא המערך שמכיל את המוצרים המשויכים.
step מספר שלם לא מספר שמייצג שלב בתהליך התשלום בקופה. אופציונלי בפעולות 'checkout'.
checkout_step מספר שלם לא מספר שמייצג שלב בתהליך התשלום בקופה.
option טקסט לא שדה נוסף לפעולות checkout ו-checkout_option שיכולות לתאר את פרטי האפשרות בדף התשלום, כמו אמצעי התשלום שנבחר.
checkout_option טקסט לא אפשרות התשלום בקופה (כלומר, אמצעי התשלום שנבחר).
מפתח סוג הערך חובה תיאור
coupon string לא קוד שובר לפריט לרכישה.

פעולות של מוצרים וקידום מכירות

הפעולות מציינות איך לפרש את נתוני המוצרים והמבצעים שאתם שולחים ל-Google Analytics.

פעולה אירוע תיאור
click קליק על קישור למוצר או למוצר למוצר אחד או יותר.
detail תצוגה של פרטי המוצר.
add הוספה של מוצר אחד או יותר לעגלת קניות.
remove מסירים מוצר אחד או יותר מעגלת קניות.
checkout התחלת תהליך התשלום למוצר אחד או יותר.
checkout_option המערכת שולחת את ערך האפשרות של שלב נתון בקופה.
purchase מכירה של מוצר אחד או יותר.
refund ההחזר הכספי על מוצר אחד או יותר.
promo_click קליק על קידום מכירות פנימי.
add_to_cart משתמש מוסיף מוצר אחד או יותר לעגלת הקניות.
begin_checkout משתמש מתחיל את תהליך התשלום על מוצר אחד או יותר.
checkout_progress משתמש משלים את שלבי התשלום אחרי השלב הראשון בקופה.
purchase משתמש משלים רכישה.
refund משתמש מקבל החזר כספי על מוצר אחד או יותר.
remove_from_cart משתמש מסיר מוצר אחד או יותר מעגלת קניות.
select_content משתמש לוחץ על קישור למוצר או למוצר.
set_checkout_option השלב בקופה שהמשתמש משלים.
view_item משתמש צופה בפרטים של מוצר.
view_item_list משתמש צופה ברשימה של מוצר אחד או יותר.
view_promotion משתמש לוחץ על קידום מכירות פנימי.
view_refund משתמש צופה בהחזר כספי על מוצר אחד או יותר.

דוגמאות

מדידת החשיפות של מוצרים

כדי למדוד חשיפות של מוצרים, צריך לשלוח view_item_list עם פרטי המוצר:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

מדידת קליקים על מוצרים

כדי למדוד קליק על מוצר, צריך לשלוח אירוע select_content, לציין את product בתור content_type ולספק את פרטי המוצר:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

מדידת הצפיות בפרטי המוצרים

אחרי לחיצה על כרטיס מוצר, משתמש יכול לראות את דף פרטי המוצר. כדי למדוד צפיות בפרטי מוצר, צריך לשלוח אירוע view_item עם פרטי המוצר:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

מדידת הוספות לעגלת קניות והסרת ממנה

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

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

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

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

מדידת הביצועים בקופה

כדי למדוד כל שלב בתהליך התשלום:

  1. מוסיפים קוד מדידה כדי למדוד כל שלב בתהליך התשלום בקופה.
  2. אם רלוונטי, מוסיפים קוד מדידה כדי לתעד את האפשרויות של התשלום בקופה.

‫1. מדידת השלבים בקופה

כדי למדוד את השלב הראשון בקופה, שולחים אירוע begin_checkout עם הפריטים:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

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

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. מדידת האפשרויות בקופה

כדי למדוד אפשרות בקופה, צריך לשלוח אירוע set_checkout_option עם אפשרות התשלום:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

מדידת החשיפות של המבצע

כדי למדוד חשיפות של מבצעים, צריך לשלוח אירוע view_promotion עם פרטי המבצע:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

מדידת קליקים על קידום מכירות

כדי למדוד קליק על מבצע, צריך לשלוח אירוע select_content ולציין את המבצע:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

מדידת רכישות

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

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

מדידת החזרים כספיים

כדי למדוד החזר כספי מלא על עסקה, צריך לשלוח אירוע refund עם מזהה העסקה:

gtag('event', 'refund', { "transaction_id": "T12345" })

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

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});