কোর রিপোর্টিং API - রেফারেন্স গাইড

এই নথিটি কোর রিপোর্টিং 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 না পছন্দসই নমুনা স্তর। অনুমোদিত মান:
  • DEFAULT - একটি নমুনা আকারের সাথে প্রতিক্রিয়া প্রদান করে যা গতি এবং নির্ভুলতার ভারসাম্য বজায় রাখে।
  • FASTER — একটি ছোট নমুনা আকারের সাথে দ্রুত প্রতিক্রিয়া প্রদান করে।
  • HIGHER_PRECISION — একটি বড় নমুনা আকার ব্যবহার করে আরও সঠিক প্রতিক্রিয়া প্রদান করে, কিন্তু এর ফলে প্রতিক্রিয়া ধীর হতে পারে।
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
প্রয়োজন।
Analytics ডেটা পুনরুদ্ধার করতে ব্যবহৃত অনন্য আইডি। এই আইডিটি হল নেমস্পেস 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: ga:country ga: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
  1. ফিল্টার সিনট্যাক্স
  2. ফিল্টার অপারেটর
  3. এক্সপ্রেশন ফিল্টার করুন
  4. ফিল্টার সমন্বয়
ঐচ্ছিক।

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 স্ট্যাটাস কোড ফিরে আসে।
    • কেস সংবেদনশীলতা — নিয়মিত এক্সপ্রেশন ম্যাচিং কেস-সংবেদনশীল।

ফিল্টার সমন্বয়

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 সারি প্রদান করে।
অ্যানালিটিক্স কোর রিপোর্টিং এপিআই প্রতি অনুরোধে সর্বাধিক 10,000 সারি ফেরত দেয়, আপনি যতই জিজ্ঞাসা করুন না কেন। এটি অনুরোধের চেয়ে কম সারিও ফিরিয়ে দিতে পারে, যদি আপনার প্রত্যাশার মতো অনেক মাত্রার অংশ না থাকে। উদাহরণস্বরূপ, ga:country এর জন্য 300 টিরও কম সম্ভাব্য মান রয়েছে, তাই শুধুমাত্র দেশ অনুসারে বিভক্ত করার সময়, আপনি 300 টির বেশি সারি পেতে পারবেন না, এমনকি যদি আপনি max-results উচ্চতর মান সেট করেন।

আউটপুট

output=dataTable
ঐচ্ছিক।
প্রতিক্রিয়াতে ফিরে আসা অ্যানালিটিক্স ডেটার আউটপুট প্রকার সেট করতে এই প্যারামিটারটি ব্যবহার করুন। অনুমোদিত মান হল:
  • json — প্রতিক্রিয়াতে ডিফল্ট rows বৈশিষ্ট্য আউটপুট করে, একটি JSON অবজেক্ট ধারণ করে।
  • dataTable — প্রতিক্রিয়াতে একটি dataTable বৈশিষ্ট্য আউটপুট করে, একটি ডেটা টেবিল অবজেক্ট ধারণ করে। এই Data Table অবজেক্টটি সরাসরি Google চার্ট ভিজ্যুয়ালাইজেশনের সাথে ব্যবহার করা যেতে পারে।
সরবরাহ না করা হলে, ডিফল্ট JSON প্রতিক্রিয়া ব্যবহার করা হবে।

ক্ষেত্র

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 এ ব্যাখ্যা করা হয়েছে।

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 সম্পদের ধরন। মান হল "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 প্যারামিটার দ্বারা নির্দিষ্ট করা ডেটা কোয়েরির শেষ তারিখ।
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 = মাত্রার সংখ্যা + মেট্রিক্সের সংখ্যা।
JSON (ডেটা টেবিল)
{
  "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 প্যারামিটার দ্বারা নির্দিষ্ট করা ডেটা কোয়েরির শেষ তারিখ।
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)