Google Analytics Data API-এর ওভারভিউ

আপনি Data API ব্যবহার করে প্রোগ্রাম্যাটিক্যালি Google Analytics রিপোর্ট ডেটা অ্যাক্সেস করতে পারবেন।

Google Analytics প্রপার্টি সম্পর্কে আরও জানুন।

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

Google Analytics Data API v1 ব্যবহার করে আপনি যেসব বিষয়ে রিপোর্ট করতে পারেন তার কিছু উদাহরণ এখানে দেওয়া হল:

  • গত সপ্তাহে আপনার Android অ্যাপে কতজন দৈনিক অ্যাক্টিভ ব্যবহারকারী ছিলেন।
  • গত ২৮ দিনে আপনার সাইটের সেরা ১০টি পৃষ্ঠা কতবার দেখা হয়েছে।
  • গত ৩০ মিনিটে আপনার iOS অ্যাপে দেশ প্রতি কতজন অ্যাক্টিভ ব্যবহারকারী ছিলেন।

এছাড়াও, আপনি Google Analytics Data API v1 ব্যবহার করে নিম্নলিখিত কাজগুলি করতে পারবেন:

  • Google Analytics ডেটা দেখানোর জন্য কাস্টম ড্যাশবোর্ড তৈরি করুন।
  • সময় বাঁচাতে জটিল রিপোর্টিং টাস্ক অটোমেট করুন।
  • অন্যান্য বিজনেস অ্যাপ্লিকেশনের সাথে আপনার Google Analytics ডেটা ইন্টিগ্রেট করুন।

ডেটার সামঞ্জস্য ও রিপোর্টিং পরিচয়

Google Analytics Data API v1, Google Analytics ইন্টারফেসের মতো একই রিপোর্ট ডেটা অ্যাক্সেস করে। API-এর মাধ্যমে পাওয়া ডেটা আপনার Google Analytics প্রপার্টির জন্য কনফিগার করা রিপোর্টিং আইডেন্টিটি সেটিংসকে সম্পূর্ণভাবে মেনে চলে, যাতে ব্যবহারকারীর সংখ্যা, ডিডুপ্লিকেশন এবং ডেটা মডেলিং আপনার প্রপার্টি সেটিংসে বেছে নেওয়া আইডেন্টিটি স্পেসের সাথে সামঞ্জস্যপূর্ণ হয়—যেমন ব্লেন্ডেড, অবজার্ভড বা ডিভাইস-ভিত্তিক।

বিভিন্ন আইডেন্টিটি স্পেস কীভাবে আপনার রিপোর্টকে প্রভাবিত করতে পারে সে সম্পর্কে আরও জানতে, রিপোর্টিং আইডেন্টিটি দেখুন।

শুরু করুন

Java, Python, Node.js, PHP, C#, Go বা Ruby-তে ক্লায়েন্ট লাইব্রেরি ব্যবহার শুরু করতে, ক্লায়েন্ট লাইব্রেরি কুইকস্টার্ট দেখুন। কীভাবে কোয়েরি তৈরি, ফিল্টার ডাইমেনশন এবং উত্তর পড়তে হয় তা জানতে, রিপোর্ট তৈরি করুন দেখুন অথবা কোয়েরি এক্সপ্লোরার-এ ইন্টার‍্যাক্টিভভাবে কোয়েরি পরীক্ষা করুন।

runReport নম্বর অনুরোধ ও উত্তরের নমুনা

REST-এর মাধ্যমে ইভেন্ট ডেটা কোয়েরি করতে, POST অনুরোধটি runReport এন্ডপয়েন্টে পাঠান, যেখানে RunReportRequest JSON বডিতে আপনার dateRanges, dimensions এবং metrics উল্লেখ করা থাকবে:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [
    { "startDate": "7daysAgo", "endDate": "yesterday" }
  ],
  "dimensions": [
    { "name": "country" }
  ],
  "metrics": [
    { "name": "activeUsers" }
  ]
}

অথবা অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করে সমতুল্য curl কমান্ড রান করুন:

curl -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRanges": [
      { "startDate": "7daysAgo", "endDate": "yesterday" }
    ],
    "dimensions": [
      { "name": "country" }
    ],
    "metrics": [
      { "name": "activeUsers" }
    ]
  }'

API একটি RunReportResponse ফেরত দেয় যাতে কলাম হেডার ও ডেটা সারি থাকে:

{
  "dimensionHeaders": [
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "activeUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "United States" }],
      "metricValues": [{ "value": "4820" }]
    },
    {
      "dimensionValues": [{ "value": "Japan" }],
      "metricValues": [{ "value": "2541" }]
    }
  ],
  "rowCount": 2,
  "kind": "analyticsData#runReport"
}

উপলভ্য পদ্ধতি

এখানে ডেটা API পদ্ধতির তালিকা দেওয়া হল। আরও জানতে, রেফারেন্স ডকুমেন্টেশন দেখুন।

  • runReport এই পদ্ধতি আপনার Google Analytics ইভেন্ট ডেটার একটি কাস্টমাইজ করা রিপোর্ট প্রদান করে এবং এটি সহজ রিপোর্ট কোয়েরির জন্য একটি পছন্দের পদ্ধতি।
  • batchRunReports এটি runReport পদ্ধতির একটি ব্যাচ ভার্সন যা আপনাকে একটি API কলের মাধ্যমে একাধিক রিপোর্ট তৈরি করতে দেয়।
  • runPivotReport এই পদ্ধতি আপনার Google Analytics ইভেন্ট ডেটার একটি কাস্টমাইজ করা পিভট রিপোর্ট ফেরত দেয়। পিভট রিপোর্ট হল সাধারণ রিপোর্টের চেয়ে আরও উন্নত এবং প্রকাশযোগ্য ফর্ম্যাট। প্রতিটি পিভট রিপোর্ট রেসপন্সে দৃশ্যমান ডাইমেনশন কলাম ও সারি বর্ণনা করে।
  • batchRunPivotReports এটি runPivotReport পদ্ধতির একটি ব্যাচ ভার্সন যা আপনাকে একটি API কলের মাধ্যমে একাধিক রিপোর্ট তৈরি করতে দেয়।
  • getMetadata এই পদ্ধতি রিপোর্টিং পদ্ধতিতে উপলভ্য ডাইমেনশন ও মেট্রিকের জন্য মেটাডেটা রিটার্ন করে। ডাইমেনশন ও মেট্রিক এক্সপ্লোর করতে ব্যবহার করা হয়। এই পদ্ধতির উত্তরে নির্দিষ্ট Google Analytics প্রপার্টির জন্য উপলভ্য কাস্টম ডাইমেনশন ও মেট্রিক্সও অন্তর্ভুক্ত থাকে।
  • checkCompatibility এই পদ্ধতিটি ডাইমেনশন এবং মেট্রিক্সের তালিকা তৈরি করে যা একটি রিপোর্ট অনুরোধে যোগ করা যেতে পারে এবং সামঞ্জস্য বজায় রাখতে পারে।
  • runRealtimeReport এই পদ্ধতি আপনার প্রপার্টির জন্য রিয়েল-টাইম ইভেন্ট ডেটার কাস্টমাইজ করা রিপোর্ট ফেরত পাঠায়। Google Analytics-এ পাঠানোর কয়েক সেকেন্ডের মধ্যে রিয়েল-টাইম রিপোর্টে ইভেন্ট দেখা যায়। রিয়েল-টাইম রিপোর্টে বর্তমান সময় থেকে ৩০ মিনিট আগে পর্যন্ত (Google Analytics 360 প্রপার্টির জন্য ৬০ মিনিট পর্যন্ত) ইভেন্ট ও ব্যবহারের ডেটা দেখানো হয়।
  • properties.audienceExports পদ্ধতির একটি গ্রুপ যা আপনাকে অডিয়েন্স এক্সপোর্ট জেনারেট করতে দেয়, যার মধ্যে কোনও অডিয়েন্সে ব্যবহারকারীদের একটি স্ন্যাপশট অন্তর্ভুক্ত থাকে।
  • properties.recurringAudienceLists (আগাম প্রিভিউ) একাধিক পদ্ধতির একটি গ্রুপ যা আপনাকে রেকারিং অডিয়েন্স এক্সপোর্ট ম্যানেজ করতে দেয়। একটি পুনরাবৃত্ত অডিয়েন্স এক্সপোর্ট প্রতিদিন নতুন অডিয়েন্স তালিকা তৈরি করে।
  • runFunnelReport (আগাম প্রিভিউ) এই পদ্ধতি আপনার Google Analytics ইভেন্ট ডেটার কাস্টমাইজ করা ফানেল রিপোর্ট ফিরিয়ে দেয়। ফানেল এক্সপ্লোরেশন আপনাকে কোনও টাস্ক সম্পূর্ণ করার জন্য ব্যবহারকারীর নেওয়া পদক্ষেপগুলি ভিজ্যুয়ালাইজ করতে এবং প্রতিটি পদক্ষেপে তারা কতটা সফল বা ব্যর্থ হচ্ছে তা দ্রুত দেখতে দেয়।
  • properties.chat (আগাম প্রিভিউ) এই পদ্ধতি Google Analytics-এ Ask Advisor-এ প্রোগ্রাম্যাটিক কথোপকথন সংক্রান্ত অ্যাক্সেস প্রদান করে। আপনি ইভেন্ট ডেটা সম্পর্কে স্বাভাবিক ভাষায় প্রশ্ন করতে, পারফর্ম্যান্সের পরিবর্তন ডায়াগনসিস করতে এবং স্ট্রাকচার্ড ন্যারেটিভ ও সারণী আকারে ইনসাইট পেতে পারেন।

কাজ করে এমন ডাইমেনশন ও মেট্রিক

Data API-তে কাজ করে এমন সব ডাইমেনশন ও মেট্রিকের তালিকা দেখতে, API স্কিমা ডকুমেন্টেশন দেখুন।