אירועים

ad_impression

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

פרמטרים

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

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

שליחת אירוע

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

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

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

add_payment_info

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

פרמטרים

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

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

add_shipping_info

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

פרמטרים

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

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

add_to_cart

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

פרמטרים

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

add_to_wishlist

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

פרמטרים

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

begin_checkout

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

פרמטרים

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

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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


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

campaign_details

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

פרמטרים

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

שליחת אירוע

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

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

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

earn_virtual_currency

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

פרמטרים

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

שליחת אירוע

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

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

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

generate_lead

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

פרמטרים

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

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

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

שליחת אירוע

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

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

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

join_group

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

פרמטרים

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

שליחת אירוע

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

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

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

level_up

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

פרמטרים

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

שליחת אירוע

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

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

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

התחברות

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

פרמטרים

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

שליחת אירוע

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

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

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

post_score

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

פרמטרים

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

שליחת אירוע

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

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

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

purchase

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

פרמטרים

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

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

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

refund

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

פרמטרים

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

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

remove_from_cart

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

פרמטרים

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

screen_view

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

פרמטרים

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

שליחת אירוע

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

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

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

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

פרמטרים

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

שליחת אירוע

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

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

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

select_content

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

פרמטרים

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

שליחת אירוע

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

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

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

select_item

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

פרמטרים

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

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

select_promotion

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

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

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

המערכת מתעלמת מהמדיניות אם היא מוגדרת ברמת הפריט.
promotion_name string לא Summer Sale שם המבצע שמשויך לאירוע.

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

שיתוף אחד

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

פרמטרים

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

שליחת אירוע

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

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

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

sign_up

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

פרמטרים

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

שליחת אירוע

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

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

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

spend_virtual_currency

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

פרמטרים

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

שליחת אירוע

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

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

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

tutorial_begin

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

פרמטרים

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

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

שליחת אירוע

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

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

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

tutorial_complete

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

פרמטרים

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

שליחת אירוע

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

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

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

unlock_achievement

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

פרמטרים

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

שליחת אירוע

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

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

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

view_cart

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

פרמטרים

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

view_item

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

פרמטרים

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

view_item_list

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

פרמטרים

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

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

view_promotion

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

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

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

המערכת מתעלמת מהמדיניות אם היא מוגדרת ברמת הפריט.
promotion_name string לא Summer Sale שם המבצע שמשויך לאירוע.

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

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

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

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

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

*חובה לציין item_id או item_name.

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

שם הפריט.

*חובה לציין item_id או item_name.

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

פרמטרים coupon ברמת האירוע וברמת הפריט הם בלתי תלויים.
creative_name string לא summer_banner2 השם של הקריאייטיב לקידום מכירות.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות creative_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-creative_name ברמת האירוע, אם הוא קיים.
creative_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות המשויכת לפריט.

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

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

אם היא מוגדרת, המערכת מתעלמת מהמדיניות item_list_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-item_list_name ברמת האירוע, אם הוא קיים.
item_variant string לא green הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של אפשרויות/פרטים נוספים של הפריט.
location_id string לא ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה מקום Google של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

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

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

שליחת אירוע

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

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

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

view_search_results

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

פרמטרים

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

שליחת אירוע

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

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

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