אירועים

ad_impression

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

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

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

פרמטרים

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

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

שליחת אירוע

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

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

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

add_payment_info

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

add_shipping_info

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

add_to_cart

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

add_to_wishlist

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

begin_checkout

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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


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

campaign_details

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

פרמטרים

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

שליחת אירוע

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

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

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

close_convert_lead

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

פרמטרים

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

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

* בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר value.

שליחת אירוע

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

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

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

close_unconvert_lead

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

פרמטרים

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

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

* בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר value.
unconvert_lead_reason string לא לא התקבלה תשובה הסיבה לכך שהליד לא המיר.

שליחת אירוע

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

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

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

disqualify_lead

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

פרמטרים

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

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

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

שליחת אירוע

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

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

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

earn_virtual_currency

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

פרמטרים

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

שליחת אירוע

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

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

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

generate_lead

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

פרמטרים

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

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

* בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר value.
lead_source string לא תערוכה מסחרית המקור של הליד.

שליחת אירוע

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

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

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

join_group

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

פרמטרים

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

שליחת אירוע

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

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

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

level_up

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

פרמטרים

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

שליחת אירוע

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

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

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

login

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

פרמטרים

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

שליחת אירוע

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

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

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

post_score

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

פרמטרים

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

שליחת אירוע

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

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

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

purchase

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

הפרמטר transaction_id עוזר למנוע כפילות של אירועים ברכישה.
coupon string לא SUMMER_FUN השם/הקוד של השובר שמשויך לאירוע.

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את 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

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

פרמטרים

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

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

* בדרך כלל נדרש value כדי לקבל דיווח משמעותי. אם מסמנים את האירוע כאירוע מרכזי, מומלץ להגדיר את value. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר value.

שליחת אירוע

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

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

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

refund

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

remove_from_cart

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

screen_view

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

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

פרמטרים

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

שליחת אירוע

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

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

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

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

פרמטרים

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

שליחת אירוע

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

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

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

select_content

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

פרמטרים

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

שליחת אירוע

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

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

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

select_item

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את 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 לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
promotion_id string לא P_12345 מזהה המבצע שמשויך לפריט.

אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_id ברמת האירוע.
אם לא מוגדר, נעשה שימוש בpromotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא מבצע קיץ שם המבצע שמשויך לפריט.

אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בpromotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

ניסיון האירוע הזה בכלי ליצירת אירועים ב-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 כן Gems שם המטבע הווירטואלי.
item_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": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

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

פרמטרים

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

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

שליחת אירוע

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

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

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

tutorial_complete

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

פרמטרים

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

שליחת אירוע

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

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

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

unlock_achievement

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

פרמטרים

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

שליחת אירוע

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

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

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

view_cart

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

view_item

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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

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

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

view_item_list

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

פרמטרים

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

מדדי ערך באירוע view_item לא תורמים להכנסה

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

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

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

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

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

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

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

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

שם הפריט.

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

affiliation string לא Google Store הנתונים שמשויכים למוצר ומציינים את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: המאפיין `affiliation` זמין רק ברמת הפריט.
coupon string לא SUMMER_FUN השם או הקוד של השובר שמשויך לפריט.

פרמטרים ברמת האירוע וברמת הפריט הם בלתי תלויים.coupon
discount number לא ‫2.22 הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
index number לא 5 האינדקס או המיקום של הפריט ברשימה.
item_brand string לא Google המותג של הפריט.
item_category string לא ביגוד הקטגוריה של הפריט. אם משתמשים בתכונה הזו כחלק מהיררכיית קטגוריות או טקסונומיה, זו תהיה הקטגוריה הראשונה.
item_category2 string לא אדם מבוגר ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
item_category3 string לא חולצות ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
item_category4 string לא צוות ההפקה ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
item_category5 string לא שרוולים קצרים ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
item_list_id string לא related_products המזהה של הרשימה שבה הפריט הוצג למשתמש.

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

אם הפרמטר הזה מוגדר, המערכת מתעלמת מitem_list_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בitem_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את 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 לא ירוק הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות או פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה המקום ב-Google של סן פרנסיסקו) המיקום הפיזי שמשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה המקום ב-Google שמתאים לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין `location id` זמין רק ברמת הפריט.
price number לא 10.01 מחיר הפריט ביחידות של המטבע שצוין בפרמטר currency. ‫
אם חלה הנחה על הפריט, מגדירים את price למחיר היחידה המוזל ומציינים את ההנחה על מחיר היחידה בפרמטר discount.
promotion_id string לא P_12345 מזהה המבצע שמשויך לפריט.

אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_id ברמת האירוע.
אם לא מוגדר, נעשה שימוש בpromotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא מבצע קיץ שם המבצע שמשויך לפריט.

אם הפרמטר הזה מוגדר, המערכת מתעלמת מpromotion_name ברמת האירוע.
אם לא מוגדר, נעשה שימוש בpromotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

שליחת אירוע

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