אירועים

תרגום: מושבת

ad_impression

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

  • אירוע ad_impression שנשלח באמצעות Measurement Protocol לא ייכלל בייצוא לפלטפורמות פרסום אחרות, כמו Google Ads.
  • שליחת אירועי ad_impression באמצעות ה-Measurement Protocol עלולה לגרום חשיפות כפולות אם הגדרתם תיוג או את ה-SDK של הקישור מוצרי הפרסום של Google. צריך לשלוח אירוע ad_impression באמצעות Measurement Protocol רק אם האירוע לא תועדו על ידי תיוג או באמצעות ה-SDK.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
ad_platform string לא MoPub פלטפורמת הפרסום.
ad_source string לא AdColony מקור המודעות.
ad_format string לא כרזה פורמט המודעה.
ad_unit_name string לא Banner_03 השם של יחידת המודעות.
currency string לא USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number לא 3.99
הערך של חשיפת המודעה.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי.
* צריך להגדיר את currency אם מגדירים את value.

שליחת האירוע

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

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

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

add_payment_info

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
coupon string לא SUMMER_FUN השם/הקוד של השובר שמשויך לאירוע.

פרמטרים של coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
payment_type string לא כרטיס אשראי אמצעי התשלום הנבחר.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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 מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
coupon string לא SUMMER_FUN השם/הקוד של השובר שמשויך לאירוע.

פרמטרים של coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
shipping_tier string לא קרקע דרגת המשלוח (למשל: Ground, Air, Next-day) שנבחרו למשלוח של הפריט שנרכש.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

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

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
coupon string לא SUMMER_FUN השם/הקוד של השובר שמשויך לאירוע.

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויית.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

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

פרמטרים

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

שליחת האירוע

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

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

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

close_convert_lead

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

פרמטרים

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

* אם מגדירים את 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 באירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את 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 באירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את 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 באירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את 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 אותיות.

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

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

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
transaction_id string כן T_12345 המזהה הייחודי של עסקה.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax. בדרך כלל נדרש הפרמטר
* value לקבלת דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
coupon string לא SUMMER_FUN השם/הקוד של השובר שמשויך לאירוע.

פרמטרים של coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
shipping number לא 3.33 עלות המשלוח המשויכת לעסקה.
tax number לא 1.11 עלות המס שמשויכת לעסקה.
items Array<Item> לא* הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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": "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_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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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": "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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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 מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
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 מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את הפרמטר value, צריך לציין את הפרמטר currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב-items. אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217.

* אם מגדירים את value, חובה לציין currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את value לסכום של (price * quantity) לכל הפריטים ב items אין לכלול shipping או tax.
* value בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר value. חובה להזין
* currency אם מגדירים את הערך value.
items Array<Item> כן הפריטים באירוע.

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

שם סוג חובה ערך לדוגמה תיאור
item_id string כן* SKU_12345

המזהה של הפריט.

*צריך להזין את אחד מהערכים item_id או item_name.

item_name string כן* חולצת Stan and Friends

שם הפריט.

*נדרש אחד מהשדות item_id או item_name.

affiliation string לא Google Store הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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",
      "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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: 'שיוך' זמין רק ברמת הפריט.
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 מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
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"
      }
    }]
  })
});