এই নথিটি কোর রিপোর্টিং API সংস্করণ 3.0-এর জন্য অনুসন্ধান এবং প্রতিক্রিয়া উভয়ের জন্য সম্পূর্ণ রেফারেন্স প্রদান করে।
ভূমিকা
আপনি গুগল অ্যানালিটিক্স রিপোর্ট ডেটার জন্য কোর রিপোর্টিং এপিআই জিজ্ঞাসা করুন৷ প্রতিটি প্রশ্নের জন্য একটি ভিউ (প্রোফাইল) আইডি, একটি শুরু এবং শেষ তারিখ এবং অন্তত একটি মেট্রিক প্রয়োজন৷ আপনার ক্যোয়ারী পরিমার্জিত করার জন্য আপনি অতিরিক্ত ক্যোয়ারী প্যারামিটার যেমন মাত্রা, ফিল্টার এবং সেগমেন্ট সরবরাহ করতে পারেন। এই সমস্ত ধারণাগুলি কীভাবে একসাথে কাজ করে তা বোঝার জন্য ওভারভিউ গাইডটি দেখুন।
অনুরোধ
API ডেটা অনুরোধ করার জন্য একটি একক পদ্ধতি প্রদান করে:
analytics.data.ga.get()
এই পদ্ধতিটি বিভিন্ন ক্লায়েন্ট লাইব্রেরিতে প্রকাশ করা হয় এবং ক্যোয়ারী প্যারামিটার সেট করার জন্য ভাষা নির্দিষ্ট ইন্টারফেস রয়েছে।
API একটি REST-ful endpoint হিসাবে জিজ্ঞাসা করা যেতে পারে:
Authorization: Bearer {oauth2-token} GET https://www.googleapis.com/analytics/v3/data/ga ?ids=ga:12345 &start-date=2008-10-01 &end-date=2008-10-31 &metrics=ga:sessions,ga:bounces
প্রতিটি URL ক্যোয়ারী প্যারামিটার একটি API ক্যোয়ারী প্যারামিটার নির্দিষ্ট করে যা URL এনকোড করা আবশ্যক ।
ক্যোয়ারী পরামিতি সারাংশ
নিম্নলিখিত সারণীটি কোর রিপোর্টিং API দ্বারা গৃহীত সমস্ত ক্যোয়ারী পরামিতিগুলির সংক্ষিপ্ত বিবরণ দেয়৷ একটি বিস্তারিত বিবরণের জন্য প্রতিটি পরামিতি নামের উপর ক্লিক করুন.
নাম | মান | প্রয়োজন | সারসংক্ষেপ |
---|---|---|---|
ids | string | হ্যাঁ | ga:XXXX ফর্মের অনন্য টেবিল ID, যেখানে XXXX হল Analytics ভিউ (প্রোফাইল) ID যার জন্য কোয়েরি ডেটা পুনরুদ্ধার করবে৷ |
start-date | string | হ্যাঁ | বিশ্লেষণ ডেটা আনার জন্য শুরুর তারিখ। অনুরোধগুলি YYYY-MM-DD হিসাবে ফর্ম্যাট করা একটি শুরুর তারিখ নির্দিষ্ট করতে পারে, বা একটি আপেক্ষিক তারিখ হিসাবে (যেমন, today , yesterday , বা NdaysAgo যেখানে N একটি ধনাত্মক পূর্ণসংখ্যা)। |
end-date | string | হ্যাঁ | Analytics ডেটা আনার শেষ তারিখ। অনুরোধ YYYY-MM-DD হিসাবে ফর্ম্যাট করা একটি শেষ তারিখ নির্দিষ্ট করতে পারে, বা একটি আপেক্ষিক তারিখ হিসাবে (যেমন, today , yesterday , বা NdaysAgo যেখানে N একটি ধনাত্মক পূর্ণসংখ্যা)। |
metrics | string | হ্যাঁ | কমা দ্বারা পৃথক করা মেট্রিক্সের একটি তালিকা, যেমন ga:sessions,ga:bounces । |
dimensions | string | না | আপনার অ্যানালিটিক্স ডেটার জন্য কমা-বিভক্ত মাত্রার একটি তালিকা, যেমন ga:browser,ga:city । |
sort | string | না | প্রত্যাবর্তিত ডেটার জন্য বাছাই ক্রম এবং বাছাই দিক নির্দেশ করে কমা দ্বারা পৃথক করা মাত্রা এবং মেট্রিক্সের একটি তালিকা৷ |
filters | string | না | মাত্রা বা মেট্রিক ফিল্টার যা আপনার অনুরোধের জন্য ফিরে আসা ডেটাকে সীমাবদ্ধ করে। |
segment | string | না | আপনার অনুরোধের জন্য প্রত্যাবর্তিত ডেটা বিভাগ করুন। |
samplingLevel | string | না | পছন্দসই নমুনা স্তর। অনুমোদিত মান:
|
include-empty-rows | boolean | না | ডিফল্ট থেকে সত্য; মিথ্যাতে সেট করা হলে, সারি যেখানে সমস্ত মেট্রিক মান শূন্য সেগুলি প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। |
start-index | integer | না | পুনরুদ্ধার করার জন্য প্রথম সারি ডেটা, 1 থেকে শুরু হয় max-results পরামিতি সহ একটি পৃষ্ঠা সংখ্যা পদ্ধতি হিসাবে এই প্যারামিটারটি ব্যবহার করুন। |
max-results | integer | না | প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য সর্বাধিক সংখ্যক সারি। |
output | string | না | অ্যানালিটিক্স ডেটার জন্য পছন্দসই আউটপুট টাইপ প্রতিক্রিয়াতে ফিরে এসেছে। গ্রহণযোগ্য মান হল json এবং dataTable । ডিফল্ট: json । |
fields | string | না | প্রতিক্রিয়া অন্তর্ভুক্ত করার জন্য ক্ষেত্রগুলির একটি উপসেট নির্দিষ্ট করে নির্বাচক৷ |
prettyPrint | string | না | ইন্ডেন্টেশন এবং লাইন ব্রেক সহ প্রতিক্রিয়া প্রদান করে। ডিফল্ট false . |
userIp | string | না | শেষ ব্যবহারকারীর IP ঠিকানা নির্দিষ্ট করে যার জন্য API কল করা হচ্ছে। প্রতি আইপি ব্যবহার ক্যাপ করতে ব্যবহৃত হয়। |
quotaUser | string | না | ব্যবহারকারীর আইপি ঠিকানা অজানা থাকলে এমন ক্ষেত্রে userIp-এর বিকল্প। |
access_token | string | না | একটি OAuth 2.0 টোকেন প্রদান করার একটি সম্ভাব্য উপায়। |
callback | string | না | জাভাস্ক্রিপ্ট কলব্যাক ফাংশনের নাম যা প্রতিক্রিয়া পরিচালনা করে। JavaScript JSON-P অনুরোধে ব্যবহৃত হয়। |
key | string | না | কোটা পেতে আপনার আবেদন নির্দিষ্ট করতে OAuth 1.0a অনুমোদনের জন্য ব্যবহৃত হয়। উদাহরণস্বরূপ: key= AldefliuhSFADSfasdfasdfASdf । |
ক্যোয়ারী প্যারামিটার বিবরণ
আইডি
ids= ga:12345
ga:
Analytics ভিউ (প্রোফাইল) আইডি সহ। আপনি analytics.management.profiles.list
পদ্ধতি ব্যবহার করে ভিউ (প্রোফাইল) আইডি পুনরুদ্ধার করতে পারেন, যা Google Analytics ম্যানেজমেন্ট API- এর ভিউ (প্রোফাইল) রিসোর্সে id
প্রদান করে।শুরুর তারিখ
start-date= 2009-04-20
start-date
এবং end-date
পরামিতি অন্তর্ভুক্ত না করলে, সার্ভার একটি ত্রুটি ফেরত দেয়। তারিখের মানগুলি YYYY-MM-DD
প্যাটার্ন ব্যবহার করে বা today
, yesterday
বা NdaysAgo
প্যাটার্ন ব্যবহার করে একটি নির্দিষ্ট তারিখের জন্য হতে পারে৷ মান অবশ্যই মিলতে হবে [0-9]{4}-[0-9]{2}-[0-9]{2}|today|yesterday|[0-9]+(daysAgo)
start-date
হল 2005-01-01
। শুরুর তারিখের জন্য কোন উচ্চ সীমা সীমাবদ্ধতা নেই।আপেক্ষিক তারিখগুলি ব্যবহার করে গত 7 দিনের (গতকাল থেকে শুরু) তারিখের সীমার উদাহরণ:
&start-date=7daysAgo &end-date=yesterday
শেষ তারিখ
end-date= 2009-05-20
start-date
এবং end-date
পরামিতি অন্তর্ভুক্ত না করলে, সার্ভার একটি ত্রুটি ফেরত দেয়। তারিখের মানগুলি YYYY-MM-DD
প্যাটার্ন ব্যবহার করে বা today
, yesterday
বা NdaysAgo
প্যাটার্ন ব্যবহার করে একটি নির্দিষ্ট তারিখের জন্য হতে পারে৷ মান অবশ্যই মিলতে হবে [0-9]{4}-[0-9]{2}-[0-9]{2}|today|yesterday|[0-9]+(daysAgo)
end-date
হল 2005-01-01
। end-date
জন্য কোন উচ্চ সীমা সীমাবদ্ধতা নেই।আপেক্ষিক তারিখগুলি ব্যবহার করে গত 10 দিনের (আজ থেকে শুরু) তারিখের সীমার উদাহরণ:
&start-date=9daysAgo &end-date=today
মাত্রা
dimensions= ga:browser,ga:city
dimensions
পরামিতি সাধারণ মানদণ্ড দ্বারা মেট্রিক্স ভেঙে দেয়; উদাহরণস্বরূপ, ga:browser
বা ga:city
দ্বারা। যদিও আপনি আপনার সাইটের মোট পৃষ্ঠাদর্শনের সংখ্যা জিজ্ঞাসা করতে পারেন, ব্রাউজার দ্বারা বিভক্ত পৃষ্ঠা দর্শনের সংখ্যা জিজ্ঞাসা করা আরও আকর্ষণীয় হতে পারে। এই ক্ষেত্রে, আপনি ফায়ারফক্স, ইন্টারনেট এক্সপ্লোরার, ক্রোম এবং আরও অনেকগুলি থেকে পৃষ্ঠা দর্শনের সংখ্যা দেখতে পাবেন৷ একটি ডেটা অনুরোধে dimensions
ব্যবহার করার সময়, নিম্নলিখিত সীমাবদ্ধতা সম্পর্কে সচেতন হন:
- আপনি যেকোনো প্রশ্নে সর্বাধিক 7টি মাত্রা সরবরাহ করতে পারেন।
- আপনি শুধুমাত্র মাত্রার সমন্বয়ে একটি প্রশ্ন পাঠাতে পারবেন না : আপনাকে অবশ্যই অন্তত একটি মেট্রিকের সাথে অনুরোধ করা যেকোনো মাত্রা একত্র করতে হবে।
- একই ক্যোয়ারীতে শুধুমাত্র কিছু নির্দিষ্ট মাত্রা জিজ্ঞাসা করা যেতে পারে। কোন মাত্রা একসাথে ব্যবহার করা যেতে পারে তা দেখতে মাত্রা এবং মেট্রিক্স রেফারেন্সে বৈধ সমন্বয় টুল ব্যবহার করুন।
মেট্রিক্স
metrics= ga:sessions,ga:bounces
dimensions
প্যারামিটার না থাকে, তাহলে প্রত্যাবর্তিত মেট্রিক্স অনুরোধকৃত তারিখের সীমার জন্য সমষ্টিগত মান প্রদান করে, যেমন সামগ্রিক পৃষ্ঠাদর্শন বা মোট বাউন্স। যাইহোক, যখন মাত্রার অনুরোধ করা হয়, মানগুলিকে মাত্রা মান দ্বারা ভাগ করা হয়। উদাহরণ স্বরূপ, ga:pageviews
ga:country
pageviews দেশের প্রতি মোট পেজভিউ প্রদান করে। মেট্রিক্সের অনুরোধ করার সময়, মনে রাখবেন:- যেকোনো অনুরোধে কমপক্ষে একটি মেট্রিক সরবরাহ করতে হবে; একটি অনুরোধ শুধুমাত্র মাত্রা গঠিত হতে পারে না.
- আপনি যেকোনো প্রশ্নের জন্য সর্বোচ্চ 10টি মেট্রিক সরবরাহ করতে পারেন।
- একাধিক বিভাগ থেকে মেট্রিক্সের বেশিরভাগ সংমিশ্রণ একসাথে ব্যবহার করা যেতে পারে, যদি কোন মাত্রা নির্দিষ্ট করা না থাকে।
- একটি মেট্রিক অন্যান্য মাত্রা বা মেট্রিক্সের সাথে একত্রে ব্যবহার করা যেতে পারে, কিন্তু শুধুমাত্র সেই মেট্রিকের জন্য বৈধ সমন্বয় প্রযোজ্য। বিস্তারিত জানার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স দেখুন।
সাজান
sort= ga:country,ga:browser
মেট্রিক্স এবং মাত্রার একটি তালিকা যা প্রত্যাবর্তিত ডেটার জন্য সাজানোর ক্রম এবং সাজানোর দিক নির্দেশ করে।
- তালিকাভুক্ত মেট্রিক্স এবং মাত্রার বাম থেকে ডান ক্রম অনুসারে সাজানোর ক্রম নির্দিষ্ট করা হয়।
- বাছাই করার দিকনির্দেশ ডিফল্ট আরোহীতে এবং অনুরোধ করা ক্ষেত্রে একটি বিয়োগ চিহ্ন (
-
) উপসর্গ ব্যবহার করে অবরোহে পরিবর্তন করা যেতে পারে।
একটি প্রশ্নের ফলাফল বাছাই করা আপনাকে আপনার ডেটা সম্পর্কে বিভিন্ন প্রশ্ন জিজ্ঞাসা করতে সক্ষম করে। উদাহরণস্বরূপ, "আমার শীর্ষ দেশগুলি কী এবং তারা কোন ব্রাউজারগুলি সবচেয়ে বেশি ব্যবহার করে?" আপনি নিম্নলিখিত পরামিতি দিয়ে একটি প্রশ্ন করতে পারেন। এটি প্রথমে ga:country
এবং তারপর ga:browser
দ্বারা বাছাই করে, উভয় ক্রমানুসারে:
sort=ga:country,ga:browser
সম্পর্কিত প্রশ্নের উত্তর দিতে "আমার শীর্ষ ব্রাউজারগুলি কী এবং কোন দেশগুলি সেগুলি সবচেয়ে বেশি ব্যবহার করে?", আপনি নিম্নলিখিত প্যারামিটার দিয়ে একটি প্রশ্ন করতে পারেন৷ এটি প্রথমে
ga:browser
এবং তারপর ga:country
অনুসারে বাছাই করে, উভয় ক্রমানুসারে:sort=ga:browser,ga:country
sort
পরামিতি ব্যবহার করার সময়, নিম্নলিখিতগুলি মনে রাখবেন:
- শুধুমাত্র মাত্রা বা মেট্রিক্স মান অনুসারে সাজান যা আপনি
dimensions
বাmetrics
প্যারামিটারে ব্যবহার করেছেন। যদি আপনার অনুরোধটি এমন একটি ক্ষেত্রে বাছাই করে যা মাত্রা বা মেট্রিক্স প্যারামিটারে নির্দেশিত নয়, আপনি একটি ত্রুটি পাবেন। - ডিফল্টরূপে, এন-ইউএস লোকেলে স্ট্রিংগুলিকে ক্রমবর্ধমান বর্ণানুক্রমিকভাবে সাজানো হয়।
- সংখ্যাগুলি ডিফল্টরূপে ঊর্ধ্বগামী সাংখ্যিক ক্রমে সাজানো হয়।
- তারিখগুলি ডিফল্টভাবে তারিখ অনুসারে ক্রমবর্ধমান ক্রমে সাজানো হয়।
ফিল্টার
filters=ga:medium%3D%3Dreferral
filters
ক্যোয়ারী স্ট্রিং প্যারামিটার আপনার অনুরোধ থেকে প্রত্যাবর্তিত ডেটা সীমাবদ্ধ করে। filters
প্যারামিটার ব্যবহার করার জন্য, ফিল্টার করার জন্য একটি মাত্রা বা মেট্রিক সরবরাহ করুন, তারপরে ফিল্টার এক্সপ্রেশন। উদাহরণস্বরূপ, নিম্নলিখিত ক্যোয়ারীটি ga:pageviews
এবং ga:browser
জন্য অনুরোধ করে (প্রোফাইল) 12134
, যেখানে ga:browser
ডাইমেনশন Firefox
স্ট্রিং দিয়ে শুরু হয়:
https://www.googleapis.com/analytics/v3/data/ga ?ids=ga:12134 &dimensions=ga:browser &metrics=ga:pageviews &filters=ga:browser%3D~%5EFirefox &start-date=2007-01-01 &end-date=2007-12-31
ফিল্টার করা প্রশ্নগুলি সারিগুলিকে সীমাবদ্ধ করে যা ফলাফলে অন্তর্ভুক্ত করা হয় (বা না)। ফলাফলের প্রতিটি সারি ফিল্টারের বিরুদ্ধে পরীক্ষা করা হয়: ফিল্টারটি মেলে, সারিটি ধরে রাখা হয় এবং যদি এটি মেলে না, সারিটি বাদ দেওয়া হয়।
- URL এনকোডিং : Google API ক্লায়েন্ট লাইব্রেরি স্বয়ংক্রিয়ভাবে ফিল্টার অপারেটরদের এনকোড করে।
- মাত্রা ফিল্টারিং : ফিল্টারিং কোনো মাত্রা একত্রিত হওয়ার আগে ঘটে, যাতে প্রত্যাবর্তিত মেট্রিক্স শুধুমাত্র প্রাসঙ্গিক মাত্রার জন্য মোটের প্রতিনিধিত্ব করে। উপরের উদাহরণে, পেজভিউর সংখ্যা শুধুমাত্র সেই পেজভিউ হবে যেখানে ফায়ারফক্স ব্রাউজার।
- মেট্রিক্স ফিল্টারিং : মেট্রিক্স একত্রিত হওয়ার পরে মেট্রিক্সে ফিল্টারিং ঘটে।
- বৈধ সংমিশ্রণ : আপনি এমন একটি মাত্রা বা মেট্রিকের জন্য ফিল্টার করতে পারেন যা আপনার প্রশ্নের অংশ নয়, যদি অনুরোধের সমস্ত মাত্রা/মেট্রিক্স এবং ফিল্টারটি বৈধ সংমিশ্রণ হয়। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট ব্রাউজারে ফিল্টারিং পৃষ্ঠা দর্শনের তারিখের তালিকার জন্য অনুসন্ধান করতে চাইতে পারেন। আরও তথ্যের জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স দেখুন।
ফিল্টার সিনট্যাক্স
একটি একক ফিল্টার ফর্ম ব্যবহার করে:
ga:name operator expression
এই সিনট্যাক্সে:
- নাম — ফিল্টার করার জন্য মাত্রা বা মেট্রিকের নাম। যেমন:
ga:pageviews
ফিল্টার পেজভিউ মেট্রিকে। - অপারেটর - ব্যবহার করার জন্য ফিল্টার মিলের ধরন সংজ্ঞায়িত করে। অপারেটর হয় মাত্রা বা মেট্রিক্স নির্দিষ্ট.
- অভিব্যক্তি — ফলাফলে অন্তর্ভুক্ত করা বা বাদ দেওয়া মানগুলিকে বলে। এক্সপ্রেশন রেগুলার এক্সপ্রেশন সিনট্যাক্স ব্যবহার করে।
ফিল্টার অপারেটর
মাত্রার জন্য ছয়টি ফিল্টার অপারেটর এবং মেট্রিক্সের জন্য ছয়টি ফিল্টার অপারেটর রয়েছে। URL ক্যোয়ারী স্ট্রিংগুলিতে অন্তর্ভুক্ত করার জন্য অপারেটরগুলিকে অবশ্যই URL-এনকোডেড হতে হবে৷
টিপ : ইউআরএল এনকোডিং প্রয়োজন এমন ফিল্টার ডিজাইন করতে ডেটা ফিড কোয়েরি এক্সপ্লোরার ব্যবহার করুন, যেহেতু ক্যোয়ারী এক্সপ্লোরার স্বয়ংক্রিয়ভাবে স্ট্রিং এবং স্পেস ধারণকারী URLS এনকোড করে।
অপারেটর | বর্ণনা | URL এনকোড করা ফর্ম | উদাহরণ |
---|---|---|---|
== | সমান | %3D%3D | ফলাফল ফেরত দিন যেখানে পৃষ্ঠার সময় ঠিক দশ সেকেন্ড:filters=ga:timeOnPage%3D%3D10 |
!= | সমান না | !%3D | পৃষ্ঠায় সময় দশ সেকেন্ড না হলে ফলাফল ফেরত দিন:filters=ga:timeOnPage!%3D10 |
> | অপেক্ষা বৃহত্তর | %3E | ফলাফল ফেরত দিন যেখানে পৃষ্ঠার সময় কঠোরভাবে দশ সেকেন্ডের বেশি:filters=ga:timeOnPage%3E10 |
< | থেকে কম | %3C | পৃষ্ঠার সময় কঠোরভাবে দশ সেকেন্ডের কম হলে ফলাফল ফেরত দিন:filters=ga:timeOnPage%3C10 |
>= | এর চেয়ে বড় বা সমান | %3E%3D | পৃষ্ঠায় সময় দশ সেকেন্ড বা তার বেশি হলে ফলাফল ফেরত দিন:filters=ga:timeOnPage%3E%3D10 |
<= | অপেক্ষাকৃত ছোট বা সমান | %3C%3D | পৃষ্ঠার সময় দশ সেকেন্ড বা তার কম যেখানে ফলাফল ফেরত দিন:filters=ga:timeOnPage%3C%3D10 |
অপারেটর | বর্ণনা | URL এনকোড করা ফর্ম | উদাহরণ |
---|---|---|---|
== | খাপে খাপ | %3D%3D | মোট মেট্রিক্স যেখানে শহরটি আরভিন :filters=ga:city%3D%3DIrvine |
!= | মেলে না | !%3D | মোট মেট্রিক্স যেখানে শহরটি আরভাইন নয় :filters=ga:city!%3DIrvine |
=@ | সাবস্ট্রিং ধারণ করে | %3D@ | মোট মেট্রিক্স যেখানে শহরে ইয়র্ক রয়েছে:filters=ga:city%3D@York |
!@ | সাবস্ট্রিং ধারণ করে না | !@ | মোট মেট্রিক্স যেখানে শহরে ইয়র্ক নেই:filters=ga:city!@York |
=~ | রেগুলার এক্সপ্রেশনের জন্য একটি মিল রয়েছে | %3D~ | মোট মেট্রিক্স যেখানে শহর নতুন দিয়ে শুরু হয়:filters=ga:city%3D~%5ENew.* (%5E হল ^ অক্ষর থেকে এনকোড করা ইউআরএল যা স্ট্রিংয়ের শুরুতে একটি প্যাটার্ন অ্যাঙ্কর করে।) |
!~ | রেগুলার এক্সপ্রেশনের সাথে মেলে না | !~ | মোট মেট্রিক্স যেখানে শহর নতুন দিয়ে শুরু হয় না:filters=ga:city!~%5ENew.* |
এক্সপ্রেশন ফিল্টার করুন
ফিল্টার এক্সপ্রেশনের জন্য কয়েকটি গুরুত্বপূর্ণ নিয়ম রয়েছে:
- ইউআরএল-সংরক্ষিত অক্ষর — অক্ষর যেমন
&
অবশ্যই স্বাভাবিক উপায়ে ইউআরএল-এনকোড করা উচিত। - সংরক্ষিত অক্ষর — সেমিকোলন এবং কমা একটি অভিব্যক্তিতে উপস্থিত হলে ব্যাকস্ল্যাশ এস্কেপ করা আবশ্যক:
- সেমিকোলন
\;
- কমা
\,
- সেমিকোলন
- রেগুলার এক্সপ্রেশন — আপনি
=~
এবং!~
অপারেটর ব্যবহার করে ফিল্টার এক্সপ্রেশনে রেগুলার এক্সপ্রেশন ব্যবহার করতে পারেন। তাদের সিনট্যাক্স পার্ল রেগুলার এক্সপ্রেশনের অনুরূপ এবং এই অতিরিক্ত নিয়ম রয়েছে:- সর্বোচ্চ দৈর্ঘ্য 128 অক্ষর — 128 অক্ষরের বেশি রেগুলার এক্সপ্রেশনের ফলে সার্ভার থেকে
400 Bad Request
স্ট্যাটাস কোড ফিরে আসে। - কেস সংবেদনশীলতা — নিয়মিত এক্সপ্রেশন ম্যাচিং কেস-সংবেদনশীল।
- সর্বোচ্চ দৈর্ঘ্য 128 অক্ষর — 128 অক্ষরের বেশি রেগুলার এক্সপ্রেশনের ফলে সার্ভার থেকে
ফিল্টার সমন্বয়
OR
এবং AND
বুলিয়ান লজিক ব্যবহার করে ফিল্টারগুলিকে একত্রিত করা যেতে পারে। এটি আপনাকে একটি ফিল্টার এক্সপ্রেশনের 128 অক্ষর সীমা কার্যকরভাবে প্রসারিত করতে দেয়।
বা
OR
অপারেটর একটি কমা ( ,
) ব্যবহার করে সংজ্ঞায়িত করা হয়। এটি AND
অপারেটরের উপর অগ্রাধিকার নেয় এবং একই অভিব্যক্তিতে মাত্রা এবং মেট্রিক্স একত্রিত করতে ব্যবহার করা যাবে না।
উদাহরণ: (প্রত্যেকটি URL এনকোড করা আবশ্যক)
দেশটি হয় (মার্কিন যুক্তরাষ্ট্র বা কানাডা):
ga:country==United%20States,ga:country==Canada
ফায়ারফক্স ব্যবহারকারীরা (উইন্ডোজ বা ম্যাকিনটোশ) অপারেটিং সিস্টেমে:
ga:browser==Firefox;ga:operatingSystem==Windows,ga:operatingSystem==Macintosh
এবং
AND
অপারেটর একটি সেমি-কোলন ( ;
) ব্যবহার করে সংজ্ঞায়িত করা হয়। এটির পূর্বে OR
অপারেটর এবং CAN একই অভিব্যক্তিতে মাত্রা এবং মেট্রিক্স একত্রিত করতে ব্যবহার করা যেতে পারে।
উদাহরণ: (প্রত্যেকটি URL এনকোড করা আবশ্যক)
দেশটি মার্কিন যুক্তরাষ্ট্র এবং ব্রাউজারটি হল Firefox:
ga:country==United%20States;ga:browser==Firefox
দেশ মার্কিন যুক্তরাষ্ট্র এবং ভাষা 'en' দিয়ে শুরু হয় না:
ga:country==United%20States;ga:language!~^en.*
অপারেটিং সিস্টেম হল (উইন্ডোজ বা ম্যাকিনটোশ) এবং ব্রাউজার হল (ফায়ারফক্স বা ক্রোম):
ga:operatingSystem==Windows,ga:operatingSystem==Macintosh;ga:browser==Firefox,ga:browser==Chrome
দেশটি হল মার্কিন যুক্তরাষ্ট্র এবং সেশনগুলি 5 টির বেশি:
ga:country==United%20States;ga:sessions>5
সেগমেন্ট
segment=gaid::-10
segment=sessions::condition::ga:medium%3D%3Dreferral
segment=users::condition::ga:browser%3D%3DChrome
কোর রিপোর্টিং এপিআই-এ কীভাবে একটি সেগমেন্টের জন্য অনুরোধ করা যায় তার সম্পূর্ণ বিশদ বিবরণের জন্য সেগমেন্ট ডেভ গাইড দেখুন।
বিভাগগুলির একটি ধারণাগত ওভারভিউয়ের জন্য, সহায়তা কেন্দ্রে বিভাগগুলির বৈশিষ্ট্য রেফারেন্স এবং বিভাগগুলি দেখুন৷
সেগমেন্টে অনুমোদিত মাত্রা এবং মেট্রিক্স।
সমস্ত মাত্রা এবং মেট্রিক্স সেগমেন্টে ব্যবহার করা যাবে না। সেগমেন্টে কোন মাত্রা এবং মেট্রিক্স অনুমোদিত তা পর্যালোচনা করতে ডাইমেনশন এবং মেট্রিক্স এক্সপ্লোরার দেখুন।
স্যাম্পলিং লেভেল
samplingLevel=DEFAULT
-
DEFAULT
- একটি নমুনা আকারের সাথে প্রতিক্রিয়া প্রদান করে যা গতি এবং নির্ভুলতার ভারসাম্য বজায় রাখে। -
FASTER
— একটি ছোট নমুনা আকারের সাথে দ্রুত প্রতিক্রিয়া প্রদান করে। -
HIGHER_PRECISION
— একটি বড় নমুনা আকার ব্যবহার করে আরও সঠিক প্রতিক্রিয়া প্রদান করে, কিন্তু এর ফলে প্রতিক্রিয়া ধীর হতে পারে।
DEFAULT
নমুনা স্তর ব্যবহার করা হবে।অন্তর্ভুক্ত-খালি-সারি
include-empty-rows=true
শুরু-সূচক
start-index=10
1
। (ফলাফল সূচীগুলি 1-ভিত্তিক। অর্থাৎ, প্রথম সারিটি সারি 1
, সারি 0
নয়।) এই প্যারামিটারটিকে max-results
প্যারামিটার সহ এমন পরিস্থিতিতে ব্যবহার করুন যখন totalResults
10,000 ছাড়িয়ে যায় এবং আপনি সূচিবদ্ধ সারিগুলি পুনরুদ্ধার করতে চান 10,001 এবং তার পরেসর্বোচ্চ ফলাফল
max-results=100
start-index
সাথে একত্রে এটি ব্যবহার করতে পারেন, বা প্রথমটি দিয়ে শুরু করে ফিরে আসা উপাদানগুলির সংখ্যা সীমাবদ্ধ করতে এটি একা ব্যবহার করতে পারেন। যদি max-results
সরবরাহ না করা হয়, প্রশ্নটি ডিফল্ট সর্বোচ্চ 1000 সারি প্রদান করে।ga:country
এর জন্য 300 টিরও কম সম্ভাব্য মান রয়েছে, তাই শুধুমাত্র দেশ অনুসারে বিভক্ত করার সময়, আপনি 300 টির বেশি সারি পেতে পারবেন না, এমনকি যদি আপনি max-results
উচ্চতর মান সেট করেন।আউটপুট
output=dataTable
-
json
— প্রতিক্রিয়াতে ডিফল্টrows
বৈশিষ্ট্য আউটপুট করে, একটি JSON অবজেক্ট ধারণ করে। -
dataTable
— প্রতিক্রিয়াতে একটিdataTable
বৈশিষ্ট্য আউটপুট করে, একটি ডেটা টেবিল অবজেক্ট ধারণ করে। এইData Table
অবজেক্টটি সরাসরি Google চার্ট ভিজ্যুয়ালাইজেশনের সাথে ব্যবহার করা যেতে পারে।
ক্ষেত্র
fields=rows,columnHeaders(name,dataType)
আংশিক প্রতিক্রিয়ায় কোন ক্ষেত্রগুলিকে ফিরিয়ে আনতে হবে তা নির্দিষ্ট করে৷ আপনি যদি API প্রতিক্রিয়াতে ক্ষেত্রগুলির একটি উপসেট ব্যবহার করেন তবে কোন ক্ষেত্রগুলি অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করতে আপনি fields
পরামিতি ব্যবহার করতে পারেন।
ক্ষেত্র অনুরোধ প্যারামিটার মান বিন্যাস শিথিলভাবে XPath সিনট্যাক্সের উপর ভিত্তি করে। সমর্থিত সিনট্যাক্স নীচে সংক্ষিপ্ত করা হয়.
- একাধিক ক্ষেত্র নির্বাচন করতে একটি কমা-বিচ্ছিন্ন তালিকা ব্যবহার করুন।
- একটি ক্ষেত্রের মধ্যে নেস্ট করা একটি ক্ষেত্র b নির্বাচন করতে
a/b
ব্যবহার করুন; b এর মধ্যে c নেস্টেড একটি ক্ষেত্র নির্বাচন করতেa/b/c
ব্যবহার করুন। -
"( )"
বন্ধনীতে অভিব্যক্তি স্থাপন করে অ্যারে বা বস্তুর নির্দিষ্ট উপ-ক্ষেত্রগুলির একটি সেট অনুরোধ করতে একটি উপ-নির্বাচক ব্যবহার করুন।
উদাহরণস্বরূপ:fields=columnHeaders(name,dataType)
columnHeaders
অ্যারেতে শুধুমাত্রname
এবংdataType
ক্ষেত্রগুলি প্রদান করে। আপনি একটি একক উপ-ক্ষেত্রও নির্দিষ্ট করতে পারেন, যেখানেfields=columnHeader(name)
হলfields=columnHeader/name
এর সমতুল্য।
prettyPrint
prettyPrint=false
true
হলে মানব-পাঠযোগ্য বিন্যাসে প্রতিক্রিয়া প্রদান করে। ডিফল্ট মান: false
।
কোটা ব্যবহারকারী
quotaUser=4kh4r2h4
ব্যবহারকারীর আইপি ঠিকানা অজানা থাকা অবস্থায়ও আপনাকে সার্ভার-সাইড অ্যাপ্লিকেশন থেকে প্রতি-ব্যবহারকারী কোটা প্রয়োগ করতে দেয়। এটি ঘটতে পারে, উদাহরণস্বরূপ, ব্যবহারকারীর পক্ষ থেকে অ্যাপ ইঞ্জিনে ক্রোন কাজ চালানোর অ্যাপ্লিকেশনগুলির সাথে। আপনি যেকোন নির্বিচারে স্ট্রিং চয়ন করতে পারেন যা ব্যবহারকারীকে অনন্যভাবে সনাক্ত করে, তবে এটি 40টি অক্ষরের মধ্যে সীমাবদ্ধ।
উভয় প্রদান করা হলে এটি userIp
ওভাররাইড করে।
প্রতিক্রিয়া
সফল হলে, এই অনুরোধটি নীচে সংজ্ঞায়িত JSON কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে। যদি আউটপুট প্যারামিটার dataTable
সেট করা থাকে তবে অনুরোধটি নীচে সংজ্ঞায়িত JSON (ডেটা টেবিল) কাঠামোর সাথে একটি প্রতিক্রিয়া বডি প্রদান করে।
দ্রষ্টব্য : "ফলাফল" শব্দটি প্রশ্নের সাথে মেলে এমন সারিগুলির সম্পূর্ণ সেটকে বোঝায়, যখন "প্রতিক্রিয়া" ফলাফলের বর্তমান পৃষ্ঠায় প্রত্যাবর্তিত সারিগুলির সেটকে বোঝায়৷ তারা ভিন্ন হতে পারে যদি মোট সংখ্যার ফলাফল বর্তমান প্রতিক্রিয়ার জন্য পৃষ্ঠার আকারের চেয়ে বড় হয়, যেমন itemPerPage এ ব্যাখ্যা করা হয়েছে।
{
"kind": "analytics#gaData",
"id": string,
"selfLink": string,
"containsSampledData": boolean,
"query": {
"start-date": string,
"end-date": string,
"ids": string,
"dimensions": [
string
],
"metrics": [
string
],
"include-empty-rows": boolean
"samplingLevel": string,
"sort": [
string
],
"filters": string,
"segment": string,
"start-index": integer,
"max-results": integer
},
"itemsPerPage": integer,
"totalResults": integer,
"previousLink": string,
"nextLink": string,
"profileInfo": {
"profileId": string,
"accountId": string,
"webPropertyId": string,
"internalWebPropertyId": string,
"profileName": string,
"tableId": string
},
"columnHeaders": [
{
"name": string,
"columnType": string,
"dataType": string
}
],
"rows": [
[
string
]
],
"sampleSize": string,
"sampleSpace": string,
"totalsForAllResults": [
{
metricName: string,
...
}
]
}
প্রতিক্রিয়া ক্ষেত্র
প্রতিক্রিয়া শরীরের গঠন বৈশিষ্ট্য নিম্নরূপ সংজ্ঞায়িত করা হয়:
সম্পত্তির নাম | মান | বর্ণনা |
---|---|---|
kind | string | সম্পদের ধরন। মান হল "analytics#gaData"। |
id | string | এই তথ্য প্রতিক্রিয়া জন্য একটি আইডি. |
query | object | এই অবজেক্টে ক্যোয়ারীতে প্যারামিটার হিসাবে পাস করা সমস্ত মান রয়েছে। প্রতিটি ক্ষেত্রের অর্থ তার সংশ্লিষ্ট ক্যোয়ারী প্যারামিটারের বর্ণনায় ব্যাখ্যা করা হয়েছে। |
query.start-date | string | শুরুর তারিখ. |
query.end-date | string | শেষ তারিখ. |
query.ids | string | অনন্য টেবিল আইডি। |
query.dimensions[] | list | বিশ্লেষণ মাত্রা তালিকা. |
query.metrics[] | list | বিশ্লেষণ মেট্রিক্সের তালিকা। |
query.samplingLevel | string | Requested sampling level. |
query.include-empty-rows | boolean | ডিফল্ট থেকে সত্য; মিথ্যাতে সেট করা হলে, সারি যেখানে সমস্ত মেট্রিক মান শূন্য সেগুলি প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। |
query.sort[] | list | মেট্রিক বা মাত্রার তালিকা যার উপর ডেটা সাজানো হয়েছে। |
query.filters | string | মেট্রিক বা মাত্রা ফিল্টারগুলির কমা দ্বারা পৃথক করা তালিকা৷ |
query.segment | string | বিশ্লেষণ বিভাগ। |
query.start-index | integer | সূচনা শুরু করুন। |
query.max-results | integer | প্রতি পৃষ্ঠায় সর্বোচ্চ ফলাফল। |
startIndex | integer | start-index কোয়েরি প্যারামিটার দ্বারা নির্দিষ্ট করা সারিগুলির শুরুর সূচী৷ ডিফল্ট মান হল 1। |
itemsPerPage | integer | প্রত্যাবর্তিত সারির প্রকৃত সংখ্যা নির্বিশেষে প্রতিক্রিয়াটিতে সর্বাধিক সংখ্যক সারি থাকতে পারে। যদি max-results ক্যোয়ারী প্যারামিটার নির্দিষ্ট করা হয়, তাহলে itemsPerPage এর মান max-results থেকে ছোট বা 10,000। itemsPerPage এর ডিফল্ট মান হল 1000৷ |
totalResults | integer | প্রশ্নের ফলাফলে সারির মোট সংখ্যা, উত্তরে যত সারির সংখ্যাই থাকুক না কেন। যে ক্যোয়ারীগুলির ফলে প্রচুর সংখ্যক সারি হয়, তার জন্য totalResults itemsPerPage এর থেকে বেশি হতে পারে। totalResults আরও ব্যাখ্যার জন্য পেজিং দেখুন এবং বড় প্রশ্নের জন্য itemsPerPage দেখুন। |
startDate | string | ডেটা কোয়েরির জন্য শুরুর তারিখ, যেমন start-date প্যারামিটার দ্বারা নির্দিষ্ট করা হয়েছে। |
endDate | string | end-date প্যারামিটার দ্বারা নির্দিষ্ট করা ডেটা কোয়েরির শেষ তারিখ। |
selfLink | string | এই ডেটা প্রশ্নের জন্য ফলাফলের এই পৃষ্ঠায় লিঙ্ক করুন। |
previousLink | string | এই ডেটা প্রশ্নের জন্য ফলাফলের পূর্ববর্তী পৃষ্ঠায় লিঙ্ক করুন। |
nextLink | string | এই ডেটা প্রশ্নের জন্য ফলাফলের পরবর্তী পৃষ্ঠায় লিঙ্ক করুন। |
profileInfo | object | ভিউ (প্রোফাইল) সম্পর্কে তথ্য যার জন্য ডেটা অনুরোধ করা হয়েছিল। দেখুন (প্রোফাইল) ডেটা গুগল অ্যানালিটিক্স ম্যানেজমেন্ট API এর মাধ্যমে উপলব্ধ। |
profileInfo.profileId | string | দেখুন (প্রোফাইল) আইডি, যেমন 1174 । |
profileInfo.accountId | string | অ্যাকাউন্ট আইডি যার এই ভিউ (প্রোফাইল) অন্তর্গত, যেমন 30481 । |
profileInfo.webPropertyId | string | ওয়েব প্রপার্টি আইডি যার সাথে এই ভিউ (প্রোফাইল) অন্তর্গত, যেমন UA-30481-1 । |
profileInfo.internalWebPropertyId | string | এই ভিউ (প্রোফাইল) যে ওয়েব সম্পত্তির জন্য অভ্যন্তরীণ আইডি, যেমন UA-30481-1 । |
profileInfo.profileName | string | ভিউয়ের নাম (প্রোফাইল)। |
profileInfo.tableId | string | ভিউ (প্রোফাইল) এর জন্য টেবিল আইডি, যার মধ্যে "ga:" এর পরে ভিউ (প্রোফাইল) আইডি থাকে। |
containsSampledData | boolean | উত্তরে নমুনাযুক্ত ডেটা থাকলে সত্য। |
sampleSize | string | নমুনা করা ডেটা গণনা করতে ব্যবহৃত নমুনার সংখ্যা। |
sampleSpace | string | মোট নমুনা স্থান আকার. এটি মোট উপলব্ধ নমুনা স্থানের আকার নির্দেশ করে যেখান থেকে নমুনাগুলি নির্বাচন করা হয়েছিল৷ |
columnHeaders[] | list | কলামের শিরোনাম যা মেট্রিক নামের পরে মাত্রার নাম তালিকাভুক্ত করে। মাত্রা এবং মেট্রিক্সের ক্রম metrics এবং dimensions পরামিতির মাধ্যমে অনুরোধে উল্লেখ করা অনুরূপ। হেডারের সংখ্যা হল মাত্রার সংখ্যা + মেট্রিক্সের সংখ্যা। |
columnHeaders[].name | string | মাত্রা বা মেট্রিকের নাম। |
columnHeaders[].columnType | string | কলামের ধরন। হয় "DIMENSION" বা "METRIC"। |
columnHeaders[].dataType | string | ডেটা টাইপ। ডাটা টাইপ হিসাবে ডাইমেনশন কলাম হেডারে শুধুমাত্র STRING আছে। মেট্রিক কলাম হেডারে মেট্রিক মানগুলির জন্য ডেটা প্রকার রয়েছে যেমন INTEGER , PERCENT , TIME , CURRENCY , FLOAT , ইত্যাদি৷ সমস্ত সম্ভাব্য ডেটা প্রকারের জন্য মেটাডেটা API প্রতিক্রিয়া দেখুন৷ |
totalsForAllResults | object | মেট্রিক নাম এবং মানগুলির মূল-মান জোড়া হিসাবে অনুরোধ করা মেট্রিকের জন্য মোট মান। মেট্রিক মোটের ক্রম অনুরোধে উল্লিখিত মেট্রিক অর্ডারের সমান। |
rows[] | list | অ্যানালিটিক্স ডেটা সারি, যেখানে প্রতিটি সারিতে মেট্রিক মান অনুসরণ করে মাত্রা মানগুলির একটি তালিকা থাকে। মাত্রা এবং মেট্রিক্সের ক্রম অনুরোধে উল্লিখিত হিসাবে একই। প্রতিটি সারিতে N ক্ষেত্রের একটি তালিকা রয়েছে, যেখানে N = মাত্রার সংখ্যা + মেট্রিক্সের সংখ্যা। |
{
"kind": "analytics#gaData",
"id": string,
"selfLink": string,
"containsSampledData": boolean,
"query": {
"start-date": string,
"end-date": string,
"ids": string,
"dimensions": [
string
],
"metrics": [
string
],
"samplingLevel": string,
"include-empty-rows": boolean,
"sort": [
string
],
"filters": string,
"segment": string,
"start-index": integer,
"max-results": integer
},
"itemsPerPage": integer,
"totalResults": integer,
"previousLink": string,
"nextLink": string,
"profileInfo": {
"profileId": string,
"accountId": string,
"webPropertyId": string,
"internalWebPropertyId": string,
"profileName": string,
"tableId": string
},
"columnHeaders": [
{
"name": string,
"columnType": string,
"dataType": string
}
],
"dataTable": {
"cols": [
{
"id": string,
"label": string,
"type": string
}
],
"rows": [
{
"c": [
{
"v": string
}
]
}
]
},
"sampleSize": string,
"sampleSpace": string,
"totalsForAllResults": [
{
metricName: string,
...
}
]
}
প্রতিক্রিয়া ক্ষেত্র
প্রতিক্রিয়া শরীরের গঠন বৈশিষ্ট্য নিম্নরূপ সংজ্ঞায়িত করা হয়:
সম্পত্তির নাম | মান | বর্ণনা |
---|---|---|
kind | string | সম্পদের ধরন। মান হল "analytics#gaData"। |
id | string | এই তথ্য প্রতিক্রিয়া জন্য একটি আইডি. |
query | object | এই অবজেক্টে ক্যোয়ারীতে প্যারামিটার হিসাবে পাস করা সমস্ত মান রয়েছে। প্রতিটি ক্ষেত্রের অর্থ তার সংশ্লিষ্ট ক্যোয়ারী প্যারামিটারের বর্ণনায় ব্যাখ্যা করা হয়েছে। |
query.start-date | string | শুরুর তারিখ. |
query.end-date | string | শেষ তারিখ. |
query.ids | string | অনন্য টেবিল আইডি। |
query.dimensions[] | list | বিশ্লেষণ মাত্রা তালিকা. |
query.metrics[] | list | বিশ্লেষণ মেট্রিক্সের তালিকা। |
query.samplingLevel | string | Requested sampling level. |
query.include-empty-rows | boolean | ডিফল্ট থেকে সত্য; মিথ্যাতে সেট করা হলে, সারি যেখানে সমস্ত মেট্রিক মান শূন্য সেগুলি প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। |
query.sort[] | list | মেট্রিক বা মাত্রার তালিকা যার উপর ডেটা সাজানো হয়েছে। |
query.filters | string | মেট্রিক বা মাত্রা ফিল্টারগুলির কমা দ্বারা পৃথক করা তালিকা৷ |
query.segment | string | বিশ্লেষণ বিভাগ। |
query.start-index | integer | সূচনা শুরু করুন। |
query.max-results | integer | প্রতি পৃষ্ঠায় সর্বোচ্চ ফলাফল। |
startIndex | integer | start-index কোয়েরি প্যারামিটার দ্বারা নির্দিষ্ট করা সারিগুলির শুরুর সূচী৷ ডিফল্ট মান হল 1। |
itemsPerPage | integer | প্রত্যাবর্তিত সারির প্রকৃত সংখ্যা নির্বিশেষে প্রতিক্রিয়াটিতে সর্বাধিক সংখ্যক সারি থাকতে পারে। যদি max-results ক্যোয়ারী প্যারামিটার নির্দিষ্ট করা হয়, তাহলে itemsPerPage এর মান max-results থেকে ছোট বা 10,000। itemsPerPage এর ডিফল্ট মান হল 1000৷ |
totalResults | integer | প্রশ্নের ফলাফলে সারির মোট সংখ্যা, উত্তরে যত সারির সংখ্যাই থাকুক না কেন। যে ক্যোয়ারীগুলির ফলে প্রচুর সংখ্যক সারি হয়, তার জন্য totalResults itemsPerPage এর থেকে বেশি হতে পারে। totalResults আরও ব্যাখ্যার জন্য পেজিং দেখুন এবং বড় প্রশ্নের জন্য itemsPerPage দেখুন। |
startDate | string | ডেটা কোয়েরির জন্য শুরুর তারিখ, যেমন start-date প্যারামিটার দ্বারা নির্দিষ্ট করা হয়েছে। |
endDate | string | end-date প্যারামিটার দ্বারা নির্দিষ্ট করা ডেটা কোয়েরির শেষ তারিখ। |
selfLink | string | এই ডেটা প্রশ্নের জন্য ফলাফলের এই পৃষ্ঠায় লিঙ্ক করুন। |
previousLink | string | এই ডেটা প্রশ্নের জন্য ফলাফলের পূর্ববর্তী পৃষ্ঠায় লিঙ্ক করুন। |
nextLink | string | এই ডেটা প্রশ্নের জন্য ফলাফলের পরবর্তী পৃষ্ঠায় লিঙ্ক করুন। |
profileInfo | object | ভিউ (প্রোফাইল) সম্পর্কে তথ্য যার জন্য ডেটা অনুরোধ করা হয়েছিল। দেখুন (প্রোফাইল) ডেটা গুগল অ্যানালিটিক্স ম্যানেজমেন্ট API এর মাধ্যমে উপলব্ধ। |
profileInfo.profileId | string | দেখুন (প্রোফাইল) আইডি, যেমন 1174 । |
profileInfo.accountId | string | অ্যাকাউন্ট আইডি যার এই ভিউ (প্রোফাইল) অন্তর্গত, যেমন 30481 । |
profileInfo.webPropertyId | string | ওয়েব প্রপার্টি আইডি যার সাথে এই ভিউ (প্রোফাইল) অন্তর্গত, যেমন UA-30481-1 । |
profileInfo.internalWebPropertyId | string | এই ভিউ (প্রোফাইল) যে ওয়েব সম্পত্তির জন্য অভ্যন্তরীণ আইডি, যেমন UA-30481-1 । |
profileInfo.profileName | string | ভিউয়ের নাম (প্রোফাইল)। |
profileInfo.tableId | string | ভিউ (প্রোফাইল) এর জন্য টেবিল আইডি, যার মধ্যে "ga:" এর পরে ভিউ (প্রোফাইল) আইডি থাকে। |
containsSampledData | boolean | উত্তরে নমুনাযুক্ত ডেটা থাকলে সত্য। |
sampleSize | string | নমুনা করা ডেটা গণনা করতে ব্যবহৃত নমুনার সংখ্যা। |
sampleSpace | string | মোট নমুনা স্থান আকার. এটি মোট উপলব্ধ নমুনা স্থানের আকার নির্দেশ করে যেখান থেকে নমুনাগুলি নির্বাচন করা হয়েছিল৷ |
columnHeaders[] | list | কলামের শিরোনাম যা মেট্রিক নামের পরে মাত্রার নাম তালিকাভুক্ত করে। মাত্রা এবং মেট্রিক্সের ক্রম metrics এবং dimensions পরামিতির মাধ্যমে অনুরোধে উল্লেখ করা অনুরূপ। হেডারের সংখ্যা হল মাত্রার সংখ্যা + মেট্রিক্সের সংখ্যা। |
columnHeaders[].name | string | মাত্রা বা মেট্রিকের নাম। |
columnHeaders[].columnType | string | কলামের ধরন। হয় "DIMENSION" বা "METRIC"। |
columnHeaders[].dataType | string | ডেটা টাইপ। ডাটা টাইপ হিসাবে ডাইমেনশন কলাম হেডারে শুধুমাত্র STRING আছে। মেট্রিক কলাম হেডারে মেট্রিক মানগুলির জন্য ডেটা প্রকার রয়েছে যেমন INTEGER , PERCENT , TIME , CURRENCY , FLOAT , ইত্যাদি৷ সমস্ত সম্ভাব্য ডেটা প্রকারের জন্য মেটাডেটা API প্রতিক্রিয়া দেখুন৷ |
totalsForAllResults | object | মেট্রিক নাম এবং মানগুলির মূল-মান জোড়া হিসাবে অনুরোধ করা মেট্রিকের জন্য মোট মান। মেট্রিক মোটের ক্রম অনুরোধে উল্লিখিত মেট্রিক অর্ডারের সমান। |
dataTable | object | একটি ডেটা টেবিল অবজেক্ট যা Google চার্টের সাথে ব্যবহার করা যেতে পারে। |
dataTable.cols[] | list | মেট্রিক্স অনুসরণ করে মাত্রার জন্য কলাম বর্ণনাকারীদের একটি তালিকা। মাত্রা এবং মেট্রিক্সের ক্রম metrics এবং dimensions পরামিতির মাধ্যমে অনুরোধে উল্লেখ করা অনুরূপ। কলামের সংখ্যা হল মাত্রার সংখ্যা + মেট্রিক্সের সংখ্যা। |
dataTable.cols[].id | string | একটি আইডি, যা একটি নির্দিষ্ট কলাম উল্লেখ করতে ব্যবহার করা যেতে পারে (কলাম সূচী ব্যবহার করার বিকল্প হিসাবে)। এই মান সেট করতে মাত্রা বা মেট্রিক আইডি ব্যবহার করা হয়। |
dataTable.cols[].label | string | কলামের জন্য একটি লেবেল (যা একটি ভিজ্যুয়ালাইজেশন দ্বারা প্রদর্শিত হতে পারে)। এই মান সেট করতে মাত্রা বা মেট্রিক আইডি ব্যবহার করা হয়। |
dataTable.cols[].type | string | এই কলামের জন্য ডেটা টাইপ। |
dataTable.rows[] | list | ডেটা টেবিল ফর্ম্যাটে অ্যানালিটিক্স ডেটা সারি, যেখানে প্রতিটি সারি মেট্রিক্স অনুসরণ করে মাত্রার জন্য ঘরের মানগুলির একটি তালিকা ধারণকারী বস্তু। মাত্রা এবং মেট্রিক্সের ক্রম অনুরোধে উল্লিখিত হিসাবে একই। প্রতিটি ঘরে N ক্ষেত্রের একটি তালিকা রয়েছে, যেখানে N = মাত্রার সংখ্যা + মেট্রিক্সের সংখ্যা। |
ত্রুটি কোড
একটি অনুরোধ সফল হলে কোর রিপোর্টিং API একটি 200
HTTP স্থিতি কোড প্রদান করে৷ যদি একটি প্রশ্নের প্রক্রিয়াকরণের সময় একটি ত্রুটি ঘটে, API একটি ত্রুটি কোড এবং বিবরণ প্রদান করে। অ্যানালিটিক্স এপিআই ব্যবহার করে এমন প্রতিটি অ্যাপ্লিকেশানের যথাযথ ত্রুটি হ্যান্ডলিং যুক্তি প্রয়োগ করতে হবে। ত্রুটি কোড এবং সেগুলি কীভাবে পরিচালনা করবেন তার বিশদ বিবরণের জন্য, ত্রুটি প্রতিক্রিয়া রেফারেন্স গাইড পড়ুন।
এটা চেষ্টা করুন!
আপনি কোর রিপোর্টিং এপিআই-এ প্রশ্নগুলি চেষ্টা করে দেখতে পারেন।
একটি ক্যোয়ারীতে মেট্রিক্স এবং মাত্রার বৈধ সমন্বয় দেখতে, ক্যোয়ারী এক্সপ্লোরারে প্যারামিটারের জন্য নমুনা মান লিখুন। নমুনা প্রশ্নের ফলাফলগুলি সমস্ত নির্দিষ্ট মেট্রিক্স এবং মাত্রার মান সহ একটি টেবিল হিসাবে দেখানো হয়৷
লাইভ ডেটাতে অনুরোধ করতে এবং JSON ফর্ম্যাটে প্রতিক্রিয়া দেখতে, Google Data APIs Explorer- এ
analytics.data.ga.get
পদ্ধতি ব্যবহার করে দেখুন।
স্যাম্পলিং
Google Analytics ফ্লাইতে মাত্রা এবং মেট্রিক্সের নির্দিষ্ট সমন্বয় গণনা করে। যুক্তিসঙ্গত সময়ে ডেটা ফেরত দিতে, Google Analytics শুধুমাত্র ডেটার একটি নমুনা প্রক্রিয়া করতে পারে।
আপনি স্যাম্পলিং লেভেল প্যারামিটার সেট করে অনুরোধের জন্য ব্যবহার করার জন্য নমুনা স্তর নির্দিষ্ট করতে পারেন।
যদি একটি কোর রিপোর্টিং এপিআই প্রতিক্রিয়াতে নমুনাযুক্ত ডেটা থাকে, তাহলে containsSampledData
প্রতিক্রিয়া ক্ষেত্রটি true
হবে। এছাড়াও, 2টি বৈশিষ্ট্য প্রশ্নের জন্য নমুনা স্তর সম্পর্কে তথ্য প্রদান করবে: sampleSize
এবং sampleSpace
। এই 2টি মান দিয়ে আপনি সেশনের শতাংশ গণনা করতে পারেন যা প্রশ্নের জন্য ব্যবহৃত হয়েছিল। উদাহরণস্বরূপ, যদি sampleSize
হয় 201,000
এবং sampleSpace
220,000
হয় তাহলে রিপোর্টটি (201,000 / 220,000) * 100 = 91.36% সেশনের উপর ভিত্তি করে তৈরি হয়।
নমুনার একটি সাধারণ বিবরণের জন্য নমুনা দেখুন এবং এটি কীভাবে Google Analytics-এ ব্যবহার করা হয়।
বড় ডেটা ফলাফল হ্যান্ডলিং
আপনি যদি আশা করেন যে আপনার ক্যোয়ারীটি একটি বড় ফলাফল সেট ফিরিয়ে দেবে, তাহলে আপনার API ক্যোয়ারী অপ্টিমাইজ করতে, ত্রুটি এড়াতে এবং কোটা ওভাররান কমাতে সাহায্য করার জন্য নীচের নির্দেশিকাগুলি ব্যবহার করুন৷ মনে রাখবেন যে আমরা যেকোন একটি API অনুরোধে সর্বাধিক 7টি মাত্রা এবং 10টি মেট্রিক্সের অনুমতি দিয়ে একটি কর্মক্ষমতা বেসলাইন সেট করি৷ যদিও কিছু ক্যোয়ারী যেগুলি প্রচুর সংখ্যক মেট্রিক্স এবং মাত্রা নির্দিষ্ট করে সেগুলি অন্যদের তুলনায় প্রক্রিয়া করতে বেশি সময় নিতে পারে, অনুরোধ করা মেট্রিকের সংখ্যা সীমিত করা ক্যোয়ারী কর্মক্ষমতা উন্নত করার জন্য যথেষ্ট নাও হতে পারে৷ পরিবর্তে, আপনি সেরা কর্মক্ষমতা ফলাফলের জন্য নিম্নলিখিত কৌশলগুলি ব্যবহার করতে পারেন।
ক্যোয়ারী প্রতি মাত্রা হ্রাস
API যেকোনো একটি অনুরোধে 7টি মাত্রা পর্যন্ত নির্দিষ্ট করার অনুমতি দেয়। অনেক সময়, গুগল অ্যানালিটিক্সকে অবশ্যই এই জটিল প্রশ্নের ফলাফলগুলি ফ্লাইতে গণনা করতে হবে। এটি বিশেষ করে সময়সাপেক্ষ হতে পারে যদি ফলাফল সারির সংখ্যা বেশি হয়। উদাহরণ স্বরূপ, কিওয়ার্ডের জন্য ক্যোয়ারী করা, শহর অনুসারে ঘন্টায় লক্ষ লক্ষ সারি ডেটার সাথে মেলে। আপনার ক্যোয়ারীতে ডাইমেনশনের সংখ্যা সীমিত করে আপনি Google Analytics-এর সারির সংখ্যা কমিয়ে কর্মক্ষমতা উন্নত করতে পারেন।
তারিখ ব্যাপ্তি দ্বারা প্রশ্ন বিভক্ত করা
একটি দীর্ঘ তারিখ পরিসরের তারিখ-কী ফলাফলের মাধ্যমে পেজ করার পরিবর্তে, এক সপ্তাহের জন্য - বা এমনকি একদিনের জন্য - একটি সময়ে আলাদা প্রশ্ন গঠনের কথা বিবেচনা করুন৷ অবশ্যই, একটি বৃহৎ ডেটা সেটের জন্য, এমনকি এক দিনের ডেটার জন্য একটি অনুরোধ max-results
চেয়ে বেশি ফেরত দিতে পারে, এই ক্ষেত্রে পেজিং এড়ানো যাবে না। কিন্তু যাই হোক না কেন, যদি আপনার ক্যোয়ারির জন্য মিলে যাওয়া সারির সংখ্যা max-results
চেয়ে বেশি হয়, তাহলে তারিখের সীমা ভেঙে দিলে ফলাফলগুলি পুনরুদ্ধার করার মোট সময় কমে যেতে পারে। এই পদ্ধতিটি একক-থ্রেডেড এবং সমান্তরাল উভয় প্রশ্নেই কর্মক্ষমতা উন্নত করতে পারে।
পেজিং
ফলাফলের মাধ্যমে পেজিং বড় ফলাফলের সেটগুলিকে পরিচালনাযোগ্য অংশে ভাঙার একটি কার্যকর উপায় হতে পারে। totalResults
ক্ষেত্রটি বলে যে কতগুলি মিলে যাওয়া সারি বিদ্যমান, এবং itemsPerPage
সর্বাধিক সংখ্যক সারি দেয় যা ফলাফলে ফেরত দেওয়া যেতে পারে। যদি itemsPerPage
এ totalResults
একটি উচ্চ অনুপাত থাকে, তাহলে পৃথক প্রশ্নগুলি প্রয়োজনের চেয়ে বেশি সময় নিতে পারে। আপনার যদি শুধুমাত্র সীমিত সংখ্যক সারির প্রয়োজন হয়, যেমন প্রদর্শনের উদ্দেশ্যে, আপনি max-results
প্যারামিটারের মাধ্যমে প্রতিক্রিয়া আকারের একটি সুস্পষ্ট সীমা সেট করা সুবিধাজনক বলে মনে করতে পারেন। যাইহোক, যদি আপনার অ্যাপ্লিকেশনটিকে সম্পূর্ণরূপে ফলাফলের একটি বড় সেট প্রক্রিয়া করতে হয়, তাহলে সর্বাধিক অনুমোদিত সারিগুলির অনুরোধ করা আরও কার্যকর হতে পারে।
জিজিপ ব্যবহার করে
প্রতিটি অনুরোধের জন্য প্রয়োজনীয় ব্যান্ডউইথ কমানোর একটি সহজ এবং সুবিধাজনক উপায় হল জিজিপ কম্প্রেশন সক্ষম করা। যদিও ফলাফলগুলিকে কম্প্রেস করার জন্য অতিরিক্ত CPU সময় প্রয়োজন, নেটওয়ার্ক খরচের সাথে ট্রেডঅফ সাধারণত এটিকে খুব সার্থক করে তোলে। একটি gzip-এনকোড করা প্রতিক্রিয়া পাওয়ার জন্য আপনাকে দুটি জিনিস করতে হবে: একটি Accept-Encoding
শিরোনাম সেট করুন এবং স্ট্রিং gzip
ধারণ করতে আপনার ব্যবহারকারী এজেন্টকে পরিবর্তন করুন। এখানে gzip কম্প্রেশন সক্ষম করার জন্য সঠিকভাবে গঠিত HTTP হেডারগুলির একটি উদাহরণ রয়েছে:
Accept-Encoding: gzip User-Agent: my program (gzip),
এই নথিটি কোর রিপোর্টিং API সংস্করণ 3.0-এর জন্য অনুসন্ধান এবং প্রতিক্রিয়া উভয়ের জন্য সম্পূর্ণ রেফারেন্স প্রদান করে।
ভূমিকা
আপনি গুগল অ্যানালিটিক্স রিপোর্ট ডেটার জন্য কোর রিপোর্টিং এপিআই জিজ্ঞাসা করুন৷ প্রতিটি প্রশ্নের জন্য একটি ভিউ (প্রোফাইল) আইডি, একটি শুরু এবং শেষ তারিখ এবং অন্তত একটি মেট্রিক প্রয়োজন৷ আপনার ক্যোয়ারী পরিমার্জিত করার জন্য আপনি অতিরিক্ত ক্যোয়ারী প্যারামিটার যেমন মাত্রা, ফিল্টার এবং সেগমেন্ট সরবরাহ করতে পারেন। এই সমস্ত ধারণাগুলি কীভাবে একসাথে কাজ করে তা বোঝার জন্য ওভারভিউ গাইডটি দেখুন।
অনুরোধ
API ডেটা অনুরোধ করার জন্য একটি একক পদ্ধতি প্রদান করে:
analytics.data.ga.get()
এই পদ্ধতিটি বিভিন্ন ক্লায়েন্ট লাইব্রেরিতে প্রকাশ করা হয় এবং ক্যোয়ারী প্যারামিটার সেট করার জন্য ভাষা নির্দিষ্ট ইন্টারফেস রয়েছে।
API একটি REST-ful endpoint হিসাবে জিজ্ঞাসা করা যেতে পারে:
Authorization: Bearer {oauth2-token} GET https://www.googleapis.com/analytics/v3/data/ga ?ids=ga:12345 &start-date=2008-10-01 &end-date=2008-10-31 &metrics=ga:sessions,ga:bounces
প্রতিটি URL ক্যোয়ারী প্যারামিটার একটি API ক্যোয়ারী প্যারামিটার নির্দিষ্ট করে যা URL এনকোড করা আবশ্যক ।
ক্যোয়ারী পরামিতি সারাংশ
নিম্নলিখিত সারণীটি কোর রিপোর্টিং API দ্বারা গৃহীত সমস্ত ক্যোয়ারী পরামিতিগুলির সংক্ষিপ্ত বিবরণ দেয়৷ একটি বিস্তারিত বিবরণের জন্য প্রতিটি পরামিতি নামের উপর ক্লিক করুন.
নাম | মান | প্রয়োজন | সারসংক্ষেপ |
---|---|---|---|
ids | string | হ্যাঁ | ga:XXXX ফর্মের অনন্য টেবিল ID, যেখানে XXXX হল Analytics ভিউ (প্রোফাইল) ID যার জন্য কোয়েরি ডেটা পুনরুদ্ধার করবে৷ |
start-date | string | হ্যাঁ | বিশ্লেষণ ডেটা আনার জন্য শুরুর তারিখ। অনুরোধগুলি YYYY-MM-DD হিসাবে ফর্ম্যাট করা একটি শুরুর তারিখ নির্দিষ্ট করতে পারে, বা একটি আপেক্ষিক তারিখ হিসাবে (যেমন, today , yesterday , বা NdaysAgo যেখানে N একটি ধনাত্মক পূর্ণসংখ্যা)। |
end-date | string | হ্যাঁ | Analytics ডেটা আনার শেষ তারিখ। অনুরোধ YYYY-MM-DD হিসাবে ফর্ম্যাট করা একটি শেষ তারিখ নির্দিষ্ট করতে পারে, বা একটি আপেক্ষিক তারিখ হিসাবে (যেমন, today , yesterday , বা NdaysAgo যেখানে N একটি ধনাত্মক পূর্ণসংখ্যা)। |
metrics | string | হ্যাঁ | কমা-বিচ্ছিন্ন মেট্রিকগুলির একটি তালিকা যেমন ga:sessions,ga:bounces । |
dimensions | string | না | আপনার বিশ্লেষণ ডেটা যেমন ga:browser,ga:city হিসাবে কমা-বিচ্ছিন্ন মাত্রার একটি তালিকা। |
sort | string | না | কমা-বিচ্ছিন্ন মাত্রা এবং মেট্রিকগুলির একটি তালিকা যা প্রত্যাবর্তিত ডেটার জন্য বাছাই ক্রম এবং বাছাইয়ের দিক নির্দেশ করে। |
filters | string | না | আপনার অনুরোধের জন্য প্রত্যাবর্তিত ডেটা সীমাবদ্ধতা বা মেট্রিক ফিল্টার। |
segment | string | না | বিভাগগুলি আপনার অনুরোধের জন্য ডেটা ফিরে আসে। |
samplingLevel | string | না | কাঙ্ক্ষিত নমুনা স্তর। অনুমোদিত মান:
|
include-empty-rows | boolean | না | সত্য হিসাবে ডিফল্ট; যদি মিথ্যা সেট করা হয় তবে সারিগুলি যেখানে সমস্ত মেট্রিক মান শূন্য থাকে তা প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। |
start-index | integer | না | পুনরুদ্ধার করার জন্য ডেটা প্রথম সারি, 1 থেকে শুরু করে এই প্যারামিটারটি max-results প্যারামিটারের পাশাপাশি পৃষ্ঠাগুলি প্রক্রিয়া হিসাবে ব্যবহার করুন। |
max-results | integer | না | প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য সর্বাধিক সংখ্যক সারি। |
output | string | না | প্রতিক্রিয়াতে ফিরে আসা অ্যানালিটিক্স ডেটার জন্য কাঙ্ক্ষিত আউটপুট প্রকার। গ্রহণযোগ্য মানগুলি json এবং dataTable । ডিফল্ট: json । |
fields | string | না | নির্বাচক প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য ক্ষেত্রগুলির একটি উপসেট নির্দিষ্ট করে। |
prettyPrint | string | না | ইন্ডেন্টেশন এবং লাইন ব্রেক সহ প্রতিক্রিয়া প্রদান করে। ডিফল্ট false . |
userIp | string | না | শেষ ব্যবহারকারীর আইপি ঠিকানা নির্দিষ্ট করে যার জন্য এপিআই কল করা হচ্ছে। আইপি প্রতি ব্যবহার ক্যাপ করতে ব্যবহৃত। |
quotaUser | string | না | যখন ব্যবহারকারীর আইপি ঠিকানা অজানা থাকে তখন ইউজারআইপির বিকল্প। |
access_token | string | না | একটি OAuth 2.0 টোকেন সরবরাহ করার একটি সম্ভাব্য উপায়। |
callback | string | না | জাভাস্ক্রিপ্ট কলব্যাক ফাংশনের নাম যা প্রতিক্রিয়া পরিচালনা করে। জাভাস্ক্রিপ্ট জেএসএন-পি অনুরোধগুলিতে ব্যবহৃত। |
key | string | না | কোটা পেতে আপনার অ্যাপ্লিকেশন নির্দিষ্ট করতে OAuth 1.0a অনুমোদনের জন্য ব্যবহৃত। উদাহরণস্বরূপ: key= AldefliuhSFADSfasdfasdfASdf । |
ক্যোয়ারী প্যারামিটার বিশদ
আইডি
ids= ga:12345
ga:
বিশ্লেষণ ভিউ (প্রোফাইল) আইডি সহ। আপনি analytics.management.profiles.list
পদ্ধতি ব্যবহার করে ভিউ (প্রোফাইল) আইডি পুনরুদ্ধার করতে পারেন, যা গুগল অ্যানালিটিক্স ম্যানেজমেন্ট এপিআইয়ের ভিউ (প্রোফাইল) রিসোর্সে id
সরবরাহ করে।শুরুর তারিখ
start-date= 2009-04-20
start-date
এবং end-date
পরামিতিগুলি অন্তর্ভুক্ত না করেন তবে সার্ভার একটি ত্রুটি ফিরিয়ে দেয়। today
, yesterday
, বা NdaysAgo
প্যাটার্ন ব্যবহার করে YYYY-MM-DD
বা আত্মীয়ের প্যাটার্ন ব্যবহার করে তারিখের মানগুলি নির্দিষ্ট তারিখের জন্য হতে পারে। মানগুলি অবশ্যই মেলে [0-9]{4}-[0-9]{2}-[0-9]{2}|today|yesterday|[0-9]+(daysAgo)
start-date
2005-01-01
। স্টার্ট-তারিখের জন্য কোনও উপরের সীমা সীমাবদ্ধতা নেই।আপেক্ষিক তারিখগুলি ব্যবহার করে গত 7 দিনের (গতকাল শুরু) উদাহরণ তারিখের পরিসীমা:
&start-date=7daysAgo &end-date=yesterday
শেষ তারিখ
end-date= 2009-05-20
start-date
এবং end-date
পরামিতিগুলি অন্তর্ভুক্ত না করেন তবে সার্ভার একটি ত্রুটি ফিরিয়ে দেয়। today
, yesterday
, বা NdaysAgo
প্যাটার্ন ব্যবহার করে YYYY-MM-DD
বা আত্মীয়ের প্যাটার্ন ব্যবহার করে তারিখের মানগুলি নির্দিষ্ট তারিখের জন্য হতে পারে। মানগুলি অবশ্যই মেলে [0-9]{4}-[0-9]{2}-[0-9]{2}|today|yesterday|[0-9]+(daysAgo)
end-date
2005-01-01
। end-date
জন্য কোনও উপরের সীমা সীমাবদ্ধতা নেই।আপেক্ষিক তারিখগুলি ব্যবহার করে গত 10 দিনের (আজ শুরু) উদাহরণ তারিখের পরিসীমা:
&start-date=9daysAgo &end-date=today
মাত্রা
dimensions= ga:browser,ga:city
dimensions
প্যারামিটারগুলি সাধারণ মানদণ্ড দ্বারা মেট্রিকগুলি ভেঙে দেয়; উদাহরণস্বরূপ, ga:browser
বা ga:city
। আপনি যখন আপনার সাইটে মোট পৃষ্ঠাগুলির সংখ্যা জিজ্ঞাসা করতে পারেন, ব্রাউজারের দ্বারা বিভক্ত পৃষ্ঠাভিউগুলির সংখ্যা জিজ্ঞাসা করা আরও আকর্ষণীয় হতে পারে। এই ক্ষেত্রে, আপনি ফায়ারফক্স, ইন্টারনেট এক্সপ্লোরার, ক্রোম এবং আরও অনেক কিছু থেকে পৃষ্ঠাভিউয়ের সংখ্যা দেখতে পাবেন। কোনও ডেটা অনুরোধে dimensions
ব্যবহার করার সময়, নিম্নলিখিত সীমাবদ্ধতাগুলি সম্পর্কে সচেতন হন:
- আপনি যে কোনও ক্যোয়ারিতে সর্বোচ্চ 7 টি মাত্রা সরবরাহ করতে পারেন।
- আপনি কেবল মাত্রা নিয়ে রচিত একটি ক্যোয়ারী প্রেরণ করতে পারবেন না : আপনাকে অবশ্যই কমপক্ষে একটি মেট্রিকের সাথে কোনও অনুরোধ করা মাত্রা একত্রিত করতে হবে।
- একই ক্যোয়ারিতে কেবল নির্দিষ্ট কিছু মাত্রা অনুসন্ধান করা যেতে পারে। কোন মাত্রা একসাথে ব্যবহার করা যেতে পারে তা দেখতে মাত্রা এবং মেট্রিক্স রেফারেন্সে বৈধ সংমিশ্রণ সরঞ্জামটি ব্যবহার করুন।
মেট্রিক্স
metrics= ga:sessions,ga:bounces
dimensions
প্যারামিটার না থাকে তবে ফেরত মেট্রিকগুলি অনুরোধ করা তারিখের পরিসীমা যেমন সামগ্রিক পৃষ্ঠাভিউ বা মোট বাউন্সের জন্য সামগ্রিক মান সরবরাহ করে। যাইহোক, যখন মাত্রাগুলির জন্য অনুরোধ করা হয়, মানগুলি মাত্রা মান দ্বারা বিভাগ করা হয়। উদাহরণস্বরূপ, ga:pageviews
ga:country
প্রতি দেশে মোট পৃষ্ঠাগুলি প্রদান করে। মেট্রিকের অনুরোধ করার সময়, মনে রাখবেন:- যে কোনও অনুরোধ অবশ্যই কমপক্ষে একটি মেট্রিক সরবরাহ করতে হবে; একটি অনুরোধ শুধুমাত্র মাত্রা নিয়ে গঠিত হতে পারে না।
- আপনি যে কোনও প্রশ্নের জন্য সর্বোচ্চ 10 মেট্রিক সরবরাহ করতে পারেন।
- একাধিক বিভাগ থেকে মেট্রিকের বেশিরভাগ সংমিশ্রণ একসাথে ব্যবহার করা যেতে পারে, তবে কোনও মাত্রা নির্দিষ্ট না করা থাকে।
- একটি মেট্রিক অন্যান্য মাত্রা বা মেট্রিকগুলির সাথে একত্রে ব্যবহার করা যেতে পারে তবে কেবলমাত্র যেখানে বৈধ সংমিশ্রণগুলি সেই মেট্রিকের জন্য প্রযোজ্য। বিশদগুলির জন্য মাত্রা এবং মেট্রিক রেফারেন্স দেখুন।
সাজান
sort= ga:country,ga:browser
মেট্রিক এবং মাত্রাগুলির একটি তালিকা এবং প্রত্যাবর্তিত ডেটার জন্য বাছাইয়ের ক্রম এবং বাছাইয়ের দিক নির্দেশ করে।
- বাছাই অর্ডার তালিকাভুক্ত মেট্রিক এবং মাত্রাগুলির বাম থেকে ডান ক্রম দ্বারা নির্দিষ্ট করা হয়।
- আরোহণের দিকে ডিফল্টগুলি বাছাই করা এবং অনুরোধ করা ক্ষেত্রে একটি বিয়োগ চিহ্ন (
-
) উপসর্গ ব্যবহার করে অবতরণে পরিবর্তন করা যেতে পারে।
একটি ক্যোয়ারির ফলাফল বাছাই করা আপনাকে আপনার ডেটা সম্পর্কে বিভিন্ন প্রশ্ন জিজ্ঞাসা করতে সক্ষম করে। উদাহরণস্বরূপ, "আমার শীর্ষ দেশগুলি কী এবং কোন ব্রাউজারগুলি তারা সবচেয়ে বেশি ব্যবহার করে?" এই প্রশ্নটি সমাধান করার জন্য? আপনি নিম্নলিখিত প্যারামিটার সহ একটি ক্যোয়ারী করতে পারেন। এটি প্রথমে ga:country
এবং তারপরে ga:browser
উভয়ই আরোহী ক্রমে:
sort=ga:country,ga:browser
সম্পর্কিত প্রশ্নের উত্তর দেওয়ার জন্য "আমার শীর্ষ ব্রাউজারগুলি কী এবং কোন দেশগুলি সেগুলি সবচেয়ে বেশি ব্যবহার করে?", আপনি নিম্নলিখিত প্যারামিটারটি দিয়ে একটি জিজ্ঞাসা করতে পারেন। এটি প্রথমে
ga:browser
এবং তারপরে ga:country
, উভয়ই আরোহী ক্রমে:sort=ga:browser,ga:country
sort
প্যারামিটারটি ব্যবহার করার সময়, নিম্নলিখিতটি মনে রাখবেন:
- আপনি
dimensions
বাmetrics
পরামিতিগুলিতে ব্যবহার করেছেন কেবল মাত্রা বা মেট্রিক মান দ্বারা বাছাই করুন। যদি আপনার অনুরোধটি এমন কোনও ক্ষেত্রে বাছাই করে যা মাত্রা বা মেট্রিক প্যারামিটারে নির্দেশিত না হয় তবে আপনি একটি ত্রুটি পাবেন। - ডিফল্টরূপে, স্ট্রিংগুলি এন-ইউএস লোকালে আরোহী বর্ণানুক্রমিক ক্রমে বাছাই করা হয়।
- সংখ্যাগুলি ডিফল্টরূপে আরোহী সংখ্যার ক্রমগুলিতে বাছাই করা হয়।
- তারিখগুলি ডিফল্টরূপে তারিখ অনুসারে আরোহী ক্রমে বাছাই করা হয়।
ফিল্টার
filters=ga:medium%3D%3Dreferral
filters
ক্যোয়ারী স্ট্রিং প্যারামিটারটি আপনার অনুরোধ থেকে প্রাপ্ত ডেটা সীমাবদ্ধ করে। filters
প্যারামিটার ব্যবহার করতে, ফিল্টার করার জন্য একটি মাত্রা বা মেট্রিক সরবরাহ করুন, তারপরে ফিল্টার এক্সপ্রেশন। উদাহরণস্বরূপ, নিম্নলিখিত ক্যোয়ারী ga:pageviews
এবং ga:browser
ভিউ (প্রোফাইল) 12134
জন্য ব্রাউজার অনুরোধ করেছে, যেখানে ga:browser
মাত্রা স্ট্রিং Firefox
দিয়ে শুরু হয়:
https://www.googleapis.com/analytics/v3/data/ga ?ids=ga:12134 &dimensions=ga:browser &metrics=ga:pageviews &filters=ga:browser%3D~%5EFirefox &start-date=2007-01-01 &end-date=2007-12-31
ফিল্টার করা প্রশ্নগুলি ফলাফলের অন্তর্ভুক্ত করে এমন সারিগুলিকে সীমাবদ্ধ করে (বা না করে)। ফলাফলের প্রতিটি সারি ফিল্টারটির বিপরীতে পরীক্ষা করা হয়: ফিল্টারটি যদি মেলে তবে সারিটি ধরে রাখা হয় এবং যদি এটি মেলে না তবে সারিটি বাদ দেওয়া হয়।
- ইউআরএল এনকোডিং : গুগল এপিআই ক্লায়েন্ট লাইব্রেরিগুলি স্বয়ংক্রিয়ভাবে ফিল্টার অপারেটরগুলিকে এনকোড করে।
- মাত্রা ফিল্টারিং : কোনও মাত্রা একত্রিত হওয়ার আগে ফিল্টারিং ঘটে, যাতে ফিরে আসা মেট্রিকগুলি কেবলমাত্র প্রাসঙ্গিক মাত্রার জন্য মোট উপস্থাপন করে। উপরের উদাহরণে, পৃষ্ঠাভিউগুলির সংখ্যা কেবলমাত্র সেই পৃষ্ঠাগুলি হবে যেখানে ফায়ারফক্স ব্রাউজার।
- মেট্রিক ফিল্টারিং : মেট্রিকগুলিতে ফিল্টারিং মেট্রিকগুলি একত্রিত হওয়ার পরে ঘটে।
- বৈধ সংমিশ্রণ : আপনি এমন একটি মাত্রা বা মেট্রিকের জন্য ফিল্টার করতে পারেন যা আপনার ক্যোয়ারির অংশ নয়, অনুরোধে সমস্ত মাত্রা/মেট্রিক সরবরাহ করে এবং ফিল্টারটি বৈধ সংমিশ্রণ। উদাহরণস্বরূপ, আপনি কোনও নির্দিষ্ট ব্রাউজারে ফিল্টারিং, পৃষ্ঠাভিউগুলির একটি তারিখের তালিকার জন্য জিজ্ঞাসা করতে চাইতে পারেন। আরও তথ্যের জন্য মাত্রা এবং মেট্রিক রেফারেন্স দেখুন।
ফিল্টার সিনট্যাক্স
একটি একক ফিল্টার ফর্মটি ব্যবহার করে:
ga:name operator expression
এই সিনট্যাক্সে:
- নাম - ফিল্টার করতে মাত্রা বা মেট্রিকের নাম। উদাহরণস্বরূপ:
ga:pageviews
মেট্রিকের ফিল্টারগুলি। - অপারেটর - ব্যবহারের জন্য ফিল্টার ম্যাচের ধরণটি সংজ্ঞায়িত করে। অপারেটরগুলি হয় মাত্রা বা মেট্রিকগুলির জন্য নির্দিষ্ট।
- এক্সপ্রেশন - ফলাফলগুলি থেকে অন্তর্ভুক্ত বা বাদ দেওয়া মানগুলি বলে। এক্সপ্রেশনগুলি নিয়মিত এক্সপ্রেশন সিনট্যাক্স ব্যবহার করে।
ফিল্টার অপারেটর
মাত্রাগুলির জন্য ছয়টি ফিল্টার অপারেটর এবং মেট্রিকের জন্য ছয়টি ফিল্টার অপারেটর রয়েছে। ইউআরএল ক্যোয়ারী স্ট্রিংগুলিতে অন্তর্ভুক্ত করার জন্য অপারেটরদের অবশ্যই ইউআরএল-এনকোড করা উচিত।
টিপ : ইউআরএল এনকোডিংয়ের প্রয়োজন এমন ফিল্টারগুলি ডিজাইন করতে ডেটা ফিড ক্যোয়ারী এক্সপ্লোরার ব্যবহার করুন, যেহেতু ক্যোয়ারী এক্সপ্লোরার স্বয়ংক্রিয়ভাবে স্ট্রিং এবং স্পেসযুক্ত ইউআরএলগুলিকে এনকোড করে।
অপারেটর | বর্ণনা | ইউআরএল এনকোডেড ফর্ম | উদাহরণ |
---|---|---|---|
== | সমান | %3D%3D | ফলাফলের ফলাফলগুলি যেখানে পৃষ্ঠায় সময় ঠিক দশ সেকেন্ড:filters=ga:timeOnPage%3D%3D10 |
!= | সমান না | !%3D | ফলাফলের ফলাফলগুলি যেখানে পৃষ্ঠায় সময় দশ সেকেন্ড নয় :filters=ga:timeOnPage!%3D10 |
> | অপেক্ষা বৃহত্তর | %3E | ফলাফলের ফলাফলগুলি যেখানে পৃষ্ঠায় সময়টি দশ সেকেন্ডের চেয়ে কঠোরভাবে বেশি:filters=ga:timeOnPage%3E10 |
< | থেকে কম | %3C | ফলাফলের ফলাফলগুলি যেখানে পৃষ্ঠায় সময়টি কঠোরভাবে দশ সেকেন্ডেরও কম থাকে:filters=ga:timeOnPage%3C10 |
>= | এর চেয়ে বড় বা সমান | %3E%3D | রিটার্ন ফলাফল যেখানে পৃষ্ঠায় সময় দশ সেকেন্ড বা তার বেশি হয়:filters=ga:timeOnPage%3E%3D10 |
<= | অপেক্ষাকৃত ছোট বা সমান | %3C%3D | রিটার্ন ফলাফল যেখানে পৃষ্ঠায় সময় দশ সেকেন্ড বা তার চেয়ে কম হয়:filters=ga:timeOnPage%3C%3D10 |
অপারেটর | বর্ণনা | ইউআরএল এনকোডেড ফর্ম | উদাহরণ |
---|---|---|---|
== | খাপে খাপ | %3D%3D | সমষ্টিগত মেট্রিকগুলি যেখানে শহরটি ইরভিন :filters=ga:city%3D%3DIrvine |
!= | মেলে না | !%3D | সমষ্টিগত মেট্রিকগুলি যেখানে শহরটি ইরভিন নয় :filters=ga:city!%3DIrvine |
=@ | সাবস্ট্রিং রয়েছে | %3D@ | সমষ্টিগত মেট্রিকগুলি যেখানে শহরে ইয়র্ক রয়েছে:filters=ga:city%3D@York |
!@ | সাবস্ট্রিং নেই | !@ | সমষ্টিগত মেট্রিকগুলি যেখানে শহরে ইয়র্ক থাকে না:filters=ga:city!@York |
=~ | নিয়মিত অভিব্যক্তির জন্য একটি ম্যাচ রয়েছে | %3D~ | সমষ্টিগত মেট্রিকগুলি যেখানে শহরটি নতুন দিয়ে শুরু হয়:filters=ga:city%3D~%5ENew.* (%5e হ'ল URL টি ^ অক্ষর থেকে এনকোড করা হয়েছে যা স্ট্রিংয়ের শুরুতে একটি প্যাটার্নকে নোঙ্গর করে)) |
!~ | নিয়মিত অভিব্যক্তির সাথে মেলে না | !~ | সমষ্টিগত মেট্রিকগুলি যেখানে শহরটি নতুন দিয়ে শুরু হয় না:filters=ga:city!~%5ENew.* |
এক্সপ্রেশন ফিল্টার করুন
ফিল্টার এক্সপ্রেশনগুলির জন্য বেশ কয়েকটি গুরুত্বপূর্ণ নিয়ম রয়েছে:
- ইউআরএল-রক্ষিত অক্ষর -যেমন
&
অবশ্যই URL- এনকোড করা উচিত। - সংরক্ষিত চরিত্রগুলি - সেমিকোলন এবং কমা অবশ্যই কোনও অভিব্যক্তিতে উপস্থিত হলে ব্যাকস্ল্যাশকে অবশ্যই পালাতে হবে:
- সেমিকোলন
\;
- কমা
\,
- সেমিকোলন
- নিয়মিত এক্সপ্রেশন - আপনি
=~
এবং!~
অপারেটরগুলি ব্যবহার করে ফিল্টার এক্সপ্রেশনগুলিতে নিয়মিত এক্সপ্রেশনগুলিও ব্যবহার করতে পারেন। তাদের সিনট্যাক্সটি পার্ল নিয়মিত অভিব্যক্তির অনুরূপ এবং এই অতিরিক্ত নিয়ম রয়েছে:- সর্বাধিক 128 অক্ষরের দৈর্ঘ্য - 128 টির চেয়ে বেশি দীর্ঘ নিয়মিত এক্সপ্রেশনগুলির ফলে
400 Bad Request
স্থিতি কোড সার্ভার থেকে ফিরে আসে। - কেস সংবেদনশীলতা -নিয়মিত অভিব্যক্তি ম্যাচিং কেস-সংবেদনশীল।
- সর্বাধিক 128 অক্ষরের দৈর্ঘ্য - 128 টির চেয়ে বেশি দীর্ঘ নিয়মিত এক্সপ্রেশনগুলির ফলে
ফিল্টার সংমিশ্রণ
ফিল্টারগুলি OR
এবং AND
বুলিয়ান লজিক ব্যবহার করে একত্রিত করা যেতে পারে। এটি আপনাকে ফিল্টার এক্সপ্রেশনটির 128 চরিত্রের সীমা কার্যকরভাবে প্রসারিত করতে দেয়।
বা
OR
অপারেটরটি একটি কমা ( ,
) ব্যবহার করে সংজ্ঞায়িত করা হয়। এটি AND
অপারেটরের চেয়ে অগ্রাধিকার নেয় এবং একই অভিব্যক্তিতে মাত্রা এবং মেট্রিকগুলি একত্রিত করতে ব্যবহৃত হতে পারে না।
উদাহরণ: (প্রতিটি অবশ্যই ইউআরএল এনকোড করা উচিত)
দেশ হয় হয় (মার্কিন যুক্তরাষ্ট্র বা কানাডা):
ga:country==United%20States,ga:country==Canada
(উইন্ডোজ বা ম্যাকিনটোস) অপারেটিং সিস্টেমে ফায়ারফক্স ব্যবহারকারীরা:
ga:browser==Firefox;ga:operatingSystem==Windows,ga:operatingSystem==Macintosh
এবং
AND
অপারেটরটি একটি আধা-কলোন ( ;
) ব্যবহার করে সংজ্ঞায়িত করা হয়। এটি OR
অপারেটর দ্বারা পূর্ববর্তী এবং একই অভিব্যক্তিতে মাত্রা এবং মেট্রিকগুলি একত্রিত করতে ব্যবহার করা যেতে পারে।
উদাহরণ: (প্রতিটি অবশ্যই ইউআরএল এনকোড করা উচিত)
দেশটি মার্কিন যুক্তরাষ্ট্র এবং ব্রাউজারটি ফায়ারফক্স:
ga:country==United%20States;ga:browser==Firefox
দেশটি মার্কিন যুক্তরাষ্ট্র এবং ভাষা 'এন' দিয়ে শুরু হয় না:
ga:country==United%20States;ga:language!~^en.*
অপারেটিং সিস্টেমটি (উইন্ডোজ বা ম্যাকিনটোস) এবং ব্রাউজারটি (ফায়ারফক্স বা ক্রোম):
ga:operatingSystem==Windows,ga:operatingSystem==Macintosh;ga:browser==Firefox,ga:browser==Chrome
দেশটি মার্কিন যুক্তরাষ্ট্র এবং সেশনগুলি 5 এর চেয়ে বেশি:
ga:country==United%20States;ga:sessions>5
সেগমেন্ট
segment=gaid::-10
segment=sessions::condition::ga:medium%3D%3Dreferral
segment=users::condition::ga:browser%3D%3DChrome
মূল প্রতিবেদন এপিআই -তে কোনও বিভাগের জন্য কীভাবে অনুরোধ করবেন সে সম্পর্কে সম্পূর্ণ তথ্যের জন্য বিভাগগুলি ডেভ গাইড দেখুন।
বিভাগগুলির একটি ধারণাগত ওভারভিউয়ের জন্য, সহায়তা কেন্দ্রে বিভাগগুলি বৈশিষ্ট্য রেফারেন্স এবং বিভাগগুলি দেখুন।
বিভাগগুলিতে অনুমোদিত মাত্রা এবং মেট্রিকগুলি।
সমস্ত মাত্রা এবং মেট্রিকগুলি বিভাগগুলিতে ব্যবহার করা যায় না। বিভাগগুলিতে কোন মাত্রা এবং মেট্রিকের অনুমতি রয়েছে তা পর্যালোচনা করতে মাত্রা এবং মেট্রিক এক্সপ্লোরারটি পরিদর্শন করে।
স্যাম্পলিংলভেল
samplingLevel=DEFAULT
-
DEFAULT
- একটি নমুনা আকারের সাথে প্রতিক্রিয়া ফেরত দেয় যা গতি এবং নির্ভুলতার ভারসাম্য বজায় রাখে। -
FASTER
- একটি ছোট নমুনার আকারের সাথে একটি দ্রুত প্রতিক্রিয়া প্রদান করে। -
HIGHER_PRECISION
- একটি বৃহত নমুনার আকার ব্যবহার করে আরও সঠিক প্রতিক্রিয়া প্রদান করে তবে এর ফলে প্রতিক্রিয়াটি ধীর হতে পারে।
DEFAULT
স্যাম্পলিং স্তরটি ব্যবহার করা হবে।খালি-সারি অন্তর্ভুক্ত করুন
include-empty-rows=true
শুরু-সূচক
start-index=10
1
। ( max-results
totalResults
1
-ভিত্তিক 0
অর্থা 10,001 এবং এর বাইরেও।সর্বোচ্চ-ফলাফল
max-results=100
start-index
সাথে সংমিশ্রণে এটি ব্যবহার করতে পারেন, বা প্রথমটি দিয়ে শুরু করে ফিরে আসা উপাদানগুলির সংখ্যা সীমাবদ্ধ করতে একা এটি ব্যবহার করতে পারেন। যদি max-results
সরবরাহ না করা হয় তবে ক্যোয়ারী ডিফল্ট সর্বোচ্চ 1000 সারি দেয়।ga:country
জন্য 300 টিরও কম সম্ভাব্য মান রয়েছে, সুতরাং যখন কেবল দেশে বিভাগ করা হয়, আপনি max-results
উচ্চতর মান হিসাবে নির্ধারণ করলেও আপনি 300 টিরও বেশি সারি পেতে পারবেন না।আউটপুট
output=dataTable
-
json
- একটি জেএসএন অবজেক্টযুক্ত প্রতিক্রিয়াতে ডিফল্টrows
সম্পত্তি আউটপুট করে। -
dataTable
- একটি ডেটা টেবিল অবজেক্টযুক্ত প্রতিক্রিয়াতে একটিdataTable
সম্পত্তি আউটপুট দেয়। এইData Table
অবজেক্টটি সরাসরি গুগল চার্ট ভিজ্যুয়ালাইজেশনের সাথে ব্যবহার করা যেতে পারে।
ক্ষেত্র
fields=rows,columnHeaders(name,dataType)
আংশিক প্রতিক্রিয়াতে কোন ক্ষেত্রগুলি ফিরে আসতে কোন ক্ষেত্রগুলি নির্দিষ্ট করে। আপনি যদি কেবল এপিআই প্রতিক্রিয়াতে ক্ষেত্রগুলির একটি উপসেট ব্যবহার করেন তবে কোন ক্ষেত্রগুলি অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করতে আপনি fields
প্যারামিটারটি ব্যবহার করতে পারেন।
ক্ষেত্রগুলির অনুরোধ প্যারামিটার মানটির ফর্ম্যাটটি xpath সিনট্যাক্সের উপর ভিত্তি করে আলগাভাবে। সমর্থিত সিনট্যাক্সটি নীচে সংক্ষিপ্ত করা হয়েছে।
- একাধিক ক্ষেত্র নির্বাচন করতে কমা-বিচ্ছিন্ন তালিকা ব্যবহার করুন।
- ক্ষেত্রের মধ্যে বাস করা একটি ক্ষেত্র বি নির্বাচন করতে
a/b
ব্যবহার করুন; খের মধ্যে নেস্টেড ফিল্ড সি নির্বাচন করতেa/b/c
ব্যবহার করুন। - প্রথম বন্ধনীতে এক্সপ্রেশন রেখে অ্যারে বা অবজেক্টের নির্দিষ্ট উপ-ক্ষেত্রের একটি সেট অনুরোধ করতে একটি উপ-নির্বাচনকারী ব্যবহার করুন
"( )"
।
উদাহরণস্বরূপ:fields=columnHeaders(name,dataType)
columnHeaders
অ্যারেতে কেবলname
এবংdataType
ক্ষেত্রগুলি প্রদান করে। আপনি একটি একক উপ-ক্ষেত্রও নির্দিষ্ট করতে পারেন, যেখানেfields=columnHeader(name)
fields=columnHeader/name
সমতুল্য।
prettyPrint
prettyPrint=false
true
হলে একটি মানব-পঠনযোগ্য ফর্ম্যাটে প্রতিক্রিয়া প্রদান করে। ডিফল্ট মান: false
।
কোটাউজার
quotaUser=4kh4r2h4
ব্যবহারকারীর আইপি ঠিকানা অজানা থাকলেও আপনাকে সার্ভার-সাইড অ্যাপ্লিকেশন থেকে প্রতি-ব্যবহারকারী কোটা প্রয়োগ করতে দেয়। এটি ঘটতে পারে, উদাহরণস্বরূপ, এমন অ্যাপ্লিকেশনগুলির সাথে যা কোনও ব্যবহারকারীর পক্ষে অ্যাপ ইঞ্জিনে ক্রোন কাজ চালায়। আপনি কোনও স্বেচ্ছাসেবী স্ট্রিং চয়ন করতে পারেন যা কোনও ব্যবহারকারীকে অনন্যভাবে সনাক্ত করে তবে এটি 40 টি অক্ষরের মধ্যে সীমাবদ্ধ।
উভয় সরবরাহ করা হলে এটি userIp
ওভাররাইড করে।
প্রতিক্রিয়া
যদি সফল হয় তবে এই অনুরোধটি নীচে সংজ্ঞায়িত JSON কাঠামোর সাথে একটি প্রতিক্রিয়া বডি ফেরত দেয়। যদি আউটপুট প্যারামিটারটি dataTable
সেট করা থাকে তবে অনুরোধটি নীচে সংজ্ঞায়িত JSON (ডেটা টেবিল) কাঠামোর সাথে একটি প্রতিক্রিয়া বডি ফেরত দেয়।
দ্রষ্টব্য : "ফলাফল" শব্দটি ক্যোয়ারির সাথে মেলে এমন সারিগুলির পুরো সেটকে বোঝায়, যখন "প্রতিক্রিয়া" ফলাফলের বর্তমান পৃষ্ঠায় ফিরে আসা সারিগুলির সেটকে বোঝায়। আইটেমসপেজে বর্ণিত হিসাবে মোট সংখ্যার ফলাফলগুলি বর্তমান প্রতিক্রিয়ার জন্য পৃষ্ঠার আকারের চেয়ে বেশি হলে এগুলি আলাদা হতে পারে।
{
"kind": "analytics#gaData",
"id": string,
"selfLink": string,
"containsSampledData": boolean,
"query": {
"start-date": string,
"end-date": string,
"ids": string,
"dimensions": [
string
],
"metrics": [
string
],
"include-empty-rows": boolean
"samplingLevel": string,
"sort": [
string
],
"filters": string,
"segment": string,
"start-index": integer,
"max-results": integer
},
"itemsPerPage": integer,
"totalResults": integer,
"previousLink": string,
"nextLink": string,
"profileInfo": {
"profileId": string,
"accountId": string,
"webPropertyId": string,
"internalWebPropertyId": string,
"profileName": string,
"tableId": string
},
"columnHeaders": [
{
"name": string,
"columnType": string,
"dataType": string
}
],
"rows": [
[
string
]
],
"sampleSize": string,
"sampleSpace": string,
"totalsForAllResults": [
{
metricName: string,
...
}
]
}
প্রতিক্রিয়া ক্ষেত্র
প্রতিক্রিয়া শরীরের কাঠামোর বৈশিষ্ট্যগুলি নিম্নলিখিত হিসাবে সংজ্ঞায়িত করা হয়েছে:
সম্পত্তির নাম | মান | বর্ণনা |
---|---|---|
kind | string | রিসোর্স টাইপ। মানটি "অ্যানালিটিক্স#গ্যাডাটা"। |
id | string | এই ডেটা প্রতিক্রিয়া জন্য একটি আইডি। |
query | object | এই অবজেক্টে ক্যোয়ারিতে পরামিতি হিসাবে পাস করা সমস্ত মান রয়েছে। প্রতিটি ক্ষেত্রের অর্থ এর সাথে সম্পর্কিত ক্যোয়ারী প্যারামিটারের বিবরণে ব্যাখ্যা করা হয়। |
query.start-date | string | শুরুর তারিখ. |
query.end-date | string | শেষ তারিখ. |
query.ids | string | অনন্য টেবিল আইডি। |
query.dimensions[] | list | বিশ্লেষণ মাত্রার তালিকা। |
query.metrics[] | list | বিশ্লেষণ মেট্রিকের তালিকা। |
query.samplingLevel | string | Requested sampling level. |
query.include-empty-rows | boolean | সত্য হিসাবে ডিফল্ট; যদি মিথ্যা সেট করা হয় তবে সারিগুলি যেখানে সমস্ত মেট্রিক মান শূন্য থাকে তা প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। |
query.sort[] | list | মেট্রিক বা মাত্রার তালিকা যেখানে ডেটা বাছাই করা হয়। |
query.filters | string | মেট্রিক বা মাত্রা ফিল্টারগুলির কমা-বিচ্ছিন্ন তালিকা। |
query.segment | string | বিশ্লেষণ বিভাগ। |
query.start-index | integer | সূচক শুরু করুন। |
query.max-results | integer | প্রতি পৃষ্ঠায় সর্বোচ্চ ফলাফল। |
startIndex | integer | start-index ক্যোয়ারী প্যারামিটার দ্বারা নির্দিষ্ট সারিগুলির প্রারম্ভিক সূচক। ডিফল্ট মান হল 1। |
itemsPerPage | integer | প্রত্যাবর্তিত সারিগুলির প্রকৃত সংখ্যা নির্বিশেষে প্রতিক্রিয়াটিতে সর্বাধিক সংখ্যক সারি থাকতে পারে। যদি max-results ক্যোয়ারী প্যারামিটারটি নির্দিষ্ট করা থাকে তবে itemsPerPage মান max-results বা 10,000 এর চেয়ে ছোট। itemsPerPage ডিফল্ট মান 1000। |
totalResults | integer | প্রশ্নের ফলাফলে সারির মোট সংখ্যা, উত্তরে যত সারির সংখ্যাই থাকুক না কেন। প্রচুর পরিমাণে সারিগুলির ফলাফলের জন্য, totalResults itemsPerPage চেয়ে বেশি হতে পারে। বৃহত্তর প্রশ্নের জন্য totalResults এবং itemsPerPage আরও ব্যাখ্যা করার জন্য পেজিং দেখুন। |
startDate | string | start-date প্যারামিটার দ্বারা উল্লিখিত হিসাবে ডেটা ক্যোয়ারির জন্য শুরু করার তারিখ। |
endDate | string | end-date প্যারামিটার দ্বারা উল্লিখিত হিসাবে ডেটা ক্যোয়ারির জন্য শেষ তারিখ। |
selfLink | string | এই ডেটা ক্যোয়ারির জন্য ফলাফলের এই পৃষ্ঠায় লিঙ্ক করুন। |
previousLink | string | এই ডেটা ক্যোয়ারির জন্য ফলাফলের পূর্ববর্তী পৃষ্ঠায় লিঙ্ক। |
nextLink | string | এই ডেটা ক্যোয়ারির জন্য ফলাফলের পরবর্তী পৃষ্ঠায় লিঙ্ক করুন। |
profileInfo | object | ভিউ (প্রোফাইল) সম্পর্কে তথ্য যার জন্য ডেটা অনুরোধ করা হয়েছিল। গুগল অ্যানালিটিক্স ম্যানেজমেন্ট এপিআইয়ের মাধ্যমে দেখুন (প্রোফাইল) ডেটা উপলব্ধ। |
profileInfo.profileId | string | দেখুন (প্রোফাইল) আইডি, যেমন 1174 । |
profileInfo.accountId | string | অ্যাকাউন্ট আইডি যার সাথে এই ভিউ (প্রোফাইল) এর অন্তর্গত, যেমন 30481 । |
profileInfo.webPropertyId | string | ওয়েব প্রপার্টি আইডি যার সাথে এই দৃশ্য (প্রোফাইল) এর সাথে সম্পর্কিত, যেমন UA-30481-1 । |
profileInfo.internalWebPropertyId | string | ওয়েব সম্পত্তির জন্য অভ্যন্তরীণ আইডি যেখানে এই ভিউ (প্রোফাইল) এর সাথে সম্পর্কিত, যেমন UA-30481-1 । |
profileInfo.profileName | string | দৃশ্যের নাম (প্রোফাইল)। |
profileInfo.tableId | string | ভিউ (প্রোফাইল) এর জন্য টেবিল আইডি, "জিএ:" এর পরে ভিউ (প্রোফাইল) আইডি রয়েছে। |
containsSampledData | boolean | সত্য যদি প্রতিক্রিয়াটিতে নমুনাযুক্ত ডেটা থাকে। |
sampleSize | string | নমুনাযুক্ত ডেটা গণনা করতে ব্যবহৃত নমুনার সংখ্যা। |
sampleSpace | string | মোট নমুনা স্থান আকার। এটি মোট উপলভ্য নমুনা স্থানের আকার নির্দেশ করে যা থেকে নমুনাগুলি নির্বাচন করা হয়েছিল। |
columnHeaders[] | list | কলাম শিরোনামগুলি মেট্রিকের নামগুলি অনুসরণ করে মাত্রার নামগুলি তালিকা করে। ডাইমেনশন এবং মেট্রিকের ক্রমটি metrics এবং dimensions পরামিতিগুলির মাধ্যমে অনুরোধে উল্লিখিত হিসাবে একই। শিরোনামের সংখ্যা হ'ল মাত্রার সংখ্যা + মেট্রিকের সংখ্যা। |
columnHeaders[].name | string | মাত্রা বা মেট্রিকের নাম। |
columnHeaders[].columnType | string | কলাম প্রকার। হয় "মাত্রা" বা "মেট্রিক"। |
columnHeaders[].dataType | string | ডেটা টাইপ। মাত্রা কলামের শিরোনামগুলিতে কেবল ডেটা টাইপ হিসাবে STRING থাকে। মেট্রিক কলাম শিরোনামগুলিতে মেট্রিক মানগুলির জন্য ডেটা প্রকার রয়েছে যেমন INTEGER , PERCENT , TIME , CURRENCY , FLOAT ইত্যাদি সম্ভাব্য সমস্ত ডেটা ধরণের জন্য মেটাডেটা এপিআই প্রতিক্রিয়া দেখুন। |
totalsForAllResults | object | মেট্রিক নাম এবং মানগুলির কী-মান জোড়া হিসাবে অনুরোধ করা মেট্রিকগুলির জন্য মোট মান। মেট্রিকের মোটের ক্রমটি অনুরোধে উল্লিখিত মেট্রিক অর্ডার হিসাবে একই। |
rows[] | list | অ্যানালিটিক্স ডেটা সারি, যেখানে প্রতিটি সারিতে মেট্রিক মানগুলির পরে মাত্রা মানগুলির একটি তালিকা থাকে। ডাইমেনশনস এবং মেট্রিকের ক্রমটি অনুরোধে উল্লিখিত হিসাবে একই। প্রতিটি সারিতে এন ক্ষেত্রগুলির একটি তালিকা রয়েছে, যেখানে এন = মাত্রার সংখ্যা + মেট্রিকের সংখ্যা। |
{
"kind": "analytics#gaData",
"id": string,
"selfLink": string,
"containsSampledData": boolean,
"query": {
"start-date": string,
"end-date": string,
"ids": string,
"dimensions": [
string
],
"metrics": [
string
],
"samplingLevel": string,
"include-empty-rows": boolean,
"sort": [
string
],
"filters": string,
"segment": string,
"start-index": integer,
"max-results": integer
},
"itemsPerPage": integer,
"totalResults": integer,
"previousLink": string,
"nextLink": string,
"profileInfo": {
"profileId": string,
"accountId": string,
"webPropertyId": string,
"internalWebPropertyId": string,
"profileName": string,
"tableId": string
},
"columnHeaders": [
{
"name": string,
"columnType": string,
"dataType": string
}
],
"dataTable": {
"cols": [
{
"id": string,
"label": string,
"type": string
}
],
"rows": [
{
"c": [
{
"v": string
}
]
}
]
},
"sampleSize": string,
"sampleSpace": string,
"totalsForAllResults": [
{
metricName: string,
...
}
]
}
প্রতিক্রিয়া ক্ষেত্র
প্রতিক্রিয়া শরীরের কাঠামোর বৈশিষ্ট্যগুলি নিম্নলিখিত হিসাবে সংজ্ঞায়িত করা হয়েছে:
সম্পত্তির নাম | মান | বর্ণনা |
---|---|---|
kind | string | রিসোর্স টাইপ। মানটি "অ্যানালিটিক্স#গ্যাডাটা"। |
id | string | এই ডেটা প্রতিক্রিয়া জন্য একটি আইডি। |
query | object | এই অবজেক্টে ক্যোয়ারিতে পরামিতি হিসাবে পাস করা সমস্ত মান রয়েছে। প্রতিটি ক্ষেত্রের অর্থ এর সাথে সম্পর্কিত ক্যোয়ারী প্যারামিটারের বিবরণে ব্যাখ্যা করা হয়। |
query.start-date | string | শুরুর তারিখ. |
query.end-date | string | শেষ তারিখ. |
query.ids | string | অনন্য টেবিল আইডি। |
query.dimensions[] | list | বিশ্লেষণ মাত্রার তালিকা। |
query.metrics[] | list | বিশ্লেষণ মেট্রিকের তালিকা। |
query.samplingLevel | string | Requested sampling level. |
query.include-empty-rows | boolean | সত্য হিসাবে ডিফল্ট; যদি মিথ্যা সেট করা হয় তবে সারিগুলি যেখানে সমস্ত মেট্রিক মান শূন্য থাকে তা প্রতিক্রিয়া থেকে বাদ দেওয়া হবে। |
query.sort[] | list | মেট্রিক বা মাত্রার তালিকা যেখানে ডেটা বাছাই করা হয়। |
query.filters | string | মেট্রিক বা মাত্রা ফিল্টারগুলির কমা-বিচ্ছিন্ন তালিকা। |
query.segment | string | বিশ্লেষণ বিভাগ। |
query.start-index | integer | সূচক শুরু করুন। |
query.max-results | integer | প্রতি পৃষ্ঠায় সর্বোচ্চ ফলাফল। |
startIndex | integer | start-index ক্যোয়ারী প্যারামিটার দ্বারা নির্দিষ্ট সারিগুলির প্রারম্ভিক সূচক। ডিফল্ট মান হল 1। |
itemsPerPage | integer | প্রত্যাবর্তিত সারিগুলির প্রকৃত সংখ্যা নির্বিশেষে প্রতিক্রিয়াটিতে সর্বাধিক সংখ্যক সারি থাকতে পারে। যদি max-results ক্যোয়ারী প্যারামিটারটি নির্দিষ্ট করা থাকে তবে itemsPerPage মান max-results বা 10,000 এর চেয়ে ছোট। itemsPerPage ডিফল্ট মান 1000। |
totalResults | integer | প্রশ্নের ফলাফলে সারির মোট সংখ্যা, উত্তরে যত সারির সংখ্যাই থাকুক না কেন। প্রচুর পরিমাণে সারিগুলির ফলাফলের জন্য, totalResults itemsPerPage চেয়ে বেশি হতে পারে। বৃহত্তর প্রশ্নের জন্য totalResults এবং itemsPerPage আরও ব্যাখ্যা করার জন্য পেজিং দেখুন। |
startDate | string | start-date প্যারামিটার দ্বারা উল্লিখিত হিসাবে ডেটা ক্যোয়ারির জন্য শুরু করার তারিখ। |
endDate | string | end-date প্যারামিটার দ্বারা উল্লিখিত হিসাবে ডেটা ক্যোয়ারির জন্য শেষ তারিখ। |
selfLink | string | এই ডেটা ক্যোয়ারির জন্য ফলাফলের এই পৃষ্ঠায় লিঙ্ক করুন। |
previousLink | string | এই ডেটা ক্যোয়ারির জন্য ফলাফলের পূর্ববর্তী পৃষ্ঠায় লিঙ্ক। |
nextLink | string | এই ডেটা ক্যোয়ারির জন্য ফলাফলের পরবর্তী পৃষ্ঠায় লিঙ্ক করুন। |
profileInfo | object | ভিউ (প্রোফাইল) সম্পর্কে তথ্য যার জন্য ডেটা অনুরোধ করা হয়েছিল। গুগল অ্যানালিটিক্স ম্যানেজমেন্ট এপিআইয়ের মাধ্যমে দেখুন (প্রোফাইল) ডেটা উপলব্ধ। |
profileInfo.profileId | string | দেখুন (প্রোফাইল) আইডি, যেমন 1174 । |
profileInfo.accountId | string | অ্যাকাউন্ট আইডি যার সাথে এই ভিউ (প্রোফাইল) এর অন্তর্গত, যেমন 30481 । |
profileInfo.webPropertyId | string | ওয়েব প্রপার্টি আইডি যার সাথে এই দৃশ্য (প্রোফাইল) এর সাথে সম্পর্কিত, যেমন UA-30481-1 । |
profileInfo.internalWebPropertyId | string | ওয়েব সম্পত্তির জন্য অভ্যন্তরীণ আইডি যেখানে এই ভিউ (প্রোফাইল) এর সাথে সম্পর্কিত, যেমন UA-30481-1 । |
profileInfo.profileName | string | দৃশ্যের নাম (প্রোফাইল)। |
profileInfo.tableId | string | ভিউ (প্রোফাইল) এর জন্য টেবিল আইডি, "জিএ:" এর পরে ভিউ (প্রোফাইল) আইডি রয়েছে। |
containsSampledData | boolean | সত্য যদি প্রতিক্রিয়াটিতে নমুনাযুক্ত ডেটা থাকে। |
sampleSize | string | নমুনাযুক্ত ডেটা গণনা করতে ব্যবহৃত নমুনার সংখ্যা। |
sampleSpace | string | মোট নমুনা স্থান আকার। এটি মোট উপলভ্য নমুনা স্থানের আকার নির্দেশ করে যা থেকে নমুনাগুলি নির্বাচন করা হয়েছিল। |
columnHeaders[] | list | কলাম শিরোনামগুলি মেট্রিকের নামগুলি অনুসরণ করে মাত্রার নামগুলি তালিকা করে। ডাইমেনশন এবং মেট্রিকের ক্রমটি metrics এবং dimensions পরামিতিগুলির মাধ্যমে অনুরোধে উল্লিখিত হিসাবে একই। শিরোনামের সংখ্যা হ'ল মাত্রার সংখ্যা + মেট্রিকের সংখ্যা। |
columnHeaders[].name | string | মাত্রা বা মেট্রিকের নাম। |
columnHeaders[].columnType | string | কলাম প্রকার। হয় "মাত্রা" বা "মেট্রিক"। |
columnHeaders[].dataType | string | ডেটা টাইপ। মাত্রা কলামের শিরোনামগুলিতে কেবল ডেটা টাইপ হিসাবে STRING থাকে। মেট্রিক কলাম শিরোনামগুলিতে মেট্রিক মানগুলির জন্য ডেটা প্রকার রয়েছে যেমন INTEGER , PERCENT , TIME , CURRENCY , FLOAT ইত্যাদি সম্ভাব্য সমস্ত ডেটা ধরণের জন্য মেটাডেটা এপিআই প্রতিক্রিয়া দেখুন। |
totalsForAllResults | object | মেট্রিক নাম এবং মানগুলির কী-মান জোড়া হিসাবে অনুরোধ করা মেট্রিকগুলির জন্য মোট মান। মেট্রিকের মোটের ক্রমটি অনুরোধে উল্লিখিত মেট্রিক অর্ডার হিসাবে একই। |
dataTable | object | একটি ডেটা টেবিল অবজেক্ট যা গুগল চার্টগুলির সাথে ব্যবহার করা যেতে পারে। |
dataTable.cols[] | list | মেট্রিকগুলি অনুসরণ করে মাত্রাগুলির জন্য কলাম বর্ণনাকারীর একটি তালিকা। ডাইমেনশন এবং মেট্রিকের ক্রমটি metrics এবং dimensions পরামিতিগুলির মাধ্যমে অনুরোধে উল্লিখিত হিসাবে একই। কলামগুলির সংখ্যা হ'ল মাত্রার সংখ্যা + মেট্রিকের সংখ্যা। |
dataTable.cols[].id | string | একটি আইডি, যা একটি নির্দিষ্ট কলাম (কলাম সূচকগুলি ব্যবহারের বিকল্প হিসাবে) উল্লেখ করতে ব্যবহার করা যেতে পারে। এই মানটি সেট করতে মাত্রা বা মেট্রিক আইডি ব্যবহৃত হয়। |
dataTable.cols[].label | string | কলামের জন্য একটি লেবেল (যা ভিজ্যুয়ালাইজেশন দ্বারা প্রদর্শিত হতে পারে)। এই মানটি সেট করতে মাত্রা বা মেট্রিক আইডি ব্যবহৃত হয়। |
dataTable.cols[].type | string | এই কলামটির জন্য ডেটা টাইপ। |
dataTable.rows[] | list | ডেটা টেবিল ফর্ম্যাটে অ্যানালিটিক্স ডেটা সারিগুলি, যেখানে প্রতিটি সারি হ'ল একটি অবজেক্ট যা মেট্রিকগুলি অনুসরণ করে মাত্রাগুলির জন্য কোষের মানগুলির একটি তালিকাযুক্ত। ডাইমেনশনস এবং মেট্রিকের ক্রমটি অনুরোধে উল্লিখিত হিসাবে একই। প্রতিটি কক্ষে এন ক্ষেত্রগুলির একটি তালিকা রয়েছে, যেখানে এন = মাত্রার সংখ্যা + মেট্রিকের সংখ্যা। |
ত্রুটি কোড
কোর রিপোর্টিং এপিআই একটি অনুরোধ সফল হলে 200
এইচটিটিপি স্থিতি কোড প্রদান করে। যদি কোনও ক্যোয়ারির প্রক্রিয়াকরণের সময় কোনও ত্রুটি দেখা দেয় তবে এপিআই একটি ত্রুটি কোড এবং বিবরণ দেয়। প্রতিটি অ্যাপ্লিকেশন যা বিশ্লেষণ এপিআই ব্যবহার করে তা যুক্তি হ্যান্ডলিং লজিককে যথাযথ ত্রুটি প্রয়োগ করতে হবে। ত্রুটি কোডগুলি এবং সেগুলি কীভাবে পরিচালনা করবেন সে সম্পর্কে বিশদগুলির জন্য, ত্রুটি প্রতিক্রিয়া রেফারেন্স গাইডটি পড়ুন।
এটা চেষ্টা করুন!
আপনি কোর রিপোর্টিং এপিআইয়ের প্রশ্নগুলি চেষ্টা করে দেখতে পারেন।
একটি ক্যোয়ারিতে মেট্রিক এবং মাত্রাগুলির বৈধ সংমিশ্রণগুলি দেখতে, ক্যোয়ারী এক্সপ্লোরারটিতে পরামিতিগুলির জন্য নমুনা মান লিখুন। নমুনা ক্যোয়ারির ফলাফলগুলি সমস্ত নির্দিষ্ট মেট্রিক এবং মাত্রার মান সহ একটি টেবিল হিসাবে দেখানো হয়।
লাইভ ডেটাতে একটি অনুরোধ করতে এবং জেএসএন ফর্ম্যাটে প্রতিক্রিয়া দেখতে, গুগল ডেটা এপিআইএস এক্সপ্লোরারটিতে
analytics.data.ga.get
পদ্ধতিটি ব্যবহার করে দেখুন।
স্যাম্পলিং
গুগল অ্যানালিটিক্স ফ্লাইতে মাত্রা এবং মেট্রিকগুলির কয়েকটি সংমিশ্রণ গণনা করে। যুক্তিসঙ্গত সময়ে ডেটা ফিরিয়ে দিতে, গুগল অ্যানালিটিক্স কেবল ডেটার একটি নমুনা প্রক্রিয়া করতে পারে।
আপনি স্যাম্পলিংলভেল প্যারামিটারটি সেট করে অনুরোধের জন্য ব্যবহার করতে স্যাম্পলিং স্তরটি নির্দিষ্ট করতে পারেন।
যদি কোনও কোর রিপোর্টিং এপিআই প্রতিক্রিয়াতে নমুনাযুক্ত ডেটা থাকে, তবে containsSampledData
প্রতিক্রিয়া ক্ষেত্রটি রয়েছে true
। তদতিরিক্ত, 2 টি বৈশিষ্ট্য ক্যোয়ারির জন্য নমুনা স্তর সম্পর্কে তথ্য সরবরাহ করবে: sampleSize
এবং sampleSpace
। এই 2 টি মানের সাথে আপনি ক্যোয়ারির জন্য ব্যবহৃত সেশনগুলির শতাংশ গণনা করতে পারেন। উদাহরণস্বরূপ, যদি sampleSize
201,000
এবং sampleSpace
220,000
হয় তবে প্রতিবেদনটি (201,000 / 220,000) * 100 = 91.36% সেশনের উপর ভিত্তি করে।
স্যাম্পলিংয়ের একটি সাধারণ বিবরণের জন্য এবং এটি কীভাবে গুগল অ্যানালিটিক্সে ব্যবহৃত হয় তার জন্য নমুনা দেখুন।
বড় ডেটা ফলাফল পরিচালনা করা
যদি আপনি আপনার ক্যোয়ারীটি কোনও বৃহত ফলাফলের সেটটি ফিরিয়ে আনার প্রত্যাশা করেন তবে আপনার এপিআই ক্যোয়ারীটি অনুকূল করতে, ত্রুটিগুলি এড়াতে এবং কোটা ওভাররনগুলি হ্রাস করতে সহায়তা করতে নীচের নির্দেশিকাগুলি ব্যবহার করুন। নোট করুন যে আমরা যে কোনও একটি এপিআই অনুরোধে সর্বাধিক 7 টি মাত্রা এবং 10 মেট্রিকের অনুমতি দিয়ে একটি পারফরম্যান্স বেসলাইন সেট করেছি। যদিও প্রচুর সংখ্যক মেট্রিক এবং মাত্রা নির্দিষ্ট করে এমন কিছু প্রশ্ন অন্যদের তুলনায় প্রক্রিয়া করতে বেশি সময় নিতে পারে, তবে অনুরোধ করা মেট্রিকগুলির সংখ্যা সীমাবদ্ধ করা ক্যোয়ারির কার্যকারিতা উন্নত করতে যথেষ্ট নাও হতে পারে। পরিবর্তে, আপনি সেরা পারফরম্যান্স ফলাফলের জন্য নিম্নলিখিত কৌশলগুলি ব্যবহার করতে পারেন।
কোয়েরিতে প্রতি মাত্রা হ্রাস করা
এপিআই যে কোনও একটি অনুরোধে 7 টি পর্যন্ত মাত্রা নির্দিষ্ট করার অনুমতি দেয়। অনেক সময়, গুগল অ্যানালিটিক্সকে অবশ্যই ফ্লাইতে এই জটিল প্রশ্নের ফলাফলগুলি গণনা করতে হবে। এটি বিশেষত সময়সাপেক্ষ হতে পারে যদি ফলাফল সারিগুলির সংখ্যা বেশি থাকে। উদাহরণস্বরূপ, কীওয়ার্ডগুলির জন্য জিজ্ঞাসা করা, সিটি বাই বাই ঘন্টা কয়েক মিলিয়ন সারি সারি ডেটা মেলে। আপনার ক্যোয়ারিতে মাত্রার সংখ্যা সীমাবদ্ধ করে গুগল অ্যানালিটিক্সের প্রয়োজনীয় সারিগুলির সংখ্যা হ্রাস করে আপনি কর্মক্ষমতা উন্নত করতে পারেন।
তারিখের পরিসীমা দ্বারা ক্যোয়ারী বিভক্ত করা
এক দীর্ঘ তারিখের পরিসীমাটির তারিখ-কীড ফলাফলের মাধ্যমে পেজিংয়ের পরিবর্তে, এক সপ্তাহের জন্য এক সপ্তাহের জন্য পৃথক ক্যোয়ারী গঠনের বিষয়টি বিবেচনা করুন-এমনকি একদিনও-এক সময়ে। অবশ্যই, একটি বৃহত ডেটা সেটের জন্য, এমনকি একক দিনের ডেটার জন্য একটি অনুরোধ max-results
চেয়ে বেশি ফিরে আসতে পারে, সেক্ষেত্রে পেজিং এড়ানো যায় না। তবে যে কোনও ক্ষেত্রে, যদি আপনার ক্যোয়ারির জন্য ম্যাচিং সারিগুলির সংখ্যা max-results
চেয়ে বেশি হয় তবে তারিখের পরিসীমাটি ভেঙে ফলাফলগুলি পুনরুদ্ধার করতে মোট সময় হ্রাস করতে পারে। এই পদ্ধতির একক থ্রেডড এবং সমান্তরাল উভয় প্রশ্নের মধ্যে কর্মক্ষমতা উন্নত করতে পারে।
পেজিং
ফলাফলের মাধ্যমে পেজিং পরিচালনাযোগ্য খণ্ডগুলিতে বড় ফলাফল সেটগুলি ভাঙ্গার একটি দরকারী উপায় হতে পারে। totalResults
ফিল্ডটি জানায় যে কতগুলি ম্যাচিং সারি বিদ্যমান রয়েছে এবং itemsPerPage
সর্বাধিক সংখ্যক সারি দেয় যা ফলাফলটিতে ফিরে আসতে পারে। যদি itemsPerPage
সাথে totalResults
উচ্চ অনুপাত থাকে তবে পৃথক অনুসন্ধানগুলি প্রয়োজনের চেয়ে বেশি সময় নিতে পারে। আপনার যদি কেবলমাত্র সীমিত সংখ্যক সারি প্রয়োজন হয় যেমন প্রদর্শনের উদ্দেশ্যে, আপনি max-results
প্যারামিটারের মাধ্যমে প্রতিক্রিয়া আকারের একটি সুস্পষ্ট সীমা সেট করা সুবিধাজনক বলে মনে করতে পারেন। তবে, যদি আপনার অ্যাপ্লিকেশনটির সম্পূর্ণরূপে ফলাফলের একটি বৃহত সেট প্রক্রিয়া করা প্রয়োজন, তবে সর্বাধিক অনুমোদিত সারিগুলির জন্য অনুরোধ করা আরও দক্ষ হতে পারে।
জিজিপ ব্যবহার করে
প্রতিটি অনুরোধের জন্য প্রয়োজনীয় ব্যান্ডউইথ হ্রাস করার একটি সহজ এবং সুবিধাজনক উপায় হ'ল জিজেডআইপি সংক্ষেপণ সক্ষম করা। যদিও ফলাফলগুলি সঙ্কুচিত করার জন্য এটির জন্য অতিরিক্ত সিপিইউ সময় প্রয়োজন, তবে নেটওয়ার্ক ব্যয় সহ ট্রেডঅফ সাধারণত এটি খুব সার্থক করে তোলে। একটি জিজিআইপি-এনকোডেড প্রতিক্রিয়া পাওয়ার জন্য আপনাকে অবশ্যই দুটি জিনিস করতে হবে: একটি Accept-Encoding
শিরোনাম সেট করুন এবং স্ট্রিং gzip
ধারণ করতে আপনার ব্যবহারকারী এজেন্টকে সংশোধন করুন। জিজিপ সংক্ষেপণ সক্ষম করার জন্য সঠিকভাবে গঠিত এইচটিটিপি শিরোনামগুলির একটি উদাহরণ এখানে রয়েছে:
Accept-Encoding: gzip User-Agent: my program (gzip)