אירועים מומלצים של Google Analytics

ברשימה הבאה מופיעים אירועים מומלצים. אתם יכולים גם ליצור ולשלוח אירועים מותאמים אישית משלכם.

כשיוצרים שמות של אירועים מותאמים אישית, צריך:

  1. פועלים לפי הכללים למתן שמות לאירועים.
  2. הימנעו משימוש בתחיליות ושמות שמורים.
  3. לא לחרוג ממגבלות איסוף האירועים, כמו מגבלת תווים של 40 לשמות של אירועים ופרמטרים.

פרטים נוספים זמינים במאמר תחילת העבודה.

אם אתם משדרגים מ-Measurement Protocol, עיינו בהוראות במאמר שדרוג מ-Measurement Protocol.

כל הנכסים

ad_impression

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

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

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

שדות של אירועים

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

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
ad_platform string לא MoPub פלטפורמת הפרסום.
ad_source string לא AdColony מקור המודעות.
ad_format string לא מודעת באנר פורמט המודעה.
ad_unit_name string לא Banner_03 השם של יחידת המודעות.

דוגמה

בדוגמה הבאה אפשר לראות איך שולחים אירוע ad_impression באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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
      }
    }]
  })
});

earn_virtual_currency

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

שדות של אירועים

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

פרמטרים

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

דוגמה

בדוגמה הבאה אפשר לראות איך שולחים אירוע earn_virtual_currency באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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
      }
    }]
  })
});

join_group

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע join_group באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

login

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע login באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

screen_view

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

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע screen_view באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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 כן חולצות טישרט המונח שהמשתמש חיפש.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע search באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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 לא מכפלה סוג התוכן שנבחר.
content_id string לא C_12345 מזהה של התוכן שנבחר. הערך חייב לכלול לפחות תו אחד שהוא לא ספרה.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע select_content באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

share

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

שדות של אירועים

שם סוג חובה ערך לדוגמה תיאור
cart_data.items Item[] לא הפריטים באירוע.

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע share באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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 השיטה ששימשה להרשמה.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע sign_up באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

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

שדות של אירועים

שם סוג חובה ערך לדוגמה תיאור
conversion_value number כן 5 הערך של המטבע הווירטואלי.
cart_data.items Item[] לא הפריטים באירוע.

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
item_name string לא Starter Boost שם הפריט שמשתמשים במטבע הווירטואלי כדי לרכוש אותו.

פרמטרים

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

דוגמה

בדוגמה הבאה אפשר לראות איך שולחים אירוע spend_virtual_currency באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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 כדי להבין כמה משתמשים מסיימים את המדריך.

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע tutorial_begin באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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 כדי להבין כמה משתמשים משלימים את המדריך.

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע tutorial_complete באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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"
    }]
  })
});

view_search_results

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע view_search_results באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

campaign_details

משתמשים באירוע הזה כדי לשלוח פרטי קמפיין שיוחלו על אירועים עם חותמת זמן ששווה לחותמת הזמן של האירוע 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.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע campaign_details באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

מכירות באינטרנט

add_payment_info

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.
cart_data.coupon_codes string[] לא SUMMER_FUN קוד השובר שמשויך לאירוע.


מגדירים את השדה coupon_codes באובייקט CartData.
* צריך לציין רק קוד שובר אחד ברשימה הזו.
* הפרמטר הזה לא תלוי בקודי שוברים ברמת הפריט.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע add_payment_info באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.
cart_data.coupon_codes string[] לא SUMMER_FUN קוד השובר שמשויך לאירוע.


מגדירים את השדה coupon_codes באובייקט CartData.
* צריך לציין רק קוד שובר אחד ברשימה הזו.
* הפרמטר הזה לא תלוי בקודי שוברים ברמת הפריט.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
shipping_tier string לא קרקע דרגת המשלוח שבחרתם לשליחת הפריט שנקנה (למשל Ground, ‏Air, ‏Next-day).

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע add_shipping_info באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע add_to_cart באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע add_to_wishlist באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.
cart_data.coupon_codes string[] לא SUMMER_FUN קוד השובר שמשויך לאירוע.


מגדירים את השדה coupon_codes באובייקט CartData.
* צריך לציין רק קוד שובר אחד ברשימה הזו.
* הפרמטר הזה לא תלוי בקודי שוברים ברמת הפריט.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע begin_checkout באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

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

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

שדות של אירועים

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

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

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

הפרמטר transaction_id עוזר למנוע כפילות של אירועים ברכישה. מגדירים את השדה transaction_id באובייקט Event.
cart_data.items Item[] לא הפריטים באירוע.

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
product_id string לא ABC123456789 המזהה של המוצר.
subscription boolean לא true

מציין אם הרכישה היא מינוי.
אם לא מגדירים את המדיניות, ברירת המחדל היא false.
free_trial boolean לא true

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

מציין אם יש הנחה על price.
אם לא מגדירים את הפרמטר, ערך ברירת המחדל הוא false.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע in_app_purchase באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "transactionId": "T_12345",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

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":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

שדות של אירועים

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

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

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

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

הפרמטר transaction_id עוזר למנוע כפילות של אירועים ברכישה. מגדירים את השדה transaction_id באובייקט Event.
user_properties.customer_type CustomerType לא NEW אם ההמרה היא מלקוח NEW או RETURNING.
cart_data.items Item[] כן הפריטים באירוע.

מגדירים את השדה cart_data.items באובייקט Event.
cart_data.coupon_codes string[] לא SUMMER_FUN קוד השובר שמשויך לאירוע.


מגדירים את השדה coupon_codes באובייקט CartData.
* צריך לציין רק קוד שובר אחד ברשימה הזו.
* הפרמטר הזה לא תלוי בקודי שוברים ברמת הפריט.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
shipping number לא 3.33 עלות המשלוח שמשויכת לעסקה מסוימת.
tax number לא 1.11 עלות המס שמשויכת לעסקה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע purchase באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.
cart_data.coupon_codes string[] לא SUMMER_FUN קוד השובר שמשויך לאירוע.


מגדירים את השדה coupon_codes באובייקט CartData.
* צריך לציין רק קוד שובר אחד ברשימה הזו.
* הפרמטר הזה לא תלוי בקודי שוברים ברמת הפריט.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
shipping number לא 3.33 עלות המשלוח שמשויכת לעסקה מסוימת.
tax number לא 1.11 עלות המס שמשויכת לעסקה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע refund באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע remove_from_cart באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

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

שדות של אירועים

שם סוג חובה ערך לדוגמה תיאור
cart_data.items Item[] כן* הפריטים באירוע.

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

מגדירים את השדה cart_data.items באובייקט Event.

פרמטרים

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

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

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

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע select_item באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

שדות של אירועים

שם סוג חובה ערך לדוגמה תיאור
cart_data.items Item[] לא הפריטים באירוע.

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

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

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

שם סוג חובה ערך לדוגמה תיאור
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_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות שמשויכת לפריט.

אם לא מגדירים את הפרמטר, ברירת המחדל היא 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 זמין רק ברמת הפריט.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע select_promotion באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע view_cart באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

שדות של אירועים

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

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע view_item באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

שדות של אירועים

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

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

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

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

שם סוג חובה ערך לדוגמה תיאור
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 זמין רק ברמת הפריט.
בנוסף לפרמטרים שנקבעו מראש, אפשר לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע view_item_list באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

שדות של אירועים

שם סוג חובה ערך לדוגמה תיאור
cart_data.items Item[] כן* הפריטים באירוע.

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

מגדירים את השדה cart_data.items באובייקט Event.

שדות פריטים

שם סוג חובה ערך לדוגמה תיאור
item_id string כן I_12345 מזהה ייחודי של הפריט. מגדירים את השדה item_id באובייקט Item.
unit_price number כן 27.67 מחיר היחידה של הפריט הזה, לא כולל מס, משלוח והנחות ברמת האירוע (ברמת העסקה).

אם לפריט יש הנחה ברמת הפריט, צריך להשתמש במחיר היחידה לאחר ההנחה. לדוגמה, אם המחיר ליחידה של פריט הוא 27.67 וההנחה ליחידה היא 6.66, צריך להגדיר את unitPrice ל-21.01.
quantity number כן 1 מספר היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

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

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

שם סוג חובה ערך לדוגמה תיאור
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_slot string לא featured_app_1 השם של משבצת הקריאייטיב לקידום המכירות שמשויכת לפריט.

אם לא מגדירים את הפרמטר, ברירת המחדל היא 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 זמין רק ברמת הפריט.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

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

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע view_promotion באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

משחקים

level_up

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע level_up באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

post_score

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע post_score באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

unlock_achievement

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע unlock_achievement באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

יצירת לידים

close_convert_lead

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

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

שדות של אירועים

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

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

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע close_convert_lead באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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 המטבע של conversion_value של האירוע, בפורמט ISO 4217 בן 3 אותיות.

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

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע close_unconvert_lead באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

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 המטבע של conversion_value של האירוע, בפורמט ISO 4217 בן 3 אותיות.

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

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע disqualify_lead באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

generate_lead

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

שדות של אירועים

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

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

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע generate_lead באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

qualify_lead

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

שדות של אירועים

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

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

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע qualify_lead באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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
      }
    }]
  })
});

working_lead

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

שדות של אירועים

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

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

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

פרמטרים

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

דוגמה

בדוגמה הבאה מוסבר איך לשלוח אירוע working_lead באמצעות Data Manager API. אם אתם משדרגים מ-Measurement Protocol, אתם יכולים להשתמש בכרטיסיות כדי להעביר את הבקשות שלכם ל-Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});