নমুনাবিহীন রিপোর্ট ডেভেলপার গাইড

গুগল অ্যানালিটিক্স ম্যানেজমেন্ট API আপনাকে প্রোগ্রাম্যাটিকভাবে নমুনাবিহীন প্রতিবেদন তৈরি করতে দেয়।

ভূমিকা

নমুনাবিহীন প্রতিবেদনগুলি হল Google Analytics প্রতিবেদন যা নমুনাবিহীন ডেটা ব্যবহার করে তৈরি করা হয়েছে। নমুনাবিহীন প্রতিবেদন বর্তমানে শুধুমাত্র Google Analytics 360 ব্যবহারকারীদের জন্য উপলব্ধ।

এই API দিয়ে, আপনি করতে পারেন:

  • আপনার সমস্ত বিদ্যমান নমুনাবিহীন প্রতিবেদন সম্পর্কে কনফিগারেশন তথ্য পুনরুদ্ধার করুন। এককালীন নমুনাবিহীন প্রতিবেদন তৈরি করুন।
  • নমুনাবিহীন প্রতিবেদনের প্রক্রিয়াকরণের স্থিতি পরীক্ষা করুন।
  • প্রক্রিয়াকরণ সম্পূর্ণ হলে একটি নমুনাবিহীন প্রতিবেদনের জন্য ডেটা ফাইলের একটি লিঙ্ক পান।
  • নমুনাবিহীন রিপোর্ট মুছুন।

নমুনাবিহীন প্রতিবেদনের জন্য ডেটা পুনরুদ্ধার করা হচ্ছে

আপনি যখন একটি নমুনাবিহীন প্রতিবেদন তৈরি করেন, তখন প্রতিবেদনটি ডাউনলোডের জন্য উপলব্ধ হওয়ার আগে কিছু সময় লাগতে পারে। একটি নমুনাবিহীন প্রতিবেদনের status ক্ষেত্র নির্দেশ করে যে প্রতিবেদনটির প্রক্রিয়াকরণ সম্পূর্ণ হয়েছে কিনা। স্ট্যাটাসটি COMPLETED হিসাবে চিহ্নিত হয়ে গেলে, রিপোর্ট ডেটা ধারণকারী ফাইলটি পুনরুদ্ধার করতে আপনি downloadType এবং সংশ্লিষ্ট ডাউনলোড বিবরণ ক্ষেত্র ব্যবহার করতে পারেন। উদাহরণ স্বরূপ:

  • যদি downloadType মান GOOGLE_DRIVE হয়, তাহলে driveDownloadDetails ক্ষেত্রটি ব্যবহার করুন৷
  • downloadType মান GOOGLE_CLOUD_STORAGE হলে, cloudStorageDownloadDetails ক্ষেত্রটি ব্যবহার করুন।

এই রিপোর্টগুলির স্থিতি পরীক্ষা করার জন্য ক্রমাগত, উচ্চ-দর, পোলিং ব্যবহার করবেন না, কারণ আপনার প্রতিদিনের কোটা মোটামুটি দ্রুত শেষ হয়ে যাওয়ার সম্ভাবনা রয়েছে। নমুনাবিহীন প্রতিবেদনের স্থিতি পরীক্ষা করার সময় আপনার অনুরোধগুলির মধ্যে একটি সময় বিলম্ব হওয়া উচিত।

Google Drive/Google Cloud Storage API ব্যবহার করা

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

উদাহরণস্বরূপ, যদি আপনার নমুনাবিহীন প্রতিবেদন Google ড্রাইভে সংরক্ষণ করা হয়, আপনি ফাইলের সংস্থান URL-এ একটি অনুমোদিত HTTP GET অনুরোধ করতে পারেন এবং ক্যোয়ারী প্যারামিটার alt=media অন্তর্ভুক্ত করতে পারেন।

GET /drive/v2/files/XXXXXX?alt=media
Host: www.googleapis.com
Content-length: 0
Authorization: Bearer ya29.AHESVbXTUv5mHMo3RYfmS1YJonjzzdTOFZwvyOAUVhrs

যেখানে XXXXXX হল নমুনাবিহীন রিপোর্ট driveDownloadDetails.documentId

প্রমাণীকরণ

আপনি যদি ফাইল ডাউনলোডের জন্য ড্রাইভ বা ক্লাউড স্টোরেজ API-এর সাথে একত্রে নমুনাবিহীন প্রতিবেদন ব্যবহার করার পরিকল্পনা করছেন, তাহলে একটি OAuth 2.0 টোকেনের অনুরোধ করার সময় আপনাকে সেই API (Analytics API প্রমাণের সুযোগ ছাড়াও) এর জন্য সংশ্লিষ্ট প্রমাণীকরণ সুযোগ অন্তর্ভুক্ত করতে হবে। এটি আপনাকে উভয় API-এর জন্য একই প্রমাণীকরণ টোকেন ব্যবহার করার অনুমতি দেবে।

নমুনাবিহীন প্রতিবেদন মুছে ফেলা হচ্ছে

আপনি নির্ধারিত বা সম্পূর্ণ নমুনাবিহীন প্রতিবেদন মুছে ফেলতে পারেন, তবে প্রতিবেদন তৈরি হওয়ার সময় সংক্ষিপ্ত সময়ের মধ্যে delete কল করলে একটি ত্রুটি দেখা দেবে। নমুনাবিহীন প্রতিবেদনগুলি মুছে ফেলা হলে শুধুমাত্র আপনার GA ভিউ (প্রোফাইল) থেকে সংস্থান মুছে যাবে, Google ড্রাইভ বা Google ক্লাউড স্টোরেজের রপ্তানি করা ডেটা থেকে যাবে।

বিধিনিষেধ

নমুনাবিহীন প্রতিবেদন তৈরির ক্ষেত্রে নিম্নলিখিত বিধিনিষেধ প্রযোজ্য:

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

যদি আপনার অনুরোধটি খুব ব্যয়বহুল বলে নির্ধারণ করা হয়, তবে ক্রিয়েট অপারেশন একটি উপযুক্ত বার্তা সহ একটি ত্রুটি ফিরিয়ে দেবে। যদি এটি ঘটে তবে আপনি করতে পারেন:

  • কম মাত্রা অনুরোধ.
  • ক্যোয়ারীটিকে ছোট তারিখের ব্যাপ্তি সহ একাধিক প্রশ্নে বিভক্ত করুন এবং ফলাফলের প্রতিবেদনগুলিকে একসাথে সেলাই করুন৷

ব্যবহারের ক্ষেত্রে

নমুনাবিহীন প্রতিবেদন এবং মূল প্রতিবেদন API

আপনি যদি রিপোর্ট ডেটা পুনরুদ্ধার করার জন্য কোর রিপোর্টিং API ব্যবহার করেন এবং এতে নমুনাযুক্ত ডেটা থাকে তাহলে আপনি নিম্নরূপ একই প্রশ্নের জন্য একটি নমুনাবিহীন প্রতিবেদন তৈরি করতে পারেন:

  1. একটি কোর রিপোর্টিং API অনুরোধ করুন।
  2. প্রতিক্রিয়াতে, ডেটা নমুনা করা হয়েছে কিনা তা দেখতে containsSampledData বৈশিষ্ট্য পরীক্ষা করুন।
  3. যদি এই বৈশিষ্ট্যটি সত্য হিসাবে সেট করা থাকে, আপনি একটি নমুনাবিহীন প্রতিবেদনের জন্য অনুরোধ তৈরি করতে একই প্রতিক্রিয়া থেকে ক্যোয়ারী এবং প্রোফাইলইনফো ক্ষেত্রগুলি ব্যবহার করতে পারেন।

কোর রিপোর্টিং API প্রতিক্রিয়া থেকে নমুনা ক্যোয়ারী ক্ষেত্র:

"query": {
  "start-date": "2011-01-01",
  "end-date": "2011-01-31",
  "ids": "ga:1234",
  "dimensions": "ga:browser",
  "metrics": [
  "ga:visits"
  ],
  "filters": "ga:country==US",
  "start-index": 1,
  "max-results": 1000
}

কোর রিপোর্টিং API প্রতিক্রিয়া থেকে নমুনা profileInfo ক্ষেত্র:

"profileInfo": {
  "profileId": "1234",
  "accountId": "12345",
  "webPropertyId": "UA-12345-1",
  "internalWebPropertyId": "11254",
  "profileName": "Name of the profile",
  "tableId": "ga:1234"
}

কোর রিপোর্টিং এপিআই প্রতিক্রিয়া থেকে কীভাবে একটি নমুনাবিহীন প্রতিবেদন তৈরি করা যায় তার একটি উদাহরণ নিচে দেওয়া হল:

জাভা

// Make a Core Reporting API call.
GaData reportingApiData = v3.data().ga().get(...).execute();

// Check if the response is sampled.
if (reportingApiData.getContainsSampledData()) {

  // Use the “query” object to construct an unsampled report object.
  Query query = reportingApiData.getQuery();
  UnsampledReport report = new UnsampledReport()
      .setDimensions(query.getDimensions())
      .setMetrics(Joiner.on(',').join(query.getMetrics()))
      .setStartDate(startDate)
      .setEndDate(endDate)
      .setSegment(query.getSegment())
      .setFilters(query.getFilters())
      .setTitle(“My unsampled report”);

  // Use “profileInfo” to create an InsertRequest for creating an
  // unsampled report.
  ProfileInfo profileInfo = reportingApiData.getProfileInfo();
  Insert insertRequest = analytics.management().unsampledReports()
  .insert(profileInfo.getAccountId(),
          profileInfo.getWebPropertyId(),
          profileInfo.getProfileId(),
          report);
  UnsampledReport createdReport = insertRequest.execute();
}

একাধিক দিনের জন্য নমুনাবিহীন ডেটা সেলাই করা

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

কোটা নীতি

নমুনাবিহীন রিপোর্ট তৈরি করার সময় প্রযোজ্য সীমা এবং কোটার সম্পূর্ণ তালিকার জন্য কনফিগারেশন এবং রিপোর্টিং API সীমা এবং কোটা দেখুন।