রিপোর্ট টাস্ক মৌলিক

রিপোর্ট টাস্ক ব্যবহার করে, আপনি আপনার 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 ক্ষেত্র যা একটি কাস্টমাইজড রিপোর্টের সংজ্ঞা বর্ণনা করে। এই প্যারামিটারের গঠন কোর রিপোর্টিং পদ্ধতি দ্বারা ব্যবহৃত রিপোর্ট সংজ্ঞার অনুরূপ।

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

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 ক্ষেত্রে Report Task নাম থাকে (যেমন properties/1234567/reportTasks/123 ), যা পরবর্তী প্রশ্নের ক্ষেত্রে Report Task এর অবস্থা পেতে এবং ফলাফল পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে।

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 পদ্ধতিতে কল করে সমস্ত Report Tasks এর অবস্থা জানতে পারবেন।

তৈরি করা প্রতিবেদনটি পুনরুদ্ধার করুন

reportTasks.create পদ্ধতি ব্যবহার করে তৈরি করা Report Task তৈরি হয়ে গেলে, reportTasks.query পদ্ধতিতে কল করুন এবং Report Task নামটি (যেমন 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"
  }
}