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

ওভারভিউ

পরিমাপ প্রোটোকল ব্যবহার করে 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 ঘোরানো উচিত।
measurement_id	পরিমাপ আইডি। একটি ডেটা স্ট্রীমের শনাক্তকারী৷ Google Analytics UI এর অধীনে পাওয়া যায়: অ্যাডমিন > ডেটা স্ট্রীম > আপনার স্ট্রিম বেছে নিন > পরিমাপ আইডি

JSON পোস্ট বডি

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

নির্দিষ্ট ইভেন্টের জন্য প্রস্তাবিত মান

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

সংরক্ষিত নাম

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

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

• ad_activeview
• ad_click
• ad_exposure
• ad_impression
• 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
• screen_view
• 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_