এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে আপনি Google Analytics পরিমাপ প্রোটোকল ওয়েব এবং অ্যাপ স্ট্রিম ইভেন্টগুলি একটি Google Analytics সার্ভারে পাঠাতে পারেন, যাতে আপনি আপনার Google Analytics রিপোর্টে পরিমাপ প্রোটোকল ইভেন্টগুলি দেখতে পারেন।
এই নির্দেশিকাটিতে আপনি যে প্ল্যাটফর্মটি দেখতে চান তা চয়ন করুন:
অনুরোধ ফরম্যাট করুন
Google Analytics 4 এর জন্য পরিমাপ প্রোটোকল শুধুমাত্র HTTP POST
অনুরোধ সমর্থন করে।
একটি ইভেন্ট পাঠাতে, নিম্নলিখিত বিন্যাস ব্যবহার করুন:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
অনুরোধ URL-এ আপনাকে অবশ্যই নিম্নলিখিতগুলি প্রদান করতে হবে:
api_secret
: এপিআই সিক্রেট গুগল অ্যানালিটিক্স UI-তে তৈরি হয়।একটি নতুন গোপনীয়তা তৈরি করতে, অ্যাডমিন > ডেটা স্ট্রীম > আপনার স্ট্রীম বেছে নিন > পরিমাপ প্রোটোকল > তৈরি করুন এ নেভিগেট করুন।
firebase_app_id
: Firebase অ্যাপ আইডি, প্রজেক্ট সেটিংস > সাধারণ > আপনার অ্যাপস > অ্যাপ আইডির অধীনে Firebase কনসোলে পাওয়া যায়।firebase_app_id
টিapp_instance_id
মত নয়।firebase_app_id
আপনার অ্যাপকে শনাক্ত করে, যেখানেapp_instance_id
অ্যাপটির একটি একক ইনস্টলেশন শনাক্ত করে।
সম্পূর্ণ রেফারেন্সের জন্য ক্যোয়ারী প্যারামিটার দেখুন।
আপনাকে অবশ্যই অনুরোধের অংশে নিম্নলিখিতগুলি প্রদান করতে হবে:
app_instance_id
: ফায়ারবেস অ্যাপ ইন্সট্যান্সের জন্য একটি অনন্য শনাক্তকারী। এটি একটি ওয়েবclient_id
থেকে আলাদা:
user_id
: ঐচ্ছিক। ব্যবহারকারীর জন্য একটি অনন্য শনাক্তকারী। শুধুমাত্র utf-8 অক্ষর থাকতে পারে। এই শনাক্তকারী সম্পর্কে আরও তথ্যের জন্য ক্রস-প্ল্যাটফর্ম বিশ্লেষণের জন্য ব্যবহারকারী-আইডি দেখুন।consent
: ঐচ্ছিক। সম্মতি সেটিংস কীভাবে সেট করবেন তা জানুন।events
: ইভেন্ট আইটেম একটি অ্যারে. আপনি একটি অনুরোধে একাধিক ইভেন্ট অন্তর্ভুক্ত করতে পারেন।রিয়েলটাইমের মতো প্রতিবেদনে ব্যবহারকারীর কার্যকলাপ প্রদর্শনের জন্য, একটি
event
জন্যparams
অংশ হিসেবেengagement_time_msec
এবংsession_id
অবশ্যই সরবরাহ করতে হবে।engagement_time_msec
প্যারামিটারটি মিলিসেকেন্ডে ইভেন্টের ব্যস্ততার সময়কে প্রতিফলিত করবে।এখানে একটি উদাহরণ:
{
"app_instance_id": "12345678901234567890123456789012",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
যদিও session_start
একটি সংরক্ষিত ইভেন্টের নাম , একটি নতুন session_id
তৈরি করা হলে session_start
পাঠানোর প্রয়োজন ছাড়াই একটি নতুন সেশন তৈরি হয়। সেশনগুলি কীভাবে গণনা করা হয় তা বুঝুন।
চেষ্টা করে দেখুন
এখানে একটি উদাহরণ রয়েছে যা আপনি আপনার Google Analytics সার্ভারে একটি tutorial_begin
ইভেন্ট পাঠাতে ব্যবহার করতে পারেন:
const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
firebase_app_id
এর বিন্যাসটি প্ল্যাটফর্ম নির্দিষ্ট। ফায়ারবেস কনফিগারেশন ফাইল এবং অবজেক্টের অধীনে অ্যাপ্লিকেশন আইডি দেখুন।
সীমাবদ্ধতা
Google Analytics-এ পরিমাপ প্রোটোকল ইভেন্ট পাঠানোর ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলি প্রযোজ্য:
- অনুরোধে সর্বাধিক 25টি ইভেন্ট থাকতে পারে।
- ইভেন্টে সর্বাধিক 25টি প্যারামিটার থাকতে পারে।
- ইভেন্টে সর্বাধিক 25টি ব্যবহারকারীর বৈশিষ্ট্য থাকতে পারে।
- ব্যবহারকারীর সম্পত্তির নাম অবশ্যই 24 অক্ষর বা তার কম হতে হবে।
- ব্যবহারকারীর সম্পত্তির মান অবশ্যই 36 অক্ষর বা তার কম হতে হবে।
- ইভেন্টের নাম অবশ্যই 40 অক্ষর বা তার কম হতে হবে, শুধুমাত্র আলফা-সংখ্যাসূচক অক্ষর এবং আন্ডারস্কোর থাকতে পারে এবং একটি বর্ণানুক্রমিক অক্ষর দিয়ে শুরু করতে হবে।
- আইটেম প্যারামিটার সহ প্যারামিটারের নামগুলি অবশ্যই 40 অক্ষর বা তার কম হতে হবে, শুধুমাত্র আলফা-সংখ্যাসূচক অক্ষর এবং আন্ডারস্কোর থাকতে পারে এবং একটি বর্ণানুক্রমিক অক্ষর দিয়ে শুরু করতে হবে।
- আইটেম প্যারামিটার মান সহ প্যারামিটার মান 100 অক্ষর বা তার কম হতে হবে।
- আইটেম প্যারামিটারে সর্বাধিক 10টি কাস্টম প্যারামিটার থাকতে পারে।
- পোস্ট বডি অবশ্যই 130kB এর থেকে ছোট হতে হবে।
- পরিমাপ প্রোটোকল ইভেন্ট থেকে ইভেন্ট-লেভেল অ্যাট্রিবিউশন বিজ্ঞাপন এবং অন্যান্য মিডিয়া ইন্টিগ্রেশনে রূপান্তর রপ্তানির জন্য সাম্প্রতিক ট্যাগিং অনলাইন ইভেন্টের 63 দিন পর পর্যন্ত সমর্থিত হয়, এমনকি যদি রূপান্তর ইভেন্টের জন্য রূপান্তর উইন্ডোটি 63 দিনের বেশি হয়। বিপরীতে, অনলাইন ইভেন্ট ট্যাগ করার জন্য ইভেন্ট-লেভেল অ্যাট্রিবিউশন সমগ্র রূপান্তর উইন্ডোর জন্য সমর্থিত।
- পুনঃবিপণনের উদ্দেশ্যে, আপনি একটি সংশ্লিষ্ট কুকি বা ডিভাইস আইডি সহ সাম্প্রতিক অনলাইন ইভেন্টের পর নিম্নলিখিত সংখ্যক দিন পর্যন্ত পরিমাপ প্রোটোকল ইভেন্টগুলিতে যোগ দিতে পারেন:
- ওয়েব স্ট্রিম: 30 দিন
- অ্যাপ স্ট্রিম: 42 দিন
- Google Analytics 4-এ পাঠানো অ্যাপ মেজারমেন্ট প্রোটোকল ইভেন্ট অ্যাপ ব্যবহারকারীদের জন্য Google বিজ্ঞাপনে সার্চ অডিয়েন্স তৈরি করে না।