আপনার প্ল্যাটফর্ম বেছে নিন:
Google Analytics পরিমাপের প্রোটোকল
HTTP ত্রুটি কোড দেখায় না, এমনকি কোনও ইভেন্ট ভুলভাবে ফর্ম্যাট করা হলে বা প্রয়োজনীয় প্যারামিটার না থাকলেও। আপনার ইভেন্ট সঠিক কিনা তা যাচাই করতে, প্রোডাকশনে ডিপ্লয় করার আগে
Measurement Protocol যাচাইকরণ সার্ভারের মাধ্যমে সেগুলি পরীক্ষা করে নেওয়া উচিত।
আপনার ইভেন্ট সঠিকভাবে স্ট্রাকচার করা হয়েছে কিনা তা যাচাই করার পরে, আপনি সঠিক কী ব্যবহার করছেন কিনা তা নিশ্চিত করতে
আপনার ইমপ্লিমেন্টেশন যাচাই করা উচিত।
আপনি সরাসরি যাচাইকরণ সার্ভারে কল করতে পারেন অথবা Google Analytics ইভেন্ট বিল্ডার ব্যবহার করতে পারেন। Google Analytics ইভেন্ট বিল্ডার আপনাকে ইন্টার্যাক্টিভভাবে ইভেন্ট তৈরি করতে দেয় এবং মেজারমেন্ট প্রোটোকল যাচাইকরণ সার্ভার ব্যবহার করে সেগুলি যাচাই করে।
এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে Google Analytics যাচাইকরণ সার্ভারের জন্য মেজারমেন্ট প্রোটোকলে ইভেন্ট পাঠাতে হয় এবং রেসপন্স ব্যাখ্যা করতে হয়।
যাচাইকরণের জন্য ইভেন্ট পাঠান
Measurement Protocol এবং Measurement Protocol যাচাইকরণ সার্ভারে ইভেন্টের জন্য পাঠানো অনুরোধের মধ্যে একমাত্র পার্থক্য হল URL।
| সার্ভার | ইউআরএল |
|---|---|
| Measurement Protocol | /mp/collect |
| Measurement Protocol যাচাইকরণ সার্ভার | /debug/mp/collect |
অন্য সব অনুরোধের ফিল্ড একই থাকে।
আমরা যাচাইকরণের জন্য নিম্নলিখিত পদ্ধতি সাজেস্ট করি:
- ডেভেলপমেন্টের সময় নিম্নলিখিত বিকল্পগুলির মধ্যে যেকোনও একটি ব্যবহার করে কঠোর যাচাইকরণ চেক ব্যবহার করুন:
- ইভেন্ট বিল্ডার-এর মাধ্যমে অনুরোধ যাচাই করুন।
validation_behavior-এর সাথে যাচাইকরণ সার্ভারে অনুরোধ পাঠান, যাENFORCE_RECOMMENDATIONS-এ সেট করা আছে।
- প্রোডাকশনে,
validation_behaviorসেট না করে অনুরোধ পাঠান যাতে Measurement Protocol-এর মাধ্যমে বাতিল করা ডেটার পরিমাণ কমানো যায়।
ভুল ইভেন্টের উদাহরণ
নিচের কোডটি থেকে বোঝা যায় যে Measurement Protocol যাচাইকরণ সার্ভারে একটি ভুল ইভেন্ট পাঠানো হয়েছে:
const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";
fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
app_instance_id: "APP_INSTANCE_ID",
validation_behavior: "ENFORCE_RECOMMENDATIONS",
events: [{
// Event names must start with an alphabetic character.
name: "_badEventName",
params: {},
}]
})
});
সঠিক ইভেন্টের উদাহরণ
নিচের কোডটি মেজারমেন্ট প্রোটোকল যাচাইকরণ সার্ভারে পাঠানো একটি সঠিক ইভেন্ট দেখায়। এই অনুরোধের ফলে উত্তরে একটি খালি validationMessages অ্যারে
পাওয়া যাবে, যেমনটি যাচাইকরণ উত্তর
বিভাগে দেখানো হয়েছে।
const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";
fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
app_instance_id: "APP_INSTANCE_ID",
validation_behavior: "ENFORCE_RECOMMENDATIONS",
events: [{
name: "level_up",
params: {
level: 2,
character: "MyHero"
},
}]
})
});
যাচাইকরণের উত্তর
ভুল ইভেন্টের উদাহরণের জন্য যাচাইকরণ সার্ভারের উত্তর এখানে দেওয়া হল।
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
কোনও যাচাইকরণ সংক্রান্ত সমস্যা না থাকা অনুরোধের ক্ষেত্রে যাচাইকরণ সার্ভারের উত্তর এখানে দেওয়া হল:
{
"validationMessages": []
}
রেসপন্স
| কী | ধরন | বিবরণ |
|---|---|---|
validationMessages |
Array<ValidationMessage> | যাচাইকরণ মেসেজের একটি অ্যারে। |
ValidationMessage
| কী | ধরন | বিবরণ |
|---|---|---|
fieldPath |
স্ট্রিং | ফিল্ডের পাথটি ভুল ছিল। |
description |
স্ট্রিং | সমস্যার বিবরণ। |
validationCode |
ValidationCode | সমস্যার সাথে সম্পর্কিত একটি যাচাইকরণ কোড। |
ValidationCode
| ভ্যালু | বিবরণ |
|---|---|
VALUE_INVALID |
fieldPath-এর জন্য দেওয়া ভ্যালু সঠিক নয়। সীমাবদ্ধতা দেখুন।
|
VALUE_REQUIRED |
fieldPath-এর জন্য প্রয়োজনীয় ভ্যালু দেওয়া হয়নি। |
NAME_INVALID |
যে নামটি দেওয়া হয়েছে সেটি সঠিক নয়। সীমাবদ্ধতা দেখুন। |
NAME_RESERVED |
প্রদান করা নামটি রিজার্ভ করা নামগুলির মধ্যে একটি ছিল। রিজার্ভ করা নাম দেখুন। |
VALUE_OUT_OF_BOUNDS |
প্রদান করা ভ্যালু অনেক বেশি। সীমাবদ্ধতা দেখুন। |
EXCEEDED_MAX_ENTITIES |
অনুরোধে অনেক বেশি প্যারামিটার ছিল। সীমাবদ্ধতা দেখুন। |
NAME_DUPLICATED |
অনুরোধে একই নাম একাধিকবার দেওয়া হয়েছে। |