Google Analytics-এর সাজেস্ট করা ইভেন্ট

নিচে সাজেস্ট করা ইভেন্টের তালিকা দেওয়া হল। এছাড়াও, আপনি নিজের কাস্টম ইভেন্ট তৈরি করে পাঠাতে পারবেন।

কাস্টম ইভেন্টের নাম তৈরি করার সময় আপনাকে অবশ্যই:

  1. ইভেন্টের নাম রাখার নিয়ম অনুসরণ করুন।
  2. রিজার্ভ করা নাম ও প্রিফিক্স এড়িয়ে চলুন।
  3. ইভেন্ট সংগ্রহের সীমা মেনে চলুন, যেমন ইভেন্ট ও প্যারামিটারের নামের ক্ষেত্রে ৪০ অক্ষরের সীমা।

বিবরণের জন্য শুরু করুন বিকল্পটি দেখুন।

আপনি যদি Measurement Protocol থেকে আপগ্রেড করেন, তাহলে নির্দেশাবলীর জন্য Measurement Protocol থেকে আপগ্রেড করুন দেখুন।

সব প্রপার্টির জন্য

ad_impression

এই ইভেন্ট শুধুমাত্র অ্যাপ স্ট্রিমের জন্য উপলভ্য।

ব্যবহারকারী কোনও বিজ্ঞাপনের ইম্প্রেশন দেখলে এই ইভেন্ট ব্যবহার করুন।

  • Measurement Protocol ব্যবহার করে পাঠানো ad_impression, Google Ads-এর মতো অন্যান্য বিজ্ঞাপন প্ল্যাটফর্মে এক্সপোর্ট করার সময় অন্তর্ভুক্ত করা হবে না।
  • আপনার লিঙ্ক করা Google বিজ্ঞাপন প্রোডাক্টের জন্য ট্যাগিং বা SDK কনফিগার করে থাকলে, মেজারমেন্ট প্রোটোকল ব্যবহার করে ad_impression ইভেন্ট পাঠালে ডুপ্লিকেট ইম্প্রেশন হতে পারে। ট্যাগিং বা SDK-এর মাধ্যমে ইভেন্ট ক্যাপচার করা না হলে, শুধুমাত্র মেজারমেন্ট প্রোটোকল ব্যবহার করে ad_impression ইভেন্ট পাঠান।

ইভেন্টের ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
currency string না ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number না ইউরো (EUR)
বিজ্ঞাপনের ইম্প্রেশনের ভ্যালু।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
ad_platform string না MoPub বিজ্ঞাপন প্ল্যাটফর্ম।
ad_source string না AdColony বিজ্ঞাপন সোর্স।
ad_format string না ব্যানার বিজ্ঞাপনের ফর্ম্যাট।
ad_unit_name string না Banner_03 বিজ্ঞাপন ইউনিটের নাম।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে ad_impression ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 না Gem ভার্চুয়াল মুদ্রার নাম।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে earn_virtual_currency ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 গ্রুপের আইডি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে join_group ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 লগ-ইন করার জন্য ব্যবহৃত পদ্ধতি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে login ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 না মূল অ্যাক্টিভিটি স্ক্রিনের ক্লাস।
screen_name string না সম্পর্কে স্ক্রিনের নাম।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে screen_view ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ টি-শার্ট যে শব্দ সার্চ করা হয়েছে।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে search ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার API-তে মাইগ্রেট করুন।

Data Manager API


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

Measurement Protocol

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

select_content

এই ইভেন্ট থেকে বোঝা যায় যে ব্যবহারকারী নির্দিষ্ট ধরনের কিছু কন্টেন্ট বেছে নিয়েছেন। এই ইভেন্ট আপনার ওয়েবসাইট বা অ্যাপে জনপ্রিয় কন্টেন্ট এবং কন্টেন্টের বিভাগ শনাক্ত করতে সাহায্য করতে পারে।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
content_type string না প্রোডাক্ট বেছে নেওয়া কন্টেন্টের ধরন।
content_id string না C_12345 বেছে নেওয়া কন্টেন্টের শনাক্তকারী। মানে অন্তত একটি সংখ্যা নয় এমন অক্ষর থাকতে হবে।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে select_content ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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[] না ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
method string না Twitter যে পদ্ধতিতে কন্টেন্ট শেয়ার করা হয়।
content_type string না ছবি শেয়ার করা কন্টেন্টের ধরন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে share ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 সাইন-আপ করার জন্য ব্যবহৃত পদ্ধতি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে sign_up ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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[] না ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

আইটেম প্যারামিটার

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_name string না স্টার্টার বুস্ট ভার্চুয়াল কারেন্সি যে আইটেমের জন্য ব্যবহার করা হচ্ছে তার নাম।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
virtual_currency_name string হ্যাঁ Gem ভার্চুয়াল মুদ্রার নাম।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে spend_virtual_currency ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 সহ ফানেলে এটি ব্যবহার করুন।

প্যারামিটারগুলি

এই ইভেন্টের জন্য কোনও প্যারামিটার সাজেস্ট করা হয়নি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে tutorial_begin ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 সহ ফানেলে এটি ব্যবহার করুন।

প্যারামিটারগুলি

এই ইভেন্টের জন্য কোনও প্যারামিটার সাজেস্ট করা হয়নি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে tutorial_complete ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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

ব্যবহারকারীকে সার্চের ফলাফল দেখানো হলে এই ইভেন্ট লগ করুন। মনে রাখবেন যে আপনি Google Analytics-এ উন্নত ইভেন্ট পরিমাপ-এর মাধ্যমে অটোমেটিক সংগ্রহের জন্য view_search_results ইভেন্ট চালু করতে পারবেন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
search_term string না জামাকাপড় সার্চের জন্য ব্যবহৃত শব্দ।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে view_search_results ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার API-তে মাইগ্রেট করুন।

Data Manager API


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

Measurement Protocol

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

campaign_details

ক্যাম্পেনের বিবরণ পাঠাতে এই ইভেন্ট ব্যবহার করুন যা campaign_details ইভেন্টের টাইমস্ট্যাম্পের চেয়ে বেশি বা সমান টাইমস্ট্যাম্প সহ ইভেন্টে প্রয়োগ করা হবে।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
campaign_id string না google_1234 ক্যাম্পেন আইডি।
campaign string না Summer_fun নির্দিষ্ট প্রোমোশন বা স্ট্র্যাটেজিক ক্যাম্পেন শনাক্ত করতে ব্যবহৃত নাম।
source string না google ক্যাম্পেন ট্রাফিকের সোর্স (যেমন, google, ইমেল ইত্যাদি)।
medium string না cpc ক্যাম্পেন মাধ্যম (যেমন, ইমেল, কস্ট-পার-ক্লিক ইত্যাদি)
term string না গ্রীষ্মকাল+ভ্রমণ বিজ্ঞাপনের জন্য কীওয়ার্ড প্রদান করতে পেড সার্চের সাথে ক্যাম্পেন টার্ম ব্যবহার করা হয়।
content string না logolink A/B টেস্টিং এবং কন্টেন্ট-টার্গেট করা বিজ্ঞাপনের জন্য ব্যবহৃত ক্যাম্পেন কন্টেন্ট, যা একই URL-এ নির্দেশ করা বিজ্ঞাপন বা লিঙ্কগুলিকে আলাদা করে।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে campaign_details ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এ থাকা সব আইটেমের জন্য (price * quantity)-এর যোগফল হিসেবে conversion_value সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।
cart_data.coupon_codes string[] না SUMMER_FUN ইভেন্টের সাথে যুক্ত কুপন কোড।


CartData অবজেক্টে coupon_codes ফিল্ড সেট করুন।
* এই তালিকায় শুধুমাত্র একটি কুপন কোড দিন।
* এটি আইটেম-লেভেল কুপন কোড থেকে আলাদা।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
payment_type string না ক্রেডিট কার্ড বেছে নেওয়া পেমেন্ট পদ্ধতি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে add_payment_info ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এ থাকা সব আইটেমের জন্য (price * quantity)-এর যোগফল হিসেবে conversion_value সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।
cart_data.coupon_codes string[] না SUMMER_FUN ইভেন্টের সাথে যুক্ত কুপন কোড।


CartData অবজেক্টে coupon_codes ফিল্ড সেট করুন।
* এই তালিকায় শুধুমাত্র একটি কুপন কোড দিন।
* এটি আইটেম-লেভেল কুপন কোড থেকে আলাদা।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
shipping_tier string না গ্রাউন্ড কেনা আইটেম ডেলিভারি করার জন্য বেছে নেওয়া শিপিং টিয়ার (যেমন, Ground, Air, Next-day)।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে add_shipping_info ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এর সব আইটেমের জন্য conversion_value-কে (price * quantity)-এর যোগফল হিসেবে সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে add_to_cart ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এ থাকা সব আইটেমের জন্য (price * quantity)-এর যোগফল হিসেবে conversion_value সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে add_to_wishlist ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এর সব আইটেমের জন্য conversion_value-কে (price * quantity)-এর যোগফল হিসেবে সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।
cart_data.coupon_codes string[] না SUMMER_FUN ইভেন্টের সাথে যুক্ত কুপন কোড।


CartData অবজেক্টে coupon_codes ফিল্ড সেট করুন।
* এই তালিকায় শুধুমাত্র একটি কুপন কোড দিন।
* এটি আইটেম-লেভেল কুপন কোড থেকে আলাদা।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে begin_checkout ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
transaction_id string না T_12345 ট্রানজ্যাকশনের অনন্য শনাক্তকারী।

transaction_id প্যারামিটার আপনাকে কেনাকাটার জন্য ডুপ্লিকেট ইভেন্ট পাওয়া এড়াতে সাহায্য করে। Event অবজেক্টে transaction_id ফিল্ড সেট করুন।
cart_data.items Item[] না ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
product_id string না ABC123456789 প্রোডাক্টের আইডি।
subscription boolean না সত্য

কেনাকাটাটি সাবস্ক্রিপশন কিনা তা নির্দেশ করে।
সেট করা না থাকলে, ডিফল্ট হিসেবে false সেট করা হয়।
free_trial boolean না সত্য

ইভেন্টটি কোনও সাবস্ক্রিপশনের ফ্রি ট্রায়ালের জন্য কিনা তা নির্দেশ করে।
সেট করা না থাকলে, ডিফল্ট হিসেবে false সেট করা হয়।
price_is_discounted boolean না মিথ্যা

price-এ ছাড় আছে কিনা তা দেখায়।
সেট করা না থাকলে, ডিফল্ট হিসেবে false সেট করা হয়।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে in_app_purchase ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার API-তে মাইগ্রেট করুন।

Data Manager API


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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

কোনও ব্যবহারকারী এক বা একাধিক আইটেম কিনলে এই ইভেন্টটি তা বোঝায়।

ইভেন্টের ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
currency string হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এর সব আইটেমের জন্য conversion_value-কে (price * quantity)-এর যোগফল হিসেবে সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
transaction_id string হ্যাঁ T_12345 ট্রানজ্যাকশনের অনন্য শনাক্তকারী।

transaction_id প্যারামিটার আপনাকে কেনাকাটার জন্য ডুপ্লিকেট ইভেন্ট পাওয়া এড়াতে সাহায্য করে। Event অবজেক্টে transaction_id ফিল্ড সেট করুন।
user_properties.customer_type CustomerType না NEW কনভার্সনটি NEW নাকি RETURNING গ্রাহকের থেকে হয়েছে।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।
cart_data.coupon_codes string[] না SUMMER_FUN ইভেন্টের সাথে যুক্ত কুপন কোড।


CartData অবজেক্টে coupon_codes ফিল্ড সেট করুন।
* এই তালিকায় শুধুমাত্র একটি কুপন কোড দিন।
* এটি আইটেম-লেভেল কুপন কোড থেকে আলাদা।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
shipping number না ৩.৩৩ ট্রানজ্যাকশনের সাথে যুক্ত শিপিং খরচ।
tax number না ১.১১ ট্রানজ্যাকশনের সাথে যুক্ত ট্যাক্সের খরচ।

আইটেম প্যারামিটার

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_name string হ্যাঁ* Stan and Friends টি-শার্ট

আইটেমের নাম।

*item_id বা item_name-এর মধ্যে যেকোনও একটি প্রয়োজন।

affiliation string না Google Store প্রোডাক্ট অ্যাফিলিয়েশন যা সাপ্লাই করা কোম্পানি বা ফিজিক্যাল স্টোরের লোকেশন চিহ্নিত করে।
মনে রাখবেন: affiliation শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
coupon string না SUMMER_FUN আইটেমের সাথে যুক্ত কুপনের নাম/কোড।

ইভেন্ট-লেভেল ও আইটেম-লেভেল coupon প্যারামিটার স্বতন্ত্র।
discount number না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে purchase ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এ থাকা সব আইটেমের জন্য (price * quantity)-এর যোগফল হিসেবে conversion_value সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
transaction_id string হ্যাঁ T_12345 ট্রানজ্যাকশনের অনন্য শনাক্তকারী।
cart_data.items Item[] না ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।
cart_data.coupon_codes string[] না SUMMER_FUN ইভেন্টের সাথে যুক্ত কুপন কোড।


CartData অবজেক্টে coupon_codes ফিল্ড সেট করুন।
* এই তালিকায় শুধুমাত্র একটি কুপন কোড দিন।
* এটি আইটেম-লেভেল কুপন কোড থেকে আলাদা।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
quantity number হ্যাঁ 1 এই নির্দিষ্ট আইটেমের জন্য কেনা ইউনিটের পরিমাণ।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
shipping number না ৩.৩৩ ট্রানজ্যাকশনের সাথে যুক্ত শিপিং খরচ।
tax number না ১.১১ ট্রানজ্যাকশনের সাথে যুক্ত ট্যাক্সের খরচ।

আইটেম প্যারামিটার

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_name string হ্যাঁ* Stan and Friends টি-শার্ট

আইটেমের নাম।

*item_id বা item_name-এর মধ্যে যেকোনও একটি প্রয়োজন।

affiliation string না Google Store প্রোডাক্ট অ্যাফিলিয়েশন যা সাপ্লাই করা কোম্পানি বা ফিজিক্যাল স্টোরের লোকেশন চিহ্নিত করে।
মনে রাখবেন: affiliation শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
coupon string না SUMMER_FUN আইটেমের সাথে যুক্ত কুপনের নাম/কোড।

ইভেন্ট-লেভেল ও আইটেম-লেভেল coupon প্যারামিটার স্বতন্ত্র।
discount number না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে refund ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এর সব আইটেমের জন্য conversion_value-কে (price * quantity)-এর যোগফল হিসেবে সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে remove_from_cart ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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-এ শুধু প্রথম এলিমেন্ট ব্যবহার করা হবে।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে select_item ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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[] না ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
promotion_id string না P_12345 আইটেমের সাথে যুক্ত প্রচারের আইডি।

সেট করা না থাকলে, ডিফল্ট হিসেবে ইভেন্ট-লেভেল promotion_id সেট করা হয়।
promotion_name string না গ্রীষ্মকালীন সেল আইটেমের সাথে যুক্ত প্রোমোশনের নাম।

সেট করা না থাকলে, ডিফল্ট হিসেবে ইভেন্ট-লেভেল promotion_name সেট করা হয়।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে select_promotion ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এর সব আইটেমের জন্য conversion_value-কে (price * quantity)-এর যোগফল হিসেবে সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে view_cart ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* items-এর সব আইটেমের জন্য conversion_value-কে (price * quantity)-এর যোগফল হিসেবে সেট করুন। shipping বা tax অন্তর্ভুক্ত করবেন না।
* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* আপনি conversion_value সেট করলে currency প্রয়োজন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে view_item ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের সাথে সম্পর্কিত আইটেমের মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* view_item ইভেন্টের ভ্যালু মেট্রিক যাতে উপার্জনে অবদান না রাখে

* আপনি conversion_value সেট করলে, উপার্জনের মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
cart_data.items Item[] হ্যাঁ ইভেন্টের জন্য আইটেম।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে view_item_list ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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-এ শুধু প্রথম এলিমেন্ট ব্যবহার করা হবে।

Event অবজেক্টে cart_data.items ফিল্ড সেট করুন।

আইটেম ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
item_id string হ্যাঁ I_12345 আইটেমের জন্য একটি অনন্য শনাক্তকারী। Item অবজেক্টে item_id ফিল্ড সেট করুন।
unit_price number হ্যাঁ ২৭.৬৭ এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য।

আইটেমে আইটেম স্কোপড ছাড় থাকলে, ছাড় দেওয়া ইউনিট মূল্য ব্যবহার করুন। যেমন, কোনও আইটেমের ইউনিট প্রাইস ২৭.৬৭ এবং ইউনিট ডিসকাউন্ট ৬.৬৬ হলে, unitPrice-এর ভ্যালু ২১.০১ হিসেবে সেট করুন।
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 না ২.২২ আইটেমের সাথে যুক্ত ইউনিট আর্থিক ছাড়ের ভ্যালু।
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 Place ID) আইটেমের সাথে যুক্ত ফিজিক্যাল লোকেশন (যেমন, ফিজিক্যাল স্টোরের লোকেশন)। সংশ্লিষ্ট আইটেমের সাথে মানানসই Google প্লেস আইডি ব্যবহার করার সাজেশন দেওয়া হয়। এছাড়াও, কাস্টম লোকেশন আইডি ব্যবহার করা যেতে পারে।
মনে রাখবেন: location_id শুধুমাত্র আইটেম-স্কোপে উপলভ্য।
promotion_id string না P_12345 আইটেমের সাথে যুক্ত প্রচারের আইডি।

সেট করা না থাকলে, ডিফল্ট হিসেবে ইভেন্ট-লেভেল promotion_id সেট করা হয়।
promotion_name string না গ্রীষ্মকালীন সেল আইটেমের সাথে যুক্ত প্রোমোশনের নাম।

সেট করা না থাকলে, ডিফল্ট হিসেবে ইভেন্ট-লেভেল promotion_name সেট করা হয়।
নির্ধারিত প্যারামিটার ছাড়াও, আপনি items অ্যারেতে সর্বাধিক ২৭টি কাস্টম প্যারামিটার যোগ করতে পারবেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে view_promotion ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 না খেলোয়াড় ১ যে চরিত্রটি লেভেল আপ করেছে।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে level_up ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 না খেলোয়াড় ১ যে চরিত্রটি স্কোর অর্জন করেছে।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে post_score ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 আনলক করা কৃতিত্বের আইডি।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে unlock_achievement ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে close_convert_lead ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
unconvert_lead_reason string না কখনও উত্তর দেননি লিড কনভার্ট না হওয়ার কারণ।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে close_unconvert_lead ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
disqualified_lead_reason string না কেনার কথা ভাবছি না লিডকে অযোগ্য হিসেবে চিহ্নিত করার কারণ।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে disqualify_lead ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
lead_source string না ট্রেড শো লিডের সোর্স।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে generate_lead ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার API-তে মাইগ্রেট করুন।

Data Manager API


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

Measurement Protocol

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

qualify_lead

কোনও ব্যবহারকারীকে কোয়ালিফায়েড লিড হিসেবে চিহ্নিত করার জন্য প্রয়োজনীয় শর্ত পূরণ করলে, এই ইভেন্ট তা পরিমাপ করে।

ইভেন্টের ফিল্ড

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
currency string হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে qualify_lead ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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 হ্যাঁ* ২.৭৯ ইভেন্টের conversion_value-এর মুদ্রা, ৩-অক্ষরের ISO 4217 ফর্ম্যাটে।

* আপনি conversion_value সেট করলে, উপার্জন সংক্রান্ত মেট্রিক সঠিকভাবে গণনা করার জন্য currency প্রয়োজন।
conversion_value number হ্যাঁ* ৩০.০৩ ইভেন্টের আর্থিক মূল্য।

* conversion_value সাধারণত অর্থপূর্ণ রিপোর্টিংয়ের জন্য প্রয়োজন। আপনি যদি ইভেন্টটিকে গুরুত্বপূর্ণ ইভেন্ট হিসেবে চিহ্নিত করেন তাহলে আপনাকে conversion_value সেট করার সাজেশন দেওয়া হয়।
* currency প্রয়োজন যদি আপনি conversion_value সেট করেন।

প্যারামিটারগুলি

নাম ধরন প্রয়োজনীয় উদাহরণ হিসেবে দেওয়া ভ্যালু বিবরণ
lead_status string না কথোপকথন শুরু করেছেন লিডের স্ট্যাটাস।

উদাহরণ

ডেটা ম্যানেজার API ব্যবহার করে কীভাবে working_lead ইভেন্ট পাঠাতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি Measurement Protocol থেকে আপগ্রেড করলে, ট্যাব ব্যবহার করে আপনার অনুরোধ ডেটা ম্যানেজার 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"
      }
    }]
  })
});