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

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

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

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

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

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

כל הנכסים

ad_impression

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

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

  • ad_impression שנשלח באמצעות Measurement Protocol לא ייכלל בייצוא לפלטפורמות פרסום אחרות, כמו Google Ads.
  • שליחת אירועים באמצעות Measurement Protocol עלולה לגרום להצגת כפילויות של חשיפות אם הגדרתם תיוג או SDK עבור מוצרי הפרסום המקושרים של Google.ad_impression שולחים אירוע 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 לא product סוג התוכן שנבחר.
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, ‏ email וכו').
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. ‫
* הפרמטר 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 כמות היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
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. ‫
* הפרמטר 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_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. ‫
* הפרמטר 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 כמות היחידות שנרכשו מהפריט הספציפי הזה.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
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",
      "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,
        "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. ‫
* הפרמטר 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_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. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר conversion_value.

דוגמה

בדוגמה הבאה אפשר לראות איך שולחים אירוע 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. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר conversion_value.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
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. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר conversion_value.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
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. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר conversion_value.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
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

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

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

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

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

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

דוגמה

בדוגמה הבאה אפשר לראות איך שולחים אירוע 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. ‫
* הפרמטר currency נדרש אם מגדירים את הפרמטר conversion_value.

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
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"
      }
    }]
  })
});