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

এই নথিটি বর্ণনা করে যে কীভাবে পরিমাপ প্রোটোকল ব্যবহার করে Google Analytics-এ ডেটা পাঠাতে হয়।

ওভারভিউ

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

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

এই দস্তাবেজটি বর্ণনা করে কিভাবে উভয় ফর্ম্যাট করতে হয়।

পরিবহন

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

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

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

সমস্ত ডেটা HTTPS প্রোটোকল দিয়ে নিরাপদে পাঠানো উচিত।

আপনি POST বা GET অনুরোধ ব্যবহার করে ডেটা পাঠাতে পারেন।

POST ব্যবহার করে

আমরা POST এর মাধ্যমে ডেটা পাঠানোর পরামর্শ দিই কারণ এটি একটি বড় পেলোডের অনুমতি দেয়৷ POST ব্যবহার করার সময়, নিম্নলিখিত HTTP অনুরোধটি ইস্যু করুন:

User-Agent: user_agent_string
POST https://www.google-analytics.com/collect
payload_data

কোথায়:

  • user_agent_string - একটি ফরম্যাট করা ইউজার এজেন্ট স্ট্রিং যা নিম্নলিখিত মাত্রাগুলি গণনা করতে ব্যবহৃত হয়: ব্রাউজার, প্ল্যাটফর্ম এবং মোবাইল ক্ষমতা।

    এই মান সেট করা না থাকলে, উপরের ডেটা গণনা করা হবে না।

  • payload_data – পোস্ট অনুরোধের BODY । বডিতে অবশ্যই 1টি URI এনকোডেড পেলোড থাকতে হবে এবং 8192 বাইটের বেশি হতে হবে না।
  • আইপি অ্যাড্রেস - এইচটিটিপি অনুরোধে অস্পষ্টভাবে পাঠানো হয় এবং গুগল অ্যানালিটিক্সে সমস্ত জিও/নেটওয়ার্কের মাত্রা গণনা করতে ব্যবহৃত হয়।

পাওয়া

পরিবেশের জন্য যেখানে আপনি POST ডেটা পাঠাতে পারবেন না, আপনি একই শেষ বিন্দুতে HTTP GET অনুরোধ পাঠাতে পারেন:

GET /collect?payload_data HTTP/1.1
Host: https://www.google-analytics.com
User-Agent: user_agent_string

যেখানে পেলোড ডেটা URI এস্কেপড কোয়েরি প্যারামিটার হিসেবে পাঠানো হয়। সম্পূর্ণ এনকোড করা URL এর দৈর্ঘ্য 8000 বাইটের বেশি হওয়া উচিত নয়৷

ক্যাশে বাস্টিং

কিছু পরিবেশে, ব্রাউজারগুলির মতো, HTTP GET অনুরোধগুলি ক্যাশে করা হতে পারে। যখন একটি অনুরোধ ক্যাশে করা হয়, পরবর্তী অনুরোধগুলি ক্যাশে থেকে পুনরুদ্ধার করা হতে পারে এবং Google Analytics-এ পাঠানো হবে না। ক্যাশের মাধ্যমে আবক্ষ করার জন্য, পরিমাপ প্রোটোকল একটি বিশেষ প্যারামিটার ( z ) প্রদান করে যা একটি এলোমেলো সংখ্যার সাথে সেট করা যেতে পারে। এটি নিশ্চিত করে যে সমস্ত পরিমাপ প্রোটোকল অনুরোধগুলি অনন্য, এবং পরবর্তী অনুরোধগুলি ক্যাশে থেকে পুনরুদ্ধার করা হয় না।

আপনি যখন ক্যাশে বাস্টার ব্যবহার করেন, তখন আমরা এই প্যারামিটারটিকে পেলোডে শেষ প্যারামিটার হিসেবে যোগ করার সুপারিশ করি।

https://www.google-analytics.com/collect?payload_data&z=123456

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

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

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

পেলোড ডেটা

পরিমাপ প্রোটোকল ব্যবহার করে Google Analytics দ্বারা সংগৃহীত সমস্ত ডেটা একটি পেলোড হিসাবে পাঠানো হয়। পেলোডটি একটি URL ক্যোয়ারী স্ট্রিং এর অনুরূপ যেখানে প্রতিটি প্যারামিটারের একটি কী এবং মান রয়েছে, একটি = অক্ষর দ্বারা পৃথক করা হয়েছে এবং প্রতিটি জোড়া একটি & অক্ষর দ্বারা সীমাবদ্ধ করা হয়েছে৷ উদাহরণ স্বরূপ:

key1=val1&key2=val2

প্রতিটি পেলোড পরিচালনার নিয়ম রয়েছে: প্রয়োজনীয় মান, ইউআরআই এনকোডিং, প্যারামিটার যা একসাথে পাঠানো যেতে পারে এবং প্যারামিটারের দৈর্ঘ্য। এছাড়াও প্রতিটি প্যারামিটারের একটি নির্দিষ্ট ধরন রয়েছে যার জন্য একটি নির্দিষ্ট বিন্যাস প্রয়োজন। নিম্নলিখিত বিভাগগুলি এই নিয়মগুলির মধ্য দিয়ে যায়।

পরিমাপ প্রোটোকল ব্যবহার করে আপনি যে সমস্ত প্যারামিটার পাঠাতে পারেন তার সম্পূর্ণ তালিকার জন্য প্যারামিটার রেফারেন্স পড়ুন।

সমস্ত হিট জন্য প্রয়োজনীয় মান

নিম্নলিখিত পরামিতি প্রতিটি পেলোডে থাকতে হবে:

নাম প্যারামিটার উদাহরণ বর্ণনা
প্রোটোকল সংস্করণ v v= 1 প্রোটোকল সংস্করণ। মান 1 হওয়া উচিত।
ট্র্যাকিং আইডি tid tid= UA-123456-1 আইডি যেটি পার্থক্য করে যে কোন Google Analytics প্রপার্টিতে ডেটা পাঠাতে হবে।
ক্লায়েন্ট আইডি cid cid= xxxxx একটি নির্দিষ্ট ব্যবহারকারীর জন্য অনন্য একটি আইডি।
টাইপ হিট করুন t t= pageview কোনো নির্দিষ্ট ব্যবহারকারীর জন্য সংগৃহীত ইন্টারঅ্যাকশনের ধরন।

Client ID এবং Hit Type ডেটা হল এমন মান যা সরাসরি Google Analytics ডেটা মডেলে ম্যাপ করে। আপনি যদি ব্যবহারকারী 5555 কে ট্র্যাক করতে চান যিনি /pageA , /pageB , এবং /pageC তে গিয়েছিলেন, তাহলে আপনি নিম্নলিখিত 3টি পেলোড পাঠাবেন:

v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageA
v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageB
v=1&tid=UA-123456-1&cid=5555&t=pageview&dp=%2FpageC

লক্ষ্য করুন যে / %2F এ এনকোড করা হয়েছে।

URL এনকোডিং মান

Google Analytics-এ পাঠানো সমস্ত মান অবশ্যই UTF-8 এবং URL এনকোডেড হতে হবে। /my page € মান সহ কী dp পাঠাতে, আপনাকে প্রথমে নিশ্চিত করতে হবে যে এটি UTF-8 এনকোড করা হয়েছে, তারপর url এনকোড করা হয়েছে, যার ফলে চূড়ান্ত স্ট্রিং হবে:

dp=%2Fmy%20page%20%E2%82%AC

কোনো অক্ষর ভুলভাবে এনকোড করা থাকলে, সেগুলিকে ইউনিকোড প্রতিস্থাপন অক্ষর xFFFD দিয়ে প্রতিস্থাপিত করা হবে।

নির্দিষ্ট হিট প্রকারের জন্য প্রয়োজনীয় মান

কিছু প্যারামিটার শুধুমাত্র নির্দিষ্ট হিট প্রকারের সাথে পাঠানো যেতে পারে। উদাহরণস্বরূপ, pageview হিট টাইপের জন্য পেজ পাথ প্যারামিটার ( dp ) সেট করা প্রয়োজন। প্যারামিটার রেফারেন্স বর্ণনা করে যে কোন হিট ধরনের জন্য কোন প্যারামিটারের প্রয়োজন।

সর্বোচ্চ দর্ঘ্য

পরিমাপ প্রোটোকলের কিছু পাঠ্য মান বাইটে নির্দিষ্ট সর্বোচ্চ দৈর্ঘ্য আছে। উদাহরণস্বরূপ, ডকুমেন্ট রেফারার ফিল্ড dr এর সর্বোচ্চ দৈর্ঘ্য 2,048 বাইট। যদি কোনো মান সর্বোচ্চ দৈর্ঘ্যের চেয়ে বেশি হয়, তাহলে সেগুলি স্বয়ংক্রিয়ভাবে কেটে যাবে। যদি একটি মাল্টি-বাইট অক্ষর সর্বোচ্চ দৈর্ঘ্য অতিক্রম করে, সমগ্র অক্ষরটি ছাঁটাই করা হবে।

সমর্থিত ডেটা প্রকার

পরিমাপ প্রোটোকলের প্রতিটি ডেটা ক্ষেত্র একটি নির্দিষ্ট ধরণের অন্তর্গত, প্রতিটির নিজস্ব বৈধতার নিয়ম রয়েছে। যদি কোনো প্যারামিটার মান বৈধকরণের নিয়মের সাথে সঙ্গতিপূর্ণ না হয়, তাহলে সেই নির্দিষ্ট প্যারামিটারটিকে উপেক্ষা করা হবে এবং Google Analytics দ্বারা প্রক্রিয়া করা হবে না। অন্যান্য সমস্ত পরামিতি স্বাভাবিক হিসাবে প্রক্রিয়া করা হবে।

পরিমাপ প্রোটোকল নিম্নলিখিত ডেটা প্রকারগুলিকে সমর্থন করে:

মনে রাখবেন যে পৃথক ডেটা ক্ষেত্রের নিজস্ব সীমাবদ্ধতা থাকতে পারে। সমস্ত ডেটা ক্ষেত্র এবং গৃহীত প্রকারের সম্পূর্ণ তালিকার জন্য ক্ষেত্র রেফারেন্স দেখুন।

পাঠ্য

স্ট্রিং প্রতিনিধিত্ব করতে ব্যবহৃত. পাঠ্য ক্ষেত্রে অতিরিক্ত প্রক্রিয়াকরণ করা হয়। সমস্ত অগ্রণী এবং পিছনের হোয়াইটস্পেস অক্ষরগুলি সরানো হয়েছে৷ দুই বা ততোধিক হোয়াইটস্পেস অক্ষরের অভ্যন্তরীণ রান (স্পেস, ট্যাব, নিউলাইন, ইত্যাদি সহ) একটি একক স্পেস অক্ষরে হ্রাস করা হয়। এই রূপান্তরটি কোনো ছেদন ঘটার আগে কাঁচা পাঠে প্রয়োগ করা হয়। উদাহরণ স্বরূপ:

   Hello      World

হয়ে যাবে:

Hello World

মুদ্রা

একটি মুদ্রার মোট মূল্য উপস্থাপন করতে ব্যবহৃত হয়। একটি দশমিক বিন্দু মুদ্রার পুরো এবং ভগ্নাংশের মধ্যে একটি বিভাজন হিসাবে ব্যবহৃত হয়। নির্ভুলতা 6 দশমিক স্থান পর্যন্ত। নিম্নলিখিত একটি মুদ্রা ক্ষেত্রের জন্য বৈধ:

1000.000001

একবার মানটি Google Analytics-এ পাঠানো হলে, প্রথম সংখ্যা, - অক্ষর বা অক্ষর পর্যন্ত সমস্ত পাঠ্য সরানো হয় . (দশমিক) অক্ষর। তাই:

$-55.00

হয়ে যাবে:

-55.00

বুলিয়ান

একটি মান সত্য বা মিথ্যা কিনা তা নির্ধারণ করতে ব্যবহৃত হয়। বৈধ মান হল:

  • 1 - সত্য
  • 0 - মিথ্যা

পূর্ণসংখ্যা

একটি পূর্ণসংখ্যা প্রতিনিধিত্ব করতে ব্যবহৃত. মান একটি স্বাক্ষরিত int64 হিসাবে সংরক্ষণ করা হয়

সংখ্যা

একটি পূর্ণসংখ্যা বা একটি ফ্লোটিং পয়েন্ট সংখ্যা উপস্থাপন করতে ব্যবহৃত হয়।