Google Analytics কোর রিপোর্টিং API চেঞ্জলগ

আমরা পর্যায়ক্রমে Google Analytics কোর রিপোর্টিং এপিআই আপডেট করি যাতে নতুন বৈশিষ্ট্যগুলি সরবরাহ করা যায় এবং পূর্ববর্তী সংস্করণগুলিতে আবিষ্কৃত ত্রুটিগুলি মেরামত করা যায়৷ বেশিরভাগ ক্ষেত্রে, এই পরিবর্তনগুলি API বিকাশকারীদের কাছে স্বচ্ছ হবে৷ যাইহোক, মাঝে মাঝে আমাদের এমন পরিবর্তন করতে হবে যার জন্য ডেভেলপারদের তাদের বিদ্যমান অ্যাপ্লিকেশনগুলিকে সংশোধন করতে হবে।

এই পৃষ্ঠাটি Google অ্যানালিটিক্স কোর রিপোর্টিং এপিআই-তে করা যেকোনো পরিবর্তনের নথিভুক্ত করে যা আপনার অ্যাপ্লিকেশনকে প্রভাবিত করতে পারে। আমরা সুপারিশ করি যে API বিকাশকারীরা যেকোন নতুন ঘোষণার জন্য পর্যায়ক্রমে এই তালিকাটি পরীক্ষা করে দেখুন। আপনি নীচের সদস্যতা বিভাগের অধীনে তালিকাভুক্ত ফিডগুলির মাধ্যমে পরিবর্তনগুলিতে সদস্যতা নিতে পারেন৷

সম্পর্কিত চেঞ্জলগ সদস্যতা

সমস্ত Google Analytics API চেঞ্জলগ
-
সাবস্ক্রাইব আরএসএস

সমস্ত সংগ্রহ, কনফিগারেশন এবং রিপোর্টিং API অন্তর্ভুক্ত করে।

সমস্ত রিপোর্টিং API চেঞ্জলগ
-
সাবস্ক্রাইব আরএসএস

কোর রিপোর্টিং API, মাল্টি-চ্যানেল ফানেল রিপোর্টিং API, এবং রিয়েল টাইম রিপোর্টিং API অন্তর্ভুক্ত।

কোর রিপোর্টিং API চেঞ্জলগ
-
সাবস্ক্রাইব আরএসএস

এটি ব্যবহারকারীর কার্যকলাপ API-এর প্রাথমিক প্রকাশ

  • ইউজার অ্যাক্টিভিটি API আপনাকে একটি নির্দিষ্ট তারিখের সীমার মধ্যে একটি একক ক্লায়েন্ট আইডি বা ব্যবহারকারী আইডির সাথে সম্পর্কিত সমস্ত ডেটা পুনরুদ্ধার করতে দেয়। এটি প্রাথমিকভাবে সম্পত্তির মালিকদের সমর্থন করার উদ্দেশ্যে যারা ব্যবহারকারীর ডেটার স্বয়ংক্রিয় অ্যাক্সেস সরাসরি সেই ব্যবহারকারীকে প্রদান করতে চান। আরো বিস্তারিত জানার জন্য ব্যবহারকারী কার্যকলাপ API গাইড দেখুন.

এই রিলিজটি অ্যানালিটিক্স রিপোর্টিং এপিআই v4 ফলাফলে প্রত্যাবর্তিত সর্বাধিক সংখ্যক সারি বাড়ায়।

অ্যানালিটিক্স রিপোর্টিং API v4 ReportData অবজেক্টে প্রত্যাবর্তিত সারিগুলির সর্বাধিক সংখ্যা 10,000 থেকে 100,000 করা হয়েছে৷

এই রিলিজটি Google Analytics রিপোর্টিং API v4-এর জন্য রিসোর্স ভিত্তিক কোটা সিস্টেমের একটি পূর্বরূপ যোগ করে, যা Analytics 360 (প্রিমিয়াম) গ্রাহকদের জন্য উচ্চতর স্যাম্পলিং থ্রেশহোল্ড ব্যবহার করার অনুমতি দেয়।

এই রিলিজটি সম্পর্কিত পণ্য বৈশিষ্ট্য এবং সংশ্লিষ্ট মাত্রা এবং মেট্রিক্স অবমূল্যায়ন করে; সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন। ডেটা অপসারণের বিশদ বিবরণের জন্য ডেটা অবচয় নীতি পর্যালোচনা করুন:

এই রিলিজটি নিম্নলিখিত মাত্রা এবং মেট্রিকগুলিকে অবমূল্যায়ন করে:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

এই রিলিজটি API-তে একটি নতুন মাত্রা যোগ করে; সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন। এই রিলিজটি বেশ কিছু অবহেলিত মাত্রা এবং মেট্রিক্সও সরিয়ে দেয়; ডেটা অপসারণের সম্পূর্ণ প্রক্রিয়া বুঝতে Google Analytics API-এর জন্য ডেটা অবচয় নীতি পর্যালোচনা করুন।

সময়

  • নতুন মাত্রা ga:dateHourMinute , যা ga:date , ga:hour , এবং ga:minute কে একত্রিত করে।

ডেটা অপসারণ

এই রিলিজটি নিম্নোক্ত অপ্রচলিত মাত্রা এবং মেট্রিকগুলিকে সরিয়ে দেয়:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

এই রিলিজটি API-তে বিদ্যমান মেট্রিক্স এবং মাত্রা আপডেট করে। সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

ব্যবহারকারীর মেট্রিক্স

ব্যবহারকারী এবং সক্রিয় ব্যবহারকারীর মেট্রিক্সের গণনা আরও দক্ষতার সাথে ব্যবহারকারীদের গণনা করার জন্য আপডেট করা হয়েছে। আপনি আপনার মেট্রিক্সে একটি ছোট পরিবর্তন দেখতে পারেন। আরও তথ্যের জন্য অনুগ্রহ করে দেখুন কিভাবে ব্যবহারকারীদের ব্যবহারকারীদের মেট্রিক্সের জন্য চিহ্নিত করা হয় ।

গণনা আপডেট দ্বারা প্রভাবিত ব্যবহারকারীর মেট্রিক্স:

  • ga:users - অনুরোধ করা সময়ের জন্য মোট ব্যবহারকারীর সংখ্যা।
  • ga:1dayusers - অনুরোধ করা সময়ের মধ্যে প্রতিটি দিনের জন্য 1-দিনের সক্রিয় ব্যবহারকারীর মোট সংখ্যা।
  • ga:7dayusers - অনুরোধ করা সময়ের মধ্যে প্রতিটি দিনের জন্য 7-দিন সক্রিয় ব্যবহারকারীর মোট সংখ্যা।
  • ga:14dayusers - অনুরোধ করা সময়ের মধ্যে প্রতিটি দিনের জন্য 14-দিন সক্রিয় ব্যবহারকারীর মোট সংখ্যা।
  • ga:30dayusers - অনুরোধ করা সময়ের মধ্যে প্রতিটি দিনের জন্য 30-দিনের সক্রিয় ব্যবহারকারীর মোট সংখ্যা।

অনন্য ঘটনা

আমরা ga:uniqueEvents এর জন্য অবচয়নের সময়কাল শেষের কাছাকাছি চলে এসেছি। 26 মার্চ, 2017-এর পরে ga:uniqueEvents এর সংজ্ঞা আপডেট করা হবে এবং ব্যক্তিগত ga:uniqueEventsTemporary মেট্রিক API থেকে সরানো হবে। আরও তথ্যের জন্য, অনন্য ইভেন্ট সহায়তা নথি দেখুন।

এই রিলিজটি API-তে একটি নতুন মাত্রা যোগ করে, ত্রুটির বার্তাগুলিকে উন্নত করে এবং AdSense মাত্রা এবং মেট্রিক্সের জন্য পূর্বে ঘোষিত পরিবর্তনগুলি কার্যকর করা শুরু করে৷

ব্যবহারকারীর মাত্রা

  • মাত্রা - ga:userBucket - যে কোনো ব্যবহারকারীর জন্য, ব্যবহারকারীর বালতির মাত্রা (মান 1 থেকে 100) ব্যবহারকারীকে যে বালতিতে বরাদ্দ করা হয়েছে তা নির্দেশ করে। বিশদ বিবরণের জন্য পরীক্ষা পুনঃবিপণন প্রচার নিবন্ধ দেখুন।

ভুল বার্তা

যেখানে আগে API একটি ভুল ত্রুটি বার্তা, Unknown dimension(s): বা Unknown metric(s): পূরণ করা হয়নি এমন শর্তগুলির সাথে ডেটার অনুরোধ করার সময়, API এখন বার্তাটি ফেরত দেয়: Restricted metric(s): ... can only be queried under certain conditions.

AdSense মাত্রা এবং মেট্রিক্স

নন-AdSense লিঙ্কযুক্ত ভিউগুলি AdSense মাত্রা এবং মেট্রিক্সের জন্য অনুসন্ধান থেকে সীমাবদ্ধ থাকবে। একটি নন-AdSense লিঙ্কযুক্ত ভিউ সহ এই মাত্রা এবং মেট্রিক্সের জন্য অনুসন্ধান করলে একটি ত্রুটি দেখা দেবে।

এটি একটি বাগ ফিক্স রিলিজ, যা AdSense মাত্রা এবং মেট্রিক্সের একটি সমস্যা সমাধান করে এবং এই মাত্রা এবং মেট্রিক্সে একটি আসন্ন পরিবর্তন ঘোষণা করে।

AdSense মাত্রা এবং মেট্রিক্স

এই রিলিজটি 1/7/2017 থেকে শুরু হওয়া একটি সমস্যার সমাধান করেছে যেখানে AdSense মাত্রা এবং মেট্রিক্সের জন্য অনুসন্ধান করা অ-AdSense লিঙ্কড ভিউগুলির জন্য একটি "অজানা মেট্রিক" ত্রুটি ফিরিয়ে দেবে৷

আসছে পরিবর্তন

1/31/2017 তারিখে বা তার পরে নন-AdSense লিঙ্ক করা ভিউগুলি AdSense মাত্রা এবং মেট্রিক্সের জন্য অনুসন্ধান থেকে সীমাবদ্ধ থাকবে। একটি নন-AdSense লিঙ্কযুক্ত ভিউ সহ এই মাত্রা এবং মেট্রিক্সের জন্য অনুসন্ধান করলে একটি ত্রুটি দেখা দেবে।

এই রিলিজটি API-তে নিম্নলিখিত নতুন মেট্রিক যোগ করে। সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

গণনা করা মেট্রিক্স

এই রিলিজ গণনা করা মেট্রিক্সের জন্য সমর্থন যোগ করে।

  • মেট্রিক - ga:calcMetric_ - অনুরোধকৃত গণনা করা মেট্রিকের মান, কোথায় গণনা করা মেট্রিকের ব্যবহারকারী-সংজ্ঞায়িত নাম বোঝায়। মনে রাখবেন যে ga:calcMetric_ এর ডেটা প্রকার ফ্লোট, পূর্ণসংখ্যা, মুদ্রা, সময় বা শতাংশ হতে পারে। বিশদ বিবরণের জন্য, গণনা করা মেট্রিক্স সম্পর্কে দেখুন।

এই রিলিজ API এ একটি নতুন মেট্রিক যোগ করে। এটি একটি বিদ্যমান মেট্রিককে অবমূল্যায়ন করে। সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

ইভেন্ট ট্র্যাকিং

ga:uniqueEvents এর সংজ্ঞা অনন্য ইভেন্টের সংখ্যাকে আরও সঠিকভাবে প্রতিফলিত করতে পরিবর্তিত হবে। এই পরিবর্তনকে প্রভাবিত করতে, আমরা প্রযুক্তিগতভাবে বর্তমান ga:uniqueEvents মেট্রিককে আমাদের ডেটা অবচয় নীতি অনুসারে অবমূল্যায়ন করব। আপনি যদি নতুন সংজ্ঞাটি চেষ্টা করতে চান তবে আপনি ব্যক্তিগত মেট্রিক ga:uniqueEventsTemporary উল্লেখ করতে পারেন, যা অনন্য ইভেন্টের সংখ্যা আরও সঠিকভাবে গণনা করে। এছাড়াও আমরা একটি নতুন মেট্রিক ga:uniqueDimensionCombinations প্রবর্তন করব যা ga: ga:uniqueEvents এর বর্তমান সংজ্ঞা বজায় রাখে। সঠিক অবচয় সময়কালের পরে (প্রায় 6 মাস), ব্যক্তিগত মেট্রিক ga:uniqueEventsTemporary সরানো হবে এবং আসল মেট্রিক ga:uniqueEvents সঠিকভাবে অনন্য ইভেন্টের সংখ্যা উপস্থাপন করবে। আরও তথ্যের জন্য, অনন্য ইভেন্ট সহায়তা নথি দেখুন।

অনন্য ঘটনা

  • মেট্রিক - ga:uniqueEvents - অনন্য ইভেন্টের সংখ্যা আরও সঠিকভাবে প্রতিফলিত করতে ga:uniqueEvents এর সংজ্ঞা শীঘ্রই পরিবর্তিত হবে। আপনি যদি বিদ্যমান সংজ্ঞা ধরে রাখতে চান তাহলে অনুগ্রহ করে এর পরিবর্তে ga:uniqueDimensionCombinations ব্যবহার করুন। আরও তথ্যের জন্য, অনন্য ইভেন্ট সহায়তা নথি দেখুন।
  • মেট্রিক - ga:uniqueDimensionCombinations - অনন্য মাত্রা সমন্বয় একটি প্রতিবেদনে প্রতিটি মাত্রার জন্য অনন্য মাত্রা-মানের সমন্বয়ের সংখ্যা গণনা করে। এটি আপনাকে সম্মিলিত (সংযুক্ত) মাত্রা পোস্ট-প্রসেসিং তৈরি করতে দেয়, যা আপনার ট্র্যাকিং বাস্তবায়ন আপডেট না করে বা অতিরিক্ত কাস্টম-ডাইমেনশন স্লট ব্যবহার না করেই আরও নমনীয় রিপোর্টিংয়ের অনুমতি দেয়। আরও তথ্যের জন্য, অনন্য ইভেন্ট সহায়তা নথি দেখুন।

ট্রানজিশন টেস্টিং - ব্যক্তিগত

  • মেট্রিক - ga:uniqueEventsTemporary - অনন্য ইভেন্টের সংখ্যা; এটি ga:uniqueEvents এর জন্য নতুন সংজ্ঞা হবে। আপনি পরিবর্তনের আগে নতুন সংজ্ঞা বুঝতে এই মেট্রিক ব্যবহার করতে পারেন। মনে রাখবেন এই মেট্রিকটি ব্যক্তিগত এবং এটি মাত্রা এবং মেট্রিক্স রেফারেন্সে প্রদর্শিত হবে না।

এই রিলিজ API এ নতুন মাত্রা এবং মেট্রিক্স যোগ করে। সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

DoubleClick বিড ম্যানেজার

  • মাত্রা - ga:dbmClickAdvertiser - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM বিজ্ঞাপনদাতার নাম (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dbmClickAdvertiserId - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM বিজ্ঞাপনদাতা আইডি (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickCreativeId - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM ক্রিয়েটিভ আইডি (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickExchange - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM এক্সচেঞ্জ নাম (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dbmClickExchangeId - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM এক্সচেঞ্জ আইডি (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickInsertionOrder - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM সন্নিবেশ অর্ডারের নাম (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickInsertionOrderId - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM সন্নিবেশ অর্ডার আইডি (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickLineItem - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM লাইন আইটেম নাম (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dbmClickLineItemId - Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের DBM লাইন আইটেম আইডি (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickSite - DBM সাইটের নাম যেখানে DBM ক্রিয়েটিভ দেখানো হয়েছে এবং Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের জন্য ক্লিক করা হয়েছে (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmClickSiteId - DBM সাইট আইডি যেখানে DBM ক্রিয়েটিভ দেখানো হয়েছে এবং Google Analytics সেশনের সাথে মিলে যাওয়া DBM ক্লিকের জন্য ক্লিক করা হয়েছে (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventAdvertiser - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM বিজ্ঞাপনদাতার নাম (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventAdvertiserId - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM বিজ্ঞাপনদাতা আইডি (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক করুন) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventCreativeId - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM ক্রিয়েটিভ আইডি (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventExchange - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM বিনিময় নাম (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক করুন) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • ডাইমেনশন - ga:dbmLastEventExchangeId - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM এক্সচেঞ্জ আইডি (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক করুন) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventInsertionOrder - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM সন্নিবেশ অর্ডারের নাম (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক করুন) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventInsertionOrderId - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM সন্নিবেশ অর্ডার আইডি (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক করুন) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventLineItem - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM লাইন আইটেমের নাম (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventLineItemId - Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের DBM লাইন আইটেম আইডি (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক) (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventSite - DBM সাইটের নাম যেখানে DBM ক্রিয়েটিভ দেখানো হয়েছিল এবং Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক) জন্য ক্লিক করা হয়েছিল (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dbmLastEventSiteId - DBM সাইট আইডি যেখানে DBM ক্রিয়েটিভ দেখানো হয়েছিল এবং Google Analytics সেশনের সাথে যুক্ত শেষ DBM ইভেন্টের জন্য (ইম্প্রেশন বা DBM লুকব্যাক উইন্ডোর মধ্যে ক্লিক) ক্লিক করা হয়েছিল (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmCPA - DBM রাজস্ব eCPA (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmCPC - DBM রাজস্ব eCPC (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmCPM - DBM রাজস্ব eCPM (শুধুমাত্র Analytics 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmCTR - DBM CTR (শুধুমাত্র অ্যানালিটিক্স 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmClicks - DBM মোট ক্লিক (শুধুমাত্র Analytics 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmConversions - DBM মোট রূপান্তর (শুধুমাত্র Analytics 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmCost - DBM খরচ (শুধুমাত্র Analytics 360, DBM-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmImpressions - DBM মোট ইম্প্রেশন (শুধুমাত্র Analytics 360, DBM এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মেট্রিক - ga:dbmROAS - DBM ROAS (শুধুমাত্র Analytics 360, DBM-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsAdGroup - DS Ad Group (শুধুমাত্র Analytics 360, DS-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dsAdGroupId - DS বিজ্ঞাপন গ্রুপ আইডি (শুধুমাত্র বিশ্লেষণ 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsAdvertiser - DS Advertiser (শুধুমাত্র Analytics 360, DS-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dsAdvertiserId - DS Advertiser ID (শুধুমাত্র Analytics 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsAgency - DS Agency (শুধুমাত্র Analytics 360, DS এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dsAgencyId - DS এজেন্সি আইডি (শুধুমাত্র অ্যানালিটিক্স 360, ডিএস-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dsCampaign - DS প্রচারাভিযান (শুধুমাত্র Analytics 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsCampaignId - DS ক্যাম্পেইন আইডি (শুধুমাত্র অ্যানালিটিক্স 360, ডিএসের সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsEngineAccount - DS ইঞ্জিন অ্যাকাউন্ট (শুধুমাত্র Analytics 360, DS-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • মাত্রা - ga:dsEngineAccountId - DS ইঞ্জিন অ্যাকাউন্ট আইডি (শুধুমাত্র Analytics 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsKeyword - DS কীওয়ার্ড (শুধুমাত্র Analytics 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • মাত্রা - ga:dsKeywordId - DS কীওয়ার্ড আইডি (শুধুমাত্র অ্যানালিটিক্স 360, ডিএসের সাথে একীকরণ প্রয়োজন)।
  • ga:dsCPC - প্রতি ক্লিকে বিজ্ঞাপনদাতার জন্য DS খরচ (শুধুমাত্র Analytics 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • ga:dsCTR - ডিএস ক্লিক থ্রু রেট (শুধুমাত্র অ্যানালিটিক্স 360, ডিএসের সাথে একীকরণ প্রয়োজন)।
  • ga:dsClicks - DS ক্লিক (শুধুমাত্র Analytics 360, DS-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • ga:dsCost - DS খরচ (শুধুমাত্র Analytics 360, DS-এর সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • ga:dsImpressions - DS ইমপ্রেশন (শুধুমাত্র অ্যানালিটিক্স 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • ga:dsProfit - DS Profie (শুধুমাত্র Analytics 360, DS-এর সাথে একীকরণ প্রয়োজন)।
  • ga:dsReturnOnAdSpend - DS রিটার্ন অন অ্যাড স্পেন্ড (শুধুমাত্র অ্যানালিটিক্স 360, ডিএসের সাথে ইন্টিগ্রেশন প্রয়োজন)।
  • ga:dsRevenuePerClick - প্রতি ক্লিকে DS আয় (শুধুমাত্র অ্যানালিটিক্স 360, DS-এর সাথে একীকরণ প্রয়োজন)।

এই রিলিজ API এ একটি নতুন মাত্রা যোগ করে। এই রিলিজটি মাত্রার সংমিশ্রণে কিছু বিধিনিষেধও যোগ করে যা একসাথে জিজ্ঞাসা করা যেতে পারে। সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

জিও নেটওয়ার্ক

  • মাত্রা - ga:continentId - ব্যবহারকারীদের মহাদেশ আইডি, ব্যবহারকারীদের IP ঠিকানা বা ভৌগলিক আইডি থেকে প্রাপ্ত।

বিধিনিষেধ

নিম্নলিখিত গোষ্ঠীগুলির নিম্নোক্ত মাত্রাগুলি অন্যান্য গোষ্ঠীর মাত্রাগুলির সাথে জিজ্ঞাসা করা যাবে না:

  • শপিং ইনফো গ্রুপে যান
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO এক্সপেরিমেন্ট গ্রুপ
    • ga:experimentVariant
    • ga:experimentId
  • সুদ গ্রুপ
    • ga:interestOtherCategory
  • মার্কেট ইন্টারেস্ট গ্রুপে
    • ga:interestInMarketCategory
  • অভ্যন্তরীণ প্রচার গ্রুপ:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • ব্র্যান্ডিং আগ্রহ গ্রুপ:
    • ga:interestAffinityCategory

এই রিলিজ নতুন সীমা এবং কোটা প্রবর্তন. বিস্তারিত জানার জন্য সীমা এবং কোটা ডকুমেন্টেশন দেখুন।

রিপোর্টিং ত্রুটি

এই রিলিজটি ব্যর্থ ( 5XX ) রিপোর্টিং অনুরোধের সীমা কার্যকর করা শুরু করে।

  • প্রতি ঘন্টায় প্রতি প্রোফাইল প্রতি প্রকল্পে 10টি ব্যর্থ অনুরোধ।
  • প্রতি দিন প্রোফাইল প্রতি প্রকল্প প্রতি 50টি ব্যর্থ অনুরোধ।

পিভট সীমা

এই রিলিজটি পিভট অনুরোধে সীমা কার্যকর করা শুরু করে:

  • একটি প্রতিবেদনের অনুরোধে এখন সর্বাধিক 2টি পিভট থাকতে পারে৷
  • একটি পিভটের সর্বোচ্চ ৪টি মাত্রা থাকতে পারে।
  • পিভট মাত্রা অনুরোধে অনুমোদিত মাত্রার মোট সংখ্যার সীমাবদ্ধতার অংশ।
  • পিভট মেট্রিক্স হল অনুরোধে অনুমোদিত মেট্রিকের মোট সংখ্যার সীমাবদ্ধতার অংশ।

এই রিলিজ API এ নতুন মাত্রা এবং মেট্রিক্স যোগ করে। সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

জিও নেটওয়ার্ক

  • মাত্রা - ga:metroId - তিন অঙ্কের নির্ধারিত বাজার এলাকা (DMA) কোড যেখান থেকে ট্রাফিক এসেছে, ব্যবহারকারীদের IP ঠিকানা বা ভৌগলিক আইডি থেকে প্রাপ্ত।

প্রকাশকদের জন্য DoubleClick

  • মেট্রিক - ga:dfpImpressions - যখনই ওয়েবসাইটে একটি পৃথক বিজ্ঞাপন প্রদর্শিত হয় তখন একটি DFP বিজ্ঞাপনের ছাপ রিপোর্ট করা হয়। উদাহরণস্বরূপ, যদি দুটি বিজ্ঞাপন ইউনিট সহ একটি পৃষ্ঠা একবার দেখা হয়, আমরা দুটি ইমপ্রেশন প্রদর্শন করব (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব সক্ষম নয় লুকান)।
  • মেট্রিক - ga:dfpCoverage - কভারেজ হল বিজ্ঞাপন অনুরোধের শতাংশ যা অন্তত একটি বিজ্ঞাপন ফেরত দিয়েছে। সাধারণত, কভারেজ এমন সাইটগুলি সনাক্ত করতে সাহায্য করতে পারে যেখানে DFP অ্যাকাউন্ট লক্ষ্যযুক্ত বিজ্ঞাপন দিতে সক্ষম নয়৷ (বিজ্ঞাপন ইম্প্রেশন / মোট বিজ্ঞাপন অনুরোধ) * 100 (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpMonetizedPageviews - এটি লিঙ্ক করা DFP অ্যাকাউন্ট থেকে একটি বিজ্ঞাপনের সাথে দেখানো সম্পত্তির মোট পৃষ্ঠা দর্শনের সংখ্যা পরিমাপ করে। মনে রাখবেন যে একটি একক পৃষ্ঠায় একাধিক বিজ্ঞাপন ইউনিট থাকতে পারে (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpImpressionsPerSession - অ্যানালিটিক্স সেশনের সাথে DFP বিজ্ঞাপন ইম্প্রেশনের অনুপাত (বিজ্ঞাপন ইম্প্রেশন / অ্যানালিটিক্স সেশন) (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpViewableImpressionsPercent - দর্শনযোগ্য বিজ্ঞাপন ইম্প্রেশনের শতাংশ। একটি ইমপ্রেশন একটি দর্শনযোগ্য ইম্প্রেশন হিসাবে বিবেচিত হয় যখন এটি ব্যবহারকারীদের ব্রাউজারে উপস্থিত হয় এবং দেখার সুযোগ থাকে (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpClicks - সাইটে কতবার DFP বিজ্ঞাপনে ক্লিক করা হয়েছে (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpCTR - একটি DFP বিজ্ঞাপনে ক্লিকের ফলে পৃষ্ঠা দর্শনের শতাংশ (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpRevenue - DFP রাজস্ব হল পরিবেশিত ইম্প্রেশনের উপর ভিত্তি করে মোট বিজ্ঞাপন আয়ের একটি অনুমান (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpRevenuePer1000Sessions - প্রতি 1,000 Analytics সেশনে DFP বিজ্ঞাপন থেকে মোট আনুমানিক আয়। মনে রাখবেন যে এই মেট্রিকটি সাইটের সেশনের উপর ভিত্তি করে, বিজ্ঞাপন ইম্প্রেশনের উপর নয় (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:dfpECPM - প্রতি হাজার পেজভিউ কার্যকরী খরচ। এটি প্রতি 1,000 পেজভিউ (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়) প্রতি DFP আয়।
  • মেট্রিক - ga:backfillImpressions - ব্যাকফিল ইমপ্রেশন হল সমস্ত AdSense বা Ad Exchance বিজ্ঞাপন ইম্প্রেশনের সমষ্টি যা DFP এর মাধ্যমে ব্যাকফিল হিসাবে পরিবেশিত হয়। যখনই একটি পৃথক বিজ্ঞাপন ওয়েবসাইটে প্রদর্শিত হয় তখন একটি বিজ্ঞাপনের ছাপ রিপোর্ট করা হয়। উদাহরণস্বরূপ, যদি দুটি বিজ্ঞাপন ইউনিট সহ একটি পৃষ্ঠা একবার দেখা হয়, আমরা দুটি ইমপ্রেশন প্রদর্শন করব (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব সক্ষম নয় লুকান)।
  • মেট্রিক - ga:backfillCoverage - ব্যাকফিল কভারেজ হল ব্যাকফিল বিজ্ঞাপনের অনুরোধের শতাংশ যা কমপক্ষে একটি বিজ্ঞাপন ফেরত দিয়েছে। সাধারণত, কভারেজ এমন সাইটগুলি সনাক্ত করতে সাহায্য করতে পারে যেখানে প্রকাশক অ্যাকাউন্ট লক্ষ্যযুক্ত বিজ্ঞাপন সরবরাহ করতে সক্ষম নয়। (বিজ্ঞাপন ইম্প্রেশন / মোট বিজ্ঞাপন অনুরোধ) * 100. যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের ওজনযুক্ত গড় (DFP লিঙ্কিং সক্ষম এবং DFP আয় লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillMonetizedPageviews - এটি লিঙ্ক করা ব্যাকফিল অ্যাকাউন্ট(গুলি) থেকে কমপক্ষে একটি বিজ্ঞাপনের সাথে দেখানো সম্পত্তিতে মোট পৃষ্ঠা দর্শনের সংখ্যা পরিমাপ করে। মনে রাখবেন যে একটি একক নগদীকৃত পৃষ্ঠাদর্শনে একাধিক বিজ্ঞাপন ইম্প্রেশন অন্তর্ভুক্ত থাকতে পারে (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillImpressionsPerSession - অ্যানালিটিক্স সেশনে ব্যাকফিল বিজ্ঞাপন ইম্প্রেশনের অনুপাত (বিজ্ঞাপন ইম্প্রেশন / অ্যানালিটিক্স সেশন)। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের সমষ্টি (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillViewableImpressionsPercent - ব্যাকফিল বিজ্ঞাপন ইম্প্রেশনের শতাংশ যা দর্শনযোগ্য ছিল। একটি ইমপ্রেশন একটি দর্শনযোগ্য ছাপ হিসাবে বিবেচিত হয় যখন এটি ব্যবহারকারীদের ব্রাউজারে উপস্থিত হয় এবং দেখার সুযোগ ছিল। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের ওজনযুক্ত গড় (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillClicks - সাইটে যতবার ব্যাকফিল বিজ্ঞাপন ক্লিক করা হয়েছে। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের সমষ্টি (DFP লিঙ্কিং সক্ষম এবং DFP আয় লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillCTR - ব্যাকফিল ইম্প্রেশনের শতাংশ যা একটি বিজ্ঞাপনে ক্লিকের ফলে। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের ওজনযুক্ত গড় (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillRevenue - ব্যাকফিল বিজ্ঞাপন থেকে মোট আনুমানিক আয়। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের সমষ্টি (DFP লিঙ্কিং সক্ষম এবং DFP আয় লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillRevenuePer1000Sessions - প্রতি 1,000 Analytics সেশনে ব্যাকফিল বিজ্ঞাপন থেকে মোট আনুমানিক আয়। মনে রাখবেন যে এই মেট্রিকটি সাইটের সেশনের উপর ভিত্তি করে এবং বিজ্ঞাপনের ইম্প্রেশন নয়। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের সমষ্টি (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।
  • মেট্রিক - ga:backfillECPM - প্রতি হাজার পেজভিউ কার্যকরী খরচ। এটি প্রতি 1,000 পৃষ্ঠা দর্শনে DFP ব্যাকফিল আয়। যদি AdSense এবং Ad Exchange উভয়ই ব্যাকফিল বিজ্ঞাপন প্রদান করে, তাহলে এই মেট্রিক হল দুটি ব্যাকফিল অ্যাকাউন্টের সমষ্টি (DFP লিঙ্কিং সক্ষম এবং DFP রাজস্ব লুকান সক্ষম নয়)।

এটি একটি বাগ ফিক্স রিলিজ, যা সেগমেন্ট এবং নমুনা নিয়ে একটি সমস্যা সমাধান করে।

সেগমেন্ট

এই রিলিজটি একটি সমস্যার সমাধান করে যার ফলে সমস্ত ব্যবহারকারীর সেগমেন্ট ( gaid::-1 ) এর সাথে অনুরোধের একটি উপসেট কোর রিপোর্টিং API V3-এ কম গণনা করা হবে এবং Analytics রিপোর্টিং API V4- এ দুটি বিভাগে বিভক্ত হবে।

স্যাম্পলিং

এই রিলিজটি একটি সমস্যা সমাধান করে যেখানে কাস্টম টেবিল থেকে অনুরোধের একটি উপসেট নমুনাযুক্ত ডেটা ফেরত দেবে।

এটি একটি বাগ ফিক্স রিলিজ, যা অ্যানালিটিক্স রিপোর্টিং API V4 কোহর্ট অনুরোধ করার সময় একটি সমস্যা সমাধান করে।

দলগত অনুরোধ

কোহর্টের অনুরোধগুলি এখন সমস্ত সমগোত্রীয় মাত্রার জন্য জিজ্ঞাসা করতে পারে; ga:acquisition... মাত্রার জন্য অনুরোধ করার সময় পূর্বে API একটি ত্রুটি প্রদান করবে।

আজীবন মূল্য অনুরোধ LTV

অনুগ্রহ করে মনে রাখবেন যে আজীবন মূল্যের অনুরোধগুলি শুধুমাত্র অ্যাপ দেখার জন্য আজীবন মূল্য প্রতিবেদন তৈরি করতে পারে।

এই রিলিজটি API-এর একটি নতুন সংস্করণ ঘোষণা করে, অ্যানালিটিক্স রিপোর্টিং API V4 । এই নতুন API হল Google Analytics-এ রিপোর্ট ডেটা অ্যাক্সেস করার জন্য সবচেয়ে উন্নত প্রোগ্রামেটিক পদ্ধতি।

মূল বৈশিষ্ট্য

Google Analytics একটি শক্তিশালী ডেটা রিপোর্টিং পরিকাঠামোর উপর নির্মিত। API ডেভেলপারদের Google Analytics প্ল্যাটফর্মের শক্তিতে অ্যাক্সেস দেয়। অ্যানালিটিক্স রিপোর্টিং API V4-এর কিছু মূল বৈশিষ্ট্যগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:

  • মেট্রিক এক্সপ্রেশন - এপিআই আপনাকে শুধুমাত্র অন্তর্নির্মিত মেট্রিক্সই নয় গাণিতিক মেট্রিক এক্সপ্রেশনের জন্যও অনুরোধ করতে দেয়। উদাহরণস্বরূপ, প্রতিটি সেশনের সংখ্যার লক্ষ্য পূরণকে অনুরোধে ga:goal1completions/ga:sessions হিসাবে প্রকাশ করা যেতে পারে।
  • একাধিক তারিখের ব্যাপ্তি - দুটি তারিখের সীমার অনুরোধ করার জন্য সমর্থন, আপনাকে একটি অনুরোধে দুটি সময়ের জন্য ডেটা তুলনা করার অনুমতি দেয়।
  • কোহর্ট এবং লাইফটাইম ভ্যালু - কোহোর্ট এবং লাইফটাইম ভ্যালু রিপোর্টের জন্য অনুরোধ করার জন্য API-এর একটি সমৃদ্ধ শব্দভাণ্ডার রয়েছে।
  • একাধিক সেগমেন্ট - আপনি এখন একটি অনুরোধে একাধিক সেগমেন্টের অনুরোধ করতে পারেন।

শুরু হচ্ছে

API এর সাথে শুরু করার সমস্ত বিবরণের জন্য বিকাশকারী ডকুমেন্টেশন দেখুন।

কোটা নীতি

Analytics রিপোর্টিং API V4 এর নিজস্ব কোটা এবং সীমা রয়েছে ; যেহেতু এটি একটি নতুন API, তাই এই সীমা এবং কোটা পরিবর্তন করা যেতে পারে।

মাইগ্রেশন

একটি মাইগ্রেশন গাইডের সাথে, আমরা Github- এ একটি পাইথন সামঞ্জস্যপূর্ণ লাইব্রেরিও উপলব্ধ করি।

মাত্রা এবং মেট্রিক্স

এই রিলিজটি বিশেষত অ্যানালিটিক্স রিপোর্টিং API V4 এর জন্য মাত্রা এবং মেট্রিক্সের একটি সেট যোগ করে। সম্পূর্ণ তালিকার সংজ্ঞার জন্য মাত্রা এবং মেট্রিক্স এক্সপ্লোরার দেখুন।

  • মাত্রা - ga:cohort - সমগোত্রীয় সংজ্ঞার উপর ভিত্তি করে একজন ব্যবহারকারীর অন্তর্গত সমষ্টির নাম। সমদলকে কীভাবে সংজ্ঞায়িত করা হয় তার উপর নির্ভর করে, একজন ব্যবহারকারী একাধিক সমগোত্রীয় হতে পারে, একইভাবে একজন ব্যবহারকারী একাধিক বিভাগের অন্তর্গত হতে পারে।

  • মাত্রা - ga:cohortNthDay - সমগোত্রীয় সংজ্ঞা তারিখের সাথে সম্পর্কিত 0-ভিত্তিক দিনের অফসেট। উদাহরণস্বরূপ, যদি একটি দলকে প্রথম দর্শনের তারিখ 2015-09-01 হিসাবে সংজ্ঞায়িত করা হয়, তাহলে 2015-09-04 তারিখের জন্য, ga:cohortNthDay হবে 3৷

  • ga:cohortNthMonth - সমগোত্রীয় সংজ্ঞা তারিখের সাথে সম্পর্কিত 0-ভিত্তিক মাস অফসেট।

  • মাত্রা - ga:cohortNthWeek - সমগোত্রীয় সংজ্ঞা তারিখের সাথে সম্পর্কিত 0-ভিত্তিক সপ্তাহ অফসেট।

  • মাত্রা - ga:acquisitionTrafficChannel - ট্রাফিক চ্যানেল যার মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। এটি ব্যবহারকারীর প্রথম সেশন থেকে বের করা হয়। ব্যবহারকারী অধিগ্রহণের সময় ডিফল্ট চ্যানেল গ্রুপিং নিয়মের উপর ভিত্তি করে ট্রাফিক চ্যানেল গণনা করা হয় (উপলভ্য হলে ভিউ লেভেলে)।

  • মাত্রা - ga:acquisitionSource - যে উৎসের মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। ব্যবহারকারীর প্রথম সেশন থেকে প্রাপ্ত।

  • মাত্রা - ga:acquisitionMedium - যে মাধ্যমটির মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। ব্যবহারকারীর প্রথম সেশন থেকে প্রাপ্ত।

  • মাত্রা - ga:acquisitionSourceMedium - ga:userAcquisitionSource এবং ga:acquisitionMedium-এর সম্মিলিত মান।

  • মাত্রা - ga:acquisitionCampaign যে প্রচারণার মাধ্যমে ব্যবহারকারী অর্জিত হয়েছিল। ব্যবহারকারীর প্রথম সেশন থেকে প্রাপ্ত।

  • মেট্রিক - ga:cohortActiveUsers - এই মেট্রিকটি 0-ভিত্তিক অফসেট মাত্রার ( ga:cohortNthDay , ga:cohortNthWeek বা ga:cohortNthMonth ) প্রসঙ্গে প্রাসঙ্গিক। এটি কোহর্টের ব্যবহারকারীদের সংখ্যা নির্দেশ করে যারা কোহর্টের এনম দিন/সপ্তাহ/মাসের সাথে সম্পর্কিত সময় উইন্ডোতে সক্রিয়। উদাহরণস্বরূপ, ga:cohortNthWeek = 1 , ব্যবহারকারীর সংখ্যা (কোহোর্টে) যারা দ্বিতীয় সপ্তাহে সক্রিয়। যদি একটি অনুরোধে ga:cohortNthDay , ga:cohortNthWeek , বা ga:cohortNthMonth এর কোনোটি না থাকে, তাহলে এই মেট্রিকের মান ga:cohortTotalUsers এর মতোই থাকবে।

  • মেট্রিক - ga:cohortTotalUsers - সমগোত্রীয় ব্যবহারকারীদের সংখ্যা, যা সমগোত্রীয় আকার নামেও পরিচিত৷

  • মেট্রিক - ga:cohortAppviewsPerUser - একটি সমষ্টির জন্য ব্যবহারকারী প্রতি অ্যাপ ভিউ।

  • মেট্রিক - ga:cohortGoalCompletionsPerUser - একটি সমষ্টির জন্য ব্যবহারকারী প্রতি লক্ষ্য পূর্ণতা।

  • মেট্রিক - ga:cohortPageviewsPerUser - একটি সমষ্টির জন্য ব্যবহারকারী প্রতি পৃষ্ঠা দর্শন।

  • মেট্রিক - ga:cohortRetentionRate - সমগোত্রীয় ধরে রাখার হার।

  • মেট্রিক - ga:cohortRevenuePerUser - একটি সমষ্টির জন্য ব্যবহারকারী প্রতি আয়।

  • মেট্রিক - ga:cohortVisitDurationPerUser - একটি গোষ্ঠীর জন্য ব্যবহারকারী প্রতি সেশনের সময়কাল।

  • মেট্রিক - ga:cohortSessionsPerUser - একটি সমষ্টির জন্য ব্যবহারকারী প্রতি সেশন।

  • মেট্রিক - ga:cohortTotalUsersWithLifetimeCriteria - এটি একটি অনুরোধের পরিপ্রেক্ষিতে প্রাসঙ্গিক যার মাত্রা রয়েছে ga:acquisitionTrafficChannel , ga:acquisitionSource , ga:acquisitionMedium , বা ga:acquisitionCampaign । এটি বর্তমান চ্যানেল, উৎস, মাধ্যম বা প্রচারাভিযানের মাধ্যমে অর্জিত সমদলের ব্যবহারকারীদের সংখ্যা প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, ga:acquisitionTrafficChannel=Direct এর জন্য, এটি কোহর্টের ব্যবহারকারীদের সংখ্যা প্রতিনিধিত্ব করে, যারা সরাসরি অর্জিত হয়েছিল। যদি উল্লিখিত মাত্রাগুলির একটিও উপস্থিত না থাকে, তাহলে এর মান ga:cohortTotalUsers এর সমান।

  • মেট্রিক - ga:cohortAppviewsPerUserWithLifetimeCriteria - একটি কোহর্টের জন্য অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি অ্যাপ ভিউ।

  • মেট্রিক - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - একটি সমষ্টির জন্য অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি লক্ষ্য পূর্ণতা।

  • মেট্রিক - ga:cohortPageviewsPerUserWithLifetimeCriteria - একটি কোহর্টের জন্য অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি পৃষ্ঠা দর্শন।

  • মেট্রিক - ga:cohortRevenuePerUserWithLifetimeCriteria - একটি কোহর্টের জন্য অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি আয়।

  • মেট্রিক - ga:cohortSessionsPerUserWithLifetimeCriteria - একটি কোহর্টের জন্য অধিগ্রহণের মাত্রার জন্য ব্যবহারকারী প্রতি সেশনের সময়কাল।

সোশ্যাল ডেটা হাবের মাত্রা এবং মেট্রিক্স অবমূল্যায়িত করা হয়েছে এবং শুধুমাত্র 30শে এপ্রিল, 2016 এর পর থেকে শুরু হওয়া ঐতিহাসিক ডেটার উপর রিপোর্ট করবে; এই তারিখের পরে কোন নতুন তথ্য প্রদর্শিত হবে না. ডেটা অবচয় নীতি অনুসারে, 30শে সেপ্টেম্বর, 2016 এর পরে এই মাত্রা এবং মেট্রিক্সগুলি সরানো হবে৷

সংজ্ঞার সম্পূর্ণ তালিকার জন্য মাত্রা এবং মেট্রিক্স রেফারেন্স পর্যালোচনা করুন।

সামাজিক কর্ম

এই মাত্রা এবং মেট্রিকগুলিকে অবমূল্যায়ন করা হয়েছে এবং 30শে সেপ্টেম্বর, 2016 এর পরে সরানো হবে৷ ডেটা অপসারণের বিশদ বিবরণের জন্য ডেটা অবচয় নীতি পর্যালোচনা করুন:

  • মাত্রা - ga:socialActivityEndorsingUrl - একটি সামাজিক ডেটা হাব কার্যকলাপের জন্য, এটি সামাজিক কার্যকলাপের URL (যেমন, Google+ পোস্ট URL, ব্লগ মন্তব্য URL, ইত্যাদি)৷
  • মাত্রা - ga:socialActivityDisplayName - একটি সামাজিক ডেটা হাব কার্যকলাপের জন্য, এটি সামাজিক নেটওয়ার্ক ব্যবহারকারীদের দ্বারা পোস্ট করা সামাজিক কার্যকলাপের শিরোনাম৷
  • মাত্রা - ga:socialActivityPost - একটি সামাজিক ডেটা হাব কার্যকলাপের জন্য, এটি সামাজিক নেটওয়ার্ক ব্যবহারকারীদের দ্বারা পোস্ট করা সামাজিক কার্যকলাপের বিষয়বস্তু (যেমন, Google+ এ পোস্ট করা একটি বার্তার বিষয়বস্তু)৷
  • মাত্রা - ga:socialActivityTimestamp - একটি সামাজিক ডেটা হাব কার্যকলাপের জন্য, এটি সেই সময় যখন সামাজিক নেটওয়ার্কে সামাজিক কার্যকলাপ ঘটে।
  • মাত্রা - ga:socialActivityUserHandle - একটি সামাজিক ডেটা হাব কার্যকলাপের জন্য, এটি এমন ব্যবহারকারীদের সামাজিক নেটওয়ার্ক হ্যান্ডেল (যেমন, নাম বা আইডি) যারা সামাজিক কার্যকলাপ শুরু করেছে৷
  • Dimension - ga:socialActivityUserPhotoUrl - For a social data hub activity, this is the URL of the photo associated with users' social network profiles.“
  • Dimension - ga:socialActivityUserProfileUrl - For a social data hub activity, this is the URL of the associated users' social network profiles.
  • Dimension - ga:socialActivityTagsSummary - For a social data hub activity, this is a comma-separated set of tags associated with the social activity.“
  • Dimension - ga:socialActivityAction - For a social data hub activity, this represents the type of social action (eg, vote, comment, +1, etc.) associated with the activity.
  • Dimension - ga:socialActivityNetworkAction - For a social data hub activity, this is the type of social action and the social network where the activity originated.
  • Dimension - ga:socialActivityContentUrl - For a social data hub activity, this is the URL shared by the associated social network users.
  • Metric - ga:socialActivities - Total number of activities where a content URL was shared or mentioned on a social data hub partner network.

This release adds a new dimension to the API. Review the Dimensions and Metrics Reference for the complete list of definitions.

Platform or Device

  • Dimension - ga:browserSize - The viewport size of the users' browsers. Browser size is a session scoped dimension which captures the initial dimensions of the viewport in pixels and is formatted as width X height. For example, 1920x960.

This release adds a new parameter to the API.

Include Empty Rows

  • This release adds the new optional parameter include-empty-rows , which when set to false rows without data will be omitted from the response. The default value is true , which is a non breaking change, and as such should not require a code update. See the Core Reporting API reference documentation for details.

This release adds new metrics to the API. Review the Dimensions and Metrics Reference for the complete list of definitions.

User

  • Metric - ga:1dayUsers - Total number of 1-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 1 day period ending on the given date.
  • Metric - ga:7dayUsers - Total number of 7-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 7 day period ending on the given date.
  • Metric - ga:14dayUsers - Total number of 14-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 14 day period ending on the given date.
  • Metric - ga:30dayUsers - Total number of 30-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 30 day period ending on the given date.

This release adds new metrics to the API. Review the Dimensions and Metrics Reference for the complete list of definitions.

DoubleClick Ad Exchange (AdX)

  • Metric - ga:adxCTR - The percentage of pageviews that resulted in a click on an AdX ad.
  • Metric - ga:adxClicks - The number of times AdX ads were clicked on your site.
  • Metric - ga:adxCoverage - Coverage is the percentage of ad requests that returned at least one ad. Generally, coverage can help you identify sites where your AdX account isn't able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100
  • Metric - ga:adxECPM - The effective cost per thousand pageviews. It is your AdX Revenue per 1000 pageviews.
  • Metric - ga:adxImpressions - An AdX ad impression is reported whenever an individual ad is displayed on your website. For example, if a page with two ad units is viewed once, we'll display two impressions.
  • Metric - ga:adxImpressionsPerSession - The ratio of AdX ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions).
  • Metric - ga:adxMonetizedPageviews - Monetized Pageviews measures the total number of pageviews on your property that were shown with an ad from your linked AdX account. Note: A single page can have multiple ad units.
  • Metric - ga:adxRevenue - The total estimated revenue from AdX ads.
  • Metric - ga:adxRevenuePer1000Sessions - The total estimated revenue from AdX ads per 1000 Analytics sessions. Note that this metric is based on sessions to your site and not ad impressions.
  • Metric - ga:adxViewableImpressionsPercent - The percentage of ad impressions that were viewable. An impression is considered a viewable impression when it has appeared within a user's browser and had the opportunity to be seen.

This release deprecates existing dimensions or metrics. Review the Dimensions and Metrics Reference for the complete list of definitions.

Deprecated Dimensions

These dimensions have been deprecated. Review the Data Deprecation Policy for details on data removal:

  • Dimension - ga:adSlotPosition - Use ga:adSlot instead.
  • Dimension - ga:nextPagePath - Use ga:pagePath instead.
  • Dimension - ga:nextContentGroupXX - Use ga:contentGroupXX instead.

This release adds a new dimension to the API. Review Dimensions and Metrics Reference for the complete list of dimensions and metrics.

Adwords

  • Dimension - ga:adQueryWordCount - The number of words in the search query.

This release adds new dimensions to the API. Review Dimensions and Metrics Reference for the complete list of dimensions and metrics.

Platform or Device

  • Dimension - ga:dataSource - The data source of a hit. Hits sent from ga.js and analytics.js are reported as “web”; hits sent from the mobile SDKs are reported as “app”. These values can be overridden.
  • Dimension - ga:searchAfterDestinationPage - The page that the user visited after performing an internal search on your site.

This release adds new dimensions and metrics to the API and deprecates two existing metrics. Review the Dimensions and Metrics Reference for the complete list of definitions.

ECommerce

  • Metric - ga:transactionsPerUser - The total number of transactions divided by total number of users.
  • Metric - ga:revenuePerUser - The total sale revenue provided in the transaction excluding shipping and tax divided by total number of users.

User

  • Metric - ga:sessionsPerUser - The total number of sessions divided by the total number of users.

Geo Network

  • Dimension - ga:cityId - The city IDs of users, derived from IP addresses or Geographical IDs.
  • Dimension - ga:countryIsoCode - The country ISO code of users, derived from IP addresses or Geographical IDs. Values are given as an ISO-3166-1 alpha-2 code.
  • Dimension - ga:regionId - The region ID of users, derived from IP addresses or Geographical IDs. In the US, a region is a state, such as New York.
  • Dimension - ga:regionIsoCode - The region ISO code of users, derived from IP addresses or Geographical IDs. Values are given as an ISO-3166-2 code.
  • Dimension - ga:subContinentCode - The sub-continent code of users, derived from IP addresses or Geographical IDs. For example, Polynesia or Northern Europe. Values are given as a UN M.49 code.

DoubleClick Campaign Manager

  • Metric - ga:dcmROAS - DCM Return On Ad Spend (ROAS) (premium only).

Deprecated Metrics

These metrics have been deprecated. Review the Data Deprecation Policy for details on data removal: + Metric - ga:dcmROI - Use ga:dcmROAS instead. + Metric - ga:dcmMargen - Use ga:dcmROAS instead.

This release adds a new metric to the API and deprecates two existing metrics. Check the Dimensions and Metrics Reference for the complete list of definitions.

AdWords

  • Metric - ga:ROAS - Return On Ad Spend (ROAS) is the total transaction revenue and goal value divided by derived advertising cost.

Deprecated Dimensions and Metrics

These dimensions and metrics have been deprecated. Review the Data Deprecation Policy for details on data removal: + Metric - ga:ROI - Use ga:ROAS instead. + Metric - ga:margin - Use ga:ROAS instead.

This release adds new metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.

AdSense

  • Metric - ga:adsenseCoverage - The percentage of ad requests that returned at least one ad.
  • Metric - ga:adsenseViewableImpressionPercent - The percentage of impressions that were viewable.

This release includes the addition of a new session metric, a new traffic sources dimension, and new DoubleClick Campaign Manager dimensions and metrics.

Dimensions and Metrics

Review the Dimensions and Metrics Reference for the complete list of definitions.

Session

  • Metric - ga:hits - Total number of hits sent to Google Analytics. This metric sums all hit types (eg pageview, event, timing, etc.)

Traffic Sources

  • Dimension - ga:campaignCode - When using manual campaign tracking, the value of the utm_id campaign tracking parameter.

DoubleClick Campaign Manager

  • Dimension - ga:dcmClickAd - DCM ad name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickAdId - DCM ad ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickAdType - DCM ad type name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickAdTypeId - DCM ad type ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickAdvertiser - DCM advertiser name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickAdvertiserId - DCM advertiser ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCampaign - DCM campaign name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCampaignId - DCM campaign ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCreative - DCM creative name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCreativeId - DCM creative ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCreativeType - DCM creative type name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCreativeTypeId - DCM creative type ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickCreativeVersion - DCM creative version of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickRenderingId - DCM rendering ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickSite - Site name where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickSiteId - DCM site ID where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickSitePlacement - DCM site placement name of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickSitePlacementId - DCM site placement ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmClickSpotId - DCM Floodlight configuration ID of the DCM click matching the Google Analytics session (premium only).
  • Dimension - ga:dcmFloodlightActivity - DCM Floodlight activity name associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityAndGroup - DCM Floodlight activity name and group name associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityGroup - DCM Floodlight activity group name associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityGroupId - DCM Floodlight activity group ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityId - DCM Floodlight activity ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightAdvertiserId - DCM Floodlight advertiser ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightSpotId - DCM Floodlight configuration ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmLastEventAd - DCM ad name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdId - DCM ad ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdType - DCM ad type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdTypeId - DCM ad type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdvertiser - DCM advertiser name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdvertiserId - DCM advertiser ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAttributionType - There are two possible values (ClickThrough and ViewThrough). If the last DCM event associated with the Google Analytics session was a click, then the value will be ClickThrough. If the last DCM event associated with the Google Analytics session was an ad impression, then the value will be ViewThrough (premium only).
  • Dimension - ga:dcmLastEventCampaign - DCM campaign name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCampaignId - DCM campaign ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreative - DCM creative name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeId - DCM creative ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeType - DCM creative type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeTypeId - DCM creative type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeVersion - DCM creative version of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventRenderingId - DCM rendering ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSite - Site name where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSiteId - DCM site ID where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSitePlacement - DCM site placement name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSitePlacementId - DCM site placement ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSpotId - DCM Floodlight configuration ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Metric - ga:dcmFloodlightQuantity - The number of DCM Floodlight conversions (premium only).
  • Metric - dcmFloodlightRevenue - DCM Floodlight revenue (premium only).

This release includes the addition of the new content grouping dimensions and metrics.

Dimensions and Metrics

Review the Dimensions and Metrics Reference for the complete list of definitions.

Content Grouping

  • Dimension - ga:landingContentGroupXX - The first matching content group in a user's session.
  • Dimension - ga:nextContentGroupXX - Refers to content group that was visited after another content group.
  • Dimension - ga:contentGroupXX - Content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/url regex match, or predefined rules.
  • Dimension - ga:previousContentGroupXX - Refers to content group that was visited before another content group.
  • Metric - ga:contentGroupUniqueViewsXX - The number of different (unique) pages within a session for the specified content group. This takes into account both the pagePath and pageTitle to determine uniqueness.

This release includes a new dateOfSession condition for Segments and the addition of new Enhanced Ecommerce dimensions and metrics.

Segments

Segments now support a new dateOfSession condition which can restrict a segment to a group of users who have initiated a session within a certain date range. See the Segments Developer Guide for details.

Dimensions and Metrics

Review the Dimensions and Metrics Reference for the complete list of definitions for Enhanced Ecommerce .

Enhanced Ecommerce

  • Dimension - ga:internalPromotionCreative - The creative content designed for a promotion.
  • Dimension - ga:internalPromotionId - The ID you are using for the promotion.
  • Dimension - ga:internalPromotionName - The name of the promotion.
  • Dimension - ga:internalPromotionPosition - The position of the promotion on the web page or application screen.
  • Dimension - ga:orderCouponCode - Code for the order-level coupon.
  • Dimension - ga:productBrand - The brand name under which the product is sold.
  • Dimension - ga:productCategoryHierarchy - The hierarchical category in which the product is classified (Enhanced Ecommerce).
  • Dimension - ga:productCategoryLevelXX - Level (1-5) in the product category hierarchy, starting from the top.
  • Dimension - ga:productCouponCode - Code for the product-level coupon.
  • Dimension - ga:productListName - The name of the product list in which the product appears.
  • Dimension - ga:productListPosition - The position of the product in the product list.
  • Dimension - ga:productVariant - The specific variation of a product, eg, XS, S, M, L for size or Red, Blue, Green, Black for color.
  • Dimension - ga:checkoutOptions - User options specified during the checkout process, eg, FedEx, DHL, UPS for delivery options or Visa, MasterCard, AmEx for payment options. This dimension should be used along with Shopping Stage.
  • Dimension - ga:shoppingStage - Various stages of the shopping experience that users completed in a session, eg, PRODUCT_VIEW, ADD_TO_CART, CHECKOUT, etc.
  • Metric - ga:internalPromotionCTR - The rate at which users clicked through to view the internal promotion (number of clicks / number of times promotion appeared).
  • Metric - ga:internalPromotionClicks - The number of clicks on an internal promotion.
  • Metric - ga:internalPromotionViews - The number of views of an internal promotion.
  • Metric - ga:localProductRefundAmount - Refund amount for a given product in the local currency.
  • Metric - ga:localRefundAmount - Total refund amount for the transaction in the local currency.
  • Metric - ga:productAddsToCart - Number of times the product was added to the shopping cart.
  • Metric - ga:productCheckouts - Number of times the product was included in the check-out process.
  • Metric - ga:productDetailViews - Number of times users viewed the product-detail page.
  • Metric - ga:productListClicks - Number of times users clicked the product when it appeared in the product list.
  • Metric - ga:productListViews - Number of times the product appeared in a product list.
  • Metric - ga:productListCTR - The rate at which users clicked through on the product in a product list.
  • Metric - ga:productRefunds - Number of times a refund was issued for the product.
  • Metric - ga:productRefundAmount - Total refund amount associated with the product.
  • Metric - ga:productRemovesFromCart - Number of times the product was removed from shopping carts.
  • Metric - ga:productRevenuePerPurchase - Average product revenue per purchase (commonly used with Product Coupon Code).
  • Metric - ga:buyToDetailRate - Unique purchases divided by views of product detail pages.
  • Metric - ga:cartToDetailRate - Product adds divided by views of product details.
  • Metric - ga:quantityAddedToCart - Number of product units added to cart.
  • Metric - ga:quantityCheckedOut - Number of product units included in check out.
  • Metric - ga:quantityRefunded - Number of product units refunded.
  • Metric - ga:quantityRemovedFromCart - Number of product units removed from cart.
  • Metric - ga:refundAmount - Currency amount refunded for a transaction.
  • Metric - ga:totalRefunds - Number of refunds that have been issued.

This release includes a bug fix for column header names as well as the addition of new dimensions and metrics.

Dimensions and Metrics

Review the Dimensions and Metrics Reference for the complete list of definitions.

System

  • Dimension - ga:sourcePropertyDisplayName - Source property display name of roll-up properties. This is valid only for roll-up properties.
  • Dimension - ga:sourcePropertyTrackingId - Source property tracking ID of roll-up properties. This is valid only for roll-up properties

Channel Grouping

  • Dimension - ga:channelGrouping - The default channel grouping that is shared within the View (Profile).
  • Dimension - ga:correlationModelId - Correlation Model ID for related products.
  • Dimension - ga:queryProductId - ID of the product being queried.
  • Dimension - ga:queryProductName - Name of the product being queried.
  • Dimension - ga:queryProductVariation - Variation of the product being queried.
  • Dimension - ga:relatedProductId - ID of the related product.
  • Dimension - ga:relatedProductName - Name of the related product.
  • Dimension - ga:relatedProductVariation - Variation of the related product.
  • Metric - ga:correlationScore - Correlation Score for related products.
  • Metric - ga:queryProductQuantity - Quantity of the product being queried.
  • Metric - ga:relatedProductQuantity - Quantity of the related product.

Header column name correction

  • There was a bug in the 2014-04-16 release; if you queried for a deprecated dimension or metric, the API would return column headers with the replacement dimension or metric. Now it correctly returns the same dimension or metric name used in the request.

This release includes the addition and renaming of dimensions and metrics. Review the Dimensions and Metrics Reference for the complete list of definitions.

New Dimensions and Metrics

The following dimensions have been added to the Core Reporting API:

AdWords

  • Dimension - ga:isTrueViewVideoAd - Yes or No - Indicates whether the ad is an AdWords TrueView video ad.

Time

  • Dimension - ga:nthHour - Index for each hour in the specified date range. Index for the first hour of first day (ie, start-date) in the date range is 0, 1 for the next hour, and so on.

Renamed Dimensions and Metrics

All visitor and visit based dimensions and metrics have been renamed to instead use user and session respectively.

The following dimensions and metrics have been renamed. Review the Data Deprecation Policy for details on data renaming:

Audience

  • Dimension - ga:visitorAgeBracket - Use ga:userAgeBracket instead.
  • Dimension - ga:visitorGender - Use ga:userGender instead.

Ecommerce

  • Metric - ga:transactionRevenuePerVisit - Use ga:transactionRevenuePerSession instead.
  • Metric - ga:transactionsPerVisit - Use ga:transactionsPerSession instead.

Event Tracking

  • Metric - ga:eventsPerVisitWithEvent - Use ga:eventsPerSessionWithEvent instead.
  • Metric - ga:visitsWithEvent - Use ga:sessionsWithEvent instead.

Goal Conversions

  • Metric - ga:goalValuePerVisit - Use ga:goalValuePerSession instead.
  • Metric - ga:percentVisitsWithSearch - Use ga:percentSessionsWithSearch instead.
  • Metric - ga:searchVisits - Use ga:searchSessions instead.

Page Tracking

  • Metric - ga:pageviewsPerVisit - Use ga:pageviewsPerSession instead.

Session

  • Dimension - ga:visitLength - Use ga:sessionDurationBucket instead.
  • Metric - ga:avgTimeOnSite - Use ga:avgSessionDuration instead.
  • Metric - ga:timeOnSite - Use ga:sessionDuration instead.
  • Metric - ga:visitBounceRate - Use ga:bounceRate instead.
  • Metric - ga:visits - Use ga:sessions instead.

Social Interactions

  • Dimension - ga:socialInteractionNetworkActionVisit - Use ga:socialInteractionNetworkActionSession instead.
  • Metric - ga:socialInteractionsPerVisit - Use ga:socialInteractionsPerSession instead.

User

  • Dimension - ga:daysSinceLastVisit - Use ga:daysSinceLastSession instead.
  • Dimension - ga:visitCount - Use ga:sessionCount instead.
  • Dimension - ga:visitorType - Use ga:userType instead.
  • Dimension - ga:visitsToTransaction - Use ga:sessionsToTransaction instead.
  • Metric - ga:newVisits - Use ga:newUsers instead.
  • Metric - ga:percentNewVisits - Use ga:percentNewSessions instead.
  • Metric - ga:visitors - Use ga:users instead.

Segments: Core Reporting API v2.4 & v3.0

New segments support in the Core Reporting API.

  • The segment parameter now supports user and sequence segments. User level and session level segments created in the web interface can be queried with the segment parameter.
  • A new syntax for dynamic segments is available to use with the segment parameter. For details see the Segments Dev Guide
  • The dynamic:: prefix has been deprecated. It is recommended that you migrate to the new syntax as soon as possible.

This release includes a new Data Table response format and the addition and deprecation of dimensions and metrics (Review the Dimensions and Metrics Reference for the complete list of definitions).

Data Table Output

To make it easier to render your Google Analytics data using Google Charts visualizations, the API can optionally return a Data Table object in the response.

  • An optional output query parameter has been added to the API. It can be used to select the output format of Analytics data in the response, which is JSON by default. If set to datatable , a dataTable property that contains a Data Table object is included in the response. This object can be used directly with Google Charts . See the Core Reporting API reference for details.

New Dimensions and Metrics

The following dimensions and metrics have been added to the Core Reporting API:

Time

  • Dimension - ga:minute - Returns the minute in the hour. The possible values are between 00 and 59 .
  • Dimension - ga:nthMinute - Index for each minute in the specified date range. Index for the first minute of first day (ie, start-date) in the date range is 0 , 1 for the next minute, and so on.

Audience

  • Dimension - ga:visitorAgeBracket - Age bracket of visitor.
  • Dimension - ga:visitorGender - Gender of visitor.
  • Dimension - ga:interestAffinityCategory - Indicates that users are more likely to be interested in learning about the specified category.
  • Dimension - ga:interestInMarketCategory - Indicates that users are more likely to be ready to purchase products or services in the specified category.
  • Dimension - ga:interestOtherCategory - Indicates that users are more likely to be interested in learning about the specified category, and more likely to be ready to purchase.

Dimensions and Metrics Allowed In Segments

These dimensions and metrics can now be used in segments:

  • Dimension - ga:sourceMedium - Combined values of ga:source and ga:medium .
  • Metric - ga:localItemRevenue - Product revenue in local currency.

Deprecated Dimensions and Metrics

These dimensions and metrics have been deprecated. Review the Data Deprecation Policy for details on data removal:

  • Dimension - ga:isMobile - Use ga:deviceCategory instead (eg, ga:deviceCategory==mobile ).
  • Dimension - ga:isTablet - Use ga:deviceCategory instead (eg, ga:deviceCategory==tablet ).
  • Metric - ga:entranceBounceRate - Use ga:visitBounceRate instead.

This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.

Adsense

  • Access to Adsense data has been added:

    • Met - ga:adsenseRevenue - The total revenue from AdSense ads.
    • Met - ga:adsenseAdUnitsViewed - The number of AdSense ad units viewed. An Ad unit is a set of ads displayed as a result of one piece of the AdSense ad code. Details: https://support.google.com/adsense/answer/32715 .
    • Met - ga:adsenseAdsViewed - The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit.
    • Met - ga:adsenseAdsClicks - The number of times AdSense ads on your site were clicked.
    • Met - ga:adsensePageImpressions - The number of pageviews during which an AdSense ad was displayed. A page impression can have multiple Ad Units.
    • Met - ga:adsenseCTR - The percentage of page impressions that resulted in a click on an AdSense ad. ( ga:adsenseAdsClicks/ga:adsensePageImpressions )
    • Met - ga:adsenseECPM - The estimated cost per thousand page impressions. It is your AdSense Revenue per 1000 page impressions. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Met - ga:adsenseExits - The number of sessions that ended due to a user clicking on an AdSense ad.

Time

  • Dim - ga:isoYear - The ISO year of the visit. Details: http://en.wikipedia.org/wiki/ISO_week_date . ga:isoYear should only be used with ga:isoWeek since ga:week represents gregorian calendar.
  • Dim - ga:isoYearIsoWeek - Combined values of ga:isoYear and ga:isoWeek .

Adwords

New Sample Size Control and Relative Dates Features

Relative Dates
  • Support for relative dates has been added to the Core Reporting API. today , yesterday , and NdaysAgo are now valid values for the start-date and end-date query parameters.
  • Using these values will automatically determine the date range based on the current date at the time the query is made, and on the timezone of the view (profile) specified in the query. See the API Reference for additional details.
Sampling Level
  • A new parameter, samplingLevel , has been introduced that allows you to set the sampling level (ie the number of visits used to calculate the result) for a reporting query. Allowed values are: DEFAULT , FASTER , and HIGHER_PRECISION .
  • 2 new fields have been added to the API Response: sampleSize and sampleSpace . You can use these values to calculate the percentage of visits that were used for a sampled response.
  • See the API Reference and Sampling for additional details.

Bug Fixes

  • The ga:adwordsCustomerID now correctly returns the 10-digit AdWords Customer ID corresponding to the AdWords API AccountInfo.customerId . This fix makes it possible to join Analytics data with multiple AdWords accounts.

As part of the new segments launch , we will be rolling out the following changes to the Core Reporting API.

  • The segment parameter now supports the new alphanumeric ID for custom advanced segments, which is returned in the Management API Segments collection .
  • The current numeric IDs for custom segments are now under deprecation. These legacy IDs will continue to be supported for 6 months. We recommend applications that save user segment IDs to switch to the new alphanumeric IDs. Once the deprecation period is over, any queries with the old numeric IDs will return an error.
  • Currently, only the visit level segments created in the web interface will be queryable through the segment parameter.
  • The existing default segments with negative numeric IDs will not be affected. However, the new default segments are currently not supported.

This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.

App Tracking

  • This data is found in App profile reports:
    • Dim - ga:appId - The id of the application.
    • Dim - ga:appInstallerId - ID of the installer (eg, Google Play Store) from which the app was downloaded. By default, the app installer id is set based on the PackageManager#getInstallerPackageName method.
    • Dim - ga:appName - The name of the application.
    • Dim - ga:appVersion - The version of the application.
    • Dim - ga:exitScreenName - The name of the screen when the user exited the application.
    • Dim - ga:landingScreenName - The name of the first screen viewed.
    • Dim - ga:screenDepth - The number of screenviews per session reported as a string. Can be useful for historgrams.
    • Dim - ga:screenName - The name of the screen.
    • Met - ga:avgScreenviewDuration - The average amount of time users spent on a screen in seconds.
    • Met - ga:timeOnScreen - The time spent viewing the current screen.
    • Met - ga:screenviews - The total number of screen views. Use this instead of ga:appviews .
    • Met - ga:uniqueScreenviews - The number of different (unique) ga:screenviews within a session. Use this instead of ga:uniqueAppviews .
    • Met - ga:screenviewsPerSession - The average number of ga:screenviews per session. Use this instead of ga:appviewsPerVisit .

Deprecated

The following metrics have been deprecated. Use the new metric name instead.

  • Met - ga:appviews - Use ga:screenviews instead.
  • Met - ga:uniqueAppviews - Use ga:uniqueScreenviews instead.
  • Met - ga:appviewsPerVisit - Use ga:screenviewsPerSession instead.

Custom Variables or Columns

  • Access to custom dimension and metrics:

    • Dim - ga:dimensionXX - The name of the requested custom dimension, where XX refers the number/index of the custom dimension.
    • Met - ga:metricXX - The name of the requested custom metric, where XX refers the number/index of the custom metric.

Documentation Changes

The following Custom Variable dimension and metric have been renamed. This is a documentation change only, it will not require you to update your queries.

  • ga:customVarName(n) → ga:customVarNameXX
  • ga:customVarValue(n) → ga:customVarValueXX

Ecommerce

  • Dim - ga:currencyCode - The local currency code of the transaction based on ISO 4217 standard.
  • Met - ga:localItemRevenue - Product revenue in local currency.
  • Met - ga:localTransactionRevenue - Transaction revenue in local currency.
  • Met - ga:localTransactionShipping - Transaction shipping cost in local currency.
  • Met - ga:localTransactionTax - Transaction tax in local currency.

Exceptions

  • This data comes from exception tracking.
    • Dim - ga:exceptionDescription - The description for the exception.
    • Met - ga:exceptionsPerScreenview - The number of exceptions thrown divided by the number of screenviews.
    • Met - ga:fatalExceptionsPerScreenview - The number of fatal exceptions thrown divided by the number of screenviews.

Goal Conversions

  • Dim - ga:goalCompletionLocation - The page path or screen name that matched any destination type goal completion.
  • Dim - ga:goalPreviousStep1 - The page path or screen name that matched any destination type goal, one step prior to the goal completion location.
  • Dim - ga:goalPreviousStep2 - The page path or screen name that matched any destination type goal, two steps prior to the goal completion location.
  • Dim - ga:goalPreviousStep3 - The page path or screen name that matched any destination type goal, three steps prior to the goal completion location.

Documentation Changes

The following Goal Conversions dimension and metrics have been renamed. This is a documentation change only, it will not require you to update your queries.

  • ga:goal(n)AbandonRate → ga:goalXXAbandonRate
  • ga:goal(n)Abandons → ga:goalXXAbandons
  • ga:goal(n)Completions → ga:goalXXCompletions
  • ga:goal(n)ConversionRate → ga:goalXXConversionRate
  • ga:goal(n)Starts → ga:goalXXStarts
  • ga:goal(n)Value → ga:goalXXValue
  • ga:searchGoal(n)ConversionRate → ga:searchGoalXXConversionRate
  • Met - ga:percentSearchRefinements - The percentage of number of times a refinement (ie, transition) occurs between internal search keywords within a session.

Page Tracking

  • Met - ga:pageValue - The average value of this page or set of pages. Page Value is ((Transaction Revenue + Total Goal Value) divided by Unique Pageviews for the page or set of pages).

Platform or Device

  • This data is derived from the HTTP User-Agent string.

    • Dim - ga:deviceCategory - The type of device: Desktop, Tablet, or Mobile.
    • Dim - ga:isTablet - Indicates tablet visitors. The possible values are Yes or No .
    • Dim - ga:mobileDeviceMarketingName - Marketing name used for mobile device.

Social Interactions

  • This data comes from onsite social interaction tracking.

    • Dim - ga:socialEngagementType - Engagement type. Possible values are Socially Engaged or Not Socially Engaged .

Time

  • Dim - ga:dateHour - Combined values of ga:date and ga:hour .
  • Dim - ga:dayOfWeekName - The name of the day of the week (in English).
  • Dim - ga:isoWeek - The ISO week number, where each week starts with a Monday. Details: http://en.wikipedia.org/wiki/ISO_week_date .
  • Dim - ga:yearMonth - Combined values of ga:year and ga:month .
  • Dim - ga:yearWeek - Combined values of ga:year and ga:week .

Traffic Sources

  • Dim - ga:fullReferrer - The full referring URL including the hostname and path.
  • Dim - ga:sourceMedium - The combined values of ga:source and ga:medium .
  • This release adds 5 new site speed metrics:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • This release adds a new default segment for Tablet Traffic, gaid::-13 .

This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for definitions.

App Tracking

  • This data is found in Mobile App tracking SDK reports:
    • Met - ga:uniqueAppviews - The number of app views per session.
    • Met - 'ga:appviews - The total number of app views.
    • Met - ga:appviewsPerVisit - The average number of app views per session.

Traffic Sources

  • Dim - ga:socialNetwork - A string representing the social network name. This can be related to the referring social network for traffic sources, or to the social network for social data hub activities. Eg Google+, Blogger, reddit, etc.
  • Dim - ga:hasSocialSourceReferral - Indicates visits that arrived to the site from a social source (ie A social network such as Google+, Facebook, Twitter, etc.). The possible values are Yes or No, where the first letter must be capitalized.

Social Activities

  • This data comes from offsite activity imported from Social Data Hub partners.
    • Dim - ga:socialActivityDisplayName - For a social data hub activity, this string represents the title of the social activity posted by the social network user.
    • Dim - ga:socialActivityEndorsingUrl - For a social data hub activity, this string represents the URL of the social activity (eg the Google+ post URL, the blog comment URL, etc.)
    • Dim - ga:socialActivityPost - For a social data hub activity, this string represents the content of the social activity posted by the social network user (eg The message content of a Google+ post)
    • Dim - ga:socialActivityTimestamp - For a social data hub activity, this string represents when the social activity occurred on the social network.
    • Dim - ga:socialActivityUserPhotoUrl - For a social data hub activity, this string represents the URL of the photo associated with the user's social network profile.
    • Dim - ga:socialActivityUserProfileUrl - For a social data hub activity, this string represents the URL of the associated user's social network profile.
    • Dim - ga:socialActivityContentUrl - For a social data hub activity, this string represents the URL shared by the associated social network user.
    • Dim - ga:socialActivityTagsSummary - For a social data hub activity, this is a comma-separated set of tags associated with the social activity.
    • Dim - ga:socialActivityUserHandle - For a social data hub activity, this string represents the social network handle (ie name) of the user who initiated the social activity.
    • Dim - ga:socialActivityAction - For a social data hub activity, this string represents the type of social action associated with the activity (eg vote, comment, +1, etc.).
    • Dim - ga:socialActivityNetworkAction - For a social data hub activity, this string represents the type of social action and the social network where the activity originated.
    • Met - ga:socialActivities - The count of activities where a content URL was shared/mentioned on a social data hub partner network.

Social Interactions

  • This data comes from onsite social interaction tracking.
    • Dim - ga:socialInteractionAction - For social interactions, a string representing the social action being tracked (eg +1, like, bookmark)
    • Dim - ga:socialInteractionNetwork - For social interactions, a string representing the social network being tracked (eg Google, Facebook, Twitter, LinkedIn)
    • Dim - ga:socialInteractionNetworkAction - For social interactions, a string representing the concatenation of the ga:socialInteractionNetwork and ga:socialInteractionAction being tracked (eg Google: +1, Facebook: like)
    • Dim - ga:socialInteractionTarget - For social interactions, a string representing the URL (or resource) which receives the social network action.
    • Met - ga:socialInteractions - The total number of social interactions on your site.
    • Met - ga:uniqueSocialInteractions - The total number of unique social interactions on your site. Based on the value pair ga:socialInteractionNetwork and ga:socialInteractionAction
    • Met - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions . The average number of social interactions per visit to your site.

Geo / Network

  • Dim - ga:metro - The Designated Market Area (DMA) from where traffic originated.

Page Tracking

  • Dim - ga:pagePathLevel1 - This dimension rolls up all the pagePaths in the first hierarchical level in pagePath.
  • Dim - ga:pagePathLevel2 - This dimension rolls up all the pagePaths in the second hierarchical level in pagePath.
  • Dim - ga:pagePathLevel3 - This dimension rolls up all the pagePaths in the third hierarchical level in pagePath.
  • Dim - ga:pagePathLevel4 - This dimension rolls up all the pagePaths in the fourth hierarchical level in pagePath. All the additional levels in the pagePath hierarchy are also rolled up in this dimension.

Exception Tracking

  • This data come from exception tracking data.

    • Met - ga:exceptions - The number of exceptions that were sent to Google Analytics.
    • Met - ga:fatalExceptions - The number of exceptions where isFatal is set to true.

User Timings

  • This data comes from user timing data.

    • Dim - ga:userTimingCategory - A string for categorizing all user timing variables into logical groups for easier reporting purposes.
    • Dim - ga:userTimingLabel - A string to indicate the name of the action of the resource being tracked.
    • Dim - ga:userTimingVariable - A string that can be used to add flexibility in visualizing user timings in the reports.
    • Dim - ga:userTimingValue The number of milliseconds in elapsed time sent to Google Analytics.
    • Met - ga:userTimingSample - The number of samples that were sent.
    • Met - ga:avgUserTimingValue - The average user timing value. ga:userTimiingValue / ga:userTimiingSample .

Device / Platform

  • This data comes from the user agent of the collected data.
    • Dim - ga:mobileDeviceBranding - Mobile manufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile).
    • Dim - ga:mobileDeviceModel - Mobile device model (example: Nexus S)
    • Dim - ga:mobileInputSelector - Selector used on the mobile device (examples: touchscreen, joystick, click-wheel, stylus)
    • Dim - ga:mobileDeviceInfo - The branding, model, and marketing name used to identify the mobile device.

Bug Fixes

  • The API now correctly handles UTF-8 characters in a filter or dynamic segment.

This release enables Google Analytics premium accounts to access up to 50 custom variables.

This release fixes 2 bugs:

Bug Fixes

  • Query filters that contain special characters inside regular expressions no longer return server errors.

  • Combining a metric filter with an advanced segment no longer returns an error.

This release add new site speed metrics to the API.

New Metrics

  • The following site speed metrics have been added:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Check the Dimensions and Metrics Reference for definitions.

API Version 2.3 Deprecation Reminder

  • Version 2.3 of the Data Export API has been depreacted for 2 months. In roughly 4 more months we will shut down this service and only support the new Core Reporting API version 3.0 and version 2.4 .

  • We highly recommend you migrate your applications to version 3.0.

  • In 4 months requests to the legacy version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 XML response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.

  • All requests for version 2.3 JSON or the Google Data JavaScript client library that uses version 2.3 JSON output, will return 404 status codes.

  • To get full quota, both version 3.0 and version 2.4 require you to register your application in the Google APIs Console and use an API key (or OAuth 2.0 token) in each request.

We fixed a small bug with ga:visitLength . This dimension now returns correct data.

This release effects all Google Analytics API developers. It announces two new versions of the API, requires applications to register, introduces a new quota policy, and it changes the API name to the Core Reporting API. Finally it deprecates the existing Data Export API version 2.3.

Version 3.0

  • The Core Reporting API version 3.0 is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.

  • New Features

    • New JSON based output reduces the size of the response ~10x from the previous XML output.
    • New Google API client libraries that support Java, JavaScript, Python, PHP, Ruby, and .Net.
    • Support for the Google Discovery API .
    • Support for OAuth 2.0 as the new, recommended way to authorize users.

  • Updates

    • New URL to make requests: https://www.googleapis.com/analytics/v3/data/ga… .
    • Registration and developers tokens required.
    • All requests for configuration data should be done through the Management API .

Version 2.4

  • The Core Reporting API version 2.4 is a minor version upgrade that is mostly backwards compatible with the existing Data Export API version 2.3.

  • Updates

    • New URL to make requests: https://www.googleapis.com/analytics/v2.4/data…
    • Registration and developers tokens required.
    • XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.
    • Error code for quota errors have changed from 503 to 403
    • JSON responses are not supported.
    • Google Data JavaScript client library not supported.
    • No Account Feed. All requests for configuration data should be done through the Management API .

Registration

  • All applications built using the Google Analytics API must be registered as a project through the Google APIs Console .

  • Each request to the API must include either a API key or for OAuth 2.0, a Client Id and Client Secret.

Quota Policy

  • The following quota applies to both Anlaytics APIs (Management API and Data Export API)

    • 50,000 requests per project per day
    • 10 queries per second (QPS) per IP address

  • The following quota applies to the Data Export API

    • 10,000 requests per profile per day
    • 10 concurrent requests per profile

  • For unregistered applications, we provide a very low grace quota to accommodate a small amount of testing.

Deprecations

  • This release also announces the deprecation of Version 2.3 and the upcoming shut down of the Account Feed in the Data Export API. In 6 months:

    • Requests to the version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.

    • Requests to the version 2.3 JSON output will not be supported by the version 2.4 response and will return 404 Not Found status codes. If you need a JSON response, upgrade to Version 3.0.

    • Requests to the Account Feed in the Data Export API will return 404 Not Found status codes. All requests for configuration data should be done through the Management API .

This release adds fresher AdWords data and more combinations for AdWords dimensions and metrics.

  • AdWords data is now updated within an hour. Before the data was updated daily.

  • We've relaxed a number valid combinations restrictions with AdWords data.

A few weeks ago we made a change to disallow API queries that asked for ga:adGroup or ga:adContent with ga:impressions , since this combination returned 0. With this change, this combination is now back and has been fixed to return correct data.

This release fixes some invalid combinations of dimensions and metrics

Fixed invalid metrics/dimensions combinations

  • Last month we announced some upcoming changes to the API to disallow some invalid queries in the data feed that do not return any data. We have now made those changes to the API, and the following combinations are now invalid:

    • Product dimensions cannot be combined with transaction metrics.
    • ga:adContent or ga:adGroup cannot be combined with ga:impressions .

    Instead of returning a response with 0 results, the API now returns 400 error code for all queries that ask for these combinations.

This release deprecates the confidence interval value in metrics.

Deprecation of Confidence Interval

  • If you haven't already done so, please stop using confidence interval values for metrics. With this release, the Data Export API Data Feed returns 0.0 for all the confidence interval values. In a month or so, we will we will completely remove this attribute from all metric elements.

    To determine if a response has been sampled, please use the containsSampledData field in the response.

This release adds 3 new metrics and updates the return value of two.

New Data Updates

  • We added 3 new metrics dealing with site speed performance to the API:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Metric Updates

  • To specify currency values in filters, you must specify the actual value passed in from the tracking code, (eg 1 unit will now be specified as 1).

  • ga:CTR now returns the actual percent (eg a value of 2% is returned as 2).

This release improves improves Data Feed performance and adds new data:

Performance Improvement

  • This release improves data feed latency by 30 to 35%.

New Data Updates

  • We have updated the list of dimensions and metrics that are allowed in Advanced Segments. Please refer to the updated list to make sure that your requests are valid.

Upcoming Changes

  • Currently, you need to specify a currency filter value as micro units, (eg 1 unit of currency is specified as 1000000). In the near future, you will need to specify the actual value passed in from the tracking code, (eg 1 unit will now be specified as 1).

  • Currently, ga:CTR is a percent and returns the value 0.02. In the near future this will change to return the actual percent (eg 2).

This release adds more data to the Data Feed:

New Data Updates

  • The following Time dimension has been added: ga:dayOfWeek

  • The following Internal Search metric has been added: ga:percentVisitsWithSearch

  • The following Event Tracking metrics have been added:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Upcoming Changes

Currently the API returns 401 status codes for for various authorization issues. Within the next couple of weeks, the 401 status will be used exclusively for invalid tokens, giving developers a way to error handle this particular exception.

This release adds significantly more data to the Data Feed:

New Data Updates

  • The calculation of ga:visitors has been changed to return the number of unique visitors across the date range and now supports more dimension and metric combinations.

  • 10 new AdWords dimensions have been added: ga:adDistributionNetwork , ga:adMatchType , ga:adMatchedQuery , ga:adPlacementDomain , ga:adPlacementUrl , ga:adFormat , ga:adTargetingType , ga:adTargetingOption , ga:adDisplayUrl , ga:adDestinationUrl .

  • The metric ga:organicSearches has been added to the campaign group.

  • The metric ga:searchResultViews has been added to the internal site search group.

  • 3 new time-based dimensions have been added: ga:nthDay , ga:nthWeek , ga:nthMonth .

  • The groupings of dimensions and metrics have been changed to better reflect the features they represent.

New Calculated Metrics

The following calculated metrics are derived from calculations using the base metrics. Note: Each name with (n) supports values 1-20.

  • Goal Based: ga:costPerConversion , ga:costPerGoalConversion , ga:costPerTransaction , ga:goal(n)AbandonRate , ga:goal(n)Abandons , ga:goal(n)ConversionRate , ga:goalAbandonRateAll , ga:goalAbandonsAll , ga:goalConversionRateAll , ga:goalValueAllPerSearch , ga:goalValuePerVisit .

  • Content Based: ga:entranceBounceRate , ga:visitBounceRate , ga:entranceRate , ga:exitRate , ga:pageviewsPerVisit , ga:avgTimeOnPage , ga:avgTimeOnSite , ga:avgEventValue .

  • Internal Site Search Based: ga:avgSearchDepth , ga:avgSearchDuration , ga:avgSearchResultViews , ga:searchGoalConversionRateAll , ga:searchGoal(n)ConversionRate , ga:searchExitRate .

  • Ecommerce Based: ga:itemsPerPurchase , ga:margin , ga:percentNewVisits , ga:revenuePerItem , ga:revenuePerTransaction , ga:ROI , ga:RPC , ga:totalValue , ga:transactionRevenuePerVisit , ga:transactionsPerVisit .

This release adds a new feature to the Data Feed:

New Features

  • A new XML element has been added lets users know if the data has been sampled. true . This element will always return whether the data was sampled or not with either true or false . The Java and JavaScript libraries have also been updated with helper methods to access this element.

This release fixes 2 bugs:

Bug Fixes

  • Previously adding an OR operator to a filter expression with a dimension (ie, ga:keyword==store,ga:keyword==bar ) could result in different values than if each filter was applied individually across multiple queries. This has been fixed and using the OR operator now returns consistent values.

  • Some of the API error messages for invalid filters have been updated to NOT include whether it was a dimension or metric filter that caused the error (though the actual offending filter expression will continue to be returned).

This release fixes 3 bugs:

Bug Fixes

  • An encoding issue in the JavaScript Client Library has been fixed. Analytics issue tracker

  • A bug that prevented the Account Feed to not return when a goal name, goal path, goal comparison value, or goal comparison type had been incorrectly set, has now been fixed.

  • It is invalid to OR a dimension and metric in the Data Feed query filter parameter. For example: ga:source==google,ga:visits>5 . The error message for this invalid query has been updated to say: Cannot OR dimension filter(s) with metric filter .

This release adds new data and fixes a bug:

New Features

  • The following 5 dimensions have been added in the new category D8. Adwords :

    • ga:adwordsAdGroupId : corresponds to the AdWords API AdGroup.id
    • ga:adwordsCampaignId : corresponds to the AdWords API Campaign.id
    • ga:adwordsCreativeId : corresponds to the AdWords API Ad.id
    • ga:adwordsCriteriaId : corresponds to the AdWords API Criterion.id
    • ga:adwordsCustomerId : cooresponds to the AdWords API AccountInfo.customerId

Bug Fixes

  • We fixed an issue where the Account Feed would not return data if one of the profiles had a misconfigured goal or step.

This release adds a number of new features and fixes a bug:

New Features

  • The iPhone Default Segment (gaid::-11) has been enhanced to now report on all mobile devices . The ID is the same as before (-11), but the name of the segment is now: Mobile Traffic .

  • The sampling rate used by the API is now the same as the web interface. This brings the data for sampled reports inline with the web interface and increases consistency between the two.

  • The quota policy has been updated in an effort to ensure that all users receive equitable access to resources. Please refer to our quota policy documentation for more details. The new policy is:

    • A single web property may make a maximum of 10,000 requests per 24 hours.
    • An application can only make 10 requests in any given 1-second period.
    • An application can only have 4 pending requests at any given time.

  • Some restrictions on dimension and metric combinations have been relaxed. ga:nextPagePath and ga:previousPagePath are now part of the D3. Content group. The D8. Custom Variable group is now called the D6. Custom Variable group. Please see the updated reference guide for these new combinations.

Bug Fixes

  • We fixed a bug on how the API reports the confidenceInterval value for metrics. Previously confidence intervals could have a value of either INF or a number from 0 to 1. Now all confidence intervals will have a value of either INF or a number greater than or equal to 0.

  • ga:itemQuantity and ga:uniquePurchases were previously swapped and returned each other's value. They are now fixed to return the correct data.

Deprecation of Dimensions and Metrics Reminder

  • If you haven't done so already, please stop using the previously deprecated dimensions and metrics

This release adds a number of new features:

This release increments the major version number to 2

  • Some features require the use of the latest client libraries. We officially support: Java & Javascript . 3rd party libraries might not be updated yet.

    • Version 2 may be requested by adding the header GData-Version: 2 to each account or data feed request Read the documentation for more details.
    • A new XML namespace has been added to both account and data feeds:
      xmlns:ga='http://schemas.google.com/ga/2009'

  • The API now supports the Google Data protocol version 2 .

Advanced segmentation support

  • Dynamic segments query parameter:

    • ...&segment=dynamic:: expression
    • allows creation of advanced segments “on the fly.”
    • expression can be any dimension or metric and should follow the same syntax as filters.

  • Default and custom segments query parameter:

    • ...&segment=gaid:: number
    • where number is an ID referencing an advanced segment defined in the Google Analytics Web Interface.
    • ID can be found in the account feed.

  • The account feed describes segment data through the following XML elements and attributes:

    • ga:visitorType==Returning Visitor

  • The data feed also provides an XML element indicating whether a segment was applied in the API request.

  • More details on advanced segments in our documentation .

New goal data available

  • Destination and engagement type goals available in the account feed:

  • 48 new goal metrics have been added for goals 5-20 which all follow the convention goal(n)Completions , where (n) is a number between 1 and 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value

  • GoalCompletionAll , GoalStartsAll and GoalValueAll have been updated to account for the new goal data.

New custom variable data

  • All custom variables ever collected by each profile have been added as a new XML element to the account feed:

  • 10 new dimensions have been added for custom variables. They follow the convention customVar(n) where (n) can be a number between 1 and 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Deprecated dimensions & metrics to be removed!

  • If you haven't done so already, please stop using the previously deprecated dimensions and metrics. They will be removed soon and will return errors from our API if requested.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • The following dimensions have been renamed:

    • ga:countOfVisits is now ga:visitCount
    • ga:countOfVisitsToATransaction is now ga:visitsToTransaction

This release adds new features and deprecates some old functionality:

  • The following dimensions and metrics are now deprecated. We'll be permanently removing them from our API in one month. Please make sure to update your code so your applications don't break:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • The following Dimensions have been renamed:

    • ga:countOfVisits is now ga:visitCount
    • ga:countOfVisitsToATransaction is now ga:visitsToTransaction

  • All Event Tracking data is now exposed as 2 new groups:

    D7. Events (Dimensions) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Events (Metrics) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • Overall site navigation data is is now exposed through the following dimensions:

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

  • Landing page navigation is now exposed through the following dimensions:

    D3. Content * ga:landingPagePath * ga:secondPagePath

  • The maximum length of regular expressions in the Data Feed's filter query parameter has been raised from 32 to 128 characters.

  • The Length of Visit report (found through the UI under Visitors -> Visitor Loyalty) is now exposed through the new dimension:

    • ga:visitLength

This release updates the Google Analytics Data Export API as follows:

  • Some restrictions on dimension and metric combinations have been relaxed. You can now query most content and visitor level dimensions together, for example ga:pagePath and ga:source is now a valid combination. Please see the updated reference guide for these new combinations: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • The total number of rows that can be asked for in one request has been increased to 10,000. The default number of rows returned is still 1,000, but can now be increased by setting the max-results query parameter.

  • The Account Feed now returns two new data elements for each Table ID (currency and timezone).

  • We're now enforcing that data queries must include at least one valid metric.

  • All previous deprecation changes have taken effect.

This release removes deprecated features from our private beta:

  • The account feed requests will no longer support a username in them. Instead, it will only accept requests in the following format:
    https://www.google.com/analytics/feeds/accounts/default

  • The following metrics are being removed and will no longer work. Instead, we have provided instructions on how to calculate these values here: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit

  • The following dimensions and metrics have been renamed. The old names will no longer work. Please verify you are using the official names in our documentation here: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    Dimensions * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku

    Metrics * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value