אירועים

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את value, צריך לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value	number	לא	3.99	הערך של החשיפה של המודעה. * value בדרך כלל נדרש כדי לקבל דיווח משמעותי. חובה להזין * currency אם מגדירים את הערך value.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מקור התנועה של הקמפיין (למשל Google, אימייל וכו').
medium	string	לא	cpc	אמצעי ההגעה לאתר בקמפיין (למשל, אימייל, עלות לקליק וכו')
term	string	לא	summer+travel	מונח הקמפיין המשמש לחיפוש בתשלום כדי לספק את מילות המפתח למודעות.
content	string	לא	logolink	תוכן הקמפיין המשמש לבדיקות A/B ולמודעות שמטורגטות לפי תוכן, כדי להבדיל בין מודעות או קישורים שמפנים לאותה כתובת URL.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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

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

פרמטרים

שם	סוג	נדרש	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	הערך של המטבע הווירטואלי.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	המזהה של הקבוצה.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	הדמות שהפכה לרמה הבאה.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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"
      }
    }]
  })
});

התחברות

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

פרמטרים

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	הדמות שהשיגה את הניקוד.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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

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

פרמטרים

שם	סוג	נדרש	ערך לדוגמה	תיאור
currency	string	כן*	USD	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	לא	מידע כללי	שם המסך.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	כן	חולצות טי-שירט	המונח שבחרתם לחפש.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מזהה של התוכן שנבחר.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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
          }
        ]
      }
    }]
  })
});

שיתוף

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

פרמטרים

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	השיטה ששימשה להרשמה.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	שם הפריט שעבורו נעשה שימוש במטבע הווירטואלי.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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 כדי להבין כמה משתמשים משלימים את המדריך.

פרמטרים

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

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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 כדי להבין כמה משתמשים השלימו את המדריך.

פרמטרים

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	המזהה של ההישג שהנעילה שלו בוטלה.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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 ברמת האירוע וברמת הפריט הם בלתי תלויים.
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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	לא	בגדים	המונח ששימש לחיפוש.

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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	מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. * אם מגדירים את 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_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	לא	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	כמות הפריטים. אם הערך לא מוגדר, quantity מוגדר כ-1.

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

שליחת האירוע

כדאי לנסות את האירוע הזה בכלי ליצירת אירועים ב-GA4

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
          }
        ]
      }
    }]
  })
});