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

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

পরিবহন

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

নিম্নলিখিত এন্ডপয়েন্টে অনুরোধ পাঠান:

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

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

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 স্ট্যাটাস কোড ফেরত দেয়। পেলোডটি ত্রুটিপূর্ণ হলে, অথবা ডেটা ভুল হলে বা গুগল অ্যানালিটিক্স দ্বারা প্রক্রিয়াকৃত না হলে মেজারমেন্ট প্রোটোকল কোনো এরর কোড ফেরত দেয় না।

পেলোড

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

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

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

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

api_secret

 গুগল অ্যানালিটিক্স UI থেকে API সিক্রেটটি আবশ্যক ।

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

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

JSON পোস্ট বডি

চাবি প্রকার বর্ণনা

user_id

 string

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

timestamp_micros

 number

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

user_properties

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

user_data

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

non_personalized_ads

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

user_location

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

ip_override

 string ঐচ্ছিক । আইপি অ্যাড্রেস যা গুগল অ্যানালিটিক্স অনুরোধের জন্য ভৌগোলিক তথ্য সংগ্রহ করতে ব্যবহার করে।

device

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

validation_behavior

 string

ঐচ্ছিক। অনুরোধের যাচাইকরণ আচরণ নির্ধারণ করে।

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

events[]

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

events[].name

 string আবশ্যক । অনুষ্ঠানের নাম। সকল বিকল্পের জন্য ইভেন্টসমূহ দেখুন।

events[].params

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

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

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

চাবি প্রকার বর্ণনা

session_id

engagement_time_msec

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

timestamp_micros

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

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

চাবি প্রকার বর্ণনা

ad_user_data

 string

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

হয় GRANTED অথবা DENIED ।

ad_personalization

 string

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

হয় GRANTED অথবা DENIED ।

ভৌগোলিক তথ্য

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

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

চাবি প্রকার বর্ণনা

city

 string ঐচ্ছিক । শহরের নাম । শহরটি যদি মার্কিন যুক্তরাষ্ট্রে হয়, তাহলে country_id এবং region_id ও সেট করুন, যাতে গুগল অ্যানালিটিক্স শহরের নামটিকে একটি সিটি আইডির সাথে সঠিকভাবে সংযুক্ত করতে পারে।

region_id

 string ঐচ্ছিক । আইএসও ৩১৬৬ দেশ এবং উপবিভাগ। উদাহরণস্বরূপ, 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 পাঠান, তাহলে গুগল অ্যানালিটিক্স আইপি অ্যাড্রেস থেকে ভৌগোলিক তথ্য সংগ্রহ করে। আর যদি আপনি user_location পাঠান, গুগল অ্যানালিটিক্স ip_override উপেক্ষা করে।

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

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

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

ডিভাইসের তথ্য পাঠাতে, 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"
}

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

বৈধতা আচরণ

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

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

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

  • আপনার অনুরোধগুলির সম্ভাব্য সমস্যা সম্পর্কে যথাসম্ভব বেশি মতামত পেতে, ইভেন্টগুলি যাচাই করার সময় 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_