דף זה תורגם על ידי Cloud Translation API.

אירועים

`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`.

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_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 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`payment_type`	`string`	לא	כרטיס אשראי	אמצעי התשלום שנבחר.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`add_shipping_info`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`shipping_tier`	`string`	לא	קרקע	דרגת המשלוח שבחרתם לשליחת הפריט שנקנה (למשל `Ground`, ‏ `Air`,‏ `Next-day`).
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`add_to_cart`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`add_to_wishlist`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`begin_checkout`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`campaign_details`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`campaign_id`	`string`	לא	google_1234	מזהה הקמפיין.
`campaign`	`string`	לא	Summer_fun	השם המשמש לזיהוי קידום מכירות או קמפיין אסטרטגי ספציפיים.
`source`	`string`	לא	google	מקור התנועה בקמפיין (למשל, google, ‏ email וכו').
`medium`	`string`	לא	cpc	אמצעי ההגעה לאתר בקמפיין (למשל, אימייל, עלות לקליק וכו')
`term`	`string`	לא	summer+travel	מונח הקמפיין שמשמש בקמפיינים לרשת החיפוש בתשלום כדי לספק את מילות המפתח למודעות.
`content`	`string`	לא	logolink	תוכן הקמפיין שמשמש לבדיקות A/B ולמודעות שמטורגטות לפי תוכן, כדי להבדיל בין מודעות או קישורים שמפנים לאותה כתובת URL.

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

`close_convert_lead`

האירוע הזה מודד מתי ליד הושלם והוגדר כסגור (למשל, דרך רכישה).

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

`close_unconvert_lead`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

`disqualify_lead`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

`earn_virtual_currency`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

`generate_lead`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

`join_group`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

`level_up`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

`login`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

`post_score`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

`purchase`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`transaction_id`	`string`	כן	T_12345	המזהה הייחודי של עסקה. הפרמטר `transaction_id` עוזר למנוע כפילות של אירועים ברכישה.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`shipping`	`number`	לא	3.33	עלות המשלוח שמשויכת לעסקה.
`tax`	`number`	לא	1.11	עלות המס שמשויכת לעסקה.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`qualify_lead`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

`refund`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`transaction_id`	`string`	כן	T_12345	המזהה הייחודי של עסקה.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`shipping`	`number`	לא	3.33	עלות המשלוח שמשויכת לעסקה.
`tax`	`number`	לא	1.11	עלות המס שמשויכת לעסקה.
`items`	`Array<Item>`	לא*		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`remove_from_cart`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`screen_view`

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

האירוע הזה משמש לציון מעבר מסך.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`screen_class`	`string`	לא	MainActivity	הסיווג של המסך.
`screen_name`	`string`	לא	מידע כללי	שם המסך.

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

`search`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

`select_content`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`content_type`	`string`	לא	product	סוג התוכן שנבחר.
`content_id`	`string`	לא	C_12345	מזהה של התוכן שנבחר.

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

`select_item`

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

פרמטרים

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

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`select_promotion`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`creative_name`	`string`	לא	summer_banner2	השם של הקריאייטיב לקידום המכירות. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`creative_slot`	`string`	לא	featured_app_1	השם של משבצת הקריאייטיב לקידום המכירות המשויכת לאירוע. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`promotion_id`	`string`	לא	P_12345	המזהה של המבצע שמשויך לאירוע. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`promotion_name`	`string`	לא	מבצע קיץ	השם של המבצע שמשויך לאירוע. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`items`	`Array<Item>`	לא		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_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 של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`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.

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`share`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

`sign_up`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

`spend_virtual_currency`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

`tutorial_begin`

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

פרמטרים

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

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

`tutorial_complete`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

`unlock_achievement`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

`view_cart`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_item`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות. מדדי ערך באירוע `view_item` שלא תורמים להכנסה * אם מגדירים את הפרמטר `value`, צריך לציין את הפרמטר `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב-`items`. אין לכלול את הערכים `shipping` או `tax`. * הפרמטר `value` נדרש בדרך כלל לקבלת דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את `value`. * צריך להגדיר את `currency` אם מגדירים את `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

`view_item_list`

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

פרמטרים

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

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *נדרש אחד מהשדות `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות. הערה: השדה affiliation זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים של `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה שמשויכת לפריט.
`index`	`number`	לא	5	המדד/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	הלבשה	הקטגוריה של הפריט. אם משתמשים בו כחלק מהיררכיית קטגוריות או מטקסונומיה, זו תהיה הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_id` ברמת האירוע, אם הוא קיים.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם ההגדרה מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם לא מגדירים את הפרמטר, המערכת משתמשת ב-`item_list_name` ברמת האירוע, אם הוא קיים.
`item_variant`	`string`	לא	green	גרסת הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, מגדירים את `price` למחיר המוזל ליחידה ומציינים את ההנחה על מחיר היחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_promotion`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`creative_name`	`string`	לא	summer_banner2	השם של הקריאייטיב לקידום המכירות. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`creative_slot`	`string`	לא	featured_app_1	השם של משבצת הקריאייטיב לקידום המכירות המשויכת לאירוע. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`promotion_id`	`string`	לא	P_12345	המזהה של המבצע שמשויך לאירוע. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`promotion_name`	`string`	לא	מבצע קיץ	השם של המבצע שמשויך לאירוע. המערכת תתעלם מהמאפיין אם הוא מוגדר ברמת הפריט.
`items`	`Array<Item>`	כן*		הפריטים באירוע. * המערך `items` אמור לכלול רכיב אחד, שמייצג את הפריט שמשויך למבצע. אם מציינים כמה רכיבים, המערכת תשתמש רק ברכיב הראשון ב-`items`.

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

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *נדרש אחד מהשדות `item_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 של סן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי של החנות). מומלץ להשתמש במזהה המקום ב-Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית. הערה: השדה location id זמין רק ברמת הפריט.
`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.

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_search_results`

רושמים את האירוע הזה כשהתוצאות של חיפוש מוצגות למשתמש. שימו לב שאפשר להפעיל את האירוע view_search_results לאיסוף אוטומטי באמצעות מדידת אירועים משופרת ב-Google Analytics.

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

`working_lead`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה בכלי ליצירת אירועים ב-Google Analytics?

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});