আপনি 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" }
]
}
অথবা Application Default
Credentials ব্যবহার করে সমতুল্য 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 স্কিমা ডকুমেন্টেশন দেখুন।