এই নথিটি Google Analytics রিপোর্টিং API v4-এর উন্নত বৈশিষ্ট্যগুলি বর্ণনা করে৷ API এর বিস্তারিত রেফারেন্সের জন্য, রেফারেন্স গাইড দেখুন।
ভূমিকা
একটি সাধারণ প্রতিবেদন তৈরি করার পরে, উন্নত প্রতিবেদন তৈরি করতে এই বৈশিষ্ট্যগুলি ব্যবহার করুন:
পিভটস
Google Analytics রিপোর্টিং API v4 আপনাকে পিভট টেবিল তৈরি করতে দেয়। একটি পিভট টেবিলের সাথে একটি অনুরোধ তৈরি করতে, ReportRequest- এ পিভট ক্ষেত্রটি সংজ্ঞায়িত করুন। পিভট অবজেক্টের নিজস্ব মাত্রা এবং মেট্রিক্স এবং ঐচ্ছিক startGroup
এবং maxGroupCount
আছে পিভট টেবিলে অন্তর্ভুক্ত করা মাত্রার সংখ্যা নির্দিষ্ট করতে।
অনুরোধ
নিম্নলিখিত API কল দেশ অনুসারে সেশনের অনুরোধ করে এবং ফলাফলগুলি ব্রাউজারে পিভট করে:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
প্রতিক্রিয়া কলাম শিরোনাম
একটি পিভট অনুরোধের জন্য প্রত্যাবর্তিত রিপোর্ট অবজেক্টে, metricHeader
পিভটহেডার অবজেক্টের একটি তালিকা রয়েছে যার pivotHeaderEntries
ক্ষেত্রগুলি পিভট মাত্রা মান এবং সংশ্লিষ্ট মেট্রিক মানগুলির ক্রম নির্ধারণ করে, উদাহরণস্বরূপ:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
প্রতিক্রিয়া সারি
রিপোর্টডেটা অবজেক্টের প্রতিটি সারি dateRangeValue অবজেক্টের একটি অ্যারেকে সংজ্ঞায়িত করে, যার প্রতিটিতে পিভট ভ্যালু অবজেক্টের একটি সেট রয়েছে; মানগুলির ক্রম প্রতিক্রিয়া কলামের শিরোনামে পিভট শিরোনামে তালিকাভুক্ত মেট্রিক্সের ক্রম অনুসারে।
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
মনে রাখবেন যে রিপোর্টে শুধুমাত্র তিনটি পিভট মান রয়েছে কারণ মূল অনুরোধে, maxGroupCount
হল 3। "totalPivotGroupsCount": 7
।
পিভট টেবিল সারি উদাহরণ
উপরের নমুনা প্রতিক্রিয়াতে, মার্কিন যুক্তরাষ্ট্রের সাথে যুক্ত সারিটি নিম্নলিখিত পিভট টেবিলে উপস্থাপন করা হয়েছে:
দেশ | মোট সেশন | ইন্টারনেট এক্সপ্লোরার সেশন | ফায়ারফক্স সেশন | অ্যান্ড্রয়েড ব্রাউজার সেশন |
---|---|---|---|---|
ভারত | 12 | 3 | 2 | 4 |
যুক্তরাষ্ট্র | 192 | 21 | 18 | 1 |
যুক্তরাজ্য | 35 | 12 | 2 | 0 |
সমদল
একটি সমগোত্র হল ব্যবহারকারীদের একটি গ্রুপ যারা একটি সাধারণ বৈশিষ্ট্য ভাগ করে নেয়। উদাহরণস্বরূপ, একই অধিগ্রহণের তারিখ সহ সমস্ত ব্যবহারকারী একই দলভুক্ত। কোহর্ট অ্যানালাইসিস রিপোর্ট আপনাকে সমগোত্রীয় আচরণকে বিচ্ছিন্ন ও বিশ্লেষণ করতে দেয়। কোহর্টের নির্দিষ্ট মাত্রা এবং মেট্রিক্সের তালিকার জন্য, কোহর্ট এবং লাইফটাইম ভ্যালু (LTV) মাত্রা এবং মেট্রিক্স দেখুন।
একটি সমগোত্রীয় অনুরোধ সংজ্ঞায়িত করতে, আপনাকে অবশ্যই name
, type
এবং dateRange সহ একটি dateRange
বস্তুকে সংজ্ঞায়িত করতে হবে:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
API এক্সপ্লোরারে উপরের উদাহরণটি দেখুন।
সমগোত্রীয় সীমাবদ্ধতা
একটি বৈধ সমগোত্রীয় অনুরোধ নিম্নলিখিত বিধিনিষেধ পূরণ করতে হবে:
- যদি অনুরোধে এক বা একাধিক সমগোত্রীয় সংজ্ঞা থাকে তবেই
ga:cohort
মাত্রা অন্তর্ভুক্ত করা হয়। - সমগোত্রীয় নাম অবশ্যই অনন্য হতে হবে।
- একটি অনুরোধে সর্বাধিক 12টি সমগোত্রীয়।
-
ga:cohortNthWeek
সংজ্ঞায়িত করা হলে, শুরুর তারিখটি অবশ্যই রবিবার এবং শেষ তারিখটি অবশ্যই শনিবার হতে হবে৷ga:cohortNthMonth
সংজ্ঞায়িত করা হলে, শুরুর তারিখটি অবশ্যই মাসের প্রথম দিন এবং শেষ তারিখটি অবশ্যই মাসের শেষ দিন হতে হবে৷ যদিga:cohortNthDay
সংজ্ঞায়িত করা হয়, তারিখের ব্যাপ্তি অবশ্যই ঠিক একদিন হতে হবে। - আজকের তারিখের সাথে সমগোত্রীয় অনুরোধ অনুমোদিত নয়।
- সমগোত্রীয় এবং নন-কোহর্ট অনুরোধ একই
batchGet
অনুরোধে থাকা উচিত নয়। - কোহর্টে তারিখের ব্যাপ্তি অবশ্যই ফেব্রুয়ারী 1, 2015 এর পরে হতে হবে।
আজীবন মূল্য (LTV)
লাইফটাইম ভ্যালু রিপোর্ট দেখায় কিভাবে ব্যবহারকারীর মান (রাজস্ব) এবং ব্যস্ততা (অ্যাপভিউ, লক্ষ্য পূরণ, সেশন এবং সেশনের সময়কাল) একজন ব্যবহারকারী অর্জিত হওয়ার 90 দিনের মধ্যে বৃদ্ধি পায়। LTV নির্দিষ্ট মাত্রা এবং মেট্রিক্স দেখুন।
একটি LTV অনুরোধকে lifetimeValue
ভ্যালু ফিল্ড true
হিসাবে সেট করা সহ একটি সমগোত্রীয় হিসাবে সংজ্ঞায়িত করা হয়, উদাহরণস্বরূপ:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
API এক্সপ্লোরারে উপরের উদাহরণটি দেখুন।
কোহর্ট এবং লাইফটাইম ভ্যালু (LTV) মাত্রা এবং মেট্রিক্স
মাত্রা
মাত্রার নাম | সংজ্ঞা |
---|---|
ga:cohort | সমগোত্রের নাম যার সাথে একজন ব্যবহারকারী অন্তর্গত। সমদলকে কীভাবে সংজ্ঞায়িত করা হয় তার উপর নির্ভর করে, একজন ব্যবহারকারী একাধিক সমগোত্রীয় হতে পারে, একইভাবে একজন ব্যবহারকারী একাধিক বিভাগের অন্তর্গত হতে পারে। |
ga:cohortNthDay | সমগোত্রীয় সংজ্ঞা তারিখের সাথে সম্পর্কিত 0-ভিত্তিক দিনের অফসেট। উদাহরণ স্বরূপ, যদি একটি দলকে 2015-09-01 2015-09-04 জন্য, ga:cohortNthDay হবে 3৷ |
ga:cohortNthMonth | সমগোত্রীয় সংজ্ঞা তারিখের সাথে সম্পর্কিত 0-ভিত্তিক মাস অফসেট। |
ga:cohortNthWeek | সমগোত্রীয় সংজ্ঞা তারিখের সাথে সম্পর্কিত 0-ভিত্তিক সপ্তাহ অফসেট। |
ga:acquisitionTrafficChannel | ট্রাফিক চ্যানেল যার মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। এটি ব্যবহারকারীর প্রথম সেশন থেকে বের করা হয়। ব্যবহারকারী অধিগ্রহণের সময় ডিফল্ট চ্যানেল গ্রুপিং নিয়মের উপর ভিত্তি করে ট্রাফিক চ্যানেল গণনা করা হয় (উপলভ্য হলে ভিউ লেভেলে)। |
ga:acquisitionSource | যে উৎসের মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। ব্যবহারকারীর প্রথম সেশন থেকে প্রাপ্ত। |
ga:acquisitionMedium | যে মাধ্যমটির মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। ব্যবহারকারীর প্রথম সেশন থেকে প্রাপ্ত। |
ga:acquisitionSourceMedium | ga:userAcquisitionSource এবং ga:acquisitionMedium এর সম্মিলিত মান। |
ga:acquisitionCampaign | যে প্রচারাভিযানের মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। ব্যবহারকারীর প্রথম সেশন থেকে প্রাপ্ত। |
মেট্রিক্স
মেট্রিক নাম | সংজ্ঞা |
---|---|
ga:cohortActiveUsers | এই মেট্রিকটি 0-ভিত্তিক অফসেট মাত্রার ( ga:cohortNthDay , ga:cohortNthWeek বা ga:cohortNthMonth ) প্রসঙ্গে প্রাসঙ্গিক। এটি কোহর্টের ব্যবহারকারীদের সংখ্যা নির্দেশ করে যারা কোহর্টের এনম দিন/সপ্তাহ/মাসের সাথে সম্পর্কিত সময় উইন্ডোতে সক্রিয়। উদাহরণস্বরূপ, ga:cohortNthWeek = 1 , ব্যবহারকারীর সংখ্যা (কোহোর্টে) যারা দ্বিতীয় সপ্তাহে সক্রিয়। যদি একটি অনুরোধে ga:cohortNthDay , ga:cohortNthWeek , বা ga:cohortNthMonth এর কোনোটি না থাকে, তাহলে এই মেট্রিকের মান ga:cohortTotalUsers এর মতোই থাকবে। |
ga:cohortTotalUsers | গোষ্ঠীভুক্ত ব্যবহারকারীর সংখ্যা, যা সমদলের আকার নামেও পরিচিত। |
ga:cohortAppviewsPerUser | একটি সমষ্টির জন্য ব্যবহারকারী প্রতি অ্যাপ ভিউ। |
ga:cohortGoalCompletionsPerUser | একটি সমষ্টির জন্য ব্যবহারকারী প্রতি লক্ষ্য পূরণ। |
ga:cohortPageviewsPerUser | একটি সমষ্টির জন্য ব্যবহারকারী প্রতি পৃষ্ঠা দর্শন। |
ga:cohortRetentionRate | কোহর্ট ধরে রাখার হার। |
ga:cohortRevenuePerUser | একটি সমষ্টির জন্য ব্যবহারকারী প্রতি আয়। |
ga:cohortVisitDurationPerUser | একটি সমষ্টির জন্য ব্যবহারকারী প্রতি সেশনের সময়কাল। |
ga:cohortSessionsPerUser | সমগোত্রীয়দের জন্য ব্যবহারকারী প্রতি সেশন। |
লাইফটাইম ভ্যালু (LTV) মেট্রিক্স
মেট্রিক নাম | সংজ্ঞা |
---|---|
ga:cohortTotalUsersWithLifetimeCriteria | এটি একটি অনুরোধের পরিপ্রেক্ষিতে প্রাসঙ্গিক যার মাত্রা রয়েছে ga:acquisitionTrafficChannel , ga:acquisitionSource , ga:acquisitionMedium , বা ga:acquisitionCampaign । এটি বর্তমান চ্যানেল, উৎস, মাধ্যম বা প্রচারাভিযানের মাধ্যমে অর্জিত সমদলের ব্যবহারকারীদের সংখ্যা প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, ga:acquisitionTrafficChannel=Direct এর জন্য, এটি কোহর্টের ব্যবহারকারীদের সংখ্যা প্রতিনিধিত্ব করে, যারা সরাসরি অর্জিত হয়েছিল। যদি উল্লিখিত মাত্রাগুলির একটিও উপস্থিত না থাকে, তাহলে এর মান ga:cohortTotalUsers (শুধুমাত্র অ্যাপ ভিউ ) এর সমান। |
ga:cohortAppviewsPerUserWithLifetimeCriteria | একটি সমগোত্রীয় অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি অ্যাপ ভিউ (শুধু অ্যাপ ভিউ )। |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria | একটি সমগোত্রীয় অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি লক্ষ্য পূর্ণতা (শুধুমাত্র অ্যাপ ভিউ )। |
ga:cohortPageviewsPerUserWithLifetimeCriteria | একটি সমগোত্রীয় অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি পৃষ্ঠা দর্শন (শুধুমাত্র অ্যাপ ভিউ )। |
ga:cohortRevenuePerUserWithLifetimeCriteria | একটি সমগোত্রীয় অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি আয় (শুধুমাত্র অ্যাপ ভিউ )। |
ga:cohortSessionsPerUserWithLifetimeCriteria | একটি সমগোত্রীয় অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি সেশনের সময়কাল (শুধুমাত্র অ্যাপ ভিউ )। |