בדף הזה מוסבר איך להשתמש ב-gtag.js כדי לאסוף נתוני מסחר אלקטרוני משופר. אם הגדרתם את Google Analytics ב-gtag.js והפעלתם מסחר אלקטרוני משופר ב-Google Analytics, תוכלו להשתמש ב-gtag.js כדי לשלוח ל-Google Analytics נתוני חשיפות, נתוני מוצרים, נתוני מבצעים ונתוני פעולות.
פעולות וסוגים של נתונים של מסחר אלקטרוני משופר
יש כמה סוגים של נתוני מסחר אלקטרוני שאפשר לשלוח:
נתוני חשיפות
מייצג מידע על המוצר שצפו בו. הוא נקרא impressionFieldObject
ומכיל את הערכים הבאים:
מפתח | סוג הערך | חובה | תיאור |
---|---|---|---|
id |
טקסט | *כן |
מזהה המוצר או המק"ט (למשל P67890).
* יש להגדיר את אחד מהערכים |
name |
טקסט | *כן |
שם המוצר (למשל, טישרט של Android).
* יש להגדיר את אחד מהערכים |
list |
טקסט | לא | הרשימה או האוסף שאליהם המוצר שייך (למשל, תוצאות חיפוש) |
list_name |
טקסט | לא | הרשימה או האוסף שאליהם המוצר שייך (למשל, תוצאות חיפוש) |
brand |
טקסט | לא | המותג המשויך למוצר (למשל, Google). |
category |
טקסט | לא |
הקטגוריה שאליה משתייך המוצר (למשל, 'ביגוד'). אפשר להשתמש
במאפיין / כתו מפריד כדי לציין עד 5 רמות של היררכיה (למשל:
ביגוד/גברים/חולצות טי).
|
variant |
טקסט | לא | הווריאציה של המוצר (למשל, שחור). |
position |
מספר שלם | לא | מיקום המוצר ברשימה או באוסף (למשל 2). |
list_position |
מספר שלם | לא | מיקום המוצר ברשימה או באוסף (למשל 2). |
price |
number | לא | מחיר המוצר (למשל 29.20). |
נתוני המוצר
נתוני מוצרים מייצגים מוצרים בודדים שנצפו, נוספו לעגלת הקניות וכו'. הם נקראים productFieldObject
ומכילים את הערכים הבאים:
מפתח | סוג הערך | חובה | תיאור |
---|---|---|---|
id |
טקסט | *כן |
מזהה המוצר או המק"ט (למשל P67890).
* יש להגדיר אחד מהמזהים או |
name |
טקסט | *כן |
שם המוצר (למשל, טישרט של Android).
* יש להגדיר אחד מהמזהים או |
brand |
טקסט | לא | המותג המשויך למוצר (למשל, Google). |
category |
טקסט | לא | הקטגוריה שאליה משתייך המוצר (למשל, 'ביגוד'). אפשר להשתמש / כתו מפריד כדי לציין עד 5 רמות של היררכיה (למשל: ביגוד/גברים/חולצות טי). |
variant |
טקסט | לא | הווריאציה של המוצר (למשל, שחור). |
price |
number | לא | מחיר המוצר (למשל 29.20). |
quantity |
מספר שלם | לא | כמות המוצר (למשל 2). |
coupon |
טקסט | לא | קוד השובר המשויך למוצר (למשל SUMMER_SALE13). |
position |
מספר שלם | לא | מיקום המוצר ברשימה או באוסף (למשל 2). |
list_position |
מספר שלם | לא | מיקום המוצר ברשימה או באוסף (למשל 2). |
נתוני מבצע
מייצג מידע על מבצע שצפו בו. הוא נקרא promoFieldObject
ומכיל את הערכים הבאים:
מפתח | סוג הערך | חובה | תיאור |
---|---|---|---|
id |
טקסט | *כן |
מזהה קידום המכירות (למשל PROMO_1234).
* יש להגדיר את אחד מהערכים |
name |
טקסט | *כן |
שם המבצע (למשל, 'מבצע קיץ').
* יש להגדיר את אחד מהערכים |
creative |
טקסט | לא | הקריאייטיב שמשויך לקידום המכירות (למשל, summer_banner2). |
creative_name |
טקסט | לא | שם הקריאייטיב (למשל: summer_banner2). |
position |
טקסט | לא | מיקום הקריאייטיב (למשל,banner_slot_1). |
creative_slot |
טקסט | לא | השם של משבצת הקריאייטיב (למשל,banner_slot_1). |
נתוני פעולה
מייצג מידע על פעולה שקשורה למסחר אלקטרוני שהתרחשה.
הוא נקרא actionFieldObject
ומכיל את הערכים הבאים:
מפתח | סוג הערך | חובה | תיאור |
---|---|---|---|
id |
טקסט | *כן |
מזהה העסקה (למשל T1234).
* חובה אם סוג הפעולה הוא |
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. מדידת השלבים בקופה
כדי למדוד את השלב הראשון בקופה, שולחים אירוע 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'
}
]
});