ad_impression
אפשר להשתמש באירוע הזה כשמשתמש רואה חשיפה של מודעה.
ad_impression
שנשלח באמצעות ה-Measurement Protocol לא ייכלל בייצוא לפלטפורמות פרסום אחרות כמו Google Ads.- שליחת אירועי
ad_impression
באמצעות ה-Measurement Protocol עלולה לגרום חשיפות כפולות אם הגדרתם תיוג או את ה-SDK של הקישור מוצרי הפרסום של Google. צריך לשלוח אירועad_impression
באמצעות Measurement Protocol רק אם האירוע לא תועדו על ידי תיוג או באמצעות ה-SDK.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
ad_platform |
string |
לא | MoPub | פלטפורמת הפרסום. |
ad_source |
string |
לא | AdColony | מקור המודעות. |
ad_format |
string |
לא | כרזה | פורמט המודעה. |
ad_unit_name |
string |
לא | Banner_03 | השם של יחידת המודעות. |
currency |
string |
לא | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
לא | 3.99 | הערך של החשיפה של המודעה. * value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
חובה להזין * currency אם מגדירים את הערך value .
|
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"ad_impression",
"params":{
"ad_platform": "MoPub",
"ad_source": "AdColony",
"ad_format": "Banner",
"ad_unit_name": "Banner_03",
"currency": "USD",
"value": 3.99
}
}]
})
});
add_payment_info
האירוע הזה מציין שמשתמש שלח את פרטי התשלום שלו תהליך התשלום על החשבון במסחר אלקטרוני.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לאירוע. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
payment_type |
string |
לא | כרטיס אשראי | אמצעי התשלום הנבחר. |
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_payment_info",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"payment_type": "Credit Card",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_shipping_info
האירוע הזה מציין שמשתמש שלח את פרטי המשלוח שלו תהליך התשלום על החשבון במסחר אלקטרוני.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לאירוע. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
shipping_tier |
string |
לא | קרקע |
דרגת המשלוח (למשל: Ground , Air ,
Next-day ) שנבחרו למשלוח של הפריט שנרכש.
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_shipping_info",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping_tier": "Ground",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_to_cart
האירוע הזה מציין שפריט נוסף לעגלת הקניות לצורך רכישה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_cart",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_to_wishlist
האירוע מציין שפריט נוסף לרשימת משאלות. שימוש באירוע הזה כדי לזהות פריטים פופולריים למתנות באפליקציה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_wishlist",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
begin_checkout
האירוע הזה מציין שמשתמש התחיל את תהליך התשלום.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לאירוע. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "begin_checkout",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
campaign_details
אפשר להשתמש באירוע הזה כדי לשלוח פרטי קמפיין שיחולו על אירועים עתידיים.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
campaign_id |
string |
לא | google_1234 | מזהה הקמפיין |
campaign |
string |
לא | Summer_fun | השם שמשמש לזיהוי של קידום מכירות או קמפיין אסטרטגי ספציפי. |
source |
string |
לא | מקור התנועה של הקמפיין (למשל Google, אימייל וכו'). | |
medium |
string |
לא | cpc | אמצעי ההגעה לאתר בקמפיין (למשל, אימייל, עלות לקליק וכו') |
term |
string |
לא | summer+travel | מונח הקמפיין המשמש לחיפוש בתשלום כדי לספק את מילות המפתח למודעות. |
content |
string |
לא | logolink | תוכן הקמפיין המשמש לבדיקות A/B ולמודעות שמטורגטות לפי תוכן, כדי להבדיל בין מודעות או קישורים שמפנים לאותה כתובת URL. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink"
}
}]
})
});
close_convert_lead
האירוע הזה מודד מתי ליד (lead) הומר או נסגר (לדוגמה, באמצעות רכישה).
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "close_convert_lead",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
close_unconvert_lead
האירוע הזה מודד אם משתמש מסומן כלא הופך לליד שהשלים המרה, ולציין את הסיבה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
unconvert_lead_reason |
string |
לא | לא התקבלה תשובה | הסיבה לכך שהליד לא השלים המרה. |
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "close_unconvert_lead",
"params": {
"currency": "USD",
"value": 30.03,
"unconvert_lead_reason": "Never responded",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
disqualify_lead
האירוע הזה מודד אם משתמש מסומן כלא כשיר להיות ליד, וכן את הסיבה לפסילה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
disqualified_lead_reason |
string |
לא | לא רוצה לקנות | הסיבה לכך שליד סומן כ'נפסל'. |
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "disqualify_lead",
"params": {
"currency": "USD",
"value": 30.03,
"disqualified_lead_reason": "Not looking to buy",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
earn_virtual_currency
האירוע הזה מודד מתי משתמש מקבל מטבע וירטואלי במשחק. מומלץ לרשום את המידע הזה יחד עם spend_virtual_currency כדי להבין טוב יותר את כלכלה וירטואלית.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
virtual_currency_name |
string |
לא | תצורות Gem | שם המטבע הווירטואלי. |
value |
number |
לא | 5 | הערך של המטבע הווירטואלי. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "earn_virtual_currency",
"params": {
"virtual_currency_name": "Gems",
"value": 5
}
}]
})
});
generate_lead
האירוע הזה מודד מתי נוצר ליד (לדוגמה, דרך ). ציינו את הנתונים האלה כדי להבין את היעילות של הקמפיינים השיווקיים שלכם כמה לקוחות יוצרים אינטראקציה חוזרת עם העסק שלך אחרי רימרקטינג .
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
lead_source |
string |
לא | מופע מקצועי | מקור הליד. |
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "generate_lead",
"params": {
"currency": "USD",
"value": 30.03,
"lead_source": "Trade show",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
join_group
המערכת מתעדת את האירוע הזה כשמשתמש מצטרף לקבוצה, כמו גילדה, צוות או משפחה. כדאי להשתמש האירוע הזה כדי לנתח את מידת הפופולריות של קבוצות או תכונות חברתיות מסוימות.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
group_id |
string |
לא | G_12345 | המזהה של הקבוצה. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"join_group",
"params":{
"group_id":"G_12345"
}
}]
})
});
level_up
האירוע הזה מציין ששחקן עלה לשלב הבא במשחק. השתמשו בו כדי להעריך את רמת ההתפלגות של בסיס המשתמשים וזיהוי רמות שקשה להבין הושלם.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
level |
number |
לא | 5 | הרמה של הדמות. |
character |
string |
לא | שחקן 1 | הדמות שהפכה לרמה הבאה. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "level_up",
"params": {
"level": 5,
"character": "Player 1"
}
}]
})
});
login
שליחת האירוע הזה מציינת שמשתמש התחבר לאתר או לאפליקציה שלכם.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
method |
string |
לא | השיטה ששימשה להתחברות. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "login",
"params": {
"method": "Google"
}
}]
})
});
post_score
שליחת האירוע הזה כשהמשתמש מפרסם ציון. כדאי להשתמש באירוע הזה כדי להבין איך שמשתמשים מבצעים במשחק שלכם ומתאימה בין ציונים גבוהים לבין קהלים והתנהגויות.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
score |
number |
כן | 10000 | התוצאה לפרסום. |
level |
number |
לא | 5 | הרמה שבה נקבע המדד. |
character |
string |
לא | שחקן 1 | הדמות שהשיגה את הניקוד. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "post_score",
"params": {
"score": 10000,
"level": 5,
"character": "Player 1"
}
}]
})
});
purchase
האירוע הזה מציין מתי משתמש רכש פריט אחד או יותר.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
transaction_id |
string |
כן | T_12345 | המזהה הייחודי של עסקה. הפרמטר transaction_id עוזר למנוע כפילות של אירועים ברכישה. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לאירוע. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
shipping |
number |
לא | 3.33 | עלות המשלוח המשויכת לעסקה. |
tax |
number |
לא | 1.11 | עלות המס שמשויכת לעסקה. |
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "purchase",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
qualify_lead
האירוע הזה מודד מתי משתמש מסומן כעומד בקריטריונים כדי להפוך ליד כשיר.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "qualify_lead",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
refund
האירוע הזה מציין כשמשתמש מבצע החזר כספי על פריט אחד או יותר.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
transaction_id |
string |
כן | T_12345 | המזהה הייחודי של עסקה. |
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לאירוע. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
shipping |
number |
לא | 3.33 | עלות המשלוח המשויכת לעסקה. |
tax |
number |
לא | 1.11 | עלות המס שמשויכת לעסקה. |
items |
Array<Item>
|
לא* | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "refund",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
remove_from_cart
האירוע הזה מציין שפריט הוסר מעגלת קניות.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "remove_from_cart",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
screen_view
כדאי להשתמש באירוע הזה כדי לציין שהתרחש מעבר בין מסכים.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
screen_class |
string |
לא | MainActivity | הסיווג של המסך. |
screen_name |
string |
לא | מידע כללי | שם המסך. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "screen_view",
"params": {
"screen_class": "MainActivity",
"screen_name": "About"
}
}]
})
});
search
צריך לרשום את האירוע הזה כדי לציין מתי המשתמש ביצע חיפוש. אפשר להשתמש האירוע הזה כדי לזהות מה המשתמשים מחפשים באתר או באפליקציה שלכם. עבור לדוגמה, אפשר לשלוח את האירוע הזה כשמשתמש צופה בדף תוצאות חיפוש אחרי ביצוע חיפוש.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
search_term |
string |
כן | חולצות טי-שירט | המונח שבחרתם לחפש. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "search",
"params": {
"search_term": "t-shirts"
}
}]
})
});
select_content
האירוע הזה מציין שמשתמש בחר תוכן מסוג מסוים. האירוע הזה יכול לעזור לך לזהות תוכן פופולרי וקטגוריות של תוכן ב- באתר או באפליקציה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
content_type |
string |
לא | product | סוג התוכן שנבחר. |
content_id |
string |
לא | C_12345 | מזהה של התוכן שנבחר. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_content",
"params": {
"content_type": "product",
"content_id": "C_12345"
}
}]
})
});
select_item
האירוע הזה מציין שפריט נבחר מתוך רשימה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
items |
Array<Item> |
כן* | הפריטים באירוע. * המערך items אמור להכיל רכיב אחד
שמייצג את הפריט שנבחר. אם קיימים מספר רכיבים
צוין, המערכת תשתמש רק ברכיב הראשון של items .
|
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_item",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
select_promotion
האירוע הזה מציין מבצע שנבחר מתוך רשימה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
creative_name |
string |
לא | summer_banner2 | שם הקריאייטיב לקידום המכירות. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
creative_slot |
string |
לא | featured_app_1 | השם של מיקום הקריאייטיב לקידום מכירות המשויך אל
אירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
promotion_id |
string |
לא | P_12345 |
מזהה המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
promotion_name |
string |
לא | מבצע קיץ |
שם המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
creative_name |
string |
לא | summer_banner2 | שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ- creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד creative_name ברמת האירוע, אם
כיום. |
creative_slot |
string |
לא | featured_app_1 | השם של מיקום הקריאייטיב לקידום מכירות המשויך אל
שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ- creative_slot ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד creative_slot ברמת האירוע, אם
כיום. |
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
promotion_id |
string |
לא | P_12345 |
מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ- promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד promotion_id ברמת האירוע, אם
כיום.
|
promotion_name |
string |
לא | מבצע קיץ |
שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ- promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד promotion_name ברמת האירוע, אם
כיום.
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
share
השימוש באירוע הזה כשמשתמש משתף תוכן.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
method |
string |
לא | השיטה שבה התוכן משותף. | |
content_type |
string |
לא | תמונה | סוג התוכן המשותף. |
item_id |
string |
לא | C_12345 | המזהה של התוכן ששותף. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "share",
"params": {
"method": "Twitter",
"content_type": "image",
"item_id": "C_12345"
}
}]
})
});
sign_up
האירוע הזה מציין שמשתמש נרשם לחשבון. שימוש באירוע הזה כדי להבין את ההתנהגויות השונות של משתמשים מחוברים ולא מחוברים.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
method |
string |
לא | השיטה ששימשה להרשמה. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "sign_up",
"params": {
"method": "Google"
}
}]
})
});
spend_virtual_currency
האירוע הזה מודד את המכירה של מוצרים וירטואליים באפליקציה שלך ועוזר לך לזהות אילו מוצרים וירטואליים הם הכי פופולריים.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
value |
number |
כן | 5 | הערך של המטבע הווירטואלי. |
virtual_currency_name |
string |
כן | תצורות Gem | שם המטבע הווירטואלי. |
item_name |
string |
לא | זריקת Starter Boost | שם הפריט שעבורו נעשה שימוש במטבע הווירטואלי. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "spend_virtual_currency",
"params": {
"value": 5,
"virtual_currency_name": "Gems",
"item_name": "Starter Boost"
}
}]
})
});
tutorial_begin
האירוע הזה מציין את תחילת תהליך ההצטרפות. שימוש בפרמטר הזה במשפך עם tutorial_complete כדי להבין כמה משתמשים השלימו את המדריך.
פרמטרים
לא מוצעים פרמטרים לאירוע הזה.
אין פרמטרים לאירוע הזה.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_begin"
}]
})
});
tutorial_complete
אירוע זה מציין שהמשתמש השלים את תהליך ההצטרפות שלכם. שימוש בטיוטה הזו במשפך עם tutorial_begin כדי להבין כמה משתמשים משלימים את של המדריך.
פרמטרים
לא מוצעים פרמטרים לאירוע הזה.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_complete"
}]
})
});
unlock_achievement
תיעוד האירוע הזה כשהמשתמש ביטל את הנעילה של הישג. האירוע הזה יכול לעזור אתם מבינים איך המשתמשים חווים את המשחק שלכם.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
achievement_id |
string |
כן | A_12345 | המזהה של ההישג שהנעילה שלו בוטלה. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "unlock_achievement",
"params": {
"achievement_id": "A_12345"
}
}]
})
});
view_cart
האירוע הזה מציין שמשתמש צפה בעגלת הקניות שלו.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_cart",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
view_item
האירוע הזה מציין שחלק מהתוכן הוצג למשתמש. שימוש באירוע הזה כדי למצוא את הפריטים הפופולריים ביותר שנצפו.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
],
}
}]
})
});
view_item_list
רישום אירוע זה כשמוצגת למשתמש רשימה של פריטים קטגוריה מסוימת.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
items |
Array<Item> |
כן | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item_list",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
view_promotion
האירוע הזה מציין שמישהו צפה במבצע מתוך רשימה.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
creative_name |
string |
לא | summer_banner2 | שם הקריאייטיב לקידום המכירות. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
creative_slot |
string |
לא | featured_app_1 | השם של מיקום הקריאייטיב לקידום מכירות המשויך אל
אירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
promotion_id |
string |
לא | P_12345 |
מזהה המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
promotion_name |
string |
לא | מבצע קיץ |
שם המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט. |
items |
Array<Item> |
כן* | הפריטים באירוע. * המערך items אמור להכיל רכיב אחד
שמייצג את הפריט שמשויך למבצע. אם מספר
הרכיבים סופקו, רק הרכיב הראשון ב-items
.
|
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
creative_name |
string |
לא | summer_banner2 | שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ- creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד creative_name ברמת האירוע, אם
כיום. |
creative_slot |
string |
לא | featured_app_1 | השם של מיקום הקריאייטיב לקידום מכירות המשויך אל
שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ- creative_slot ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד creative_slot ברמת האירוע, אם
כיום. |
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
promotion_id |
string |
לא | P_12345 |
מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ- promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד promotion_id ברמת האירוע, אם
כיום.
|
promotion_name |
string |
לא | מבצע קיץ |
שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ- promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד promotion_name ברמת האירוע, אם
כיום.
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
view_search_results
האירוע הזה יתועד כשתוצאות חיפוש מוצגות למשתמש. לתשומת ליבכם: אפשר להפעיל את האירוע view_search_results לאיסוף אוטומטי באמצעות מדידת אירועים משופרת ב-Google Analytics.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
search_term |
string |
לא | הלבשה | המונח ששימש לחיפוש. |
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_search_results",
"params": {
"search_term": "Clothing"
}
}]
})
});
working_lead
האירוע הזה מודד מתי משתמש יוצר קשר או יוצר קשר עם נציג.
פרמטרים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
currency |
string |
כן* | USD |
מטבע הפריטים שמשויכים לאירוע, ב-
3 אותיות
פורמט ISO 4217. * אם מגדירים את value , חובה לציין currency
כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
|
value |
number |
כן* | 30.03 | הערך הכספי של האירוע. * מגדירים את value לסכום של (price * quantity) לכל הפריטים ב
items אין לכלול shipping או tax .
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
אם תסמן
האירוע כהמרה. לאחר מכן מומלץ להגדיר
value .
חובה להזין * currency אם מגדירים את הערך value .
|
lead_status |
string |
לא | שיחות שהתחילו | הסטטוס של הליד. |
items |
Array<Item>
|
לא | הפריטים באירוע. |
פרמטרים של פריטים
שם | סוג | חובה | ערך לדוגמה | תיאור |
---|---|---|---|---|
item_id |
string |
כן* | SKU_12345 |
המזהה של הפריט.
*צריך להזין את אחד מהערכים |
item_name |
string |
כן* | חולצת Stan and Friends |
שם הפריט.
*צריך להזין את אחד מהערכים |
affiliation |
string |
לא | Google Store |
הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה,
המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט. |
coupon |
string |
לא | SUMMER_FUN | השם/הקוד של השובר שמשויך לפריט. פרמטרים coupon ברמת האירוע וברמת הפריט הם
בלתי תלויית.
|
discount |
number |
לא | 2.22 | הערך הכספי של ההנחה ליחידה שמשויכת לפריט. |
index |
number |
לא | 5 | האינדקס/המיקום של הפריט ברשימה. |
item_brand |
string |
לא | המותג של הפריט. | |
item_category |
string |
לא | ביגוד | הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה. |
item_category2 |
string |
לא | אדם מבוגר | ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט. |
item_category3 |
string |
לא | חולצות | ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט. |
item_category4 |
string |
לא | צוות ההפקה | ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט. |
item_category5 |
string |
לא | שרוולים קצרים | ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט. |
item_list_id |
string |
לא | related_products | המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_id ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_id ברמת האירוע, אם
כיום.
|
item_list_name |
string |
לא | מוצרים קשורים | שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ- item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, ייעשה שימוש במדד item_list_name ברמת האירוע, אם
כיום.
|
item_variant |
string |
לא | green | הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות. |
location_id |
string |
לא | ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו) |
המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי)
המיקום של החנות). מומלץ להשתמש
Google
מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית
ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט. |
price |
number |
לא | 10.01 |
המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין
הפרמטר.
אם חלה הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזלת
מציינים את הנחת המחיר ליחידה בפרמטר discount .
|
quantity |
number |
לא | 3 |
כמות הפריטים. |
items
.
שליחת האירוע
כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "working_lead",
"params": {
"currency": "USD",
"value": 30.03,
"lead_status": "Started conversations",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});