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

ওভারভিউ

পরিমাপ প্রোটোকল ব্যবহার করে Google Analytics-এ ডেটা পাঠানোর দুটি অংশ রয়েছে:

1. পরিবহন - কোথায় এবং কিভাবে আপনি ডেটা পাঠান
2. পেলোড - আপনার পাঠানো ডেটা

এই নথিটি বর্ণনা করে যে কীভাবে পরিবহন এবং পেলোড ফর্ম্যাট করা হয়।

পরিবহন

URL এন্ডপয়েন্ট

আপনি নিম্নলিখিত শেষ পয়েন্টে HTTP POST অনুরোধ করে পরিমাপ প্রোটোকল ব্যবহার করে ডেটা পাঠান:

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

দ্রষ্টব্য: সমস্ত ডেটা অবশ্যই HTTPS এর মাধ্যমে নিরাপদে পাঠাতে হবে।

একটি ইভেন্ট পাঠাতে, নিম্নলিখিত POST অনুরোধ জারি করুন:

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

• অনুরোধের BODY । পেলোড দেখুন।

প্রতিক্রিয়া কোড

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

গুরুত্বপূর্ণ: আপনি যদি 2xx স্ট্যাটাস কোড না পান, তাহলে আপনার অনুরোধটি আবার চেষ্টা করা উচিত নয় । পরিবর্তে, আপনার HTTP অনুরোধে যে কোনো ত্রুটি বন্ধ করে সংশোধন করা উচিত।

পেলোড

Firebase gtag.js

দুটি অংশে পরিমাপ প্রোটোকল ডেটা ব্যবহার করে ডেটা Google Analytics-এ পাঠানো হয়:

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

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

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

বর্ণনা

api_secret

প্রয়োজন। একটি API Secret যা Google Analytics UI এর মাধ্যমে তৈরি হয়। একটি নতুন গোপনীয়তা তৈরি করতে, Google Analytics UI এ নেভিগেট করুন: অ্যাডমিন > ডেটা স্ট্রীম > আপনার স্ট্রিম বেছে নিন > পরিমাপ প্রোটোকল > তৈরি করুন আমরা সুপারিশ করি যে আপনি এইগুলিকে আপনার প্রতিষ্ঠানের কাছে গোপন রাখুন৷ আপনি যদি পরিমাপ প্রোটোকল ক্লায়েন্ট-সাইড স্থাপন করেন, তাহলে অতিরিক্ত স্প্যাম এড়াতে আপনার নিয়মিত api_secret s ঘোরানো উচিত।

JSON পোস্ট বডি

চাবি	টাইপ	বর্ণনা
user_id	string	ঐচ্ছিক। ব্যবহারকারীর জন্য একটি অনন্য শনাক্তকারী। এই শনাক্তকারী সম্পর্কে আরও তথ্যের জন্য ক্রস-প্ল্যাটফর্ম বিশ্লেষণের জন্য ব্যবহারকারী-আইডি দেখুন। user_id শুধুমাত্র utf-8 অক্ষর অন্তর্ভুক্ত করতে পারে।
timestamp_micros	number	ঐচ্ছিক। ইভেন্টের সাথে যুক্ত করার জন্য একটি ইউনিক্স টাইমস্ট্যাম্প (মাইক্রোসেকেন্ডে)। এটি শুধুমাত্র অতীতে ঘটে যাওয়া ঘটনা রেকর্ড করার জন্য সেট করা উচিত। এই মান user_property বা ইভেন্ট টাইমস্ট্যাম্পের মাধ্যমে ওভাররাইড করা যেতে পারে। সম্পত্তির টাইমজোনের উপর ভিত্তি করে ইভেন্টগুলি 3 ক্যালেন্ডার দিন পর্যন্ত ব্যাকডেট করা যেতে পারে। এই মানটি মাইক্রো সেকেন্ডে হওয়া উচিত, মিলি সেকেন্ডে নয়।
user_properties	object	ঐচ্ছিক। পরিমাপের জন্য ব্যবহারকারীর বৈশিষ্ট্য। আরও তথ্যের জন্য ব্যবহারকারীর বৈশিষ্ট্য দেখুন।
consent	object	ঐচ্ছিক। অনুরোধের জন্য সম্মতি সেটিংস সেট করে। আরও তথ্যের জন্য সম্মতি বিভাগটি দেখুন।
non_personalized_ads	boolean	ঐচ্ছিক। ব্যক্তিগতকৃত বিজ্ঞাপনের জন্য ব্যবহারকারীর ডেটা ব্যবহার করা উচিত নয় তা নির্দেশ করার জন্য true সেট করুন৷ অপ্রচলিত: এই ক্ষেত্রের পরিবর্তে consent ad_personalization ক্ষেত্রটি ব্যবহার করুন। Google Analytics যেকোনো একটি ক্ষেত্র গ্রহণ করে, কিন্তু ad_personalization সুপারিশ করা হয়।
events[]	array	প্রয়োজন। ইভেন্ট আইটেম একটি অ্যারে. প্রতি অনুরোধে 25টি ইভেন্ট পর্যন্ত পাঠানো যেতে পারে। সমস্ত বৈধ ইভেন্টের জন্য ইভেন্টের রেফারেন্স দেখুন।
events[].name	string	প্রয়োজন। অনুষ্ঠানের নাম। সমস্ত বিকল্পের জন্য ইভেন্টের রেফারেন্স দেখুন।
events[].params	object	ঐচ্ছিক। ইভেন্টের জন্য পরামিতি। প্রতিটি ইভেন্টের জন্য প্রস্তাবিত প্যারামিটারের জন্য ইভেন্ট দেখুন।

সম্মতি

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

চাবি	টাইপ	বর্ণনা
ad_user_data	string	ঐচ্ছিক। বিজ্ঞাপনের উদ্দেশ্যে Google-এ অনুরোধের ইভেন্ট এবং ব্যবহারকারীর বৈশিষ্ট্য থেকে ব্যবহারকারীর ডেটা পাঠানোর জন্য সম্মতি সেট করে। হয় GRANTED বা DENIED করা আবশ্যক.
ad_personalization	string	ঐচ্ছিক। ব্যবহারকারীর জন্য ব্যক্তিগতকৃত বিজ্ঞাপনের জন্য সম্মতি সেট করে। হয় GRANTED বা DENIED করা আবশ্যক.

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

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

• পেলোডের 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_