পরিমাপ প্রোটোকল রেফারেন্স

এই পৃষ্ঠাটি পরিমাপ প্রোটোকলের পরিবহন প্রক্রিয়া এবং ডেটা পরামিতিগুলি বর্ণনা করে।

পরিবহন

সমস্ত ডেটা HTTPS POST অনুরোধ ব্যবহার করে নিরাপদে পাঠাতে হবে।

নিম্নলিখিত শেষ বিন্দুতে অনুরোধ পাঠান:

https://www.google-analytics.com/mp/collect

আপনি যদি চান যে আপনার তথ্য EU তে সংগ্রহ করা হোক, তাহলে নিম্নলিখিত এন্ডপয়েন্টটি ব্যবহার করুন:

https://region1.google-analytics.com/mp/collect

এখানে একটি নমুনা POST অনুরোধ রয়েছে:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

অনুরোধের পেলোড দিয়ে PAYLOAD_DATA প্রতিস্থাপন করুন।

HTTP অনুরোধ গৃহীত হলে পরিমাপ প্রোটোকল একটি 2xx স্ট্যাটাস কোড প্রদান করে। যদি পেলোডটি ত্রুটিপূর্ণ হয়, অথবা ডেটা ভুল হয় বা Google Analytics দ্বারা প্রক্রিয়াজাত না হয় তবে পরিমাপ প্রোটোকল কোনও ত্রুটি কোড প্রদান করে না।

পেলোড

পেলোডের দুটি অংশ রয়েছে:

  1. কোয়েরি প্যারামিটার।
  2. একটি JSON POST বডি।

কোয়েরি প্যারামিটার

প্যারামিটারের নাম বিবরণ

api_secret

 প্রয়োজনীয় । গুগল অ্যানালিটিক্স UI থেকে API গোপনীয়তা ।

অ্যাডমিন > ডেটা স্ট্রিম > আপনার স্ট্রিম নির্বাচন করুন > পরিমাপ প্রোটোকল > তৈরি করুন এর অধীনে পাওয়া যাবে।

আপনার প্রতিষ্ঠানের জন্য ব্যক্তিগত। অতিরিক্ত স্প্যাম এড়াতে নিয়মিত আপডেট করা উচিত।

JSON POST বডি

চাবি আদর্শ বিবরণ

user_id

 string

ঐচ্ছিক । ব্যবহারকারীর জন্য একটি অনন্য শনাক্তকারী। এই শনাক্তকারী সম্পর্কে আরও তথ্যের জন্য ক্রস-প্ল্যাটফর্ম বিশ্লেষণের জন্য ব্যবহারকারী-আইডি দেখুন। শুধুমাত্র utf-8 অক্ষর অন্তর্ভুক্ত থাকতে পারে।

timestamp_micros

 number

ঐচ্ছিক । একটি ইউনিক্স টাইমস্ট্যাম্প, মাইক্রোসেকেন্ড , মিলিসেকেন্ড নয়। ইভেন্টের সময় প্রতিনিধিত্ব করে। শুধুমাত্র অতীতে ঘটে যাওয়া ইভেন্টগুলি রেকর্ড করার জন্য সেট করা উচিত। user_property বা ইভেন্ট টাইমস্ট্যাম্প দ্বারা ওভাররাইড করা যেতে পারে। ইভেন্টগুলি ৭২ ঘন্টা পর্যন্ত ব্যাকডেট করা যেতে পারে।

user_properties

 object ঐচ্ছিক । পরিমাপের জন্য ব্যবহারকারীর বৈশিষ্ট্য ।

user_data

 object ঐচ্ছিক । ব্যবহারকারীর সরবরাহিত তথ্য ।
object ঐচ্ছিক । অনুরোধের জন্য সম্মতি সেটিংস। আরও তথ্যের জন্য সম্মতি বিভাগটি দেখুন।

non_personalized_ads

 boolean ঐচ্ছিক । ব্যবহারকারীর ডেটা ব্যক্তিগতকৃত বিজ্ঞাপনের জন্য ব্যবহার করা উচিত নয় তা বোঝাতে true হিসেবে সেট করুন।

user_location

 object ঐচ্ছিক । অনুরোধের জন্য ভৌগোলিক তথ্য একটি কাঠামোগত বিন্যাসে সেট করে।

ip_override

 string ঐচ্ছিক । অনুরোধের জন্য ভৌগোলিক তথ্য সংগ্রহ করতে Google Analytics যে IP ঠিকানা ব্যবহার করে।

device

 object ঐচ্ছিক। অনুরোধের জন্য ডিভাইসের তথ্য একটি কাঠামোগত বিন্যাসে সেট করে।

validation_behavior

 string

ঐচ্ছিক। অনুরোধের জন্য বৈধতা আচরণ সেট করে।

হয় RELAXED অথবা ENFORCE_RECOMMENDATIONS । নির্দিষ্ট না থাকলে ডিফল্টভাবে RELAXED ।

events[]

 array প্রয়োজনীয় । event আইটেমের একটি অ্যারে। প্রতিটি অনুরোধে সর্বোচ্চ ২৫টি ইভেন্ট পাঠানো যেতে পারে। সমস্ত বৈধ ইভেন্টের জন্য ইভেন্ট রেফারেন্স দেখুন।

events[].name

 string প্রয়োজনীয় । ইভেন্টের নাম। সকল বিকল্পের জন্য ইভেন্ট দেখুন।

events[].params

 object ঐচ্ছিক । ইভেন্টের জন্য প্যারামিটার। প্রতিটি ইভেন্টের জন্য প্রস্তাবিত প্যারামিটারগুলির জন্য ইভেন্ট এবং সাধারণ ইভেন্ট প্যারামিটারগুলি দেখুন।

সাধারণ ইভেন্ট প্যারামিটার

পরিমাপ প্রোটোকলের নিম্নলিখিত সাধারণ ইভেন্ট প্যারামিটার রয়েছে:

চাবি আদর্শ বিবরণ

session_id

 number একটি ধনাত্মক সংখ্যা যা ব্যবহারকারীর সেশন শনাক্ত করে। বেশ কয়েকটি সাধারণ ব্যবহারের ক্ষেত্রে প্রয়োজন। নিয়মিত এক্সপ্রেশন ^\d+$ এর সাথে মিলতে হবে।

engagement_time_msec

 number ইভেন্টের জন্য ব্যবহারকারীর ব্যস্ততার সময়কাল, মিলিসেকেন্ডে। পূর্ববর্তী ইভেন্টের পর থেকে ব্যবহারকারীর ব্যস্ততার সময়কাল প্রতিফলিত করে এমন একটি মান ব্যবহার করুন।

timestamp_micros

 number ইভেন্টের জন্য ইউনিক্স এপোক সময়, মাইক্রোসেকেন্ডে। ইভেন্টের টাইমস্ট্যাম্প ওভাররাইড করতে এই প্যারামিটারটি ব্যবহার করুন।

consent বৈশিষ্ট্যটি সম্মতির ধরণগুলি কনফিগার করে এবং উল্লেখ করে। আপনি যদি consent নির্দিষ্ট না করেন, তাহলে Google Analytics ক্লায়েন্ট বা অ্যাপ ইনস্ট্যান্সের জন্য সংশ্লিষ্ট অনলাইন ইন্টারঅ্যাকশন থেকে সম্মতি সেটিংস ব্যবহার করে।

চাবি আদর্শ বিবরণ

ad_user_data

 string

ঐচ্ছিক । বিজ্ঞাপনের উদ্দেশ্যে অনুরোধের ইভেন্ট এবং ব্যবহারকারীর বৈশিষ্ট্য থেকে ব্যবহারকারীর ডেটা Google-এ পাঠানোর জন্য সম্মতি।

হয় GRANTED অথবা DENIED ।

ad_personalization

 string

ঐচ্ছিক । ব্যবহারকারীর জন্য ব্যক্তিগতকৃত বিজ্ঞাপনের জন্য সম্মতি।

হয় GRANTED অথবা DENIED ।

ভৌগোলিক তথ্য

user_location এবং ip_override বৈশিষ্ট্যগুলি ভৌগোলিক তথ্য প্রদান করে। ip_override চেয়ে user_location অগ্রাধিকার পায়।

এখানে user_location ক্ষেত্রের গঠন দেওয়া হল। যতটা সম্ভব অ্যাট্রিবিউট প্রদান করুন। আমরা কমপক্ষে country_id এবং region_id ব্যবহার করার পরামর্শ দিচ্ছি।

চাবি আদর্শ বিবরণ

city

 string ঐচ্ছিক । শহরের নাম । যদি শহরটি মার্কিন যুক্তরাষ্ট্রে থাকে, তাহলে country_id এবং region_id সেট করুন যাতে Google Analytics শহরের নামটি সঠিকভাবে একটি শহরের ID- তে ম্যাপ করতে পারে।

region_id

 string ঐচ্ছিক । ISO 3166 দেশ এবং উপবিভাগ। উদাহরণস্বরূপ, US-CA , US-AR , CA-BC , GB-LND , CN-HK ।

country_id

 string ঐচ্ছিক । ISO 3166-1 alpha-2 ফর্ম্যাটে দেশ। উদাহরণস্বরূপ, US , AU , ES , FR ।

subcontinent_id

 string ঐচ্ছিক । UN M49 ফর্ম্যাটে উপমহাদেশ। উদাহরণস্বরূপ, 011 , 021 , 030 , 039 ।

continent_id

 string ঐচ্ছিক । UN M49 ফর্ম্যাটে মহাদেশ। উদাহরণস্বরূপ, 002 , 019 , 142 , 150 ।

এখানে একটি নমুনা user_location দেওয়া হল:

"user_location": {
  "city": "Mountain View",
  "region_id": "US-CA",
  "country_id": "US",
  "subcontinent_id": "021",
  "continent_id": "019"
}

ip_override হল user_location এর বিকল্প। যদি আপনি ip_override পাঠান, তাহলে Google Analytics IP ঠিকানা থেকে ভৌগোলিক তথ্য সংগ্রহ করবে। যদি আপনি user_location পাঠান, তাহলে Google Analytics ip_override উপেক্ষা করবে।

যদি আপনি user_location বা ip_override না পাঠান, তাহলে Google Analytics ইভেন্ট ট্যাগিং থেকে ভৌগোলিক তথ্য সংগ্রহ করেclient_id ।

ভৌগোলিক তথ্য পাঠানো হোক না কেন, অনুরোধের ক্ষেত্রে Google Analytics সম্পত্তির গ্রানুলার লোকেশন ডেটা সেটিংস প্রয়োগ করে।

ডিভাইসের তথ্য

ডিভাইসের তথ্য পাঠাতে, device ফিল্ডটি ব্যবহার করুন। device ফিল্ডের গঠন এখানে দেওয়া হল। যতটা সম্ভব অ্যাট্রিবিউট প্রদান করুন। আমরা ন্যূনতম category সুপারিশ করি।

চাবি আদর্শ বিবরণ

category

 string ঐচ্ছিক। ডিভাইসের বিভাগ। উদাহরণস্বরূপ, desktop , tablet , mobile , smart TV ।

language

 string ঐচ্ছিক। ভাষাটি ISO 639-1 ফর্ম্যাটে । উদাহরণস্বরূপ, en , en-US ।

screen_resolution

 string ঐচ্ছিক। ডিভাইসের রেজোলিউশন, WIDTHxHEIGHT হিসাবে ফর্ম্যাট করা। উদাহরণস্বরূপ, 1280x2856 , 1080x2340 ।

operating_system

 string ঐচ্ছিক। অপারেটিং সিস্টেম বা প্ল্যাটফর্ম। উদাহরণস্বরূপ, MacOS ।

operating_system_version

 string ঐচ্ছিক। অপারেটিং সিস্টেম বা প্ল্যাটফর্মের সংস্করণ। উদাহরণস্বরূপ, 13.5 ।

model

 string ঐচ্ছিক। ডিভাইসের মডেল। উদাহরণস্বরূপ, Pixel 9 Pro , Samsung Galaxy S24 ।

brand

 string ঐচ্ছিক। ডিভাইসের ব্র্যান্ড। উদাহরণস্বরূপ, Google , Samsung ।

browser

 string ঐচ্ছিক। ব্রাউজারের ব্র্যান্ড বা ধরণ। উদাহরণস্বরূপ, Chrome , Firefox ।

browser_version

 string ঐচ্ছিক। ব্রাউজারের সংস্করণ। উদাহরণস্বরূপ, 136.0.7103.60 , 5.0 ।

নিম্নলিখিত স্নিপেটটি device সেটিংসের একটি উদাহরণ দেখায়:

"device": {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

আপনি নির্দিষ্ট করুন না কেনGoogle Analytics অনুরোধে প্রপার্টির গ্রানুলার ডিভাইস ডেটা সেটিংস প্রয়োগ করে।

বৈধতা আচরণ

validation_behavior অ্যাট্রিবিউটটি নিয়ন্ত্রণ করে যে পরিমাপ প্রোটোকল কীভাবে অনুরোধের বিষয়বস্তু যাচাই করে।

  • RELAXED ভ্যালিডেশন শুধুমাত্র ত্রুটিপূর্ণ অনুরোধ প্রত্যাখ্যান করে। এটি এখনও অবৈধ ফিল্ড নাম বা সঠিক ধরণের নয় এমন ডেটা সহ ইভেন্ট এবং প্যারামিটার গ্রহণ করতে পারে, কিন্তু এটি সীমা অতিক্রমকারী প্যারামিটারগুলিকে উপেক্ষা করে। পরিমাপ প্রোটোকল ডিফল্টরূপে RELAXED ভ্যালিডেশন ব্যবহার করে।
  • ENFORCE_RECOMMENDATIONS যাচাইকরণ এমন ইভেন্ট এবং আইটেম প্যারামিটারগুলিকে প্রত্যাখ্যান করে যা সঠিক ধরণের নয় বা যেগুলিতে সীমা অতিক্রম করে এমন প্যারামিটার রয়েছে। এছাড়াও, ENFORCE_RECOMMENDATIONS এমন কোনও ইভেন্ট বা ব্যবহারকারীর সম্পত্তি প্রত্যাখ্যান করে যার টাইমস্ট্যাম্প গত 72 ঘন্টার মধ্যে নেই।

আমরা নিম্নলিখিত পদ্ধতিটি সুপারিশ করি:

  • আপনার অনুরোধের সম্ভাব্য সমস্যা সম্পর্কে যতটা সম্ভব প্রতিক্রিয়া পেতে ইভেন্টগুলি যাচাই করার সময় ENFORCE_RECOMMENDATIONS ব্যবহার করুন।

    আপনি ইভেন্ট বিল্ডার ব্যবহার করেও অনুরোধগুলি যাচাই করতে পারেন কারণ এটি অনুরোধগুলি যাচাই করার সময় ENFORCE_RECOMMENDATIONS নির্দিষ্ট করে।

  • পরিমাপ প্রোটোকল দ্বারা প্রত্যাখ্যাত ডেটা মিনিমাইজ করার জন্য ইভেন্ট পাঠানোর সময় validation_behavior নির্দিষ্ট করবেন না।

    যদি আপনি কোনও নির্দিষ্ট অনুরোধ পাঠানোর সময় ডেটা সংগ্রহের চেয়ে কঠোর যাচাইকরণকে অগ্রাধিকার দিতে চান, তাহলে validation_behavior ক্ষেত্রটি যোগ করুন এবং এটিকে ENFORCE_RECOMMENDATIONS এ সেট করুন।

কাস্টম প্যারামিটার

আপনি একটি পরিমাপ প্রোটোকল পেলোডে কাস্টম ব্যবহারকারী-স্কোপড, ইভেন্ট-স্কোপড এবং আইটেম-স্কোপড প্যারামিটার অন্তর্ভুক্ত করতে পারেন।

  • ব্যবহারকারী-সুযোগপ্রাপ্ত কাস্টম প্যারামিটারগুলি user_properties এ অন্তর্ভুক্ত করা যেতে পারে।
  • ইভেন্ট-স্কোপড কাস্টম প্যারামিটারগুলি events[].params এ অন্তর্ভুক্ত করা যেতে পারে।
  • আইটেম-স্কোপড কাস্টম প্যারামিটারগুলি items অন্তর্ভুক্ত করা যেতে পারে।

কিছু ইভেন্টের জন্য প্রস্তাবিত প্যারামিটার রয়েছে। সমস্ত সমর্থিত ইভেন্টের জন্য প্রস্তাবিত প্যারামিটারগুলির জন্য ইভেন্টগুলি দেখুন।

সংরক্ষিত নাম

কিছু ইভেন্ট, প্যারামিটার এবং ব্যবহারকারীর সম্পত্তির নাম সংরক্ষিত আছে এবং ব্যবহার করা যাবে না:

সংরক্ষিত ইভেন্টের নাম

নিম্নলিখিত ইভেন্টের নামগুলি সংরক্ষিত এবং ব্যবহার করা যাবে না:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

এছাড়াও, ad_impression , in_app_purchase এবং screen_view ইভেন্টগুলি শুধুমাত্র অ্যাপ স্ট্রিমের জন্য অনুমোদিত।

সংরক্ষিত প্যারামিটারের নাম

নিম্নলিখিত প্যারামিটারের নামগুলি সংরক্ষিত এবং ব্যবহার করা যাবে না:

  • firebase_conversion

প্যারামিটারের নাম নিম্নলিখিতগুলি দিয়ে শুরু করা যাবে না:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

সংরক্ষিত ব্যবহারকারীর সম্পত্তির নাম

নিম্নলিখিত ব্যবহারকারীর সম্পত্তির নামগুলি সংরক্ষিত এবং ব্যবহার করা যাবে না:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

অতিরিক্তভাবে, ব্যবহারকারীর সম্পত্তির নামগুলি নিম্নলিখিত দিয়ে শুরু হতে পারে না:

  • _ (underscore)
  • firebase_
  • ga_
  • google_