বিকাশকারী গাইড

Google Analytics ডেটা পেতে কিভাবে রিয়েল টাইম রিপোর্টিং এপিআই ব্যবহার করতে হয় এই ডকুমেন্টটি বর্ণনা করে।

ভূমিকা

রিয়েল টাইম রিপোর্টিং API আপনাকে এই মুহূর্তে আপনার সম্পত্তিতে ঘটছে এমন কার্যকলাপের প্রতিবেদন করতে দেয়। রিয়েল টাইম ডেটা অ্যাক্সেস করতে, আপনি একটি ক্যোয়ারী তৈরি করুন যা একটি ভিউ (প্রোফাইল) এবং অন্তত একটি মেট্রিক নির্দিষ্ট করে৷ আপনার ক্যোয়ারী পরিমার্জিত করার জন্য আপনি অতিরিক্ত ক্যোয়ারী প্যারামিটার যেমন মাত্রা এবং ফিল্টার সরবরাহ করতে পারেন। এই ক্যোয়ারীটি রিয়েল টাইম রিপোর্টিং এপিআইতে পাঠানো হয় যা একটি টেবিলের আকারে ডেটা প্রদান করে।

আপনি যদি এপিআই-এ নতুন হন, তাহলে রিয়েল টাইম রিপোর্টিং এপিআই এবং এটি যে ডেটা প্রদান করে তার পরিচিতির জন্য রিয়েল টাইম রিপোর্টিং এপিআই ওভারভিউ পড়ুন।

পূর্বশর্ত

Google Analytics ডেটা পেতে রিয়েল টাইম রিপোর্টিং API ব্যবহার করার আগে:

  • API এর সাথে কাজ করে এমন প্রোগ্রামিং ভাষা নির্দিষ্ট ক্লায়েন্ট লাইব্রেরির একটি সম্পূর্ণ তালিকার জন্য ক্লায়েন্ট লাইব্রেরি পৃষ্ঠাটি পড়ুন।
  • গুগল অ্যানালিটিক্স ডেটা পেতে একাকী (ক্লায়েন্ট লাইব্রেরি ব্যবহার না করে) কীভাবে API ব্যবহার করবেন তা শিখতে রেফারেন্স গাইড পড়ুন।

প্রতিটি ক্লায়েন্ট লাইব্রেরি সমস্ত রিয়েল টাইম রিপোর্টিং API ডেটা অ্যাক্সেস করার জন্য একটি একক বিশ্লেষণ পরিষেবা অবজেক্ট প্রদান করে। একটি পরিষেবা বস্তু তৈরি করতে:

  1. Google API কনসোলে আপনার অ্যাপ্লিকেশন নিবন্ধন করুন৷
  2. Google Analytics ডেটা অ্যাক্সেস অনুমোদন করুন।
  3. একটি বিশ্লেষণ সেবা বস্তু তৈরি করুন.

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

রিয়েল টাইম রিপোর্টিং API ব্যবহার করে

রিয়েল টাইম রিপোর্টিং API ব্যবহার করতে, একটি অ্যাপ্লিকেশন:

  1. রিয়েল টাইম রিপোর্টিং এপিআই প্রশ্ন করে।
  2. API প্রতিক্রিয়া পরিচালনা করে।

রিয়েল টাইম রিপোর্টিং এপিআই জিজ্ঞাসা করা হচ্ছে

অ্যানালিটিক্স সার্ভিস অবজেক্ট একটি রিয়েল টাইম রিপোর্টিং API ক্যোয়ারী তৈরি করার একটি পদ্ধতি প্রদান করে। ক্যোয়ারী প্যারামিটার এবং API-এ উপলব্ধ ডেটার বিশদ বিবরণের জন্য, পড়ুন:

  • রিয়েল টাইম রিপোর্টিং API এর get পদ্ধতির জন্য সমস্ত ক্যোয়ারী প্যারামিটারের একটি সম্পূর্ণ তালিকার জন্য রিয়েল টাইম রিপোর্টিং API রেফারেন্স ৷
  • ক্যোয়ারী প্যারামিটারের একটি তালিকার জন্য স্ট্যান্ডার্ড কোয়েরি প্যারামিটার রেফারেন্স যা সমস্ত পদ্ধতি এবং সংস্থানগুলির সাথে ব্যবহার করা যেতে পারে।
  • Google Analytics থেকে কোন ডেটা পুনরুদ্ধার করা যেতে পারে তার একটি তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পৃষ্ঠা।

আপনি একটি ক্যোয়ারী সংজ্ঞায়িত করার পরে, গুগল অ্যানালিটিক্স সার্ভারে ক্যোয়ারী পাঠাতে এর execute পদ্ধতিতে কল করুন।

API প্রতিক্রিয়া পরিচালনা করা

রিয়েল টাইম রিপোর্টিং এপিআই-এর একটি ক্যোয়ারী সফল হলে, এপিআই রিয়েল টাইম ডেটা রিসোর্সের অংশ হিসেবে অনুরোধ করা ডেটা ফেরত দেয়। API প্রতিক্রিয়া কাঠামো এবং বিন্যাসের বিশদ বিবরণের জন্য রিয়েল টাইম রিপোর্টিং API রেফারেন্স দেখুন।

কোনো ত্রুটি দেখা দিলে, API একটি নির্দিষ্ট স্থিতি কোড এবং ত্রুটি বর্ণনা করে একটি বার্তা প্রদান করে। সমস্ত অ্যাপ্লিকেশনের ত্রুটি ধরা এবং পরিচালনা করা উচিত। ত্রুটির বিশদ তালিকা এবং পুনরায় চেষ্টা করার সুপারিশের জন্য ত্রুটি প্রতিক্রিয়া দেখুন।

কোড উদাহরণ

রিয়েল টাইম ডেটার উদাহরণ বিভাগ: পৃষ্ঠাটি রিয়েল টাইম রিপোর্টিং এপিআই জিজ্ঞাসা করতে এবং API প্রতিক্রিয়া পরিচালনা করতে বিভিন্ন প্রোগ্রামিং ভাষায় নমুনা কোড সরবরাহ করে।

ক্যোয়ারী সীমাবদ্ধতা

এইগুলি হল রিয়েল টাইম এপিআই প্রশ্নগুলির উপর বিধিনিষেধ:

  • যদি rt:activeUsers মেট্রিকটি নিম্নলিখিত মাত্রা ফিল্টার সহ একটি ক্যোয়ারীতে অন্তর্ভুক্ত করা হয়, তাহলে শুধুমাত্র AND অপারেটর এবং সমতা মিলের ধরন ( == ) সমর্থিত হয়।
    • rt:goalId
    • rt:eventAction
    • rt:eventCategory
    • rt:eventLabel

    কারণ rt:activeUsers মেট্রিক এই মুহূর্তে সাইটে সক্রিয় ব্যবহারকারীর সংখ্যা পুনরুদ্ধার করে, rt:minutesAgo ব্যবহার করবেন না rt:activeUsers সাথে। অর্থাৎ, rt:activeUsers বোঝায় যে rt:minutesAgo হল 0।

  • মেট্রিক ফিল্টার জন্য কোন সমর্থন নেই.
  • fields পরামিতি জন্য কোন সমর্থন নেই.

কোটা ব্যবস্থাপনা

সীমা এবং কোটায় বর্ণিত হিসাবে, রিয়েল টাইম রিপোর্টিং API-এর জন্য প্রতিদিনের কোটা রয়েছে যা অন্যান্য Google Analytics API-এর সাথে ভাগ করা হয়। আপনি যদি অল্প ব্যবধানে রিয়েল টাইম রিপোর্টিং এপিআই পোলিং করেন, আপনি খুব দ্রুত দৈনিক কোটার সীমাতে পৌঁছান। যখন এটি ঘটে, কোটা রিফ্রেশ না হওয়া পর্যন্ত অন্যান্য Google Analytics API-এর অনুরোধগুলিও কাজ করা বন্ধ করে দেয়।

কিছু উদাহরণ বাস্তবায়ন যা খুব দ্রুত কোটা ব্যবহার করতে পারে:

  • আপনার কাছে দৈনিক ভিত্তিতে খুব অল্প ব্যবধানে একটি একক Google Analytics ভিউ (প্রোফাইল) এর জন্য ডেটা অনুসন্ধান করার একাধিক রিয়েলটাইম ড্যাশবোর্ড রয়েছে৷
  • আপনার অনেক ব্যবহারকারীর সাথে একটি সম্পত্তি আছে এবং আপনি একটি রিয়েল টাইম উইজেট প্রয়োগ করেছেন। প্রতিবার উইজেটটি ব্যবহারকারীর কাছে প্রদর্শিত হলে, আপনি ক্যাশে ব্যবহার না করে সরাসরি Google Analytics-কে জিজ্ঞাসা করছেন।

কোটা ব্যবহার কমাতে এবং দক্ষতার সাথে পরিচালনা করতে:

  • সার্ভার-সাইড ক্যাশিং প্রয়োগ করুন। যখন একাধিক ব্যবহারকারী একই রিয়েল টাইম ডেটার জন্য একটি অনুরোধ করেন, তখন প্রতিটি ব্যবহারকারীর অনুরোধের জন্য রিয়েল টাইম রিপোর্টিং API-কে সরাসরি জিজ্ঞাসা করার পরিবর্তে আপনার একটি ক্যাশে করা প্রতিক্রিয়া ফেরত দেওয়া উচিত৷ তারপরে প্রতিদিনের কোটা সীমা অতিক্রম না করার জন্য একটি যুক্তিসঙ্গত রিফ্রেশ ব্যবধানে সাম্প্রতিক রিয়েল টাইম ডেটা সহ পর্যায়ক্রমে ক্যাশে রিফ্রেশ করুন।
  • অতিরিক্ত মাত্রা নির্দিষ্ট করে একাধিক প্রশ্ন একত্রিত করুন এবং সার্ভার বা ক্লায়েন্ট সাইডে প্রতিক্রিয়া পার্স করুন।
  • আপনি যে সময়ে রিয়েল টাইম ডেটার অনুরোধ করছেন সেই সময়ের ব্যবধান বাড়ান৷

উদাহরণ: একটি রিফ্রেশ ব্যবধান গণনা করা

আপনি যদি রিয়েল টাইম ডেটার জন্য নিয়মিত অনুরোধ করার আশা করেন, তাহলে আপনার প্রত্যাশিত ব্যবহারের উপর ভিত্তি করে একটি যুক্তিসঙ্গত রিফ্রেশ ব্যবধান নির্বাচন করা উচিত।

উদাহরণস্বরূপ, একটি একক Google Analytics ভিউ (প্রোফাইল) এর দৈনিক কোটা সীমা রয়েছে প্রতিদিন 10,000 অনুরোধ। এক দিনে, যদি আপনি একটি একক ভিউ (প্রোফাইল) এর জন্য কোর রিপোর্টিং এপিআই-তে 6,000টি প্রশ্ন করার আশা করেন, তাহলে সেই ভিউ (প্রোফাইলের) জন্য আপনার কাছে 4,000টি অনুরোধ অবশিষ্ট থাকবে।

ধরুন আপনি 3টি রিয়েল টাইম ড্যাশবোর্ড বাস্তবায়নের জন্য রিয়েল টাইম রিপোর্টিং API ব্যবহার করার সিদ্ধান্ত নিয়েছেন যা একই ভিউ (প্রোফাইল) থেকে রিয়েল টাইম ডেটার জন্য সারাদিন অনুসন্ধান চালায়। প্রতিটি ড্যাশবোর্ড প্রতিদিন প্রায় 1,333টি প্রশ্ন করতে পারে (4,000টি প্রশ্ন / 3টি ড্যাশবোর্ড)। একটি দিনে 86,400 সেকেন্ড আছে। এইভাবে প্রতিটি ড্যাশবোর্ডের জন্য রিফ্রেশ ব্যবধান অবশ্যই 65 সেকেন্ডের (86,400 / 1,333) বেশি হতে হবে যাতে ভিউ (প্রোফাইল) এর জন্য দৈনিক অনুরোধের মোট সংখ্যা 4,000 দৈনিক সীমার নিচে থাকে।