ইভেন্ট যাচাই করা

আপনার প্ল্যাটফর্ম বেছে নিন:

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 অনুরোধে একই নাম একাধিকবার দেওয়া হয়েছে।