টাস্ক সংক্রান্ত অভিযোগের প্রাথমিক বিষয়

রিপোর্ট টাস্ক ব্যবহার করে, আপনি Google Analytics ইভেন্ট ডেটার কাস্টমাইজ করা রিপোর্ট তৈরি করতে দীর্ঘ সময় ধরে চলা অ্যাসিঙ্ক্রোনাস অনুরোধ শুরু করতে পারেন।

এই অনুরোধ থেকে তৈরি করা রিপোর্ট টাস্ক রিসোর্স, আপনার Google Analytics প্রপার্টিতে রিড অ্যাক্সেস আছে এমন সব ব্যবহারকারীর কাস্টমাইজ করা রিপোর্ট অ্যাক্সেস করতে ব্যবহার করা যেতে পারে।

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

রিপোর্ট টাস্ক তৈরি করুন

রিপোর্ট টাস্ক তৈরি করতে Google Analytics Data API v1 অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করে। প্রথমে, একটি রিপোর্ট টাস্ক তৈরি করার জন্য reportTasks.create পদ্ধতিতে একটি অনুরোধ প্রয়োজন। তারপর, জেনারেট করা কাস্টমাইজড রিপোর্ট ফিরিয়ে আনতে reportTasks.query পদ্ধতি ব্যবহার করা হয়।

এছাড়াও, আপনি reportTasks.get ব্যবহার করে নির্দিষ্ট রিপোর্ট টাস্কের কনফিগারেশন মেটাডেটা এবং reportTasks.list ব্যবহার করে কোনও প্রপার্টির সব রিপোর্ট টাস্কের তালিকা পেতে পারেন।

অভিযোগকারী এন্টিটি বেছে নিন

Data API v1-এর সব পদ্ধতিতে Google Analytics প্রপার্টি আইডেন্টিফায়ার URL অনুরোধের পাথে properties/GA_PROPERTY_ID ফর্ম্যাটে উল্লেখ করতে হয়, যেমন:

  POST  https://analyticsdata.googleapis.com/v1alpha/properties/GA_PROPERTY_ID/reportTasks

নির্দিষ্ট Google Analytics প্রপার্টিতে সংগ্রহ করা Google Analytics ইভেন্ট ডেটার উপর ভিত্তি করে রিপোর্ট তৈরি করা হয়।

আপনি Data API ক্লায়েন্ট লাইব্রেরি-এর মধ্যে কোনও একটি ব্যবহার করলে, অনুরোধের URL পাথ ম্যানুয়ালি পরিবর্তন করার প্রয়োজন নেই। বেশিরভাগ API ক্লায়েন্ট property প্যারামিটার প্রদান করে যা properties/GA_PROPERTY_ID ফর্ম্যাটে স্ট্রিং আশা করে। ক্লায়েন্ট লাইব্রেরি ব্যবহারের উদাহরণ দেখতে দ্রুত শুরুর নির্দেশিকা দেখুন।

রিপোর্ট টাস্ক তৈরি করার অনুরোধ করুন

রিপোর্ট টাস্ক তৈরি করতে, অনুরোধে ReportTask অবজেক্ট ব্যবহার করে reportTasks.create মেথড কল করুন। নিম্নলিখিত প্যারামিটারগুলি প্রয়োজন:

  • reportDefinition ফিল্ড যা কাস্টমাইজ করা রিপোর্টের সংজ্ঞা বর্ণনা করে। এই প্যারামিটারের গঠন Core Reporting পদ্ধতি দ্বারা ব্যবহৃত রিপোর্টের সংজ্ঞার অনুরূপ।

রিপোর্ট টাস্ক তৈরির অনুরোধের উদাহরণ:

HTTP অনুরোধ

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/reportTasks
{
  "reportDefinition": {
    "dateRanges": [{ "startDate": "2024-05-01"", "endDate": "2024-05-15" }],
    "dimensions": [{ "name": "country" }],
    "metrics": [{ "name": "activeUsers" }]
  }
}

reportTasks.create পদ্ধতির উত্তরে name ফিল্ডে (যেমন properties/1234567/reportTasks/123) রিপোর্ট টাস্কের নাম থাকে, যা রিপোর্ট টাস্কের স্ট্যাটাস জানতে এবং ফলাফল রিপোর্ট পেতে পরবর্তী কোয়েরিতে ব্যবহার করা যেতে পারে।

HTTP রেসপন্স

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.ReportTask",
    "name": "properties/1234567/reportTasks/123",
    "reportDefinition": {
      "dimensions": [
        {
          "name": "country"
        }
      ],
      "metrics": [
        {
          "name": "activeUsers"
        }
      ],
      "dateRanges": [
        {
          "startDate": "2024-05-01",
          "endDate": "2024-05-15"
        }
      ]
    },
    "reportMetadata": {
      "state": "CREATING",
      "beginCreatingTime": "2024-05-16T00:00:01.133612336Z"
    }
  }
}

রিপোর্ট টাস্কের প্রস্তুতি সংক্রান্ত স্ট্যাটাস পান

reportTasks.create কলের পরে রিপোর্ট তৈরি করতে কয়েক মিনিট সময় লাগতে পারে। আপনি reportTasks.get মেথড কল করে রিপোর্ট টাস্কের জন্য প্রস্তুতি স্ট্যাটাস পেতে পারেন।

রিপোর্ট টাস্ক নির্দিষ্ট করতে, reportTasks.create রেসপন্স থেকে পাওয়া রিপোর্ট টাস্কের নাম (যেমন properties/1234567/reportTasks/123) ব্যবহার করুন।

উদাহরণ:

HTTP অনুরোধ

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/reportTasks/123

রিপোর্ট টাস্কের জন্য প্রস্তুতি স্ট্যাটাস উত্তরের state ফিল্ডে ফেরত পাঠানো হয়। রিপোর্ট তৈরি করা হয়ে গেলে, রিপোর্ট টাস্কের স্ট্যাটাস CREATING থেকে ACTIVE-এ পরিবর্তিত হয়।

reportMetadata ফিল্ডে তৈরি করা রিপোর্ট সম্পর্কে উচ্চ লেভেলের তথ্য থাকে, যেমন সারি গণনা এবং চার্জ করা কোটা টোকেনের পরিমাণ।

HTTP রেসপন্স

{
  "reportDefinition": {
    "dimensions": [
      {
        "name": "country"
      }
    ],
    "metrics": [
      {
        "name": "activeUsers"
      }
    ],
    "dateRanges": [
      {
        "startDate": "2024-05-01",
        "endDate": "2024-05-15"
      }
    ]
  },
  "reportMetadata": {
    "state": "ACTIVE",
    "beginCreatingTime": "2024-05-16T00:00:01.133612336Z",
    "creationQuotaTokensCharged": 6,
    "taskRowCount": 167,
    "errorMessage": "",
    "totalRowCount": 167
  }
}

আপনি reportTasks.list মেথড কল করে সব রিপোর্ট টাস্কের স্ট্যাটাস জানতে পারবেন।

জেনারেট করা রিপোর্ট ফিরিয়ে আনা

reportTasks.create পদ্ধতি ব্যবহার করে তৈরি করা রিপোর্ট টাস্ক জেনারেট করা হলে, reportTasks.query পদ্ধতি কল করুন এবং রিপোর্ট টাস্কের নাম উল্লেখ করুন (যেমন properties/1234567/reportTasks/123)।

HTTP অনুরোধ

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/reportTasks/123:query

রিপোর্ট টাস্ক রেডি থাকলে, জেনারেট করা রিপোর্ট সহ একটি উত্তর পাঠানো হয়:

HTTP রেসপন্স

{
  "dimensionHeaders": [
    {
      "name": "country"
    }
  ],
  "metricHeaders": [
    {
      "name": "activeUsers",
      "type": "TYPE_INTEGER"
    }
  ],
  "rows": [

...

  ],
  "rowCount": 167,
  "metadata": {
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles"
  }
}

পরবর্তী ধাপ