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

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

পরিবহন

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

পেলোড

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

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

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

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

api_secret

 প্রয়োজন Google Analytics UI থেকে API সিক্রেট ।

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

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

JSON পোস্ট বডি

চাবি টাইপ বর্ণনা

user_id

 string

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

timestamp_micros

 number

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

user_properties

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

user_data

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

non_personalized_ads

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

user_location

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

ip_override

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

device

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

events[]

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

events[].name

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

events[].params

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

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

চাবি টাইপ বর্ণনা

ad_user_data

 string

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

হয় 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 সেট করুন যাতে Google Analytics শহরের নামটিকে একটি শহরের আইডিতে সঠিকভাবে ম্যাপ করতে পারে।

region_id

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

country_id

 string ঐচ্ছিক ISO 3166-1 আলফা-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 অনুরোধে প্রপার্টির দানাদার ডিভাইস ডেটা সেটিংস প্রয়োগ করে।

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

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

  • ইউজার-স্কোপড কাস্টম প্যারামিটার 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
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

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

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

  • 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_