- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- ব্যবহারকারী
- UserIdType
- কার্যকলাপ টাইপ
- ইউজার অ্যাক্টিভিটি সেশন
- কার্যকলাপ
- কাস্টম ডাইমেনশন
- পেজভিউ ডেটা
- ScreenviewData
- ইকমার্স ডেটা
- ইকমার্স অ্যাকশন
- লেনদেন ডেটা
- প্রোডাক্ট তথ্য
- ইকমার্স টাইপ
- GoalSetData
- গোল ডেটা
- ইভেন্ট ডেটা
- এটা চেষ্টা করুন!
ব্যবহারকারীর কার্যকলাপ ডেটা প্রদান করে।
HTTP অনুরোধ
POST https://analyticsreporting.googleapis.com/v4/userActivity:search
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব | |
---|---|
{ "dateRange": { object( |
ক্ষেত্র | |
---|---|
dateRange | তারিখ ব্যাপ্তি যার জন্য ব্যবহারকারীর কার্যকলাপ পুনরুদ্ধার করতে হবে৷ যদি একটি তারিখ পরিসর প্রদান করা না হয়, ডিফল্ট তারিখ পরিসীমা (শুরু তারিখ: বর্তমান তারিখ - 7 দিন, শেষ তারিখ: বর্তমান তারিখ - 1 দিন)। |
viewId | প্রয়োজন। Analytics ভিউ আইডি যেখান থেকে ডেটা পুনরুদ্ধার করতে হবে। প্রতিটি SearchUserActivityRequest-এ অবশ্যই |
user | প্রয়োজন। প্রশ্ন করার জন্য অনন্য ব্যবহারকারী আইডি। প্রতিটি SearchUserActivityRequest এই ক্ষেত্রটি থাকতে হবে। |
activityTypes[] | অনুরোধ করা হচ্ছে সমস্ত কার্যকলাপ ধরনের সেট. শুধুমাত্র এই ধরনের মেলানো কার্যক্রম প্রতিক্রিয়ায় ফেরত দেওয়া হবে। খালি থাকলে, সমস্ত কার্যকলাপ ফেরত দেওয়া হবে। |
pageSize | পৃষ্ঠার আকার পেজিংয়ের জন্য এবং প্রত্যাবর্তিত সারিগুলির সর্বাধিক সংখ্যা নির্দিষ্ট করে৷ পৃষ্ঠার আকার > 0 হওয়া উচিত। মান 0 হলে বা ক্ষেত্রটি নির্দিষ্ট না থাকলে, অনুরোধটি প্রতি পৃষ্ঠায় 1000 সারিগুলির ডিফল্ট প্রদান করে। |
pageToken | ফলাফলের পরবর্তী পৃষ্ঠা পেতে একটি ধারাবাহিকতা টোকেন। অনুরোধে এটি যোগ করলে পেজটোকেনের পরে সারিগুলি ফিরে আসবে। SearchUserActivityRequest অনুরোধের উত্তরে নেক্সটপেজটোকেন প্যারামিটারে পেজটোকেনটি ফেরত দেওয়া মান হওয়া উচিত। |
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
userActivity:get
call.
JSON প্রতিনিধিত্ব | |
---|---|
{
"sessions": [
{
object( |
ক্ষেত্র | |
---|---|
sessions[] | প্রতিটি রেকর্ড একটি সেশন প্রতিনিধিত্ব করে (ডিভাইসের বিবরণ, সময়কাল, ইত্যাদি)। |
totalRows | এই ক্যোয়ারী দ্বারা প্রত্যাবর্তিত মোট সারি (বিভিন্ন পৃষ্ঠা জুড়ে)। |
nextPageToken | পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি SearchUserActivityRequest- এ পাস করা উচিত। |
sampleRate | এই ক্ষেত্রটি প্রদত্ত অনুরোধের জন্য স্যাম্পলিং রেট উপস্থাপন করে এবং এটি 0.0 থেকে 1.0 এর মধ্যে একটি সংখ্যা। বিস্তারিত জানার জন্য ডেভেলপার গাইড দেখুন। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics
ব্যবহারকারী
একটি নির্দিষ্ট ব্যবহারকারীকে অনন্যভাবে সনাক্ত করার জন্য তথ্য রয়েছে।
JSON প্রতিনিধিত্ব | |
---|---|
{
"type": enum( |
ক্ষেত্র | |
---|---|
type | অনুরোধে ব্যবহারকারীর ধরন। ক্ষেত্র |
userId | ব্যবহারকারীর অনন্য আইডি যার জন্য ডেটা অনুরোধ করা হচ্ছে। |
UserIdType
উপলব্ধ বিভিন্ন ধরনের ব্যবহারকারী সনাক্তকরণ প্রতিনিধিত্ব করে।
Enums | |
---|---|
USER_ID_TYPE_UNSPECIFIED | যখন ব্যবহারকারীর আইডি প্রকারটি নির্দিষ্ট করা না থাকে, তখন ব্যবহৃত ডিফল্ট প্রকারটি হবে CLIENT_ID। |
USER_ID | একটি একক ব্যবহারকারী, যেমন একটি সাইন-ইন করা ব্যবহারকারীর অ্যাকাউন্ট, যা এক বা একাধিক ডিভাইস এবং / অথবা ব্রাউজার দৃষ্টান্ত জুড়ে সামগ্রীর সাথে ইন্টারঅ্যাক্ট করতে পারে। |
CLIENT_ID | Analytics নির্ধারিত ক্লায়েন্টআইডি। |
কার্যকলাপ টাইপ
Enums | |
---|---|
ACTIVITY_TYPE_UNSPECIFIED | অ্যাক্টিভিটি টাইপের প্রতিক্রিয়াতে এই মান কখনই থাকবে না। অনুরোধে এই ধরনের ব্যবহার করলে একটি ত্রুটি দেখা দেবে। |
PAGEVIEW | কোনো দর্শক কোনো পৃষ্ঠা দেখার কারণে কার্যকলাপের ফলে ব্যবহার করা হয়। |
SCREENVIEW | একটি মোবাইল ডিভাইসে একটি অ্যাপ্লিকেশন ব্যবহার করে একজন দর্শকের দ্বারা কার্যকলাপের ফলে ব্যবহার করা হয়। |
GOAL | একটি লক্ষ্য টাইপ কার্যকলাপ বোঝাতে ব্যবহৃত. |
ECOMMERCE | একটি ই-কমার্স লেনদেন পৃষ্ঠায় দর্শক দ্বারা সঞ্চালিত হয়েছে. |
EVENT | যখন কার্যকলাপ একটি ইভেন্ট ব্যবহার করা হয়. |
ইউজার অ্যাক্টিভিটি সেশন
এটি একটি নির্দিষ্ট ডিভাইসে একটি নির্দিষ্ট সময়ে একটি নির্দিষ্ট সময়ে সম্পাদিত একটি ব্যবহারকারীর সেশন উপস্থাপন করে।
JSON প্রতিনিধিত্ব | |
---|---|
{
"sessionId": string,
"deviceCategory": string,
"platform": string,
"dataSource": string,
"activities": [
{
object( |
ক্ষেত্র | |
---|---|
sessionId | সেশনের অনন্য আইডি। |
deviceCategory | ব্যবহৃত ডিভাইসের ধরন: "মোবাইল", "ট্যাবলেট" ইত্যাদি। |
platform | যে প্ল্যাটফর্মে কার্যকলাপ ঘটেছে: "অ্যান্ড্রয়েড", "আইওএস" ইত্যাদি। |
dataSource | একটি হিট তথ্য উৎস. ডিফল্টরূপে, analytics.js থেকে পাঠানো হিটগুলিকে "ওয়েব" হিসাবে রিপোর্ট করা হয় এবং মোবাইল SDK থেকে পাঠানো হিটগুলিকে "অ্যাপ" হিসাবে রিপোর্ট করা হয়৷ এই মানগুলি পরিমাপ প্রোটোকলে ওভাররাইড করা যেতে পারে। |
activities[] | এই অধিবেশনে প্রতিটি কার্যকলাপের একটি বিশদ দৃশ্য উপস্থাপন করে। |
sessionDate | ISO-8601 ফর্ম্যাটে এই সেশনের তারিখ। |
কার্যকলাপ
একটি কার্যকলাপ একটি ব্যবহারকারীর একটি কার্যকলাপের জন্য ডেটা প্রতিনিধিত্ব করে। লক্ষ্য করুন যে একটি কার্যকলাপ একটি হিট থেকে আলাদা। একটি আঘাতের ফলে একাধিক কার্যকলাপ হতে পারে৷ উদাহরণস্বরূপ, যদি একটি হিট একটি লেনদেন এবং একটি লক্ষ্য সম্পূর্ণতা অন্তর্ভুক্ত করে, তাহলে এই হিটের জন্য দুটি কার্যকলাপ প্রোটো থাকবে, একটি ECOMMERCE এর জন্য এবং একটি GOAL এর জন্য৷ বিপরীতভাবে, একাধিক হিট একটি কার্যকলাপ গঠন করতে পারে। ক্লাসিক ই-কমার্সে, একটি লেনদেনের ডেটা একাধিক হিটের মাধ্যমে পাঠানো হতে পারে। এই হিটগুলিকে একটি ECOMMERCE কার্যকলাপে একত্র করা হবে৷
JSON প্রতিনিধিত্ব | |
---|---|
{ "activityTime": string, "source": string, "medium": string, "channelGrouping": string, "campaign": string, "keyword": string, "hostname": string, "landingPagePath": string, "activityType": enum( |
ক্ষেত্র | ||
---|---|---|
activityTime | কার্যকলাপের টাইমস্ট্যাম্প। RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ডের জন্য সঠিক। উদাহরণ: | |
source | রেফারেলের উৎস। ম্যানুয়াল প্রচারাভিযান ট্র্যাকিংয়ের জন্য, এটি utm_source প্রচারাভিযান ট্র্যাকিং প্যারামিটারের মান। অ্যাডওয়ার্ড অটোট্যাগিংয়ের জন্য, এটি গুগল। আপনি যদি কোনটিই ব্যবহার না করেন তবে এটি উৎসের ডোমেন (যেমন, document.referrer) ব্যবহারকারীদের উল্লেখ করে। এটিতে একটি পোর্ট ঠিকানাও থাকতে পারে। ব্যবহারকারীরা যদি রেফারার ছাড়াই আসেন, তার মান (সরাসরি)। | |
medium | রেফারেলের ধরন। ম্যানুয়াল প্রচারাভিযান ট্র্যাকিংয়ের জন্য, এটি utm_medium প্রচারাভিযান ট্র্যাকিং পরামিতির মান। AdWords অটোট্যাগিংয়ের জন্য, এটি cpc. ব্যবহারকারীরা যদি গুগল অ্যানালিটিক্স দ্বারা সনাক্ত করা একটি সার্চ ইঞ্জিন থেকে আসে তবে এটি জৈব। যদি রেফারার একটি সার্চ ইঞ্জিন না হয় তবে এটি রেফারেল। ব্যবহারকারীরা সরাসরি সম্পত্তিতে এসে থাকলে এবং document.referrer খালি থাকলে, এর মান (কোনটিই নয়)। | |
channelGrouping | এই ভিউয়ের জন্য শেষ ব্যবহারকারীর সেশনের সাথে যুক্ত চ্যানেল গ্রুপ (ভিউ এর চ্যানেল গ্রুপিং দ্বারা সংজ্ঞায়িত)। | |
campaign | ম্যানুয়াল প্রচারাভিযান ট্র্যাকিংয়ের জন্য, এটি utm_campaign প্রচারাভিযান ট্র্যাকিং প্যারামিটারের মান। AdWords অটোট্যাগিংয়ের জন্য, এটি হল অনলাইন বিজ্ঞাপন প্রচারের নাম(গুলি) যা আপনি সম্পত্তির জন্য ব্যবহার করেন৷ যদি আপনি উভয়ই ব্যবহার করেন তবে এর মান (সেট নয়)। | |
keyword | ম্যানুয়াল প্রচারাভিযান ট্র্যাকিংয়ের জন্য, এটি utm_term প্রচারাভিযান ট্র্যাকিং পরামিতির মান। অ্যাডওয়ার্ড ট্রাফিকের জন্য, এতে সেরা মিলিত লক্ষ্য নির্ধারণের মানদণ্ড রয়েছে। ডিসপ্লে নেটওয়ার্কের জন্য, যেখানে একাধিক টার্গেটিং মানদণ্ড বিজ্ঞাপনটিকে দেখানোর কারণ হতে পারে, এটি বিজ্ঞাপন দ্বারা নির্বাচিত সেরা ম্যাচিং টার্গেটিং মানদণ্ড প্রদান করে। এটি ডিসপ্লে_কীওয়ার্ড, সাইট প্লেসমেন্ট, বুমুসারলিস্ট, ব্যবহারকারীর_আগ্রহ, বয়স বা লিঙ্গ হতে পারে। অন্যথায় এর মান (সেট করা হয়নি)। | |
hostname | যে হোস্টনাম থেকে ট্র্যাকিং অনুরোধ করা হয়েছিল। | |
landingPagePath | ব্যবহারকারীদের সেশনের প্রথম পৃষ্ঠা বা ল্যান্ডিং পৃষ্ঠা। | |
activityType | এই কার্যকলাপের ধরন. | |
customDimension[] | এই কার্যকলাপের সাথে যুক্ত সমস্ত কাস্টম মাত্রার একটি তালিকা৷ | |
ইউনিয়ন ক্ষেত্রের activity_details । activity_type উপর নির্ভর করে, নিম্নলিখিত ক্ষেত্রগুলির মধ্যে একটি ঠিক করা হবে। activity_details নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | ||
pageview | এটি সেট করা হবে যদি | |
appview | | |
ecommerce | এটি সেট করা হবে যদি | |
goals | এই ক্ষেত্রটিতে সমস্ত লক্ষ্যগুলির একটি তালিকা রয়েছে যা এই কার্যকলাপে পৌঁছেছিল যখন | |
event | এই ক্ষেত্রটিতে একটি ইভেন্টের সাথে সম্পর্কিত সমস্ত বিবরণ রয়েছে এবং এটি সেট করা হবে যদি |
কাস্টম ডাইমেনশন
কাস্টম মাত্রা।
JSON প্রতিনিধিত্ব | |
---|---|
{ "index": number, "value": string } |
ক্ষেত্র | |
---|---|
index | কাস্টম মাত্রার স্লট সংখ্যা। |
value | কাস্টম মাত্রার মান। ডিফল্ট মান (অর্থাৎ খালি স্ট্রিং) ক্লিয়ারিং সেশন/ভিজিটর স্কোপ কাস্টম মাত্রা মান নির্দেশ করে। |
পেজভিউ ডেটা
ভিজিটর যখন একটি পৃষ্ঠা দেখেন তখন সংগৃহীত বিশদ বিবরণ উপস্থাপন করে।
JSON প্রতিনিধিত্ব | |
---|---|
{ "pagePath": string, "pageTitle": string } |
ক্ষেত্র | |
---|---|
pagePath | দর্শক যে পৃষ্ঠাটি দেখেছেন তার URL। |
pageTitle | পৃষ্ঠার শিরোনাম যা দর্শক দেখেছেন। |
ScreenviewData
JSON প্রতিনিধিত্ব | |
---|---|
{ "screenName": string, "mobileDeviceBranding": string, "mobileDeviceModel": string, "appName": string } |
ক্ষেত্র | |
---|---|
screenName | পর্দার নাম। |
mobileDeviceBranding | মোবাইল প্রস্তুতকারক বা ব্র্যান্ডের নাম। যেমন: "গুগল", "অ্যাপল" ইত্যাদি। |
mobileDeviceModel | মোবাইল ডিভাইস মডেল। যেমন: "Pixel", "iPhone" ইত্যাদি। |
appName | আবেদনের নাম। |
ইকমার্স ডেটা
ব্যবহারকারীর কার্যকলাপের সাথে যুক্ত ই-কমার্স বিশদ।
JSON প্রতিনিধিত্ব | |
---|---|
{ "actionType": enum( |
ক্ষেত্র | |
---|---|
actionType | এই ই-কমার্স কর্মের সাথে যুক্ত কর্ম। |
transaction | এই ই-কমার্স কর্মের লেনদেনের বিবরণ। |
products[] | এই লেনদেনের পণ্যের বিবরণ। |
ecommerceType | এই ই-কমার্স কার্যকলাপের ধরন। |
ইকমার্স অ্যাকশন
একটি ই-কমার্স কর্মের সাথে যুক্ত সমস্ত কর্মের সেট।
Enums | |
---|---|
UNKNOWN | কর্মের ধরন জানা নেই। |
CLICK | পণ্য তালিকার মাধ্যমে ক্লিক করুন. |
DETAILS_VIEW | পণ্যের বিস্তারিত ভিউ। |
ADD_TO_CART | কার্টে পণ্য(গুলি) যোগ করুন। |
REMOVE_FROM_CART | কার্ট থেকে পণ্য (গুলি) সরান. |
CHECKOUT | চেক আউট. |
PAYMENT | ক্রয় সম্পন্ন হয়েছে। |
REFUND | ক্রয় ফেরত. |
CHECKOUT_OPTION | চেকআউট বিকল্প. |
লেনদেন ডেটা
ভিজিটর যখন পৃষ্ঠায় লেনদেন করে তখন সংগৃহীত বিশদ বিবরণ উপস্থাপন করে।
JSON প্রতিনিধিত্ব | |
---|---|
{ "transactionId": string, "transactionRevenue": number, "transactionTax": number, "transactionShipping": number } |
ক্ষেত্র | |
---|---|
transactionId | শপিং কার্টে কেনাকাটার জন্য ই-কমার্স ট্র্যাকিং পদ্ধতি দ্বারা সরবরাহ করা লেনদেন আইডি। |
transactionRevenue | লেনদেনের মোট বিক্রয় রাজস্ব (শিপিং এবং ট্যাক্স ব্যতীত)। |
transactionTax | লেনদেনের জন্য মোট কর। |
transactionShipping | শিপিং এর মোট খরচ। |
প্রোডাক্ট তথ্য
একটি ই-কমার্স লেনদেনে পণ্যের বিবরণ।
JSON প্রতিনিধিত্ব | |
---|---|
{ "productSku": string, "productName": string, "itemRevenue": number, "productQuantity": string } |
ক্ষেত্র | |
---|---|
productSku | অনন্য কোড যা পণ্যের প্রতিনিধিত্ব করে। |
productName | ক্রয়কৃত আইটেমগুলির জন্য ই-কমার্স ট্র্যাকিং অ্যাপ্লিকেশন দ্বারা সরবরাহ করা পণ্যের নাম। |
itemRevenue | ক্রয়কৃত পণ্য আইটেম থেকে মোট আয়। |
productQuantity | লেনদেনে এই পণ্য ইউনিটের মোট সংখ্যা। |
ইকমার্স টাইপ
এটি ই-কমার্স ডেটার ধরনের প্রতিনিধিত্ব করে যা ফেরত দেওয়া হচ্ছে।
Enums | |
---|---|
ECOMMERCE_TYPE_UNSPECIFIED | ই-কমার্স কার্যকলাপের ধরন অনির্দিষ্ট থাকলে ব্যবহৃত হয়। |
CLASSIC | যখন কার্যকলাপে ক্লাসিক (অ-বর্ধিত) ই-কমার্স তথ্য থাকে তখন ব্যবহৃত হয়। |
ENHANCED | যখন কার্যকলাপ ই-কমার্স তথ্য উন্নত করে তখন ব্যবহার করা হয়। |
GoalSetData
একটি ক্রিয়াকলাপে পৌঁছে যাওয়া লক্ষ্যগুলির একটি সেট প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব | |
---|---|
{
"goals": [
{
object( |
ক্ষেত্র | |
---|---|
goals[] | বর্তমান কর্মকান্ডে যে সকল লক্ষ্য অর্জন করা হয়েছে। |
গোল ডেটা
একটি লক্ষ্য সম্পর্কিত সমস্ত বিবরণ প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব | |
---|---|
{ "goalIndex": number, "goalCompletions": string, "goalValue": number, "goalCompletionLocation": string, "goalPreviousStep1": string, "goalPreviousStep2": string, "goalPreviousStep3": string, "goalName": string } |
ক্ষেত্র | |
---|---|
goalIndex | এটি প্রোফাইলের জন্য কনফিগার করা লক্ষ্য হিসাবে চিহ্নিত করে। |
goalCompletions | এই ক্রিয়াকলাপে মোট লক্ষ্য পূরণের সংখ্যা৷ |
goalValue | এই লক্ষ্য মান. |
goalCompletionLocation | পৃষ্ঠার URL যেখানে এই লক্ষ্যটি সম্পন্ন হয়েছে। |
goalPreviousStep1 | লক্ষ্য পূরণের এক ধাপ আগে পৃষ্ঠার URL। |
goalPreviousStep2 | লক্ষ্য পূরণের দুই ধাপ আগে পৃষ্ঠার URL। |
goalPreviousStep3 | লক্ষ্য পূরণের তিন ধাপ আগে পৃষ্ঠার URL। |
goalName | গোলের নাম। |
ইভেন্ট ডেটা
একটি ইভেন্ট সম্পর্কিত সমস্ত বিবরণ প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব | |
---|---|
{ "eventCategory": string, "eventAction": string, "eventLabel": string, "eventValue": string, "eventCount": string } |
ক্ষেত্র | |
---|---|
eventCategory | পৃষ্ঠায় যে বস্তুটির সাথে ইন্টারঅ্যাক্ট করা হয়েছিল। যেমন: 'ভিডিও'। |
eventAction | বস্তুর সাথে মিথস্ক্রিয়া প্রকার। যেমন: 'খেলুন'। |
eventLabel | ইভেন্টের সাথে লেবেল সংযুক্ত। |
eventValue | ইভেন্টের সাথে সম্পর্কিত সংখ্যাসূচক মান। |
eventCount | এই কার্যকলাপ যেমন ঘটনা সংখ্যা. |