این صفحه هرگونه تغییر ایجاد شده در APIهای گزارش Google Analytics را مستند می کند. این شامل تغییرات برای API گزارش هسته و API گزارش قیف چند کانالی است. توصیه میکنیم توسعهدهندگان API بهطور دورهای این فهرست را برای اطلاعیههای جدید بررسی کنند. همچنین می توانید از طریق فیدهای فهرست شده در بخش اشتراک در زیر، در تغییرات مشترک شوید.
مشترک شدن در تغییرات مرتبط
شامل تمام APIهای مجموعه، پیکربندی و گزارش است.
شامل API گزارش هسته، API گزارش قیف چند کانالی و API گزارش زمان واقعی است.
Core Reporting API - انتشار 19-03-2019 (19 مارس 2019)
این نسخه اولیه User Activity API است
- User Activity API به شما امکان می دهد تمام داده های مرتبط با یک Client ID یا User ID را در یک محدوده تاریخ معین بازیابی کنید. در اصل برای حمایت از صاحبان دارایی که می خواهند دسترسی خودکار به داده های کاربر را مستقیماً برای آن کاربر فراهم کنند، در نظر گرفته شده است. برای جزئیات بیشتر به راهنمای API Activity User مراجعه کنید.
Core Reporting API - انتشار 23-01-2018 (23 ژانویه 2018)
با این نسخه، سیستم سهمیه مبتنی بر منابع برای Google Analytics Reporting API v4 برای همه مشتریان Analytics 360 (Premium) در دسترس است.
Real Time Reporting API - انتشار 29-11-2017 (29 نوامبر 2017)
این نسخه تغییراتی را در سهمیه ها و محدودیت های Analytics Real Time API معرفی می کند.
تماسهای Analytics Real Time Reporting API برای مشارکت در محدودیت 10000 تماس در هر بازدید (نمایه) در روز همتراز با سایر تماسهای Analytics API استفاده میشوند. اکنون، تماسهای Analytics Real Time Reporting API به طور جداگانه محاسبه میشوند، به این معنی که میتوان با استفاده از Analytics Real Time Reporting API روزانه 10000 تماس در هر نمایش (نمایه) برقرار کرد و با استفاده از هر نما (نمایه) هر روز 10000 تماس دیگر برقرار کرد. API های تجزیه و تحلیل برای اطلاعات بیشتر به صفحه محدودیت ها و سهمیه ها مراجعه کنید.
این تغییر رویکردی دقیقتر و ایمنتر برای مدیریت سهمیهها ارائه میکند، به طوری که تماسهای مکرر با استفاده از Analytics Real Time Reporting API بهطور تصادفی همه تماسهای دیگر Analytics API را در بقیه روز برای یک نمایه فردی مسدود نمیکند.
Core Reporting API - انتشار 29-11-2017 (29 نوامبر 2017)
این نسخه حداکثر تعداد ردیف های بازگشتی را در مجموعه نتایج Analytics Reporting API v4 افزایش می دهد.
حداکثر تعداد سطرهای بازگشتی در شیء Analytics Reporting API v4 ReportData از 10000 به 100000 افزایش یافته است.
Core Reporting API - انتشار 2017-10-31 (31 اکتبر 2017)
این نسخه پیش نمایشی از سیستم سهمیه مبتنی بر منابع را برای Google Analytics Reporting API نسخه 4 اضافه می کند که امکان استفاده از آستانه نمونه برداری بالاتر را برای مشتریان Analytics 360 (Premium) فراهم می کند.
Core Reporting API - انتشار 02-06-2017 (2 ژوئن 2017)
این نسخه ویژگی محصولات مرتبط و ابعاد و معیارهای مرتبط را منسوخ میکند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی منسوخ شدن داده ها را مرور کنید:
محصولات مرتبط
این نسخه ابعاد و معیارهای زیر را منسوخ میکند:
-
ga:correlationModelId
-
ga:queryProductId
-
ga:queryProductName
-
ga:queryProductVariation
-
ga:relatedProductId
-
ga:relatedProductName
-
ga:relatedProductVariation
-
ga:correlationScore
-
ga:queryProductQuantity
-
ga:relatedProductQuantity
Core Reporting API - انتشار 11-04-2017 (11 آوریل 2017)
این نسخه بعد جدیدی به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید. این نسخه همچنین چندین ابعاد و معیارهای منسوخ را حذف می کند. برای درک کامل فرآیند حذف داده ها ، خط مشی حذف داده ها را برای API های Google Analytics مرور کنید.
زمان
- بعد جدید
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
Core Reporting API - انتشار 08-03-2017 (8 مارس 2017)
این نسخه، معیارها و ابعاد موجود در API را بهروزرسانی میکند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.
معیارهای کاربر
محاسبه معیارهای کاربران و کاربران فعال برای شمارش کارآمدتر کاربران بهروزرسانی شده است. ممکن است تغییر کوچکی در معیارهای خود مشاهده کنید. برای اطلاعات بیشتر، لطفاً ببینید چگونه کاربران برای معیارهای کاربران شناسایی می شوند .
معیارهای کاربر تحت تأثیر بهروزرسانی محاسبات:
-
ga:users
- تعداد کل کاربران برای دوره زمانی درخواستی. -
ga:1dayusers
- تعداد کل کاربران فعال 1 روزه برای هر روز در بازه زمانی درخواستی. -
ga:7dayusers
- تعداد کل کاربران فعال 7 روزه برای هر روز در بازه زمانی درخواستی. -
ga:14dayusers
- تعداد کل کاربران فعال 14 روزه برای هر روز در بازه زمانی درخواستی. -
ga:30dayusers
- تعداد کل کاربران فعال 30 روزه برای هر روز در بازه زمانی درخواستی.
رویدادهای منحصر به فرد
به پایان دوره زمانی منسوخ شدن ga:uniqueEvents
نزدیک می شویم. پس از 26 مارس 2017، تعریف ga:uniqueEvents
بهروزرسانی میشود و معیار خصوصی ga:uniqueEventsTemporary
از API حذف میشود. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.
Core Reporting API - انتشار 14-02-2017 (14 فوریه 2017)
این نسخه بعد جدیدی به API اضافه میکند، پیامهای خطا را بهبود میبخشد و تغییرات اعلام شده قبلی را برای ابعاد و معیارهای AdSense اعمال میکند.
ابعاد کاربر
- Dimension -
ga:userBucket
- برای هر کاربر مشخصی، بعد User Bucket (مقادیر 1 تا 100) سطلی را نشان می دهد که کاربر به آن اختصاص داده شده است. برای جزئیات بیشتر به مقاله کمپین های بازاریابی مجدد آزمایشی مراجعه کنید.
پیغام خطا
در جایی که قبلاً API یک پیام خطای اشتباه، Unknown dimension(s):
یا Unknown metric(s):
هنگام درخواست داده با شرایطی که برآورده نشدهاند، API اکنون این پیام را برمیگرداند: Restricted metric(s): ... can only be queried under certain conditions.
ابعاد و معیارهای AdSense
نماهای مرتبط با AdSense از پرس و جو برای ابعاد و معیارهای AdSense محدود خواهند شد. پرس و جو برای این ابعاد و معیارها با بازدیدهای غیر مرتبط با AdSense منجر به خطا می شود.
Core Reporting API - انتشار 11-01-2017 (11 ژانویه 2017)
این یک نسخه رفع اشکال است که مشکل ابعاد و معیارهای AdSense را برطرف میکند و تغییرات آتی را در این ابعاد و معیارها اعلام میکند.
ابعاد و معیارهای AdSense
این نسخه مشکلی را برطرف میکند که از 1/7/2017 شروع شده بود که در آن پرس و جو برای ابعاد و معیارهای AdSense خطای «متریک ناشناخته» را برای بازدیدهای غیر مرتبط با AdSense نشان میداد.
تغییرات آینده
در یا بعد از 1/31/2017 بازدیدهای غیر مرتبط با AdSense از درخواست برای ابعاد و معیارهای AdSense محدود میشوند. پرس و جو برای این ابعاد و معیارها با بازدیدهای غیر مرتبط با AdSense منجر به خطا می شود.
Core Reporting API - انتشار 2016-10-12 (12 اکتبر 2016)
این نسخه معیار جدید زیر را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.
معیارهای محاسبه شده
این نسخه پشتیبانی از معیارهای محاسبه شده را اضافه می کند.
- متریک -
ga:calcMetric_
- مقدار متریک محاسبه شده درخواستی، که در آن به نام متریک محاسبه شده توسط کاربر اشاره دارد. توجه داشته باشید که نوع داده ga:calcMetric_
می تواند شناور، عدد صحیح، ارز، زمان یا درصد باشد. برای جزئیات، درباره معیارهای محاسبه شده را ببینید.
Core Reporting API - انتشار 26-09-2016 (26 سپتامبر 2016)
این نسخه یک معیار جدید به API اضافه می کند. همچنین یک معیار موجود را منسوخ می کند . برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.
ردیابی رویداد
تعریف ga:uniqueEvents
تغییر خواهد کرد تا تعداد رویدادهای منحصر به فرد را با دقت بیشتری منعکس کند. برای تأثیرگذاری بر این تغییر، از لحاظ فنی معیار ga:uniqueEvents
فعلی را مطابق با خطمشی منسوخ شدن دادههای خود منسوخ خواهیم کرد. اگر میخواهید تعریف جدید را امتحان کنید، میتوانید به معیار خصوصی ga:uniqueEventsTemporary
مراجعه کنید، که با دقت بیشتری تعداد رویدادهای منحصر به فرد را محاسبه میکند. ما همچنین یک متریک جدید ga:uniqueDimensionCombinations
را معرفی خواهیم کرد که تعریف فعلی ga:uniqueEvents
را حفظ می کند. پس از دوره زمانی منسوخ شدن مناسب (تقریباً 6 ماه)، متریک خصوصی ga:uniqueEventsTemporary
حذف خواهد شد و متریک اصلی ga:uniqueEvents
به درستی تعداد رویدادهای منحصر به فرد را نشان خواهد داد. برای اطلاعات بیشتر، به اسناد راهنمای رویدادهای منحصر به فرد مراجعه کنید.
رویدادهای منحصر به فرد
- متریک -
ga:uniqueEvents
- تعریفga:uniqueEvents
به زودی تغییر خواهد کرد تا تعداد رویدادهای منحصر به فرد را با دقت بیشتری منعکس کند. اگر میخواهید تعریف موجود را حفظ کنید، لطفاً به جای آن ازga:uniqueDimensionCombinations
استفاده کنید. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید. - Metric -
ga:uniqueDimensionCombinations
- Unique Dimension Combinations تعداد ترکیبهای بعد-مقدار منحصر به فرد را برای هر بعد در یک گزارش میشمارد. این به شما امکان میدهد ابعاد ترکیبی (پیوسته) را پس از پردازش بسازید، که امکان گزارش انعطافپذیرتر را بدون نیاز به بهروزرسانی پیادهسازی ردیابی یا استفاده از شکافهای بعدی سفارشی اضافی فراهم میکند. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.
تست انتقال - خصوصی
- متریک -
ga:uniqueEventsTemporary
- تعداد رویدادهای منحصر به فرد. این تعریف جدید برایga:uniqueEvents
خواهد بود. می توانید از این معیار برای درک تعریف جدید قبل از تغییر استفاده کنید. توجه داشته باشید که این معیار خصوصی است و در مرجع ابعاد و معیارها نشان داده نخواهد شد.
Core Reporting API - انتشار 09-08-2016 (9 اوت 2016)
این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.
DoubleClick Bid Manager
- بعد -
ga:dbmClickAdvertiser
- نام تبلیغکننده DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmClickAdvertiserId
- شناسه تبلیغکننده DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmClickCreativeId
- شناسه خلاق DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد). - Dimension -
ga:dbmClickExchange
- نام تبادل DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmClickExchangeId
- شناسه تبادل DBM کلیک DBM مطابق با جلسه Google Analytics (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد). - بعد -
ga:dbmClickInsertionOrder
- نام سفارش درج DBM کلیک DBM مطابق با جلسه Google Analytics (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد). - بعد -
ga:dbmClickInsertionOrderId
- شناسه ترتیب درج DBM کلیک DBM مطابق با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmClickLineItem
- نام مورد خط DBM کلیک DBM با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد). - بعد -
ga:dbmClickLineItemId
- شناسه مورد خط DBM کلیک DBM با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmClickSite
- نام سایت DBM که در آن خلاقیت DBM نشان داده شده و برای کلیک DBM مطابق با جلسه Google Analytics روی آن کلیک شده است (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmClickSiteId
- شناسه سایت DBM که در آن خلاقیت DBM نشان داده شده و برای کلیک DBM مطابق با جلسه Google Analytics روی آن کلیک شده است (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد). - بعد -
ga:dbmLastEventAdvertiser
- نام تبلیغکننده DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به یکپارچهسازی با DBM دارد). - بعد -
ga:dbmLastEventAdvertiserId
- شناسه تبلیغکننده DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventCreativeId
- شناسه خلاق DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventExchange
- نام تبادل DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventExchangeId
- شناسه تبادل DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventInsertionOrder
- نام سفارش درج DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventInsertionOrderId
- شناسه سفارش درج DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - ابعاد -
ga:dbmLastEventLineItem
- نام مورد خط DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventLineItemId
- شناسه مورد خط DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد). - بعد -
ga:dbmLastEventSite
- نام سایت DBM که در آن خلاقیت DBM برای آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد) نشان داده شده و روی آن کلیک شده است. - بعد -
ga:dbmLastEventSiteId
- شناسه سایت DBM که در آن خلاقیت DBM برای آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد) نشان داده شد و روی آن کلیک کرد. - متریک -
ga:dbmCPA
- eCPA درآمد DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد). - متریک -
ga:dbmCPC
- eCPC درآمد DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد). - متریک -
ga:dbmCPM
- eCPM درآمد DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد). - متریک -
ga:dbmCTR
- DBM CTR (فقط Analytics 360، نیاز به ادغام با DBM دارد). - متریک -
ga:dbmClicks
- کل کلیکهای DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد). - Metric -
ga:dbmConversions
- DBM Total Conversions (فقط Analytics 360، نیاز به ادغام با DBM دارد). - Metric -
ga:dbmCost
- DBM Cost (فقط Analytics 360، نیاز به ادغام با DBM دارد). - Metric -
ga:dbmImpressions
- DBM Total Impressions (فقط Analytics 360، نیاز به ادغام با DBM دارد). - Metric -
ga:dbmROAS
- DBM ROAS (فقط Analytics 360، نیاز به ادغام با DBM دارد).
جستجوی DoubleClick
- Dimension -
ga:dsAdGroup
- DS Ad Group (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsAdGroupId
- DS Ad Group ID (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsAdvertiser
- DS Advertiser (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsAdvertiserId
- DS Advertiser ID (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsAgency
- DS Agency (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsAgencyId
- DS Agency ID (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsCampaign
- DS Campaign (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsCampaignId
- DS Campaign ID (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsEngineAccount
- DS Engine Account (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsEngineAccountId
- شناسه حساب موتور DS (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsKeyword
- DS Keyword (فقط Analytics 360، نیاز به ادغام با DS دارد). - Dimension -
ga:dsKeywordId
- DS Keyword ID (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsCPC
- هزینه DS برای تبلیغ کننده در هر کلیک (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsCTR
- نرخ کلیک DS (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsClicks
- DS Clicks (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsCost
- DS Cost (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsImpressions
- DS Impressions (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsProfit
- DS Profie (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsReturnOnAdSpend
- DS Return On Ad Spend (فقط Analytics 360، نیاز به ادغام با DS دارد). -
ga:dsRevenuePerClick
- DS Revenue Per Click (فقط Analytics 360، نیاز به ادغام با DS دارد).
API گزارش قیف چند کانالی - انتشار 14-07-2016 (14 ژوئیه 2016)
این نسخه بعد جدیدی به API اضافه می کند. برای فهرست کامل تعاریف، مرجع ابعاد و معیارها را بررسی کنید.
شناسه تراکنش
- ابعاد -
mcf:transactionId
- شناسه تراکنش که با روش ردیابی تجارت الکترونیک برای خرید در سبد خرید ارائه شده است.
Core Reporting API - انتشار 14-07-2016 (14 ژوئیه 2016)
این نسخه بعد جدیدی به 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
-
Core Reporting API - انتشار 08-07-2016 (8 ژوئیه 2016)
این نسخه محدودیت ها و سهمیه های جدیدی را معرفی می کند. برای جزئیات به اسناد محدودیت ها و سهمیه ها مراجعه کنید.
گزارش خطاها
این نسخه شروع به اعمال محدودیت در درخواست های گزارش ناموفق ( 5XX
) می کند.
- 10 درخواست ناموفق برای هر پروژه در هر نمایه در ساعت.
- 50 درخواست ناموفق برای هر پروژه در هر نمایه در روز.
محدودیت های محوری
این نسخه شروع به اعمال محدودیت در درخواست های محوری می کند:
Core Reporting API - انتشار 17-06-2016 (17 ژوئن 2016)
این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.
شبکه جغرافیایی
- بعد -
ga:metroId
- کد سه رقمی منطقه بازار تعیین شده (DMA) از جایی که ترافیک وارد شده است، که از آدرس های IP یا شناسه های جغرافیایی کاربران مشتق شده است.
DoubleClick for Publishers
- متریک -
ga:dfpImpressions
- هر زمان که یک تبلیغ منفرد در وب سایت نمایش داده می شود، نمایش تبلیغ DFP گزارش می شود. به عنوان مثال، اگر یک صفحه با دو واحد تبلیغاتی یک بار مشاهده شود، دو نمایش نمایش داده میشود (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:dfpCoverage
- پوشش درصدی از درخواستهای تبلیغاتی است که حداقل یک آگهی را برگردانده است. به طور کلی، پوشش می تواند به شناسایی سایت هایی که حساب DFP قادر به ارائه تبلیغات هدفمند نیست کمک کند. (نمایش آگهی / مجموع درخواست های آگهی) * 100 (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:dfpMonetizedPageviews
- این تعداد کل بازدیدهای صفحه در دارایی را که با یک تبلیغ از حساب DFP پیوند شده نشان داده شده است اندازه گیری می کند. توجه داشته باشید که یک صفحه میتواند چندین واحد تبلیغاتی داشته باشد (پیوند دادن DFP فعال است و درآمد DFP پنهان نشده است). - متریک -
ga:dfpImpressionsPerSession
- نسبت نمایشهای تبلیغات DFP به جلسات آنالیز (Ad Impressions / Analytics Sessions) (پیوند DFP فعال است و درآمد DFP را پنهان کنید فعال نیست). - متریک -
ga:dfpViewableImpressionsPercent
- درصد نمایشهای تبلیغاتی قابل مشاهده. یک نمایش زمانی که در مرورگرهای کاربران ظاهر شده باشد و فرصت دیده شدن را داشته باشد، یک نمایش قابل مشاهده در نظر گرفته میشود (پیوند DFP فعال است و درآمد DFP پنهان نشده است). - متریک -
ga:dfpClicks
- تعداد دفعاتی که تبلیغات DFP روی سایت کلیک شده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است). - متریک -
ga:dfpCTR
- درصد بازدید از صفحه که منجر به کلیک روی یک تبلیغ DFP شده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است). - Metric -
ga:dfpRevenue
- درآمد DFP تخمینی از کل درآمد تبلیغات بر اساس نمایشهای ارائهشده است (پیوند DFP فعال و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:dfpRevenuePer1000Sessions
- کل درآمد تخمینی از تبلیغات DFP در هر 1000 جلسه Analytics. توجه داشته باشید که این معیار براساس جلسات سایت است، نه بر اساس نمایش تبلیغات (پیوند DFP فعال است و درآمد DFP پنهان نشده است).» - متریک -
ga:dfpECPM
- هزینه موثر در هر هزار بازدید از صفحه. این درآمد DFP به ازای هر 1000 بازدید از صفحه است (پیوند DFP فعال است و درآمد DFP پنهان نشده است). - متریک -
ga:backfillImpressions
- Backfill Impressions مجموع همه نمایشهای تبلیغات AdSense یا Ad Exchance است که از طریق DFP بهعنوان پرکننده استفاده میشوند. هر زمان که یک تبلیغ فردی در وب سایت نمایش داده می شود، یک نمایش آگهی گزارش می شود. به عنوان مثال، اگر یک صفحه با دو واحد تبلیغاتی یک بار مشاهده شود، دو نمایش نمایش داده میشود (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - Metric -
ga:backfillCoverage
- Backfill Coverage درصدی از درخواستهای تبلیغاتی است که حداقل یک آگهی را برگردانده است. به طور کلی، پوشش می تواند به شناسایی سایت هایی کمک کند که حساب ناشر قادر به ارائه تبلیغات هدفمند نیست. (نمایشهای آگهی / مجموع درخواستهای آگهی) * 100. اگر هم AdSense و هم Ad Exchange آگهیهای تکمیلی ارائه میدهند، این معیار میانگین وزنی دو حساب تکمیلی است (پیوند DFP فعال است و درآمد DFP فعال نشده است).» - متریک -
ga:backfillMonetizedPageviews
- این تعداد کل بازدیدهای صفحه در دارایی را که با حداقل یک تبلیغ از حساب(های) پرکننده پیوند شده نشان داده شده است، اندازه گیری می کند. توجه داشته باشید که یک بازدید از صفحه واحد پولی میتواند شامل چندین نمایش تبلیغاتی باشد (پیوند DFP فعال است و درآمد DFP پنهان نشده است). - متریک -
ga:backfillImpressionsPerSession
- نسبت نمایشهای تبلیغاتی پسپرده به جلسات Analytics (Ad Impressions / Analytics Sessions). اگر هم AdSense و هم Ad Exchange تبلیغات پشتیبان ارائه می دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:backfillViewableImpressionsPercent
- درصدی از نمایشهای تبلیغاتی که قابل مشاهده بودند. یک برداشت زمانی به عنوان یک برداشت قابل مشاهده در نظر گرفته می شود که در مرورگر کاربران ظاهر شده باشد و فرصت دیده شدن داشته باشد. اگر AdSense و Ad Exchange هر دو آگهیهای پرکننده ارائه میدهند، این معیار میانگین وزنی دو حساب پرکننده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).» - متریک -
ga:backfillClicks
- تعداد دفعاتی که تبلیغات backfill روی سایت کلیک شده است. اگر AdSense و Ad Exchange هر دو آگهیهای پرکننده ارائه میدهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:backfillCTR
- درصد نمایشهای پرشده که منجر به کلیک روی یک آگهی شده است. اگر AdSense و Ad Exchange هر دو آگهیهای پرکننده ارائه میدهند، این معیار میانگین وزنی دو حساب پرکننده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).» - متریک -
ga:backfillRevenue
- کل درآمد تخمینی از تبلیغات پشتیبان. اگر AdSense و Ad Exchange هر دو آگهیهای پرکننده ارائه میدهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:backfillRevenuePer1000Sessions
- کل درآمد تخمینی از تبلیغات پشتیبان در هر 1000 جلسه Analytics. توجه داشته باشید که این معیار براساس جلسات سایت است و نه نمایش تبلیغات. اگر هم AdSense و هم Ad Exchange تبلیغات پشتیبان ارائه می دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست). - متریک -
ga:backfillECPM
- هزینه موثر در هر هزار بازدید از صفحه. این درآمد DFP Backfill در هر 1000 بازدید از صفحه است. اگر هم AdSense و هم Ad Exchange تبلیغات پشتیبان ارائه می دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
Core Reporting API - انتشار 18-05-2016 (18 مه 2016)
این یک نسخه رفع اشکال است که مشکل مربوط به بخش ها و نمونه برداری را برطرف می کند.
بخش ها
این نسخه مشکلی را برطرف میکند که باعث میشود زیرمجموعهای از درخواستها با بخش All Users ( gaid::-1
) در Core Reporting API V3 کم شمارش شوند و در Analytics Reporting API V4 به دو بخش تقسیم شوند.
نمونه برداری
این نسخه مشکلی را برطرف می کند که در آن زیر مجموعه ای از درخواست ها از جداول سفارشی داده های نمونه را برمی گرداند.
Core Reporting API - انتشار 29-04-2016 (29 آوریل 2016)
این یک نسخه رفع اشکال است که مشکلی را هنگام ایجاد درخواستهای گروهی Analytics Reporting API V4 برطرف میکند.
درخواست های گروهی
اکنون درخواستهای همگروهی میتوانند همه ابعاد همگروهی را درخواست کنند. قبلاً API هنگام درخواست ابعاد ga:acquisition...
خطایی را برمیگرداند.
درخواست ارزش مادام العمر LTV
لطفاً توجه داشته باشید که درخواستهای ارزش مادام العمر میتوانند گزارشهای ارزش مادامالعمر را فقط برای بازدیدهای برنامه ایجاد کنند.
API فراداده - انتشار 08-04-2016 (8 آوریل 2016)
این نسخه یک ویژگی جدید addedInApiVersion
اضافه می کند.
در نسخه API اضافه شده است
-
addedInApiVersion
یک ویژگی عددی است که می تواند برای بررسی اینکه آیا یک ستون می تواند در یک API گزارش یک نسخه مشخص استفاده شود یا خیر استفاده می شود. برای جزئیات بیشتر به Metadata API - Developer Guide مراجعه کنید.
Core Reporting API - انتشار 08-04-2016 (8 آوریل 2016)
این نسخه نسخه جدیدی از API را معرفی می کند، Analytics Reporting API V4 . این API جدید پیشرفته ترین روش برنامه نویسی برای دسترسی به داده های گزارش در Google Analytics است.
ویژگی های کلیدی
Google Analytics بر اساس یک زیرساخت گزارش دهی قدرتمند ساخته شده است. API به توسعه دهندگان امکان دسترسی به قدرت پلتفرم Google Analytics را می دهد. برخی از ویژگی های کلیدی در Analytics Reporting API V4 شامل موارد زیر است:
- عبارات متریک - API به شما امکان می دهد نه تنها معیارهای داخلی بلکه عبارات متریک ریاضی را نیز درخواست کنید. به عنوان مثال، تکمیل هدف به ازای هر تعداد جلسه میتواند در درخواست به صورت
ga:goal1completions/ga:sessions
بیان شود. - محدوده تاریخ چندگانه - پشتیبانی از درخواست دو محدوده تاریخ، به شما امکان می دهد داده ها را برای دو دوره در یک درخواست مقایسه کنید.
- گروهها و ارزش طول عمر - API دارای واژگان غنی برای درخواست گزارشهای ارزش همگروهی و طول عمر است.
- چند بخش - اکنون می توانید چندین بخش را در یک درخواست درخواست کنید.
شروع شدن
برای همه جزئیات در مورد شروع کار با API به مستندات توسعه دهنده مراجعه کنید.
خط مشی سهمیه
Analytics Reporting API V4 دارای سهمیه ها و محدودیت های خاص خود است. از آنجایی که این یک API جدید است، این محدودیت ها و سهمیه ها ممکن است تغییر کنند.
مهاجرت
همراه با راهنمای مهاجرت ، ما همچنین یک کتابخانه سازگاری پایتون را در Github در دسترس قرار می دهیم.
ابعاد و متریک
این نسخه همچنین مجموعه ای از ابعاد و معیارها را به طور خاص برای Analytics Reporting API V4 اضافه می کند. برای تعاریف فهرست کامل ، کاوشگر ابعاد و معیارها را ببینید.
بعد -
ga:cohort
- نام گروهی که یک کاربر به آن تعلق دارد بر اساس تعریف گروهها. بسته به نحوه تعریف گروهها، یک کاربر میتواند به گروههای متعددی تعلق داشته باشد، مشابه اینکه کاربر میتواند به چند بخش تعلق داشته باشد.بعد -
ga:cohortNthDay
- افست روز بر اساس 0 نسبت به تاریخ تعریف گروه. به عنوان مثال، اگر یک گروه با اولین تاریخ بازدید به عنوان 2015-09-01 تعریف شود، برای تاریخ 2015-09-04، ga:cohortNthDay 3 خواهد بود.ga:cohortNthMonth
- افست ماه مبتنی بر 0 نسبت به تاریخ تعریف گروه.بعد -
ga:cohortNthWeek
- افست هفته مبتنی بر 0 نسبت به تاریخ تعریف گروه.بعد -
ga:acquisitionTrafficChannel
- کانال ترافیکی که از طریق آن کاربر به دست آمده است. از اولین جلسه کاربر استخراج می شود. کانال ترافیک بر اساس قوانین پیشفرض گروهبندی کانال (در سطح مشاهده در صورت وجود) در زمان جذب کاربر محاسبه میشود.Dimension -
ga:acquisitionSource
- منبعی که کاربر از طریق آن به دست آمده است. برگرفته از اولین جلسه کاربر.Dimension -
ga:acquisitionMedium
- رسانه ای که از طریق آن کاربر به دست آمده است. برگرفته از اولین جلسه کاربر.Dimension -
ga:acquisitionSourceMedium
- مقدار ترکیبی ga:userAcquisitionSource و ga:acquisitionMedium.Dimension -
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
- جلسات به ازای هر کاربر برای یک گروه.Metric -
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
- مدت جلسه به ازای هر کاربر برای بعد اکتساب برای یک گروه.
Core Reporting API - انتشار 30-03-2016 (30 مارس 2016)
ابعاد و معیارهای مرکز داده اجتماعی منسوخ شده است و فقط از 30 آوریل 2016 در مورد داده های تاریخی گزارش می دهد. پس از این تاریخ هیچ داده جدیدی ظاهر نمی شود. طبق خطمشی منسوخ شدن دادهها ، این ابعاد و معیارها پس از 30 سپتامبر 2016 حذف خواهند شد.
برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.
فعالیت های اجتماعی
این ابعاد و معیارها منسوخ شده اند و پس از 30 سپتامبر 2016 حذف خواهند شد. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی منسوخ شدن داده ها را مرور کنید:
- Dimension -
ga:socialActivityEndorsingUrl
- برای یک فعالیت قطبی داده های اجتماعی ، این URL فعالیت اجتماعی است (به عنوان مثال ، URL پست Google+ ، URL نظرات وبلاگ و غیره). - Dimension -
ga:socialActivityDisplayName
- برای یک فعالیت توپی داده های اجتماعی ، این عنوان فعالیت اجتماعی است که توسط کاربران شبکه اجتماعی ارسال شده است. - Dimension -
ga:socialActivityPost
- برای یک فعالیت قطبی داده های اجتماعی ، این محتوای فعالیت اجتماعی (به عنوان مثال ، محتوای پیام ارسال شده در Google+) است که توسط کاربران شبکه های اجتماعی ارسال شده است. - ابعاد -
ga:socialActivityTimestamp
- برای فعالیت قطبی داده های اجتماعی ، این زمانی است که فعالیت اجتماعی در شبکه اجتماعی رخ داده است. - ابعاد -
ga:socialActivityUserHandle
- برای یک فعالیت توپی داده های اجتماعی ، این دسته از شبکه های اجتماعی (به عنوان مثال نام یا شناسه) کاربرانی است که فعالیت اجتماعی را آغاز کرده اند. " - Dimension -
ga:socialActivityUserPhotoUrl
- برای یک فعالیت توپی داده های اجتماعی ، این URL عکس مرتبط با پروفایل شبکه های اجتماعی کاربران است. " - Dimension -
ga:socialActivityUserProfileUrl
- برای یک فعالیت توپی داده های اجتماعی ، این URL پروفایل شبکه های اجتماعی کاربران مرتبط است. - ابعاد -
ga:socialActivityTagsSummary
- برای یک فعالیت توپی داده های اجتماعی ، این مجموعه ای از برچسب های جدا از کاما است. " - ابعاد -
ga:socialActivityAction
- برای یک فعالیت توپی داده های اجتماعی ، این نشان دهنده نوع اقدامات اجتماعی (به عنوان مثال ، رأی ، اظهار نظر ، 1+ و غیره) مرتبط با فعالیت است. - ابعاد -
ga:socialActivityNetworkAction
- برای یک فعالیت قطبی داده های اجتماعی ، این نوع اقدام اجتماعی و شبکه اجتماعی است که در آن فعالیت سرچشمه گرفته است. - Dimension -
ga:socialActivityContentUrl
- برای یک فعالیت قطبی داده های اجتماعی ، این URL است که توسط کاربران شبکه اجتماعی مرتبط به اشتراک گذاشته شده است. - Metric -
ga:socialActivities
- تعداد کل فعالیت هایی که در آن یک URL محتوا به اشتراک گذاشته شده یا در یک شبکه شریک اطلاعات اجتماعی به اشتراک گذاشته شده یا ذکر شده است.
Core Reporting API-انتشار 2016-02-03 (3 فوریه 2016)
این نسخه بعد جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
سیستم عامل یا دستگاه
- Dimension -
ga:browserSize
- اندازه نمای مرورگرهای کاربران. اندازه مرورگر ابعاد scoped جلسه ای است که ابعاد اولیه نمای در پیکسل ها را ضبط می کند و به عنوان ارتفاع X X قالب بندی می شود. به عنوان مثال ، 1920x960.
Core Reporting API-انتشار 2015-11-16 (16 نوامبر 2015)
این نسخه پارامتر جدیدی را به API اضافه می کند.
شامل ردیف های خالی
- این نسخه به پارامتر اختیاری جدید
include-empty-rows
اضافه می کند ، که هنگام تنظیم روی ردیف هایfalse
بدون داده از پاسخ حذف می شوند. مقدار پیش فرضtrue
است ، که یک تغییر غیر شکستن است و به همین ترتیب نیازی به بروزرسانی کد نیست. برای جزئیات بیشتر به مستندات مرجع API Core مراجعه کنید.
Core Reporting API-انتشار 2015-10-06 (6 اکتبر 2015)
این نسخه معیارهای جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
کاربر
- Metric -
ga:1dayUsers
- تعداد کل کاربران فعال 1 روزه برای هر روز در دوره زمانی درخواست شده. حداقل یکی از GA: Nthday ، GA: Date ، یا GA: Day باید به عنوان یک بعد مشخص شود تا از این متریک پرس و جو کند. برای تاریخ معین ، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 1 روزه منتهی به تاریخ معین خواهد بود. - متریک -
ga:7dayUsers
- تعداد کل کاربران فعال 7 روزه برای هر روز در دوره زمانی درخواست شده. حداقل یکی از GA: Nthday ، GA: Date ، یا GA: Day باید به عنوان یک بعد مشخص شود تا از این متریک پرس و جو کند. برای تاریخ معین ، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 7 روزه منتهی به تاریخ معین خواهد بود. - متریک -
ga:14dayUsers
- تعداد کل کاربران فعال 14 روزه برای هر روز در دوره زمانی درخواست شده. حداقل یکی از GA: Nthday ، GA: Date ، یا GA: Day باید به عنوان یک بعد مشخص شود تا از این متریک پرس و جو کند. برای تاریخ معین ، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 14 روزه منتهی به تاریخ معین خواهد بود. - Metric -
ga:30dayUsers
- تعداد کل کاربران فعال 30 روزه برای هر روز در دوره زمانی درخواست شده. حداقل یکی از GA: Nthday ، GA: Date ، یا GA: Day باید به عنوان یک بعد مشخص شود تا از این متریک پرس و جو کند. برای تاریخ معین ، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 30 روزه منتهی به تاریخ معین خواهد بود.
Core Reporting API-انتشار 2015-09-11 (11 سپتامبر 2015)
این نسخه معیارهای جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
Exchange Ad DoubleClick (ADX)
- Metric -
ga:adxCTR
- درصد نمای صفحه که منجر به کلیک بر روی یک تبلیغ ADX شد. - Metric -
ga:adxClicks
- تعداد دفعات تبلیغات ADX در سایت شما کلیک شده است. - Metric -
ga:adxCoverage
- پوشش درصد درخواست های AD است که حداقل یک تبلیغ را برگرداند. به طور کلی ، پوشش می تواند به شما در شناسایی سایتهایی که حساب ADX شما قادر به ارائه تبلیغات هدفمند نیست ، کمک کند. (برداشت های تبلیغاتی / کل درخواست های تبلیغی) * 100 - Metric -
ga:adxECPM
- هزینه مؤثر در هر هزار صفحه. این درآمد ADX شما در هر 1000 صفحه نمایش است. - Metric -
ga:adxImpressions
- هر زمان که یک آگهی شخصی در وب سایت شما نمایش داده می شود ، تصور تبلیغات ADX گزارش می شود. به عنوان مثال ، اگر یک صفحه با دو واحد تبلیغی یک بار مشاهده شود ، ما دو برداشت را نمایش می دهیم. - Metric -
ga:adxImpressionsPerSession
- نسبت برداشت ADX AD به جلسات تحلیلی (جلسات Impressions / Analytics). - Metric -
ga:adxMonetizedPageviews
- PageViews از درآمدزایی تعداد کل صفحه های موجود در دارایی شما را که با یک آگهی از حساب ADX مرتبط شما نشان داده شده است ، اندازه گیری می کند. توجه: یک صفحه واحد می تواند چندین واحد تبلیغاتی داشته باشد. - Metric -
ga:adxRevenue
- کل درآمد تخمین زده شده از تبلیغات ADX. - Metric -
ga:adxRevenuePer1000Sessions
- کل درآمد تخمین زده شده از تبلیغات ADX در هر 1000 جلسه تجزیه و تحلیل. توجه داشته باشید که این متریک مبتنی بر جلسات به سایت شما است و نه برداشت های تبلیغاتی. - Metric -
ga:adxViewableImpressionsPercent
- درصد برداشت های تبلیغاتی که قابل مشاهده بودند. تصور وقتی در مرورگر کاربر ظاهر شد و این فرصت را داشت که دیده شود ، یک تصور قابل مشاهده در نظر گرفته می شود.
Core Reporting API-انتشار 2015-07-23 (23 ژوئیه 2015)
این نسخه ابعاد یا معیارهای موجود را کاهش می دهد. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
ابعاد کاهش یافته
این ابعاد کاهش یافته است. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی استهلاک داده ها را مرور کنید:
- Dimension -
ga:adSlotPosition
- به جای آن ازga:adSlot
استفاده کنید. - Dimension -
ga:nextPagePath
-ga:pagePath
به جای آن استفاده کنید. - Dimension -
ga:nextContentGroupXX
- به جای آنga:contentGroupXX
استفاده کنید.
Core Reporting API-انتشار 2015-05-06 (6 مه 2015)
این نسخه بعد جدیدی را به API اضافه می کند. ابعاد و مرجع معیارها را برای لیست کامل ابعاد و معیارها بررسی کنید.
کلمات پیشنهادی
- Dimension -
ga:adQueryWordCount
- تعداد کلمات موجود در جستجوی جستجو.
Core Reporting API - انتشار 20-02-2015 (20 فوریه 2015)
این نسخه ابعاد جدیدی را به API اضافه می کند. ابعاد و مرجع معیارها را برای لیست کامل ابعاد و معیارها بررسی کنید.
سیستم عامل یا دستگاه
- Dimension -
ga:dataSource
- منبع داده یک ضربه. بازدیدهای ارسال شده از GA.JS و Analytics.js به عنوان "وب" گزارش شده است. بازدیدهای ارسال شده از SDK های موبایل به عنوان "برنامه" گزارش شده است. این مقادیر می توانند نادیده گرفته شوند.
جستجوی داخلی
- Dimension -
ga:searchAfterDestinationPage
- صفحه ای که کاربر پس از انجام یک جستجوی داخلی در سایت شما از آن بازدید کرده است.
گزارش واقعی API-انتشار 2015-02-12 (12 فوریه 2015)
این یک نسخه رفع اشکال است:
- این نسخه مسئله ای را در اجرای محدودیت های فیلتر در پرس و جو گزارش API در زمان واقعی برطرف می کند. درخواست های
rt:activeUsers
و یک فیلتر در ابعاد سطح رویداد منجر به خطایی با یک دلیلbadRequest
و یک پیام می شود کهOR operator not supported for a hit level filter
. برای اطلاعات بیشتر در مورد محدودیت های پرس و جو ، به راهنمای توسعه دهنده API Real Time Reporting مراجعه کنید.
Core Reporting API-انتشار 2015-01-21 (21 ژانویه 2015)
این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند و دو معیار موجود را کاهش می دهد. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
تجارت الکترونیک
- Metric -
ga:transactionsPerUser
- تعداد کل معاملات تقسیم شده توسط تعداد کل کاربران. - Metric -
ga:revenuePerUser
- کل درآمد فروش ارائه شده در معامله به استثنای حمل و نقل و مالیات تقسیم شده توسط تعداد کل کاربران.
کاربر
- Metric -
ga:sessionsPerUser
- تعداد کل جلسات تقسیم بر تعداد کل کاربران.
شبکه جغرافیایی
- Dimension -
ga:cityId
- شناسه های شهر کاربران ، که از آدرس IP یا شناسه های جغرافیایی گرفته شده است. - Dimension -
ga:countryIsoCode
- کد کاربران ISO کشور ، که از آدرس IP یا شناسه های جغرافیایی گرفته شده است. مقادیر به عنوان یک کد ISO-3166-1 alpha-2 داده می شوند. - Dimension -
ga:regionId
- شناسه منطقه کاربران ، که از آدرس های IP یا شناسه های جغرافیایی گرفته شده است. در ایالات متحده ، یک منطقه یک ایالت مانند نیویورک است. - Dimension -
ga:regionIsoCode
- منطقه ISO از کاربران ، مشتق شده از آدرس های IP یا شناسه های جغرافیایی. مقادیر به عنوان یک کد ISO-3166-2 ارائه شده است. - Dimension -
ga:subContinentCode
- کد زیر قاره کاربران ، که از آدرس های IP یا شناسه های جغرافیایی گرفته شده است. به عنوان مثال ، پولینزی یا اروپای شمالی. مقادیر به عنوان یک کد M.49 سازمان ملل داده می شوند.
مدیر کمپین DoubleClick
- Metric -
ga:dcmROAS
- DCM بازگرداندن هزینه های تبلیغاتی (ROAS) (فقط حق بیمه).
معیارهای مستهلک
این معیارها کاهش یافته است. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی استهلاک داده ها را مرور کنید: + متریک - ga:dcmROI
- به جای آن ga:dcmROAS
استفاده کنید. + Metric - ga:dcmMargen
- به جای آن ga:dcmROAS
استفاده کنید.
Core Reporting API-انتشار 2014-10-09 (9 اکتبر 2014)
این نسخه متریک جدیدی را به API اضافه می کند و دو معیار موجود را کاهش می دهد. برای لیست کامل تعاریف ، ابعاد و معیارها را بررسی کنید.
کلمات پیشنهادی
- Metric -
ga:ROAS
- Return Of Ad Devery (ROAS) کل درآمد و ارزش هدف معامله است که با هزینه تبلیغات مشتق شده تقسیم می شود.
ابعاد و معیارهای کاهش یافته
این ابعاد و معیارها کاهش یافته است. خط مشی استهلاک داده ها را برای جزئیات در مورد حذف داده ها مرور کنید: + متریک - ga:ROI
- به جای آن از ga:ROAS
استفاده کنید. + متریک - ga:margin
- به جای آن از ga:ROAS
استفاده کنید.
گزارش واقعی API-انتشار 2014-10-01 (1 اکتبر 2014)
این نسخه شامل یک بعد جدید است. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
زمان
- ابعاد -
rt:minutesAgo
- تعداد دقایقی قبل یک ضربه رخ داد.
Core Reporting API-انتشار 2014-10-01 (1 اکتبر 2014)
این نسخه معیارهای جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را بررسی کنید.
AdSense
- Metric -
ga:adsenseCoverage
- درصد درخواست های تبلیغاتی که حداقل یک تبلیغ را برگرداند. - Metric -
ga:adsenseViewableImpressionPercent
- درصد برداشت هایی که قابل مشاهده بودند.
قیف های چند کانال گزارش API-انتشار 2014-08-25 (25 اوت 2014)
این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را بررسی کنید.
مسیرهای تبدیل
- DIMENSION -
mcf:dcmAd
- DCM AD نام رویداد DCM (تصور یا کلیک) مطابق با تبدیل Google Analytics. - ابعاد -
mcf:dcmAdPath
- مسیر تبدیل که در آن تعامل در مسیر توسط تبلیغات DCM نشان داده می شود. - DIMENSION -
mcf:dcmAdType
- DCM AD TYPE نام رویداد DCM (Impression یا کلیک) مطابق با تبدیل Google Analytics. - DIMENSION -
mcf:dcmAdvertiser
- DCM Advertiser نام رویداد DCM (Impression یا کلیک) مطابق با تبدیل Google Analytics. - Dimension -
mcf:dcmAdvertiserPath
- مسیر تبدیل که تعامل در مسیر توسط تبلیغ کنندگان DCM نشان داده می شود. - Dimension -
mcf:dcmCampaign
- نام کمپین DCM از رویداد DCM (Impression یا کلیک) مطابق با تبدیل Google Analytics. - ابعاد -
mcf:dcmCampaignPath
- مسیر تبدیل که تعامل در مسیر توسط کمپین های DCM نشان داده می شود. - DIMENSION -
mcf:dcmCreative
- DCM نام خلاق رویداد DCM (Impression یا کلیک) مطابق با تبدیل Google Analytics. - Dimension -
mcf:dcmCreativePath
- مسیر تبدیل که تعامل در مسیر توسط خلاقین DCM نشان داده می شود. - Dimension -
mcf:dcmCreativeVersion
- نسخه خلاق DCM از رویداد DCM (Impression یا کلیک) مطابق با تبدیل Google Analytics. - Dimension -
mcf:dcmCreativeVersionPath
- مسیر تبدیل که در آن تعامل در مسیر توسط نسخه های خلاق DCM نشان داده می شود. - Dimension -
mcf:dcmNetwork
- شبکه مورد استفاده. - DIMENSION -
mcf:dcmPlacement
- نام محل قرارگیری سایت DCM از رویداد DCM (Impression یا کلیک) مطابق با تبدیل Google Analytics. - ابعاد -
mcf:dcmPlacementPath
- مسیر تبدیل که در آن تعامل در مسیر توسط مکان های DCM نشان داده می شود. - Dimension -
mcf:dcmSite
- نام سایت DCM که در آن DCM Creative برای رویداد DCM (تصور یا کلیک) مطابق با تبدیل Google Analytics نشان داده شده است. - Dimension -
mcf:dcmSitePath
- مسیر تبدیل که در آن تعامل در مسیر توسط سایت های DCM نشان داده می شود. - متریک -
mcf:firstImpressionConversions
- تعداد تبدیل هایی که تصور کمپین DCM برای اولین تعامل تبدیل در یک پنجره 30 روزه جستجو بود. این بعد شامل تکمیل هدف و معاملات است. - Metric -
mcf:firstImpressionValue
- ارزش تبدیل هایی که برای آنها یک انتخاب کمپین DCM اولین تعامل تبدیل در یک پنجره 30 روزه جستجو بود. این بعد شامل تکمیل هدف و معاملات است. - Metric -
mcf:impressionAssistedConversions
- تعداد تبدیل هایی که یک تصور کمپین DCM در مسیر تبدیل ظاهر می شود ، اما تعامل تبدیل نهایی نبود. این بعد شامل تکمیل هدف و معاملات است. - Metric -
mcf:impressionAssistedValue
- ارزش تبدیل هایی که یک تصور کمپین DCM در مسیر تبدیل ظاهر شد ، اما تعامل تبدیل نهایی نبود. این بعد شامل تکمیل هدف و معاملات است.
Core Reporting API - انتشار 25-08-2014 (25 اوت 2014)
این نسخه شامل افزودن یک متریک جلسه جدید ، ابعاد جدید منابع ترافیکی و ابعاد و معیارهای مدیر کمپین جدید DoubleClick است.
ابعاد و معیارها
برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
جلسه
- متریک -
ga:hits
- تعداد کل بازدیدهای ارسال شده به Google Analytics. این متریک همه انواع ضربه را جمع می کند (به عنوان مثال صفحه نمایش ، رویداد ، زمان بندی و غیره)
منابع ترافیک
- DIMENSION -
ga:campaignCode
- هنگام استفاده از ردیابی کمپین دستی ، مقدار پارامتر ردیابی کمپین UTM_ID.
مدیر کمپین DoubleClick
- DIMENSION -
ga:dcmClickAd
- DCM AD نام DCM با تطبیق جلسه Google Analytics (فقط حق بیمه) کلیک کنید. - DIMENSION -
ga:dcmClickAdId
- شناسه تبلیغاتی DCM از DCM با مطابقت با جلسه Google Analytics (فقط حق بیمه) کلیک کنید. - DIMENSION -
ga:dcmClickAdType
- DCM AD Type نام DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickAdTypeId
- شناسه نوع تبلیغ DCM از DCM با مطابقت با جلسه Google Analytics (فقط حق بیمه) کلیک کنید. - Dimension -
ga:dcmClickAdvertiser
- DCM Advertiser نام DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmClickAdvertiserId
- شناسه تبلیغاتی DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickCampaign
- نام کمپین DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickCampaignId
- شناسه کمپین DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickCreative
- DCM نام خلاق DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickCreativeId
- شناسه خلاق DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmClickCreativeType
- DCM Creative Type نام DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmClickCreativeTypeId
- شناسه خلاق DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmClickCreativeVersion
- نسخه خلاق DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmClickRenderingId
- شناسه رندر DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickSite
- نام سایت که در آن DCM Creative نشان داده شده و برای کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه) کلیک کرده است. - DIMENSION -
ga:dcmClickSiteId
- شناسه سایت DCM که در آن DCM Creative نشان داده شده و برای کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه) کلیک کرده است. - DIMENSION -
ga:dcmClickSitePlacement
- نام محل قرارگیری سایت DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmClickSitePlacementId
- شناسه محل قرارگیری سایت DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmClickSpotId
- شناسه پیکربندی Floodlight DCM از DCM کلیک مطابق با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmFloodlightActivity
- نام فعالیت نوری DCM در ارتباط با تبدیل چراغ (فقط حق بیمه). - Dimension -
ga:dcmFloodlightActivityAndGroup
- نام فعالیت و نام گروه DCM و نام گروه مرتبط با تبدیل چراغ (فقط حق بیمه). - Dimension -
ga:dcmFloodlightActivityGroup
- DCM NAME فعالیت گروه فعالیت FLOODLIGHT در ارتباط با تبدیل چراغ (فقط حق بیمه). - Dimension -
ga:dcmFloodlightActivityGroupId
- DCM فعالیت گروه فعالیت FLOODLIGHT در ارتباط با تبدیل چراغ (فقط حق بیمه). - Dimension -
ga:dcmFloodlightActivityId
- شناسه فعالیت سیلاب DCM در ارتباط با تبدیل چراغ (فقط حق بیمه). - Dimension -
ga:dcmFloodlightAdvertiserId
- DCM Advertiser Advertiser ID در ارتباط با تبدیل Floodlight (فقط حق بیمه). - Dimension -
ga:dcmFloodlightSpotId
- شناسه پیکربندی چراغ DCM در ارتباط با تبدیل چراغ (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventAd
- نام تبلیغ DCM آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmLastEventAdId
- DCM AD ID از آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventAdType
- DCM AD TYPE نام آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventAdTypeId
- DCM AD TYPE ID از آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventAdvertiser
- DCM Advertiser نام آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventAdvertiserId
- DCM Advertiser ID از آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmLastEventAttributionType
- دو مقدار ممکن وجود دارد (Clickthrough و Viewthrough). اگر آخرین رویداد DCM مرتبط با جلسه Google Analytics یک کلیک بود ، پس مقدار کلیک خواهد شد. اگر آخرین رویداد DCM مرتبط با جلسه Google Analytics یک تصور تبلیغاتی باشد ، ارزش آن مشاهده خواهد شد (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCampaign
- نام کمپین DCM آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCampaignId
- شناسه کمپین DCM آخرین رویداد DCM (تصور یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCreative
- نام خلاق DCM آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCreativeId
- شناسه خلاق DCM آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCreativeType
- DCM نام نوع خلاق آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCreativeTypeId
- شناسه نوع خلاق DCM از آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventCreativeVersion
- نسخه خلاق DCM آخرین رویداد DCM (تصور یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventRenderingId
- شناسه DCM از آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventSite
- نام سایت که در آن DCM Creative نشان داده شده و برای آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه) کلیک کنید. - Dimension -
ga:dcmLastEventSiteId
- شناسه سایت DCM که در آن DCM Creative برای آخرین رویداد DCM نشان داده شده و روی آن کلیک کرده است (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventSitePlacement
- نام محل قرارگیری سایت DCM آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - DIMENSION -
ga:dcmLastEventSitePlacementId
- شناسه سایت DCM از آخرین رویداد DCM (برداشت یا کلیک در پنجره Lookback DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه). - Dimension -
ga:dcmLastEventSpotId
- شناسه پیکربندی Floodlight DCM از آخرین رویداد DCM (برداشت یا کلیک در پنجره DCM Lookback) مرتبط با جلسه Google Analytics (فقط حق بیمه). - Metric -
ga:dcmFloodlightQuantity
- تعداد تبدیل DCM Floodlight (فقط حق بیمه). - Metric -
dcmFloodlightRevenue
- درآمد DCM Floodlight (فقط حق بیمه).
Core Reporting API-انتشار 2014-07-14 (14 ژوئیه 2014)
این نسخه شامل افزودن ابعاد و معیارهای جدید گروه بندی محتوای جدید است.
ابعاد و معیارها
برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
گروه بندی محتوا
- Dimension -
ga:landingContentGroupXX
- اولین گروه محتوای مطابق در جلسه کاربر. - Dimension -
ga:nextContentGroupXX
- به گروه محتوا اشاره دارد که پس از یک گروه محتوا دیگر بازدید شده است. - Dimension -
ga:contentGroupXX
- گروه محتوا در یک ویژگی. یک گروه محتوا مجموعه ای از محتوا است که یک ساختار منطقی را ارائه می دهد که می تواند با ردیابی کد یا عنوان صفحه/URL REGEX یا قوانین از پیش تعریف شده تعیین شود. - Dimension -
ga:previousContentGroupXX
- به گروه محتوا اشاره می کند که قبل از گروه محتوای دیگری بازدید شده است. - Metric -
ga:contentGroupUniqueViewsXX
- تعداد صفحات مختلف (منحصر به فرد) در یک جلسه برای گروه محتوای مشخص شده. این هم برای تعیین منحصر به فرد بودن ، هر دو صفحه و صفحه را در نظر می گیرد.
Core Reporting API-انتشار 2014-06-12 (12 ژوئن 2014)
این نسخه شامل یک شرط جدید dateOfSession
برای بخش ها و افزودن ابعاد و معیارهای جدید تجارت الکترونیکی پیشرفته است.
بخش ها
در حال حاضر بخش ها از یک وضعیت جدید dateOfSession
پشتیبانی می کنند که می تواند یک بخش را برای گروهی از کاربران که جلسه را در یک محدوده تاریخ خاص آغاز کرده اند ، محدود کند. برای جزئیات بیشتر به راهنمای توسعه بخش بخش ها مراجعه کنید.
ابعاد و معیارها
ابعاد و مرجع معیارها را برای لیست کامل تعاریف برای تجارت الکترونیکی پیشرفته مرور کنید.
تجارت الکترونیکی پیشرفته
- Dimension -
ga:internalPromotionCreative
- محتوای خلاق طراحی شده برای تبلیغ. - Dimension -
ga:internalPromotionId
- شناسه ای که برای ارتقاء استفاده می کنید. - Dimension -
ga:internalPromotionName
- نام تبلیغ. - Dimension -
ga:internalPromotionPosition
- موقعیت تبلیغ در صفحه وب یا صفحه برنامه. - Dimension -
ga:orderCouponCode
- کد برای کوپن سطح سفارش. - Dimension -
ga:productBrand
- نام تجاری که محصول آن فروخته می شود. - ابعاد -
ga:productCategoryHierarchy
- دسته سلسله مراتبی که در آن محصول طبقه بندی می شود (تجارت الکترونیکی پیشرفته). - Dimension -
ga:productCategoryLevelXX
- سطح (1-5) در سلسله مراتب دسته بندی محصولات ، از بالا شروع می شود. - Dimension -
ga:productCouponCode
- کد برای کوپن سطح محصول. - Dimension -
ga:productListName
- نام لیست محصول که در آن محصول ظاهر می شود. - Dimension -
ga:productListPosition
- موقعیت محصول در لیست محصول. - Dimension -
ga:productVariant
- تنوع خاص یک محصول ، به عنوان مثال ، XS ، S ، M ، L برای اندازه یا قرمز ، آبی ، سبز ، سیاه برای رنگ. - Dimension -
ga:checkoutOptions
- گزینه های کاربر مشخص شده در طی فرآیند پرداخت ، به عنوان مثال ، FedEx ، DHL ، UPS برای گزینه های تحویل یا ویزا ، MasterCard ، AMEX برای گزینه های پرداخت. این بعد باید همراه با مرحله خرید استفاده شود. - Dimension -
ga:shoppingStage
- مراحل مختلف تجربه خرید که کاربران در یک جلسه به پایان رساندند ، به عنوان مثال ، Product_View ، ADD_TO_CART ، پرداخت و غیره. - Metric -
ga:internalPromotionCTR
- نرخی که کاربران برای مشاهده تبلیغات داخلی (تعداد کلیک / تعداد بار تبلیغات ظاهر می شوند) از طریق آن کلیک کردند. - Metric -
ga:internalPromotionClicks
- تعداد کلیک بر روی تبلیغات داخلی. - Metric -
ga:internalPromotionViews
- تعداد دیدگاه های ارتقاء داخلی. - Metric -
ga:localProductRefundAmount
- مبلغ بازپرداخت برای یک محصول معین به ارز محلی. - Metric -
ga:localRefundAmount
- کل بازپرداخت برای معامله در ارز محلی. - Metric -
ga:productAddsToCart
- تعداد دفعات اضافه شدن محصول به سبد خرید. - Metric -
ga:productCheckouts
- تعداد دفعاتی که محصول در فرآیند چک قرار می گرفت. - Metric -
ga:productDetailViews
- تعداد بار کاربران صفحه نمایش محصول را مشاهده می کردند. - Metric -
ga:productListClicks
- تعداد دفعاتی که کاربران هنگام ظاهر شدن در لیست محصول ، بر روی محصول کلیک می کردند. - Metric -
ga:productListViews
- تعداد دفعاتی که محصول در یک لیست محصول ظاهر می شود. - Metric -
ga:productListCTR
- نرخی که کاربران در یک لیست محصول بر روی محصول کلیک کردند. - Metric -
ga:productRefunds
- تعداد دفعات بازپرداخت برای محصول صادر شده است. - Metric -
ga:productRefundAmount
- کل بازپرداخت در ارتباط با محصول. - Metric -
ga:productRemovesFromCart
- تعداد دفعات حذف محصول از چرخ دستی های خرید. - Metric -
ga:productRevenuePerPurchase
- متوسط درآمد محصول در هر خرید (که معمولاً با کد کوپن محصول استفاده می شود). - Metric -
ga:buyToDetailRate
- خریدهای منحصر به فرد تقسیم بر نمایش صفحات جزئیات محصول. - Metric -
ga:cartToDetailRate
- محصول اضافه می کند که براساس نماهای جزئیات محصول تقسیم می شود. - Metric -
ga:quantityAddedToCart
- تعداد واحدهای محصول اضافه شده به سبد خرید. - Metric -
ga:quantityCheckedOut
- تعداد واحدهای محصول موجود در بررسی. - متریک -
ga:quantityRefunded
- تعداد واحدهای محصول بازپرداخت شده است. - Metric -
ga:quantityRemovedFromCart
- تعداد واحدهای محصول که از سبد خرید خارج می شوند. - متریک -
ga:refundAmount
- مبلغ ارزی برای معامله بازپرداخت می شود. - Metric -
ga:totalRefunds
- تعداد بازپرداخت هایی که صادر شده است.
Core Reporting API-انتشار 2014-06-04 (4 ژوئن 2014)
این نسخه شامل یک رفع اشکال برای نام هدر ستون و همچنین افزودن ابعاد و معیارهای جدید است.
ابعاد و معیارها
برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
سیستم
- Dimension -
ga:sourcePropertyDisplayName
- منبع منبع نمایش نام ویژگی های Roll -Up. این فقط برای خصوصیات رول معتبر است. - Dimension -
ga:sourcePropertyTrackingId
- شناسه ردیابی خاصیت منبع از خصوصیات رول. این فقط برای خصوصیات رول معتبر است
گروه بندی کانال
- ابعاد -
ga:channelGrouping
- گروه بندی پیش فرض کانال که در نمای (نمایه) به اشتراک گذاشته می شود.
محصولات مرتبط
- Dimension -
ga:correlationModelId
- شناسه مدل همبستگی برای محصولات مرتبط. - ابعاد -
ga:queryProductId
- شناسه محصول مورد نظر. - Dimension -
ga:queryProductName
- نام محصول مورد نظر. - ابعاد -
ga:queryProductVariation
- تنوع محصول مورد نظر. - ابعاد -
ga:relatedProductId
- شناسه محصول مرتبط. - Dimension -
ga:relatedProductName
- نام محصول مرتبط. - Dimension -
ga:relatedProductVariation
- تنوع محصول مرتبط. - Metric -
ga:correlationScore
- نمره همبستگی برای محصولات مرتبط. - Metric -
ga:queryProductQuantity
- مقدار محصول مورد نظر. - Metric -
ga:relatedProductQuantity
- مقدار محصول مرتبط.
تصحیح نام ستون هدر
- در نسخه 2014-04-16 یک اشکال وجود داشت. اگر از ابعاد یا متریک مستهلک پرسیدید ، API با ابعاد جایگزینی یا متریک ، سر ستون های ستون را برمی گرداند. اکنون به درستی همان ابعاد یا نام متریک مورد استفاده در درخواست را برمی گرداند.
ابرداده API-انتشار 2014-06-03 (3 ژوئن 2014)
این نسخه شامل تغییر کنوانسیون نامگذاری برای ویژگی uiName
است.
تغییر uiname
- ویژگی UINAME برای ستون های Templatized اکنون از
XX
استفاده می کند تا شاخص عددی را به جای1
نشان دهد. به عنوان مثال ،Goal 1 Value
اکنونGoal XX Value
است.
Embed API - انتشار 2014-05 (28 مه 2014)
این نسخه اولیه API تعبیه شده است:
- Google Analytics Embed API یک کتابخانه JavaScript است که به شما امکان می دهد در عرض چند دقیقه به راحتی داشبورد را در یک وب سایت شخص ثالث ایجاد و تعبیه کنید. برای اطلاعات بیشتر به نمای کلی API Embed مراجعه کنید.
- شامل مؤلفه ها: AUTH ، مشاهده انتخاب ، داده ها و نمودار داده ها.
ابرداده API-انتشار 2014-04-16 (16 آوریل 2014)
این نسخه شامل استهلاک ویژگی appUiName
است. برای جزئیات بیشتر در مورد حذف ویژگی ، خط مشی استهلاک داده ها را مرور کنید:
استهلاک نام
-
appUiName
مستهلک شده است. دیگر در API ابرداده لازم نیست زیرا نام های UI برای نمای وب و برنامه (پروفایل) متحد شده اند. شما باید هر کدی را که از ویژگیappUiName
استفاده می کند حذف کنید و فقط از ویژگیuiName
استفاده کنید.
گزارش زمان واقعی API-انتشار 2014-04-16 (16 آوریل 2014)
این نسخه شامل تغییر نام ابعاد و معیارها است. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
تغییر نام به ابعاد و معیارها
ابعاد و معیارهای زیر تغییر نام داده شده است. خط مشی استهلاک داده ها را برای جزئیات در مورد تغییر نام داده ها مرور کنید:
کاربر
- Dimension -
rt:visitorType
-rt:userType
به جای آن استفاده کنید. - متریک -
rt:activeVisitors
- به جای آنrt:activeUsers
استفاده کنید.
Core Reporting API-انتشار 2014-04-16 (16 آوریل 2014)
این نسخه شامل افزودن و تغییر نام ابعاد و معیارها است. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.
ابعاد و معیارهای جدید
ابعاد زیر به API گزارش اصلی اضافه شده است:
کلمات پیشنهادی
- Dimension -
ga:isTrueViewVideoAd
-Yes
orNo
- Indicates whether the ad is an AdWords TrueView video ad.
زمان
- 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:
حضار
- Dimension -
ga:visitorAgeBracket
- Usega:userAgeBracket
instead. - Dimension -
ga:visitorGender
- Usega:userGender
instead.
تجارت الکترونیک
- Metric -
ga:transactionRevenuePerVisit
- Usega:transactionRevenuePerSession
instead. - Metric -
ga:transactionsPerVisit
- Usega:transactionsPerSession
instead.
Event Tracking
- Metric -
ga:eventsPerVisitWithEvent
- Usega:eventsPerSessionWithEvent
instead. - Metric -
ga:visitsWithEvent
- Usega:sessionsWithEvent
instead.
Goal Conversions
- Metric -
ga:goalValuePerVisit
- Usega:goalValuePerSession
instead.
Internal Search
- Metric -
ga:percentVisitsWithSearch
- Usega:percentSessionsWithSearch
instead. - Metric -
ga:searchVisits
- Usega:searchSessions
instead.
Page Tracking
- Metric -
ga:pageviewsPerVisit
- Usega:pageviewsPerSession
instead.
جلسه
- Dimension -
ga:visitLength
- Usega:sessionDurationBucket
instead. - Metric -
ga:avgTimeOnSite
- Usega:avgSessionDuration
instead. - Metric -
ga:timeOnSite
- Usega:sessionDuration
instead. - Metric -
ga:visitBounceRate
- Usega:bounceRate
instead. - Metric -
ga:visits
- Usega:sessions
instead.
تعاملات اجتماعی
- Dimension -
ga:socialInteractionNetworkActionVisit
- Usega:socialInteractionNetworkActionSession
instead. - Metric -
ga:socialInteractionsPerVisit
- Usega:socialInteractionsPerSession
instead.
کاربر
- Dimension -
ga:daysSinceLastVisit
- Usega:daysSinceLastSession
instead. - Dimension -
ga:visitCount
- Usega:sessionCount
instead. - Dimension -
ga:visitorType
- Usega:userType
instead. - Dimension -
ga:visitsToTransaction
- Usega:sessionsToTransaction
instead. - Metric -
ga:newVisits
- Usega:newUsers
instead. - Metric -
ga:percentNewVisits
- Usega:percentNewSessions
instead. - Metric -
ga:visitors
- Usega:users
instead.
Core Reporting API - انتشار 11-04-2014 (11 آوریل 2014)
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 thesegment
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.
API گزارش زمان واقعی - انتشار 03-2014 (20 مارس 2014)
ga:
Prefix Deprecated
The ga:
prefix has been deprecated for all Real Time Dimensions and Metrics and has been replaced by the new rt:
prefix. API requests that use the ga:
prefix will continue to work for 6 months, after which an error will be returned.
New Dimensions and Metrics
This update adds new dimensions and metrics to the Real Time Reporting API. Check the Dimensions and Metrics Reference for the complete list.
Event Tracking
- Dimension -
rt:eventAction
- the action of the event. - Dimension -
rt:eventCategory
- the category of the event. - Dimension -
rt:eventLabel
- the label of the event. - Dimension -
rt:totalEvents
- the total number of events for the profile, across all categories.
Goal Tracking
- Dimension -
rt:goalId
- a string corresponding to the goal ID. - Metric -
rt:goalXXValue
- the total numeric value for the requested goal number, where XX is a number between 1 and 20. - Metric -
rt:goalValueAll
- the total numeric value for all goals defined for your profile. - Metric -
rt:goalXXCompletions
- the total number of completions for the requested goal number, where XX is a number between 1 and 20. - Metric -
rt:goalCompletionsAll
- the total number of completions for all goals defined for your profile.
Page Tracking
- Metric -
rt:pageViews
- the total number of page views.
App Tracking
- Metric -
rt:screenViews
- the total number of screen views.
Multi-Channel Funnels Reporting API - Release 2014-02-14 (February 14, 2014)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.
مسیرهای تبدیل
- Dimension -
mcf:adwordsCustomerIDPath
- Sequence of AdWords customer ID along conversion paths.
فعل و انفعالات
- Dimension -
mcf:adwordsCustomerID
- Corresponds to AdWords APICustomer.id
.
Multi-Channel Funnels Reporting API - Release 2013-12-12 (December 12, 2013)
This release adds new dimensions and metrics to the API. Check the Dimensions and Metrics Reference for the complete list of definitions.
مسیرهای تبدیل
- Dimension -
mcf:adwordsAdGroupIDPath
- Sequence of AdWords ad group ID along conversion paths. - Dimension -
mcf:adwordsCampaignIDPath
- Sequence of AdWords campaign ID along conversion paths. - Dimension -
mcf:adwordsCreativeIDPath
- Sequence of AdWords creative ID along conversion paths. - Dimension -
mcf:adwordsCriteriaIDPath
- Sequence of AdWords criteria ID along conversion paths.
فعل و انفعالات
- Dimension -
mcf:adwordsAdGroupID
- Corresponds to AdWords APIAdGroup.id
. - Dimension -
mcf:adwordsCampaignID
- Corresponds to AdWords APICampaign.id
. - Dimension -
mcf:adwordsCreativeID
- Corresponds to AdWords APIAd.id
. - Dimension -
mcf:adwordsCriteriaID
- Corresponds to AdWords APICriterion.id
.
Core Reporting API - Release 2013-12-12 (December 12, 2013)
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 todatatable
, adataTable
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:
زمان
- Dimension -
ga:minute
- Returns the minute in the hour. The possible values are between00
and59
. - 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 is0
,1
for the next minute, and so on.
حضار
- 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.
ابعاد و معیارهای مجاز در بخشها
These dimensions and metrics can now be used in segments:
- Dimension -
ga:sourceMedium
- Combined values ofga:source
andga: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
- Usega:deviceCategory
instead (eg,ga:deviceCategory==mobile
). - Dimension -
ga:isTablet
- Usega:deviceCategory
instead (eg,ga:deviceCategory==tablet
). - Metric -
ga:entranceBounceRate
- Usega:visitBounceRate
instead.
Core Reporting API - Release 2013-10-28 (October 28, 2013)
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.
- Met -
زمان
- Dim -
ga:isoYear
- The ISO year of the visit. Details: http://en.wikipedia.org/wiki/ISO_week_date .ga:isoYear
should only be used withga:isoWeek
sincega:week
represents gregorian calendar. - Dim -
ga:isoYearIsoWeek
- Combined values ofga:isoYear
andga:isoWeek
.
کلمات پیشنهادی
This data is found in Adwords reports:
- Dim -
ga:adKeywordMatchType
- The match types applied to your keywords (Phrase, Exact, Broad). Details: Understanding the Search terms report .
- Dim -
Multi-Channel Funnels Reporting API - Release 2013-10-14 (October 14, 2013)
New Sample Size Control and Relative Dates Features
Relative Dates
- Support for relative dates has been added to the MCF Reporting API.
today
,yesterday
, andNdaysAgo
are now valid values for thestart-date
andend-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
, andHIGHER_PRECISION
. - 2 new fields have been added to the API Response:
sampleSize
andsampleSpace
. 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.
Core Reporting API - Release 2013-10-14 (October 14, 2013)
New Sample Size Control and Relative Dates Features
Relative Dates
- Support for relative dates has been added to the Core Reporting API.
today
,yesterday
, andNdaysAgo
are now valid values for thestart-date
andend-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
, andHIGHER_PRECISION
. - 2 new fields have been added to the API Response:
sampleSize
andsampleSpace
. 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.
API فراداده - انتشار 08-2013 (20 اوت 2013)
This is the initial release of the Metadata API:
- The Metadata API returns information about the dimensions and metrics exposed in Google Analytics reporting APIs. The metadata returned includes attributes like UI name, description, advanced segments support, and more. By using the Metadata API, your applications can automatically stay up to date with the latest data on the dimensions and metrics available for reporting queries. Visit the Metadata API Overview for more details.
API گزارش زمان واقعی - انتشار 08-2013 (1 اوت 2013)
This is the initial release of the Real Time Reporting API in limited beta:
- The Real Time Reporting API allows you to report on activity occurring on your property right now. You can use the Real Time reporting API to query for dimensions and metrics in order to build customer facing web widgets and dashboards. Visit the Real Time Reporting API Overview for more details.
Core Reporting API - انتشار 22-07-2013 (23 ژوئیه 2013)
رفع اشکال
- 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.
Core Reporting API - Release 2013-07-15 (July 16, 2013)
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.
Core Reporting API - Release 2013-07-09 (July 9, 2013)
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 thePackageManager#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 ofga:appviews
. - Met -
ga:uniqueScreenviews
- The number of different (unique)ga:screenviews
within a session. Use this instead ofga:uniqueAppviews
. - Met -
ga:screenviewsPerSession
- The average number ofga:screenviews
per session. Use this instead ofga:appviewsPerVisit
.
- Dim -
منسوخ
The following metrics have been deprecated. Use the new metric name instead.
- Met -
ga:appviews
- Usega:screenviews
instead. - Met -
ga:uniqueAppviews
- Usega:uniqueScreenviews
instead. - Met -
ga:appviewsPerVisit
- Usega:screenviewsPerSession
instead.
متغیرها یا ستون های سفارشی
Access to custom dimension and metrics:
- Dim -
ga:dimensionXX
- The name of the requested custom dimension, whereXX
refers the number/index of the custom dimension. - Met -
ga:metricXX
- The name of the requested custom metric, whereXX
refers the number/index of the custom metric.
- Dim -
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
تجارت الکترونیک
- 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.
استثناها
- 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.
- Dim -
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
Internal Search
- 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 areYes
orNo
. - Dim -
ga:mobileDeviceMarketingName
- Marketing name used for mobile device.
- Dim -
تعاملات اجتماعی
This data comes from onsite social interaction tracking.
- Dim -
ga:socialEngagementType
- Engagement type. Possible values areSocially Engaged
orNot Socially Engaged
.
- Dim -
زمان
- Dim -
ga:dateHour
- Combined values ofga:date
andga: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 ofga:year
andga:month
. - Dim -
ga:yearWeek
- Combined values ofga:year
andga:week
.
منابع ترافیک
- Dim -
ga:fullReferrer
- The full referring URL including the hostname and path. - Dim -
ga:sourceMedium
- The combined values ofga:source
andga:medium
.
Core Reporting API - Release 2013-04-04 (April 4, 2013)
- This release adds 2 new experiments metrics : -
ga:experimentId
-ga:experimentVariant
Core Reporting API - Release 2013-01-31 (January 31, 2013)
- This release adds 5 new site speed metrics:
-
ga:domInteractiveTime
-
ga:avgDomInteractiveTime
-
ga:domContentLoadedTime
-
ga:avgDomContentLoadedTime
-
ga:domLatencyMetricsSample
-
Core Reporting API - انتشار 14-01-2013 (14 ژانویه 2013)
- This release adds a new default segment for Tablet Traffic,
gaid::-13
.
Core Reporting API - Release 2012-09 (September 18, 2012)
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.
- Met -
منابع ترافیک
- 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.
فعالیت های اجتماعی
- 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.
- Dim -
تعاملات اجتماعی
- 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 thega:socialInteractionNetwork
andga: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 pairga:socialInteractionNetwork
andga:socialInteractionAction
- Met -
ga:socialInteractionsPerVisit
-ga:socialInteractions
/ga:uniqueSocialInteractions
. The average number of social interactions per visit to your site.
- Dim -
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.
- Met -
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
.
- Dim -
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.
- Dim -
Multi-Channel Funnels Reporting API - Release 2012-08 (August 1, 2012)
This is the initial release of the Multi-Channel Funnels Reporting API:
- This new API enables you to request Multi-Channel Funnels data for an authenticated user. Data is derived from conversion path data, which shows user interactions with various traffic sources over multiple visits prior to converting. This allows you to analyze how multiple marketing channels influence conversions over time. For more details on what data is available and how to use the API see Multi-Channel Funnels Reporting API .
Core Reporting API - Release 2012-05 (May 31, 2012)
رفع اشکال
- The API now correctly handles UTF-8 characters in a filter or dynamic segment.
Core Reporting API - Release 2012-05 (May 24, 2012)
This release enables Google Analytics premium accounts to access up to 50 custom variables.
Core Reporting API - Release 2012-02 (February 14, 2012)
This release fixes 2 bugs:
رفع اشکال
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.
Core Reporting API - Release 2012-02 (February 8, 2012)
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.
Core Reporting API - Release 2012-01 (January 26, 2012)
We fixed a small bug with ga:visitLength
. This dimension now returns correct data.
Core Reporting API - Release 2011-12 (December 5, 2011)
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.
نسخه 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 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.
به روز رسانی ها
- 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 .
- New URL to make requests:
نسخه 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.
به روز رسانی ها
- 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
to403
- 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 .
- New URL to make requests:
ثبت
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.
خط مشی سهمیه
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.
تحقیرها
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 .
Core Reporting API - Release 2011-09 (September 7, 2011)
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 .
Core Reporting API - Release 2011-08 (August 11, 2011)
This release fixes some invalid combinations of dimensions and metrics
ترکیب معیارها/ابعاد نامعتبر رفع شد
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
orga:adGroup
cannot be combined withga:impressions
.
Instead of returning a response with 0 results, the API now returns 400 error code for all queries that ask for these combinations.
Core Reporting API - Release 2011-07 (July 11, 2011)
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.
Core Reporting API - Release 2011-05 (May 31, 2011)
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).
Core Reporting API - Release 2011-04 (April 19, 2011)
This release improves improves Data Feed performance and adds new data:
ارتقای کارایی
- 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 apercent
and returns the value 0.02. In the near future this will change to return the actual percent (eg 2).
Core Reporting API - Release 2011-03 (March 9, 2011)
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.
Core Reporting API - Release 2011-01 (January 24, 2011)
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
.
Core Reporting API - Release 2010-11 (November 1, 2010)
This release adds a new feature to the Data Feed:
ویژگی های جدید
- A new XML element has been added lets users know if the data has been sampled.
true
true
orfalse
. The Java and JavaScript libraries have also been updated with helper methods to access this element.
Core Reporting API - انتشار 2010-08 (23 اوت 2010)
This release fixes 2 bugs:
رفع اشکال
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).
Core Reporting API - Release 2010-07 (July 26, 2010)
This release fixes 3 bugs:
رفع اشکال
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
.
Core Reporting API - Release 2010-05 (May 4, 2010)
This release adds new data and fixes a bug:
ویژگی های جدید
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
-
رفع اشکال
- We fixed an issue where the Account Feed would not return data if one of the profiles had a misconfigured goal or step.
Core Reporting API - انتشار 03-2010 (22 مارس 2010)
This release adds a number of new features and fixes a bug:
ویژگی های جدید
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
andga:previousPagePath
are now part of theD3. Content
group. TheD8. Custom Variable
group is now called theD6. Custom Variable
group. Please see the updated reference guide for these new combinations.
رفع اشکال
We fixed a bug on how the API reports the
confidenceInterval
value for metrics. Previously confidence intervals could have a value of eitherINF
or a number from 0 to 1. Now all confidence intervals will have a value of eitherINF
or a number greater than or equal to 0.ga:itemQuantity
andga: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
Core Reporting API - Release 2009-12 (December 14, 2009)
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'
- Version 2 may be requested by adding the header
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
andGoalValueAll
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 nowga:visitCount
-
ga:countOfVisitsToATransaction
is nowga:visitsToTransaction
-
Core Reporting API - Release 2009-09 (September 18, 2009)
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
Core Reporting API - Release 2009-06 (June 30, 2009)
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
andga: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.htmlThe 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.
Core Reporting API - Release 2009-05 (May 22, 2009)
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