דף זה תורגם על ידי 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`.

שליחת אירוע

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

`add_payment_info`

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של הפריטים שמשויכים לאירוע, בפורמט 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` ברמת האירוע וברמת הפריט הם בלתי תלויים.
`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 שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום בהתאמה אישית. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`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 אותיות. * אם מגדירים את הפרמטר `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 שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום בהתאמה אישית. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	מחיר הפריט ביחידות כספיות, ביחידות של פרמטר המטבע שצוין. אם יש הנחה על הפריט, צריך להגדיר את הערך של `price` למחיר המוזל ליחידה ולציין את הנחת המחיר ליחידה בפרמטר `discount`.
`quantity`	`number`	לא	3	כמות הפריט. אם לא מגדירים את הערך, `quantity` מוגדר כ-1.

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

שליחת האירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 אותיות. * אם מגדירים את הפרמטר `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 אותיות. * אם מגדירים את הפרמטר `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 אותיות. * אם מגדירים את `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`.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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`	לא	תערוכה	מקור הליד.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 אותיות. * אם מגדירים את `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 אותיות. * אם מגדירים את הפרמטר `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.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 אותיות. * אם מגדירים את הפרמטר `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({
    "client_id": "client_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

`search`

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

פרמטרים

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

שליחת אירוע

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

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

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

`select_content`

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

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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	המזהה של התוכן ששותף.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 כדי להבין כמה משתמשים השלימו את המדריך.

פרמטרים

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

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

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 כדי להבין כמה משתמשים השלימו את המדריך.

פרמטרים

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

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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	המזהה של ההישג שהנעילה שלו בוטלה.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 אותיות. * אם מגדירים את הפרמטר `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.

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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 אותיות. * אם מגדירים את הפרמטר `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.

שליחת אירוע

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

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

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

`view_item_list`

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

פרמטרים

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

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

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

שליחת אירוע

רוצים לנסות את האירוע הזה ב-Event Builder של 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"
      }
    }]
  })
});