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

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

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

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

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

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

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

ad_impression

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

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

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

ইভেন্ট ফিল্ড

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

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

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 ভার্চুয়াল মুদ্রার নাম।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 গ্রুপের আইডি।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 লগ-ইন করার জন্য ব্যবহৃত পদ্ধতি।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 না সম্পর্কে স্ক্রিনের নাম।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 হ্যাঁ টি-শার্ট যে শব্দ সার্চ করা হয়েছে।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 বেছে নেওয়া কন্টেন্টের শনাক্তকারী। ভ্যালুতে অবশ্যই অন্তত একটি সংখ্যা নয় এমন অক্ষর থাকতে হবে।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 না ছবি শেয়ার করা কন্টেন্টের ধরন।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সাইন-আপ করার জন্য ব্যবহৃত পদ্ধতি।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 ভার্চুয়াল মুদ্রার নাম।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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-এর সাথে এটি একটি ফানেলে ব্যবহার করুন।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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-এর সাথে এই ইভেন্টটি ফানেলে ব্যবহার করুন।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 না জামাকাপড় সার্চের জন্য ব্যবহৃত শব্দ।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

campaign_details

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

উপস্থিত থাকবে।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয়।
* আপনি conversion_value সেট করলে currency প্রয়োজন।
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 না ক্রেডিট কার্ড বেছে নেওয়া পেমেন্ট পদ্ধতি।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয়।
* আপনি conversion_value সেট করলে currency প্রয়োজন।
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)।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।
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 থাকে।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 না প্লেয়ার ১ যে চরিত্রটি লেভেল আপ করেছে।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 না প্লেয়ার ১ যে চরিত্রটি স্কোর করেছে।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 আনলক করা কৃতিত্বের আইডি।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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 সেট করার জন্য সাজেস্ট করা হয় ।
* আপনি conversion_value সেট করলে currency প্রয়োজন।

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

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

উদাহরণ

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

Data Manager API


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

মেজারমেন্ট প্রোটোকল

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