אירועים מומלצים

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

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

gtag.js Tag Manager Firebase

add_payment_info

האירוע הזה מציין שמשתמש שלח את פרטי התשלום שלו בתהליך תשלום בקופה של מסחר אלקטרוני.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

add_shipping_info

האירוע הזה מציין שמשתמש שלח את פרטי המשלוח שלו בתהליך תשלום בקופה באתר מסחר אלקטרוני.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

add_to_cart

האירוע הזה מציין שפריט נוסף לעגלת קניות לצורך רכישה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

add_to_wishlist

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

begin_checkout

האירוע הזה מציין שמשתמש התחיל תהליך תשלום.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

close_convert_lead

האירוע הזה מודד מתי ליד הומר ונסגר (לדוגמה, באמצעות רכישה).

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	המטבע של value האירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	כן*	30.03	הערך הכספי של האירוע. * בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫ * הפרמטר currency נדרש אם מגדירים את הפרמטר value.

דוגמה

close_unconvert_lead

האירוע הזה מודד מתי משתמש מסומן כליד שלא יהפוך ללקוח, וכולל את הסיבה לכך.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	המטבע של value האירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	כן*	30.03	הערך הכספי של האירוע. * בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫ * הפרמטר currency נדרש אם מגדירים את הפרמטר value.
unconvert_lead_reason	string	לא	לא התקבלה תשובה	הסיבה לכך שהליד לא המיר.

דוגמה

disqualify_lead

האירוע הזה מודד מתי משתמש מסומן כלא כשיר להפוך לליד, וכולל את הסיבה לפסילה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	המטבע של value האירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	כן*	30.03	הערך הכספי של האירוע. * בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫ * הפרמטר currency נדרש אם מגדירים את הפרמטר value.
disqualified_lead_reason	string	לא	לא רוצה לקנות	הסיבה לכך שליד סומן כפסול.

דוגמה

earn_virtual_currency

האירוע הזה מודד מתי משתמש מקבל מטבע וירטואלי במשחק. כדי להבין טוב יותר את הכלכלה הווירטואלית, כדאי לרשום את האירוע הזה יחד עם spend_virtual_currency.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
virtual_currency_name	string	לא	Gems	שם המטבע הווירטואלי.
value	number	לא	5	הערך של המטבע הווירטואלי.

דוגמה

generate_lead

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	המטבע של value האירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	כן*	30.03	הערך הכספי של האירוע. * בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫ * הפרמטר currency נדרש אם מגדירים את הפרמטר value.
lead_source	string	לא	תערוכה מסחרית	המקור של הליד.

דוגמה

join_group

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
group_id	string	לא	G_12345	המזהה של הקבוצה.

דוגמה

level_end

האירוע הזה מציין ששחקן הגיע לסוף שלב במשחק.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
level_name	string	לא	המסע מתחיל…	שם הרמה.
success	boolean	לא	true	הערך הוא true אם השלב הושלם בהצלחה.

דוגמה

level_start

האירוע הזה מציין ששחקן התחיל שלב במשחק.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
level_name	string	לא	המסע מתחיל…	שם הרמה.

דוגמה

level_up

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
level	number	לא	5	הרמה של הדמות.
character	string	לא	שחקן 1	הדמות שעולה ברמה.

דוגמה

login

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
method	string	לא	Google	השיטה ששימשה להתחברות.

דוגמה

post_score

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
score	number	כן	10000	הניקוד לפרסום.
level	number	לא	5	הרמה של הציון.
character	string	לא	שחקן 1	התו שהשיג את הציון.

דוגמה

purchase

האירוע הזה מציין מתי משתמש קונה פריט אחד או יותר.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

qualify_lead

האירוע הזה מודד מתי משתמש מסומן כעומד בקריטריונים להפוך לליד (lead) כשיר.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	המטבע של value האירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	כן*	30.03	הערך הכספי של האירוע. * בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫ * הפרמטר currency נדרש אם מגדירים את הפרמטר value.

דוגמה

refund

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

הערה: מומלץ לכלול את פרטי הפריט באירוע refund כדי לראות מדדי החזרים כספיים ברמת הפריט ב-Analytics.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

remove_from_cart

האירוע הזה מציין שפריט הוסר מעגלת קניות.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

search

צריך לרשום את האירוע הזה ביומן כדי לציין מתי המשתמש ביצע חיפוש. אתם יכולים להשתמש באירוע הזה כדי לזהות מה המשתמשים מחפשים באתר או באפליקציה שלכם. לדוגמה, אתם יכולים לשלוח את האירוע הזה כשמשתמש צופה בדף תוצאות חיפוש אחרי שהוא מבצע חיפוש.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
search_term	string	כן	חולצות טישרט	המונח שהמשתמש חיפש.

דוגמה

select_content

האירוע הזה מציין שמשתמש בחר תוכן מסוג מסוים. האירוע הזה יכול לעזור לכם לזהות תוכן פופולרי וקטגוריות של תוכן באתר או באפליקציה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
content_type	string	לא	product	סוג התוכן שנבחר.
content_id	string	לא	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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
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	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
promotion_id	string	לא	P_12345	מזהה המבצע שמשויך לפריט. אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_id ברמת האירוע. אם לא מוגדר, נעשה שימוש בpromotion_id ברמת האירוע, אם הוא קיים.
promotion_name	string	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_name ברמת האירוע. אם לא מוגדר, נעשה שימוש בpromotion_name ברמת האירוע, אם הוא קיים.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

share

משתמשים באירוע הזה כשמשתמש משתף תוכן.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
method	string	לא	Twitter	השיטה שבה התוכן משותף.
content_type	string	לא	תמונה	סוג התוכן ששותף.
item_id	string	לא	C_12345	המזהה של התוכן המשותף.

דוגמה

sign_up

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
method	string	לא	Google	השיטה ששימשה להרשמה.

דוגמה

spend_virtual_currency

האירוע הזה מודד את המכירה של מוצרים וירטואליים באפליקציה, ועוזר לכם לזהות אילו מוצרים וירטואליים הם הכי פופולריים.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
value	number	כן	5	הערך של המטבע הווירטואלי.
virtual_currency_name	string	כן	Gems	שם המטבע הווירטואלי.
item_name	string	לא	חבילת היתרונות למתחילים	שם הפריט שמשמש לרכישת המטבע הווירטואלי.

דוגמה

tutorial_begin

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

פרמטרים

אין פרמטרים לאירוע הזה.

דוגמה

tutorial_complete

האירוע הזה מציין שהמשתמש השלים את תהליך ההצטרפות שלכם. אפשר להשתמש באירוע הזה במשפך עם האירוע tutorial_begin כדי להבין כמה משתמשים משלימים את המדריך.

פרמטרים

אין פרמטרים מוצעים לאירוע הזה.

דוגמה

unlock_achievement

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
achievement_id	string	כן	A_12345	המזהה של ההישג שהנעילה שלו בוטלה.

דוגמה

view_cart

האירוע הזה מציין שמשתמש צפה בעגלת הקניות שלו.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

view_item

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר 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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

view_item_list

האירוע הזה נרשם ביומן כשהמשתמש רואה רשימה של פריטים מקטגוריה מסוימת.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע view_item לא תורמים להכנסה * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
item_list_id	string	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת מהמאפיין אם הוא מוגדר ברמת הפריט.
item_list_name	string	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת מהמאפיין אם הוא מוגדר ברמת הפריט.
items	Array<Item>	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
item_id	string	כן*	SKU_12345	המזהה של הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon	string	לא	SUMMER_FUN	השם או הקוד של השובר שמשויך לפריט. פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount	number	לא	‫2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index	number	לא	5	האינדקס או המיקום של הפריט ברשימה.
item_brand	string	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

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_id או item_name.
item_name	string	כן*	חולצת Stan and Friends	שם הפריט. *חובה להזין ערך באחת מהעמודות item_id או item_name.
affiliation	string	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
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	לא	Google	המותג של הפריט.
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	לא	ירוק	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id	string	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: המאפיין `location id` זמין רק ברמת הפריט.
price	number	לא	10.01	מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫ אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
promotion_id	string	לא	P_12345	מזהה המבצע שמשויך לפריט. אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_id ברמת האירוע. אם לא מוגדר, נעשה שימוש בpromotion_id ברמת האירוע, אם הוא קיים.
promotion_name	string	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_name ברמת האירוע. אם לא מוגדר, נעשה שימוש בpromotion_name ברמת האירוע, אם הוא קיים.
quantity	number	לא	3	כמות הפריטים. אם לא מגדירים את הערך, quantity מוגדר כ-1.

בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

working_lead

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
currency	string	כן*	USD	המטבע של value האירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	כן*	30.03	הערך הכספי של האירוע. * בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫ * הפרמטר currency נדרש אם מגדירים את הפרמטר value.
lead_status	string	לא	שיחות שהתחילו	הסטטוס של הליד.

דוגמה