Google Analytics - همه تغییرات API

این صفحه تغییرات ایجاد شده در همه APIها و SDK های Google Analytics را مستند می کند. این شامل تغییرات برای همه مجموعه، گزارش، و پیکربندی است. توصیه می کنیم برای اطلاعیه های جدید به صورت دوره ای این لیست را بررسی کنید. همچنین می توانید از طریق فیدهای فهرست شده در بخش اشتراک در زیر، در تغییرات مشترک شوید.

مشترک شدن در تغییرات مرتبط

همه تغییرات API Google Analytics
–
اشتراک درrss

شامل تمام APIهای مجموعه، پیکربندی و گزارش است.

این نسخه اولیه User Activity API است

  • User Activity API به شما امکان می دهد تمام داده های مرتبط با یک Client ID یا User ID را در یک محدوده تاریخ معین بازیابی کنید. در اصل برای حمایت از صاحبان دارایی که می خواهند دسترسی خودکار به داده های کاربر را مستقیماً برای آن کاربر فراهم کنند، در نظر گرفته شده است. برای جزئیات بیشتر به راهنمای API Activity User مراجعه کنید.

تنظیمات حفظ اطلاعات کاربر در مدیریت API

اکنون می‌توان تنظیمات حفظ داده‌های کاربر را با استفاده از فیلدهای جدید «dataRetentionTtl» و «dataRetentionResetOnNewActivity» که به منبع WebProperty اضافه شده‌اند، پیکربندی برنامه‌نویسی کرد.

این نسخه اولیه User Deletion API است:

  • User Deletion API به مشتری Google Analytics اجازه می دهد تا داده های یک کاربر نهایی را از یک پروژه یا دارایی وب حذف کند. درخواست های حذف کاربر را می توان با استفاده از پروژه های Firebase یا ویژگی های Google Analytics انجام داد. برای جزئیات بیشتر به نمای کلی API حذف کاربر مراجعه کنید.

عملیات را در مدیریت API بنویسید

عملیات نوشتن در مدیریت API (مانند ایجاد، به‌روزرسانی، حذف، وصله) برای منابع Web Property، View (Profile) و Goal دیگر نیازی به لیست سفید ندارند. محدودیت روزانه پیش‌فرض برای همه عملیات Write در مدیریت API 50 نوشتن در روز است. برای اطلاعات بیشتر به صفحه محدودیت ها و سهمیه ها مراجعه کنید.

این نسخه تغییراتی را در سهمیه ها و محدودیت های 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 را در بقیه روز برای یک نمایه فردی مسدود نمی‌کند.

این نسخه حداکثر تعداد ردیف های بازگشتی را در مجموعه نتایج Analytics Reporting API v4 افزایش می دهد.

حداکثر تعداد سطرهای بازگشتی در شیء Analytics Reporting API v4 ReportData از 10000 به 100000 افزایش یافته است.

این نسخه پیش نمایشی از سیستم سهمیه مبتنی بر منابع را برای Google Analytics Reporting API نسخه 4 اضافه می کند که امکان استفاده از آستانه نمونه برداری بالاتر را برای مشتریان Analytics 360 (Premium) فراهم می کند.

URL های "android-app://" به عنوان منبع ارجاع معتبر اضافه شد.

این نسخه وظیفه جدید customTask را اضافه می کند.

این نسخه ویژگی محصولات مرتبط و ابعاد و معیارهای مرتبط را منسوخ می‌کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی منسوخ شدن داده ها را مرور کنید:

این نسخه ابعاد و معیارهای زیر را منسوخ می‌کند:

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

این نسخه بعد جدیدی به 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

این نسخه، معیارها و ابعاد موجود در API را به‌روزرسانی می‌کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

معیارهای کاربر

محاسبه معیارهای کاربران و کاربران فعال برای شمارش کارآمدتر کاربران به‌روزرسانی شده است. ممکن است تغییر کوچکی در معیارهای خود مشاهده کنید. برای اطلاعات بیشتر، لطفاً ببینید چگونه کاربران برای معیارهای کاربران شناسایی می شوند .

معیارهای کاربر تحت تأثیر به‌روزرسانی محاسبات:

  • ga:users - تعداد کل کاربران برای دوره زمانی درخواستی.
  • ga:1dayusers - تعداد کل کاربران فعال 1 روزه برای هر روز در بازه زمانی درخواستی.
  • ga:7dayusers - تعداد کل کاربران فعال 7 روزه برای هر روز در بازه زمانی درخواستی.
  • ga:14dayusers - تعداد کل کاربران فعال 14 روزه برای هر روز در بازه زمانی درخواستی.
  • ga:30dayusers - تعداد کل کاربران فعال 30 روزه برای هر روز در بازه زمانی درخواستی.

رویدادهای منحصر به فرد

به پایان دوره زمانی منسوخ شدن ga:uniqueEvents نزدیک می شویم. پس از 26 مارس 2017، تعریف ga:uniqueEvents به‌روزرسانی می‌شود و معیار خصوصی ga:uniqueEventsTemporary از API حذف می‌شود. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.

این نسخه بعد جدیدی به API اضافه می‌کند، پیام‌های خطا را بهبود می‌بخشد و تغییرات اعلام شده قبلی را برای ابعاد و معیارهای AdSense اعمال می‌کند.

ابعاد کاربر

پیغام خطا

در جایی که قبلاً API یک پیام خطای اشتباه، Unknown dimension(s): یا Unknown metric(s): هنگام درخواست داده با شرایطی که برآورده نشده‌اند، API اکنون این پیام را برمی‌گرداند: Restricted metric(s): ... can only be queried under certain conditions.

ابعاد و معیارهای AdSense

نماهای مرتبط با AdSense از پرس و جو برای ابعاد و معیارهای AdSense محدود خواهند شد. پرس و جو برای این ابعاد و معیارها با بازدیدهای غیر مرتبط با AdSense منجر به خطا می شود.

معیارهای سفارشی

این یک نسخه رفع اشکال است؛ مشکل ایجاد یک متریک سفارشی از نوع TIME هنگامی که min_value تنظیم نشده بود، ناموفق بود را برطرف می کند. اکنون درخواست‌های بدون min_value یک معیار سفارشی با min_value پیش‌فرض 0 ایجاد می‌کنند.

این یک نسخه رفع اشکال است که مشکل ابعاد و معیارهای AdSense را برطرف می‌کند و تغییرات آتی را در این ابعاد و معیارها اعلام می‌کند.

ابعاد و معیارهای AdSense

این نسخه مشکلی را برطرف می‌کند که از 1/7/2017 شروع شده بود که در آن پرس و جو برای ابعاد و معیارهای AdSense خطای «متریک ناشناخته» را برای بازدیدهای غیر مرتبط با AdSense نشان می‌داد.

تغییرات آینده

در یا بعد از 1/31/2017 بازدیدهای غیر مرتبط با AdSense از درخواست برای ابعاد و معیارهای AdSense محدود می‌شوند. پرس و جو برای این ابعاد و معیارها با بازدیدهای غیر مرتبط با AdSense منجر به خطا می شود.

این نسخه معیار جدید زیر را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

معیارهای محاسبه شده

این نسخه پشتیبانی از معیارهای محاسبه شده را اضافه می کند.

  • متریک - ga:calcMetric_ - مقدار متریک محاسبه شده درخواستی، که در آن به نام متریک محاسبه شده توسط کاربر اشاره دارد. توجه داشته باشید که نوع داده ga:calcMetric_ می تواند شناور، عدد صحیح، ارز، زمان یا درصد باشد. برای جزئیات، درباره معیارهای محاسبه شده را ببینید.

این نسخه یک معیار جدید به API اضافه می کند. همچنین یک معیار موجود را منسوخ می کند . برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

ردیابی رویداد

تعریف ga:uniqueEvents تغییر خواهد کرد تا تعداد رویدادهای منحصر به فرد را با دقت بیشتری منعکس کند. برای تأثیرگذاری بر این تغییر، از لحاظ فنی معیار ga:uniqueEvents فعلی را مطابق با خط‌مشی منسوخ شدن داده‌های خود منسوخ خواهیم کرد. اگر می‌خواهید تعریف جدید را امتحان کنید، می‌توانید به معیار خصوصی ga:uniqueEventsTemporary مراجعه کنید، که با دقت بیشتری تعداد رویدادهای منحصر به فرد را محاسبه می‌کند. ما همچنین یک متریک جدید ga:uniqueDimensionCombinations را معرفی خواهیم کرد که تعریف فعلی ga:uniqueEvents را حفظ می کند. پس از دوره زمانی منسوخ شدن مناسب (تقریباً 6 ماه)، متریک خصوصی ga:uniqueEventsTemporary حذف خواهد شد و متریک اصلی ga:uniqueEvents به درستی تعداد رویدادهای منحصر به فرد را نشان خواهد داد. برای اطلاعات بیشتر، به اسناد راهنمای رویدادهای منحصر به فرد مراجعه کنید.

رویدادهای منحصر به فرد

  • متریک - ga:uniqueEvents - تعریف ga:uniqueEvents به زودی تغییر خواهد کرد تا تعداد رویدادهای منحصر به فرد را با دقت بیشتری منعکس کند. اگر می‌خواهید تعریف موجود را حفظ کنید، لطفاً به جای آن از ga:uniqueDimensionCombinations استفاده کنید. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.
  • Metric - ga:uniqueDimensionCombinations - Unique Dimension Combinations تعداد ترکیب‌های بعد-مقدار منحصر به فرد را برای هر بعد در یک گزارش می‌شمارد. این به شما امکان می‌دهد ابعاد ترکیبی (پیوسته) را پس از پردازش بسازید، که امکان گزارش انعطاف‌پذیرتر را بدون نیاز به به‌روزرسانی پیاده‌سازی ردیابی یا استفاده از شکاف‌های بعدی سفارشی اضافی فراهم می‌کند. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.

تست انتقال - خصوصی

  • متریک - ga:uniqueEventsTemporary - تعداد رویدادهای منحصر به فرد. این تعریف جدید برای ga:uniqueEvents خواهد بود. می توانید از این معیار برای درک تعریف جدید قبل از تغییر استفاده کنید. توجه داشته باشید که این معیار خصوصی است و در مرجع ابعاد و معیارها نشان داده نخواهد شد.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • سازگاری با iOS 10 و رفع اشکال.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • رفع خرابی

این نسخه ابعاد و معیارهای جدیدی را به 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 دارد).
  • 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 دارد).

ارزها

این یک نسخه رفع اشکال است؛ این مشکل را برطرف می کند که در آن زیر مجموعه ای از ارزها در رابط وب Analytics پشتیبانی می شدند اما در API پشتیبانی نمی شدند. این نسخه پشتیبانی از ارزهای زیر را اضافه می کند:

  • UAH، AED، BOB، CLP، COP، EGP، HRK، ILS، MAD، MYR، PEN، PKR، RON، RSD، SAR، SGD، VEF، LVL

برای اطلاعات بیشتر رجوع کنید به: - مرجع نماها (نمایه ها) . - مقاله مرکز راهنمایی مرجع ارز .

این نسخه، مخاطبان بازاریابی مجدد را به API مدیریت اضافه می کند.

مخاطبان بازاریابی مجدد

مدیریت API به شما این امکان را می‌دهد که مخاطبان بازاریابی مجدد را برای یک ویژگی Google Analytics create ، get ، list کنید، update و patch . برای کسب اطلاعات بیشتر در مورد نحوه عملکرد مخاطبان بازاریابی مجدد، به مقاله درباره مخاطبان بازاریابی مجدد در مرکز راهنمایی Analytics مراجعه کنید.

این نسخه بعد جدیدی به API اضافه می کند. برای فهرست کامل تعاریف، مرجع ابعاد و معیارها را بررسی کنید.

شناسه تراکنش

  • ابعاد - mcf:transactionId - شناسه تراکنش که با روش ردیابی تجارت الکترونیک برای خرید در سبد خرید ارائه شده است.

این نسخه بعد جدیدی به API اضافه می کند. این نسخه همچنین محدودیت‌های خاصی را در ترکیب ابعادی که می‌توان با هم جستجو کرد اضافه می‌کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

شبکه جغرافیایی

  • بعد - ga:continentId - شناسه قاره کاربران، برگرفته از آدرس IP کاربران یا شناسه های جغرافیایی.

محدودیت های

ابعاد زیر در گروه های زیر را نمی توان با ابعاد در گروه های دیگر جستجو کرد:

  • از گروه اطلاعات خرید دیدن کنید
    • ga:checkoutOptions
    • ga:shoppingStage
  • گروه آزمایشی GWO
    • ga:experimentVariant
    • ga:experimentId
  • گروه علاقه مندی
    • ga:interestOtherCategory
  • در گروه علاقه بازار
    • ga:interestInMarketCategory
  • گروه تبلیغات داخلی:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • گروه مورد علاقه برندینگ:
    • ga:interestAffinityCategory

این نسخه محدودیت ها و سهمیه های جدیدی را معرفی می کند. برای جزئیات به اسناد محدودیت ها و سهمیه ها مراجعه کنید.

گزارش خطاها

این نسخه شروع به اعمال محدودیت در درخواست های گزارش ناموفق ( 5XX ) می کند.

  • 10 درخواست ناموفق برای هر پروژه در هر نمایه در ساعت.
  • 50 درخواست ناموفق برای هر پروژه در هر نمایه در روز.

محدودیت های محوری

این نسخه شروع به اعمال محدودیت در درخواست های محوری می کند:

  • یک درخواست گزارش اکنون می تواند حداکثر 2 محور داشته باشد.
  • یک محور حداکثر می تواند 4 بعد داشته باشد.
  • ابعاد محوری بخشی از محدودیت در تعداد کل ابعاد مجاز در درخواست است.
  • معیارهای محوری بخشی از محدودیت در تعداد کل معیارهای مجاز در درخواست هستند.

این نسخه ابعاد و معیارهای جدیدی را به 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 فعال نیست).

این یک نسخه رفع اشکال است که مشکل مربوط به بخش ها و نمونه برداری را برطرف می کند.

بخش ها

این نسخه مشکلی را برطرف می‌کند که باعث می‌شود زیرمجموعه‌ای از درخواست‌ها با بخش All Users ( gaid::-1 ) در Core Reporting API V3 کم شمارش شوند و در Analytics Reporting API V4 به دو بخش تقسیم شوند.

نمونه برداری

این نسخه مشکلی را برطرف می کند که در آن زیر مجموعه ای از درخواست ها از جداول سفارشی داده های نمونه را برمی گرداند.

این یک نسخه رفع اشکال است که مشکلی را هنگام ایجاد درخواست‌های گروهی Analytics Reporting API V4 برطرف می‌کند.

درخواست های گروهی

اکنون درخواست‌های همگروهی می‌توانند همه ابعاد همگروهی را درخواست کنند. قبلاً API هنگام درخواست ابعاد ga:acquisition... خطایی را برمی‌گرداند.

درخواست ارزش مادام العمر LTV

لطفاً توجه داشته باشید که درخواست‌های ارزش مادام العمر می‌توانند گزارش‌های ارزش مادام‌العمر را فقط برای بازدیدهای برنامه ایجاد کنند.

این نسخه یک ویژگی جدید addedInApiVersion اضافه می کند.

در نسخه API اضافه شده است

  • addedInApiVersion یک ویژگی عددی است که می تواند برای بررسی اینکه آیا یک ستون می تواند در یک API گزارش یک نسخه مشخص استفاده شود یا خیر استفاده می شود. برای جزئیات بیشتر به Metadata API - Developer Guide مراجعه کنید.

این نسخه نسخه جدیدی از 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 کمپینی که از طریق آن کاربر به دست آمد. حاصل از اولین جلسه کاربر.

  • Metric - ga:cohortActiveUsers - این متریک در زمینه ابعاد افست مبتنی بر 0 مرتبط است ( ga:cohortNthDay ، ga:cohortNthWeek ، یا ga:cohortNthMonth ). این تعداد کاربران در گروه را نشان می دهد که در پنجره زمانی متناسب با روز Nth Day/Week/ماه فعال هستند. به عنوان مثال ، برای ga:cohortNthWeek = 1 ، تعداد کاربران (در گروه) که در هفته دوم فعال هستند. اگر یک درخواست هیچ یک از ga:cohortNthDay ، ga:cohortNthWeek یا ga:cohortNthMonth را ندارد ، این متریک همان ارزش ga:cohortTotalUsers .

  • Metric - ga:cohortTotalUsers - تعداد کاربران متعلق به گروه ، همچنین به عنوان اندازه گروه شناخته می شود.

  • Metric - ga:cohortAppviewsPerUser - نمایش برنامه برای هر کاربر برای یک گروه.

  • Metric - ga:cohortGoalCompletionsPerUser - تکمیل هدف برای هر کاربر برای یک گروه.

  • Metric - ga:cohortPageviewsPerUser - صفحه نمایش برای هر کاربر برای یک گروه.

  • Metric - ga:cohortRetentionRate - نرخ حفظ گروه.

  • متریک - ga:cohortRevenuePerUser - درآمد هر کاربر برای یک گروه.

  • Metric - ga:cohortVisitDurationPerUser - مدت زمان جلسه در هر کاربر برای یک گروه.

  • Metric - ga:cohortSessionsPerUser - جلسات برای هر کاربر برای یک گروه.

  • Metric - ga:cohortTotalUsersWithLifetimeCriteria - این در زمینه درخواستی است که دارای ابعاد ga:acquisitionTrafficChannel ، ga:acquisitionSource ، ga:acquisitionMedium یا ga:acquisitionCampaign . این تعداد کاربران در گروه های گروهی را که از طریق کانال فعلی ، منبع ، متوسط ​​یا کمپین خریداری می شوند ، نشان می دهد. به عنوان مثال ، برای ga:acquisitionTrafficChannel=Direct ، این تعداد کاربران در گروه را نشان می دهد که مستقیماً به دست آمده اند. اگر هیچ یک از ابعاد ذکر شده وجود نداشته باشد ، مقدار آن برابر با ga:cohortTotalUsers .

  • Metric - ga:cohortAppviewsPerUserWithLifetimeCriteria - نمایش برنامه برای هر کاربر برای بعد کسب برای یک گروه.

  • Metric - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - تکمیل هدف برای هر کاربر برای بعد کسب برای یک گروه.

  • Metric - ga:cohortPageviewsPerUserWithLifetimeCriteria - نمای صفحه برای هر کاربر برای بعد کسب برای یک گروه.

  • Metric - ga:cohortRevenuePerUserWithLifetimeCriteria - درآمد هر کاربر برای بعد کسب برای یک گروه.

  • Metric - ga:cohortSessionsPerUserWithLifetimeCriteria - مدت زمان جلسه برای هر کاربر برای بعد کسب برای یک گروه.

ابعاد و معیارهای توپی داده های اجتماعی کاهش یافته است و فقط در مورد داده های تاریخی که از 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 محتوا به اشتراک گذاشته شده یا در یک شبکه شریک اطلاعات اجتماعی به اشتراک گذاشته شده یا ذکر شده است.

این نسخه بعد جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.

سیستم عامل یا دستگاه

  • Dimension - ga:browserSize - اندازه نمای مرورگرهای کاربران. اندازه مرورگر ابعاد scoped جلسه ای است که ابعاد اولیه نمای در پیکسل ها را ضبط می کند و به عنوان ارتفاع X X قالب بندی می شود. به عنوان مثال ، 1920x960.

گزارش های بدون نمونه

گزارش های بدون نمونه API دیگر 100 گزارش در روز ندارند. API از همان سیستم هر روز و هر روز استفاده می کند ، همانطور که هنگام ایجاد یک گزارش غیرقابل استفاده از طریق رابط وب.

گزارش های بدون نمونه

گزارش های بدون استفاده که برای کاربر فعلی قابل دسترسی نیست ، دیگر لینک بارگیری در پیام پاسخ API مدیریت نخواهد داشت. این رفتار اکنون با عملکرد داشبورد UI سازگار است که فقط صاحبان گزارش می توانند لینک بارگیری را برای سند تولید شده مشاهده کنند.

نمایش (پروفایل)

این نسخه ویژگی botFilteringEnabled را به منبع View (Profile) اضافه می کند. این خاصیت نشان می دهد که آیا فیلتر ربات برای نمایش (پروفایل) فعال شده است. برای جزئیات بیشتر به اسناد مرجع View (پروفایل) مراجعه کنید.

گزارش های بدون نمونه

این نسخه روش delete را به گزارش های نامشخص اضافه می کند. برای جزئیات بیشتر ، گزارش های حذف نشده اسناد مرجع را حذف کنید .

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • بدون تغییر.

گوگل تگ منیجر

  • مسئله ای را برطرف کرد که هنگام اجرای تست های واحد باعث تصادف می شود.

بخش ها

این یک نسخه رفع اشکال است. این نسخه مسئله ای را برطرف می کند که باعث می شود بخش هایی با مقادیر ارز در تعریف هنگام تماس با روش لیست بخش ها نادرست ظاهر شوند.

این نسخه پارامتر جدیدی را به API اضافه می کند.

شامل ردیف های خالی

  • این نسخه به پارامتر اختیاری جدید include-empty-rows اضافه می کند ، که هنگام تنظیم روی ردیف های false بدون داده از پاسخ حذف می شوند. مقدار پیش فرض true است ، که یک تغییر غیر شکستن است و به همین ترتیب نیازی به بروزرسانی کد نیست. برای جزئیات بیشتر به مستندات مرجع API Core مراجعه کنید.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • پشتیبانی برای BitCode اضافه شده است.

گوگل تگ منیجر

  • پشتیبانی برای BitCode اضافه شده است.

این نسخه معیارهای جدیدی را به 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 روزه منتهی به تاریخ معین خواهد بود.

بخش ها

این یک نسخه رفع اشکال است. این نسخه مسئله ای را برطرف می کند که باعث می شود کاربران دارای بخش های خصوصی به چندین نمایش (پروفایل) در هنگام تماس با روش لیست Segments پاسخ خطای 500 را دریافت کنند.

این نسخه معیارهای جدیدی را به 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 - درصد برداشت های تبلیغاتی که قابل مشاهده بودند. تصور وقتی در مرورگر کاربر ظاهر شد و این فرصت را داشت که دیده شود ، یک تصور قابل مشاهده در نظر گرفته می شود.

این نسخه یک پارامتر اضافی به URL API TOS ارائه می دهد:

  • علاوه بر این از پارامتر URL ، provisioningSignup=false ، مسئله ای را که هنگام تهیه یک حساب Google Analytics برای کاربر بدون هیچ گونه حساب Google Analytics رخ می دهد ، برطرف می کند. توسعه دهندگان باید کد خود را به روز کنند تا این پارامتر را به URL TOS اضافه کنند.

دسته بندی

با این نسخه ، علاوه بر پشتیبانی عمومی دسته بندی ، ما پشتیبانی ویژه ای را برای API مجوزهای کاربر اضافه کرده ایم. درخواست های مجوز کاربر Batched شاهد افزایش قابل توجهی در عملکرد و کاهش استفاده از سهمیه خواهد بود.

نمایش (پروفایل)

با استفاده از این نسخه ، اگر در طی یک عمل درج تنظیم نشود ، ویژگی currency (نمایه) به طور پیش فرض به دلار خواهد بود. همچنین عملیات get و list ، USD را در نمای (پروفایل) که قبلاً بدون دارایی currency ایجاد شده بودند ، باز می گردد.

این نسخه ابعاد یا معیارهای موجود را کاهش می دهد. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.

ابعاد منسوخ شده

این ابعاد کاهش یافته است. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی استهلاک داده ها را مرور کنید:

  • Dimension - ga:adSlotPosition - به جای آن از ga:adSlot استفاده کنید.
  • Dimension - ga:nextPagePath - ga:pagePath به جای آن استفاده کنید.
  • Dimension - ga:nextContentGroupXX - به جای آن ga:contentGroupXX استفاده کنید.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • مسئله ای را برطرف کرد که هنگام استفاده از setCampaignParametersfromurl باعث تصادفات شد. شماره 636 .

گوگل تگ منیجر

  • بدون تغییر.

فیلترها

این نسخه ، حذف نهایی قسمتهای فیلتر مستهلک شده IS_MOBILE و IS_TABLET است که باید با DEVICE_CATEGORY=mobile و DEVICE_CATEGORY=tablet جایگزین شود. درخواست های پچ را درج ، به روزرسانی و پچ کنید که زمینه های فیلتر را برای استفاده از IS_MOBILE تنظیم می کند و IS_TABLET خطایی را برمی گرداند.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • بدون تغییر.

گوگل تگ منیجر

  • درگیری نام کلاس را برطرف کرد. شماره 631 .

این نسخه بعد جدیدی را به API اضافه می کند. ابعاد و مرجع معیارها را برای لیست کامل ابعاد و معیارها بررسی کنید.

کلمات پیشنهادی

  • Dimension - ga:adQueryWordCount - تعداد کلمات موجود در جستجوی جستجو.

فیلترها

این نسخه با اضافه کردن یک ویژگی fieldIndex به تمام بخش های جزئیات فیلتر ، پشتیبانی از یک بعد سفارشی برای یک فیلتر فیلتر را اضافه می کند. به عنوان مثال اکنون می توان عبارت فیلتر را با "field": "CUSTOM_DIMENSION" و "fieldIndex": "1" برای داشتن فیلتر در اولین بعد سفارشی.

اهداف

این نسخه همچنین هنگام ایجاد یک هدف با "comparisonValue": "0" شکست می خورد.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • پشتیبانی اضافه شده برای اعزام پس زمینه در دستگاه های بازی غیر Google.
  • Logger/LogLevel Analytics مستهلک. Analytics اکنون به جای آن از ورود به سیستم Android استفاده می کند. برای فعال کردن اشکال زدایی اشکال زدایی RUN adb shell setprop log.tag.GAv4 DEBUG .
  • اصلاح مجدد برای بهبود تحویل داده ها و نصب انتساب کمپین.
  • اشکال تجزیه شده کمپین ثابت. شماره 596 .
  • استثنائات برنامه بدون استفاده در ثانیه های اول اولیه سازی تجزیه و تحلیل به درستی گزارش شده است. شماره 443 .

گوگل تگ منیجر

  • بدون تغییرات.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • وضوح صفحه را با استفاده از BativeBounds در iOS 8.0 و جدیدتر گزارش دهید. این موضوع شماره 504 را نشان می دهد.
  • پشتیبانی اضافه شده برای پارامترهای کمپین مربوط به کلیک.
  • علاوه بر نسخه سیستم عامل دستگاه ، مدل سخت افزار iOS را گزارش دهید. این موضوع شماره 408 را نشان می دهد.
  • گزارش IAD نصب را در iOS 7.1 و جدیدتر گزارش دهید. این به چارچوب IAD نیاز دارد.
  • هشدار استهلاک اضافه شده برای نوع ضربه AppView.
  • SQLite3 اکنون یک کتابخانه مورد نیاز است.

گوگل تگ منیجر

  • یک تصادف رشته نیل در TagDispatcher را برطرف کرد.

این نسخه شامل اضافه کردن یک زمینه جدید است. مرجع فیلد را برای لیست کامل قسمت ها مرور کنید.

حمل و نقل

  • میدان حمل و نقل به شما امکان می دهد مکانیزمی را که با آنها ارسال می شود تنظیم کنید.

سایر تغییرات

  • گزینه useBeacon مستهلک می شود.
  • رفع اشکال

این نسخه نشانگر نهایی و حذف مجدد dailyUpload Resouce است. منبع dailyUpload به طور رسمی در 20 ژوئن 2014 کاهش یافت. اکنون تمام واردات داده های هزینه با استفاده از منبع بارگذاری انجام می شود.

این نسخه ابعاد جدیدی را به API اضافه می کند. ابعاد و مرجع معیارها را برای لیست کامل ابعاد و معیارها بررسی کنید.

سیستم عامل یا دستگاه

  • Dimension - ga:dataSource - منبع داده یک ضربه. بازدیدهای ارسال شده از GA.JS و Analytics.js به عنوان "وب" گزارش شده است. بازدیدهای ارسال شده از SDK های موبایل به عنوان "برنامه" گزارش شده است. این مقادیر می توانند نادیده گرفته شوند.
  • Dimension - ga:searchAfterDestinationPage - صفحه ای که کاربر پس از انجام یک جستجوی داخلی در سایت شما از آن بازدید کرده است.

این یک نسخه رفع اشکال است:

  • این نسخه مسئله ای را در اجرای محدودیت های فیلتر در پرس و جو گزارش API در زمان واقعی برطرف می کند. درخواست های rt:activeUsers و یک فیلتر در ابعاد سطح رویداد منجر به خطایی با یک دلیل badRequest و یک پیام می شود که OR operator not supported for a hit level filter . برای اطلاعات بیشتر در مورد محدودیت های پرس و جو ، به راهنمای توسعه دهنده API Real Time Reporting مراجعه کنید.

این نسخه یک پارامتر HIT جدید اضافه می کند. مرجع پارامتر را برای لیست کامل پارامترها مرور کنید.

منبع اطلاعات

  • پارامتر منبع داده ds به شما امکان می دهد منبع داده یک ضربه را تنظیم کنید.

این نسخه شامل اضافه کردن یک زمینه جدید است. مرجع فیلد را برای لیست کامل قسمت ها مرور کنید.

منبع اطلاعات

  • قسمت منبع داده به شما امکان می دهد منبع داده یک ضربه را تنظیم کنید.

این نسخه یک پارامتر HIT جدید اضافه می کند. مرجع پارامتر را برای لیست کامل پارامترها مرور کنید.

نادیده گرفتن جغرافیایی

این نسخه دو مجموعه جدید را به API مدیریت ، ابعاد سفارشی و معیارهای سفارشی اضافه می کند.

ابعاد و متریک های سفارشی

اکنون می توان ابعاد و معیارهای سفارشی را با API مدیریت ایجاد ، لیست ، دریافت ، پچ و به روزرسانی کرد.

این نسخه ابعاد و معیارهای جدیدی را به 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 استفاده کنید.

پاسخ روش list برای همه مجموعه ها اکنون شامل یک لیست خالی برای ویژگی items است که مجموعه حاوی هیچ منبع نیست. پیش از این خاصیت items از پاسخ حذف می شد. برای جزئیات کامل در مورد داده ها و پاسخ های داده های پیکربندی Google Analytics ، به مرجع API مراجعه کنید.

این نسخه دامنه جدیدی را برای API مدیریت Google Analytics معرفی می کند. - analytics.manage.users.readonly - مشاهده مجوزهای کاربر Google Analytics.

یک قسمت جدید Filters Filters DEVICE_CATEGORY اضافه شده است و IS_MOBILE و IS_TABLET اکنون کاهش یافته است. DEVICE_CATEGORY=mobile و DEVICE_CATEGORY=tablet استفاده کنید.

این نسخه شامل:

تجزیه و تحلیل ترافیک گوگل

  • مسئله ای را برطرف کرد که مانع از ارسال همه چراغها هنگام اعزام چراغها شد.
  • برنامه نمونه CuteAnimals به روز شده برای نشان دادن نحوه اعزام هنگام ورود برنامه به پس زمینه.
  • پشتیبانی اضافه شده برای زمینه های پیشرفته تجارت الکترونیکی.
  • پیام های هشدار دهنده در مورد کلاسهای Gaihit و Gaiproperty که هنگام تهیه در برابر iOS SDK 8.0 از دست رفته اند ، حذف شده است. آن کلاس ها برداشته شدند.
  • اعزام چراغها اکنون کارآمدتر است و چندین چراغ در یک درخواست HTTPS واحد ارسال می شود.
  • درخواست ها برای صرفه جویی در استفاده از برنامه داده در شرایط خاص فشرده می شوند.

گوگل تگ منیجر

  • Deprecate TagcontainerFuture مبتنی بر OpenContainerWithId. استفاده از این API در iOS8 منجر به خطا در صورت فراخوانی در برخی از مراحل چرخه عمر UIAPPDELEGATE می شود.
  • پشتیبانی از معیارهای سفارشی و ابعاد سفارشی برای تجارت الکترونیکی پیشرفته برای برچسب Google Universal Analytics.
  • رفع اشکالی که محصولات لازم را برای اقدامات پیشرفته تجارت الکترونیکی که محصولات اختیاری دارند ، نیاز داشت.
  • پشتیبانی از ویژگی های شناسایی تبلیغات برای برچسب Analytics Google Universal.
  • برنامه نمونه CuteAnimals به روز شده برای نشان دادن نحوه ارسال داده ها هنگام ورود برنامه به پس زمینه.

منبع View (نمایه) اکنون شامل یک ویژگی enhancedECommerceTracking است که نشان می دهد تجارت الکترونیکی پیشرفته فعال است ( true ) یا غیرفعال ( false ).

این نسخه متریک جدیدی را به API اضافه می کند و دو معیار موجود را کاهش می دهد. برای لیست کامل تعاریف ، ابعاد و معیارها را بررسی کنید.

کلمات پیشنهادی

  • Metric - ga:ROAS - Return Of Ad Devery (ROAS) کل درآمد و ارزش هدف معامله است که با هزینه تبلیغات مشتق شده تقسیم می شود.

ابعاد و معیارهای منسوخ شده

این ابعاد و معیارها کاهش یافته است. خط مشی استهلاک داده ها را برای جزئیات در مورد حذف داده ها مرور کنید: + متریک - ga:ROI - به جای آن از ga:ROAS استفاده کنید. + متریک - ga:margin - به جای آن از ga:ROAS استفاده کنید.

این نسخه شامل یک بعد جدید است. برای لیست کامل تعاریف ، ابعاد و معیارها را مرور کنید.

زمان

  • ابعاد - rt:minutesAgo - تعداد دقایقی قبل یک ضربه رخ داد.

این نسخه معیارهای جدیدی را به API اضافه می کند. برای لیست کامل تعاریف ، ابعاد و معیارها را بررسی کنید.

AdSense

  • Metric - ga:adsenseCoverage - درصد درخواست های تبلیغاتی که حداقل یک تبلیغ را برگرداند.
  • Metric - ga:adsenseViewableImpressionPercent - درصد برداشت هایی که قابل مشاهده بودند.
  • اکنون می توان با عبور از پارامتر useBeacon با استفاده از navigator.sendBeacon (در مرورگرهای پشتیبانی شده) ارسال شد.
  • کوکی که توسط صفحه نمایش داده شده است ، افزونه از _dc به _gat تغییر نام داده است.

این نسخه ابعاد و معیارهای جدیدی را به 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 نشان داده می شود.
  • Metric - mcf:firstImpressionConversions - تعداد تبدیل هایی که برای آنها یک انتخاب کمپین DCM اولین تعامل تبدیل در یک پنجره 30 روزه جستجو بود. این بعد شامل تکمیل هدف و معاملات است.
  • Metric - mcf:firstImpressionValue - ارزش تبدیل هایی که برای آنها یک انتخاب کمپین DCM اولین تعامل تبدیل در یک پنجره 30 روزه جستجو بود. این بعد شامل تکمیل هدف و معاملات است.
  • Metric - mcf:impressionAssistedConversions - تعداد تبدیل هایی که یک تصور کمپین DCM در مسیر تبدیل ظاهر می شود ، اما تعامل تبدیل نهایی نبود. این بعد شامل تکمیل هدف و معاملات است.
  • Metric - mcf:impressionAssistedValue - ارزش تبدیل هایی که یک تصور کمپین DCM در مسیر تبدیل ظاهر می شود ، اما تعامل تبدیل نهایی نبود. این بعد شامل تکمیل هدف و معاملات است.

این نسخه شامل افزودن یک متریک جلسه جدید ، ابعاد جدید منابع ترافیکی و ابعاد و معیارهای مدیر کمپین جدید 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 Floodlight activity name and group name associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityGroup - DCM Floodlight activity group name associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityGroupId - DCM Floodlight activity group ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightActivityId - DCM Floodlight activity ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightAdvertiserId - DCM Floodlight advertiser ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmFloodlightSpotId - DCM Floodlight configuration ID associated with the floodlight conversion (premium only).
  • Dimension - ga:dcmLastEventAd - DCM ad name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdId - DCM ad ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdType - DCM ad type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdTypeId - DCM ad type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdvertiser - DCM advertiser name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAdvertiserId - DCM advertiser ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventAttributionType - There are two possible values (ClickThrough and ViewThrough). If the last DCM event associated with the Google Analytics session was a click, then the value will be ClickThrough. If the last DCM event associated with the Google Analytics session was an ad impression, then the value will be ViewThrough (premium only).
  • Dimension - ga:dcmLastEventCampaign - DCM campaign name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCampaignId - DCM campaign ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreative - DCM creative name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeId - DCM creative ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeType - DCM creative type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeTypeId - DCM creative type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventCreativeVersion - DCM creative version of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventRenderingId - DCM rendering ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSite - Site name where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSiteId - DCM site ID where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSitePlacement - DCM site placement name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSitePlacementId - DCM site placement ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Dimension - ga:dcmLastEventSpotId - DCM Floodlight configuration ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).
  • Metric - ga:dcmFloodlightQuantity - The number of DCM Floodlight conversions (premium only).
  • Metric - dcmFloodlightRevenue - DCM Floodlight revenue (premium only).

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • بدون تغییرات.

گوگل تگ منیجر

  • Enhanced Ecommerce support has been added to the Google Universal Analytics Tag.
  • New dispatch and dispatchWithCompletionHandler methods have been added to the TAGManager class.

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

ابعاد و متریک

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

گروه بندی محتوا

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

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • Support for enhanced ecommerce has been added. See the Enhanced Ecommerce Developer Guide for details.
  • The client ID will now reset every time the advertising ID is changed.
  • Advertising ID collection is off by default.
  • Added programmatic APIs for exception reporting.
  • Bug fixes in documentation.
  • Minor bug fixes.

گوگل تگ منیجر

  • No changes to Google Tag Manager.

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • The SDK will now collect IDFA and the advertiser tracking enabled flag if the library libAdIdAccess.a (provided as part of the SDK) is included in the application and the allowIDFACollection property is set to true on the tracker.
  • Enhanced Ecommerce support has been added.
  • Added screenview hit type to replace appview hit type.
  • A hit id parameter is now added to each hit. It is changed every time an appview, screenview or pageview hit is generated.
  • ClientId will now be reset every time the IDFA value is changes. This only happens when IDFA is collected in a tracker.
  • A new dispatchWithCompletionHandler method has been added to the GAI class.
  • Fixed an issue where the SDK could send a beacon without a clientId or with an empty clientId.

گوگل تگ منیجر

  • بدون تغییرات
  • Hits that do not contain a valid tracking id are now dropped.

This release includes new data import types and the deprecation of the dailyUpload resource.

Data Import

See the Data Import Developer Guide for details how to use the Management API to import data to your Google Analytics account.

آپلودها

  • The upload resource now supports the following upload types:
    • Campaign Data
    • Content Data
    • داده های هزینه
    • اطلاعات محصول
    • Refund Data
    • داده های کاربر
  • The upload resource has a new migrateDataImport method to migrate existing Cost Data customDataSources .

Daily Uploads Deprecation

  • The dailyUpload resource is now deprecated! see the Migration Guide for details on migrating to use the Data Import feature.
  • The dailyUpload resource will continue to work for six more months, at which point any remaining customDataSources with uploadType property set to analytics#dailyUploads will be automatically migrated and only work with the upload resource.
  • Current users of the dailyUpload resource should update their code and migrate to use the Upload resource as soon as possible.

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

بخش ها

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

ابعاد و متریک

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

تجارت الکترونیک پیشرفته

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

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

ابعاد و متریک

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

سیستم

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

Channel Grouping

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

تصحیح نام ستون سرصفحه

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

This release includes a naming convention change for the uiName attribute.

uiName تغییر دهید

  • The uiName attribute for templatized columns now uses XX to represent the numeric index instead of 1 . For example, Goal 1 Value is now Goal XX Value .

This is the initial release of the Embed API:

  • Google Analytics Embed API یک کتابخانه جاوا اسکریپت است که به شما امکان می دهد به راحتی داشبورد را در یک وب سایت شخص ثالث در عرض چند دقیقه ایجاد و جاسازی کنید. Visit the Embed API Overview for more details.
  • Includes components: auth, view selector, data, and data chart.

This is the initial release of the Provisioning API:

  • The Provisioning API can be used to programmatically create new Google Analytics accounts. This API is invite-only and intended for qualified service providers and large partners. Visit the Provisioning API Overview for more details.

This release adds two new configuration APIs.

  • AdWords Links in the Management API allows you to create, list, get, update, patch, and delete links between Google AdWords accounts and Google Analytics properties and manage which Views (Profiles) are linked to Adwords data.

فیلترها

Unsampled Reports: Management API

A new resource is being added to the Management API called Unsampled Reports . Unsampled reports are Google Analytics (GA) reports that have been generated using unsampled data. Unsampled reports are currently only available to GA Premium users.

  • Updated the list of supported organic sources.

    • Removed : Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Added/Updated : Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.

  • Updated the list of supported organic sources.

    • Removed : Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Added/Updated : Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • Added User Id field.

گوگل تگ منیجر

  • Fixed a bug in Id for Advertising Macro so that it can correctly return identifier for advertiser (IDFA) if available.
  • Fixed an issue so users can use NSNumber for ecommerce data.

This release includes the deprecation of the appUiName attribute. Review the Data Deprecation Policy for details on attribute removal:

منسوخ شدن appUiName

  • The appUiName has been deprecated. It is no longer required in the Metadata API because UI names for web and app views (profiles) have been unified. You should remove any code that uses the appUiName attribute and only use the uiName attribute.

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

تغییر نام ابعاد و متریک

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

کاربر

  • Dimension - rt:visitorType - Use rt:userType instead.
  • Metric - rt:activeVisitors - Use rt:activeUsers instead.

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

ابعاد و معیارهای جدید

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

کلمات پیشنهادی

  • Dimension - ga:isTrueViewVideoAd - Yes or No - 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.

تغییر نام ابعاد و متریک

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 - Use ga:userAgeBracket instead.
  • Dimension - ga:visitorGender - Use ga:userGender instead.

تجارت الکترونیک

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

ردیابی رویداد

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

تبدیل های هدف

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

Page Tracking

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

جلسه

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

تعاملات اجتماعی

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

کاربر

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

This release contains the replacement of the appview hit type and the addition and renaming of parameters. Review the Parameter Reference for the complete list of parameters.

جایگزینی appview

  • The appview hit type has been replaced with screenview . Update your app tracking code as soon as possible to use screenview instead of appview .

پارامترهای جدید

Parameter Rename

  • Content Description has been renamed to Screen Name . The query parameter name, cd , will remain the same.

This release contains the replacement of the appview hit type and the addition of new fields. Review the Field Reference for the complete list of fields.

جایگزینی appview

  • The appview hit type has been replaced with screenview . Update your app tracking code as soon as possible to use screenview instead of appview .

فیلدهای جدید

سایر تغییرات

  • Improved debug output.
  • Fixed various prerendering bugs.
  • Added support for unprefixed prerendering apis. Prerendering now works in IE11 in addition to Chrome.
  • Other minor bug fixes in linker support.
  • Yahoo secure search is now correctly classified as an organic source.
  • Added support for unprefixed prerendering apis. Prerendering now works in IE11 in addition to Chrome.

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

New segments support in the Core Reporting API.

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

Segments: Management API v2.4 & v3.0

The following changes have been made to the Segments Collection :

  • User and sequence segments are now supported in the API.
  • The Segments Collection now returns all built-in and custom session level and user level segments.
  • The definition property for segments will now use the new segments syntax. This includes definitions for existing session level segments which will change from definition: " " definition: " " to definition: "sessions::condition:: " definition: "sessions::condition:: " .
  • A new type property has been added to the Segment resource to indicate whether a segment is CUSTOM (ie created by a user in the web interface) or BUILT_IN (ie provided by Google Analytics).

آزمایش

The following AdSense metrics can now be used as optimization objectives:

  • ga:adsenseAdsClicks — The number of times AdSense ads on your site were clicked.
  • ga:adsenseAdsViewed — The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit.
  • ga:adsenseRevenue — The total revenue from AdSense ads.

مجموعه خلاصه های حساب جدید

  • The AccountSummaries collection has been added to the Management API. It provides a summary of information for each account, property, and view (profile) an authorized user has access to in a single and fast request. See the Account Summaries Developer Guide for details.

ga: پیشوند منسوخ شده

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.

ابعاد و معیارهای جدید

This update adds new dimensions and metrics to the Real Time Reporting API. Check the Dimensions and Metrics Reference for the complete list.

ردیابی رویداد

  • 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.

ردیابی هدف

  • 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.

ردیابی برنامه

  • Metric - rt:screenViews - the total number of screen views.

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • SDK will now populate the Application Id parameter ( &aid ) by default.

گوگل تگ منیجر

  • Added support for Google Analytics Content Experiments Macro.

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • No changes to Google Analytics.

گوگل تگ منیجر

  • Added support for Google Analytics Content Experiments Macro.

This release contains:

تجزیه و تحلیل ترافیک گوگل

  • No changes to Google Analytics directly. GA users should note that Google Tag Manager no longer has a dependency on AdSupport.framework by default. This may help resolve Issue 387 .

گوگل تگ منیجر

  • Functions that call AdSupport.framework API are broken out into a separate library, libAdIdAccess.a . Apps need to link with that library to have access to the advertising identifier (IDFA) string and advertiser tracking enabled flag.

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 API Customer.id .
  • Linker parameters are no longer ignored when navigating across domains at different zoom levels in Firefox.
  • Fixed a problem where In-Page Analytics would fail to load for certain URLs.
  • Improvements to debug mode output.
  • Maintenance release.

This release contains: * Removed need for AdSupport.framework . * Removed unused code.

This release contains: * Added support for 64-bit iOS 7.0 SDK. * Removed libGoogleAnalytics_debug.a , it's part of the libGoogleAnalyticsServices.a library. * Cleaned up CuteAnimals build file for Google Analytics.

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 API AdGroup.id .
  • Dimension - mcf:adwordsCampaignID - Corresponds to AdWords API Campaign.id .
  • Dimension - mcf:adwordsCreativeID - Corresponds to AdWords API Ad.id .
  • Dimension - mcf:adwordsCriteriaID - Corresponds to AdWords API Criterion.id .

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).

خروجی جدول داده ها

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

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

ابعاد و معیارهای جدید

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 between 00 and 59 .
  • Dimension - ga:nthMinute - Index for each minute in the specified date range. Index for the first minute of first day (ie, start-date) in the date range is 0 , 1 for the next minute, and so on.

حضار

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

Dimensions and Metrics Allowed In Segments

These dimensions and metrics can now be used in segments:

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

ابعاد و معیارهای منسوخ شده

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

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

The following changes have been made to default segments due to the deprecation of the ga:isMobile and ga:isTablet dimensions:

  • Segment gaid::-11 has been renamed from Mobile Traffic to Mobile and Tablet Traffic . The definition for this segment has been changed from ga:isMobile==Yes to ga:deviceCategory==mobile,ga:deviceCategory==tablet . Note that ga:isMobile included tablet traffic, which is reflected in the new definition. If you only want mobile traffic, excluding tablet, then switch to the new Mobile Traffic segment ( gaid::-14 ).
  • Segment gaid::-13 definition has changed from ga:isTablet==Yes to ga:deviceCategory==tablet . This continues to represent Tablet Traffic .
  • Segment gaid::-14 has been added. The name of the segment is Mobile Traffic and the definition is ga:deviceCategory==mobile .
  • Maintenance release.

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.

زمان

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

کلمات پیشنهادی

Bug Fixes:

  • Timezone information for views (profiles) has been fixed. Details : Before this fix, in certain cases when listing view (profiles) in the Management API, incorrect timezone information for a view (profile) was returned. Now timezone information for views (profiles) is consistent with what is set in the Google Analytics admin interface.

This release contains: * Fixed conflict with protocol buffer SDK. * Fixed linker error when code stripping was enabled.

کنترل اندازه نمونه جدید و ویژگی های تاریخ نسبی

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

کنترل اندازه نمونه جدید و ویژگی های تاریخ نسبی

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

This release contains: * Sixth beta release. * Made change required to avoid a runtime exception when an app targeting KitKat (API Level 19) uses the SDK.

This release contains: * Second release of version 3.0. * Made change required to avoid a runtime exception when an app targeting KitKat (API Level 19) uses the SDK.

This release introduces write operations for Web Property, View (Profile), and Goal resources and a set of 3 new resources that enable User Permissions management.

API های راه اندازی و پیکربندی حساب

  • Views (Profiles) can now be created, updated, patched, and deleted. Review the View (Profiles) reference for details on the new methods.
  • Web Properties and Goals can now be created, updated, and patched. Review the Web Properties reference and Goals reference for details on the new methods.
  • A single Web Property, View (Profile), or Goal can now be requested with the get method.
  • These features are currently available as a developer preview in limited beta. If you're interested is signing up, request access to the beta .

User Permissions in the Management API

  • The new accountUserLinks resource enables the management of account permissions for users.
  • The new webpropertyUserLinks resource enables the management of property permissions for users.
  • The new profileUserLinks resource enables the management of view (profile) permissions for users.
  • Permissions for an authorized user are now available as part of the Account , Web Property and View (Profile) resources.
  • A new scope has been introduced and is required to manage user permissions. https://www.googleapis.com/auth/analytics.manage.users .
  • See the User Permissions Dev Guide for additional details.

This release contains:

  • Fixed link error when targeting iOS 7.0.

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.

This release contains: * First release of version 3.0 * SDK API change to align with analytics.js. track و send methods have been removed. Use send and the GAIDictionaryBuilder construct methods instead. * Most properties on the GAITracker protocol have been removed. Use set on the various fields instead. * All parameters set using the set method will be persisted. Previously, several parameters would only be set for the next send/track call. * GAILogger protocol is available for those wanting to implement their own custom logging for the SDK. * Minimium system requirements have changed. See Readme.txt for details. * All SDK activity (database and network access) is now done on a separate thread. * clientId can now be read. Call [tracker get:kGAIClientId] . Note that this call will block until the clientId can be read from the database. * SDK no longer uses POST unless the hit is larger than 2000 bytes. It will use GET instead. * SDK will no longer retry sending hits based off the HTTP response code.

This release contains: * First release of version 3.0 * SDK API rewritten to more closely align with analytics.js. See javadoc and /analytics/devguides/collection/android/v3/ for details. * All track و send methods removed. Instead, you can use the send method and the corresponding construct methods in the MapBuilder class to send hits. See the class Fields for a list of constants you can use to build hits using set and send . * Many of the various properties have also been removed, including useHttps , anonymizeIp , etc. You can set/reset those properties using the set command. * EasyTracker now extends Tracker . There is no need to call EasyTracker.getTracker to make tracking calls directly. * The SDK no longer sets the session control flag to start on startup. Developers are now responsible for determining if a new session is needed. Note that EasyTracker still handles session management as before. * The SDK now supports a custom logging class. See Logger in the javadoc for details. * dryRun mode has been added. * clientId can now be read. Simply call tracker.get(Fields.CLIENT_ID) . This call will block until the clientId has been loaded from the persistent store. * The SDK will no longer retry hits based on the HTTP response code.

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.

رفع اشکال

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

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

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

As part of the new segments launch , we will be rolling out the following changes to the Segments Collection :

  • All Segment IDs will be changed from positive integers to alphanumeric strings. If you have saved users' Segment IDs, we recommend you update them to use the new IDs.
  • The Segments Collection will only return the existing visit level segments. The new visitor, cohort, and sequence segments are currently not supported in the API.
  • The Segments Collection will continue to return the existing default segments with the same negative numeric IDs, however, the new default segments are currently not supported.

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

ردیابی برنامه

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

منسوخ

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

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

Custom Variables or Columns

  • Access to custom dimension and metrics:

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

تغییرات اسناد و مدارک

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 - 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.

تغییرات اسناد و مدارک

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

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

Page Tracking

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

Platform or Device

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

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

تعاملات اجتماعی

  • This data comes from onsite social interaction tracking.

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

زمان

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

منابع ترافیک

  • Dim - ga:fullReferrer - The full referring URL including the hostname and path.
  • Dim - ga:sourceMedium - The combined values of ga:source and ga:medium .

This release adds 2 new properties to the Webproperty resource :

  • profileCount - Returns profile count for a property. This allows you to filter properties that don't have any profiles (ie, profileCount = 0).
  • industryVertical - Returns the industry vertical/category selected for a property.

Bug Fixes:

  • The eCommerceTracking property of the Profile resource is now consistent with Ecommerce settings in the admin section of the web interface. Returns true when Ecommerce tracking is enabled, and false if not.
  • The Webproperty resource now includes a level property to indicate whether the web property is PREMIUM or STANDARD .

This release contains: * Fifth beta release. * EasyTracker exception parsing bug fix. When ga_reportUncaughtExceptions flag is set, we were not initializing the exception parser, and as a result not parsing the location of an uncaught exception. With this fix, the crash and exception reports will report the location of uncaught exceptions when ga_reportUncaughtExceptions is set to true.

  • A new endpoint has been added to the Management API v3 to access and modify Experiments resources.

The following changes have been pushed to the latest version of the tracking code:

  • Added support for specifying local currencies with _set , eg gaq.push(['_set', 'currencyCode', 'EUR'])
  • This release adds 5 new site speed metrics:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • This release adds a new default segment for Tablet Traffic, gaid::-13 .
  • The Profile resource now includes a type property to identify whether a profile is configured for a Web site or App. The two possible values are: WEB or APP .

This release contains:

  • Change default appVersion to the value in CFBundleShortVersionString instead of CFBundleVersionKey .
  • Use HTTPS as the default protocol instead of HTTP.
  • Track methods changed to Send (eg trackView now called sendView ).
  • Some minor bug fixes.

This release contains: * Fourth beta release. * The SDK will now respect the sample rate setting. If you previously set the sample rate to other than 100% you will now see a corresponding decrease in some of your Analytics metrics compared with beta 3. * Changed track methods to send (eg trackView now called sendView ). * Added local currency support via Transaction.setCurrencyCode * Use HTTPS by default instead of HTTP. * SDK will not attempt to dispatch hits if there is no network connectivity. * Avoid ANRs while attempting to handle install campaign data. * Removed TrackedActivity classes from the SDK. * Move SDK initialization off the main UI Thread. * Improve the SDK's ability to recover from a corrupted SQLite database. * Several other crashes and bugs fixed.

This release contains:

  • Added armv7s architecture to libGoogleAnalytics.a.
  • Removed armv6 architecture from libGoogleAnalytics.a.

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

ردیابی برنامه

  • 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.

منابع ترافیک

  • 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.

تعاملات اجتماعی

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

Geo / Network

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

Page Tracking

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

ردیابی استثنا

  • This data come from exception tracking data.

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

User Timings

  • This data comes from user timing data.

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

دستگاه / پلتفرم

  • 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.

This release contains:

  • Bug Fixes:

    • Remove NoThumb version of library.
    • Drop support for armv6.

  • ویژگی های جدید:

    • Add support for armv7s (for iPhone5).

This release contains:

  • Bug Fixes:
    • Fix migration from pre-1.5 SDK CVs to 1.5 SDK custom variables.
    • Honor user's background data restrictions setting.

This release contains:

  • Bug Fixes:
    • GANTrackerDelegate protocol methods are now optional.
    • Events now include the last tracked page view (utmp).
  • ویژگی های جدید:
    • Support for up to 50 custom variables (Note: this feature is available for Google Analytics Premium users only).
    • Updated BasicExample example app.

This release contains:

  • Bug Fixes:

    • Fix memory leak.
    • Events now include the last tracked page view ( utmp ).

  • ویژگی های جدید:

    • Support 50 custom variables (Note: this feature is available to Google Analytics Premium users only).

This release contains:

  • Added social tracking method to GAITracker :
    • trackSocial:withAction:withTarget:
  • Timing method signature changed to:
    • trackTiming:withValue:withName:withLabel:
  • Manual construction and dispatch methods added to GAITracker:
    • set:value:
    • get:
    • send:params:
  • Custom dimension setter methods added to GAITracker:
    • setCustom:dimension:
    • setCustom:metric:
  • Architecture of data store refactored to prevent reported CoreData issues.

This release contains:

  • Added support for custom dimensions and metrics.
  • Added support for social interaction tracking.
  • Made StandardExceptionParser class public
  • Fixed occasional crashes during initialization of the SDK.
  • Fixed INSTALL_REFERRER broadcasts being ignored on some devices.
  • Fixed ConcurrentModificationExceptions in GoogleTracker class.
  • Other bugfixes and enhancements

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 .

This release contains:

  • Updated to latest wire format.
  • sampleRate changed to double-precision float.
  • Excessive tracking is throttled.
  • Undispatched tracking information is deleted when opt-out is enabled.
  • Undispatched tracking information older than 30 days will be deleted.
  • Enhancements to hit dispatcher.
  • Rather than periodically retry, the dispatcher will use the Reachability API when connectivity is lost to get notified when connectivity is reestablished.
  • Updated example app.
  • Other bugfixes and enhancements.

This release contains:

  • Simplified EasyTracker interface.
  • Control of dispatching moved to a new class, GAServiceManager .
  • Updated to latest wire format.
  • sampleRate changed to double.
  • Excessive tracking is throttled.
  • Undispatched tracking information is deleted when opt-out is enabled.
  • Undispatched tracking information older than 30 days will be deleted.
  • Other bugfixes and enhancements.

رفع اشکال

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

This release contains:

  • Added uncaught exception handling facility.
  • Removed dispatchEnabled property from GAI .
  • Added defaultTracker property to GAI .
  • Added close method to GAITracker .
  • Added timing tracking method to GAITracker .
  • Added trackView method to GAITracker which takes no argument.
  • Transaction item field names updated.
  • Updated to latest wire format.
  • Event value is interpreted as a 64-bit integer.
  • ARMV6 code generation switched from THUMB to ARM.

This release contains:

  • startSession method has been removed. Use setStartSession instead.
  • Added ga_sessionTimeout parameter to EasyTracker.
  • Implemented power save mode.
  • Added trackView method to GAITracker which takes no argument.
  • Fixed a bug that prevented exception parameters from being sent on hits.
  • Hits that can't be read from the database are discarded instead of permanently blocking all hits from being dispatched.
  • Updated to latest wire format.
  • Implemented timing hit type.
  • Implemented Ecommerce hit types (transaction and item).

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

The following changes have been pushed to the latest version of the tracking code:

  • The maximum allowed site speed sample rate ( _setSiteSpeedSampleRate ) has been increased from 10% to 100%.
  • The _setAccount method now trims any leading and trailing spaces.

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.

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 نسخه 2.3 Reminder Deprecation

  • 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.

The following changes have been pushed to the latest version of the tracking code:

  • Updated the list of organic search engines detected by default. Added 'startsiden.no', 'rakuten.co.jp', 'biglobe.ne.jp', and 'goo.ne.jp'. Removed 'search' and added 'conduit.com', 'babylon.com', 'search-results.com', 'avg.com', 'comcast.net', and 'incredimail.com' all of which were previously attributed together as 'search'.

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

This release adds helpful error responses to the Management API.

  • New error codes, reasons, and descriptions have been added to the body of API error responses. All the codes have been documented for both the versions - Version 2.4 and Version 3.0 - of the Management API.

The following changes have been pushed to the latest version of the tracking code:

  • The limit on custom variable length has been increased from 64 to 128 characters. Additionally, the length is now checked before URL encoding.
  • The rate limit for event hits has been relaxed. You can now send 10 hits with 1 additional hit per second (previously this was limited to 1 hit every 5 seconds). Note that the 500 hits per session limit still applies.
  • __utmv cookies are now written with a different variable separator (caret instead of comma) to be compatible with RFCs. This should fix some of the issues related to cookie encoding issues seen by customers.

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 .

نسخه 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 to 403
    • JSON responses are not supported.
    • Google Data JavaScript client library not supported.
    • No Account Feed. All requests for configuration data should be done through the Management API .

ثبت

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

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

Quota Policy

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

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

  • The following quota applies to the Data Export API

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

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

تحقیرها

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

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

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

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

This release adds data, changes existing functionality and fixes a bug.

داده های جدید

  • The Advanced Segment collection now contains a segmentId field that can be used in the Data Export API segment parameter.

تغییرات

  • The data type for max-results has been changed to integer .

  • The default and maximum value for max-results has been changed to 1000.

رفع اشکال

  • Accounts, web properties, and profiles for Google Website Optimizer experiments are no longer included in their corresponding collections.

This release contains:

  • مستندات:

    • The ReadMe.txt has been updated to point to the website for documentation.

This release contains:

  • Bug Fixes:
    • Fixed handling of Destination URL Autotracking from Google Play.
    • Allow the referrer parameter to setReferrer to be url-encoded.

Changes to Site Speed data collection:

  • Site speed data is now automatically collected for all web properties at a 1% sample rate. The _trackPageLoadTime function, previously required to opt-in to site speed data collection, is now deprecated.
  • The default sample rate may be adjusted using the new _setSiteSpeedSampleRate function.
  • If a virtual path is used in the _trackPageview call, that path will now also be associated with any site speed data collected from that page.

This release contains:

  • Bug Fixes:
    • Changed location of the database to from the Documents directory to the Library directory.
    • The SDK no longer throws NSAsserts for SQLite database errors.
    • Fixed crash when calling trackPageview with an empty string.
    • Fixed crashes when calling various GANTracker methods after stopTracker was called.
    • Fixed several memory leaks, including one calling trackPageview with a pageURL that begins with '/'.
  • ویژگی های جدید:
    • Added dispatchSynchronously method.
    • Exposed several useful constants (see GANTracker.h).

This release contains:

  • Bug Fixes:
    • Trapped and handled several SQLiteExceptions .
    • Fixed NullPointerException in stopSession if called prior to calling startNewSession .
    • Fixed Out Of Memory errors on HTC Thunderbolt and Motorola Droid Bionic devices.
    • Eliminated unnecessary database access in the dispatch method.

This release contains the following new feature:

  • Events can be marked as non-interaction by setting the new opt_noninteraction parameter of the _trackEvent() method to true . Marking an event as non-interaction indicates that hits from the tagged event will not impact bounce rate. For more information, see the ga.js reference .

This release contains the following bug fix:

  • Fixed an issue where propagating the AdWords gclid URL parameter on internal site links could result in inflated paid visit counts.

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

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

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

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

This release contains:

  • Bug Fixes:
    • Fixed bus error when attempting to set dryRun flag prior to starting the tracker.
    • Fixed bus error when attempting to pass NULL for error.
    • Use correct language in HTTP header.
  • ویژگی های جدید:
    • Added anonymizeIp flag.
    • Added sampleRate parameter.
    • Added support for campaign referrals.

This release contains:

  • Bug Fixes:
    • Fixed bug in general campaign referral tracking.
    • Fixed anonymizeIp flag interfering with campaign tracking.

This release adds two new versions of the API with many new features, and it deprecates the old version. The changes impact the way you request and handle data from the API.

نسخه 3.0

  • This 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 data

    • Full representation of event goals
    • An internal web property ID that can be used to deep link into the GA user interface
    • Profile configurations for the default page and site search query parameters

  • تغییرات

نسخه 2.4

  • This is a minor version upgrade that is mostly backwards compatible with the existing Version 2.3.

  • تغییرات

    • A new quota policy
    • Integration with the Google APIs Console to manage API access and request more quota
    • Continued support for existing authorization mechanisms and OAuth 2.0
    • New URL to make requests: https://www.googleapis.com/analytics/v2.4/management/…
    • Responses in XML only
    • No support for the Google Data JavaScript client library
    • XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.

منسوخ شدن

  • We are announcing the deprecation of the legacy version 2.3 of the Management API. It will continue to work for two months, after which all v2.3 requests will return a v2.4 response.

This release fixes a bug which caused inflated numbers of visits and/or a decrease in the number of new visitors for some sites. The first effect primarily affected sites with organic traffic coupled with specific user behavior. The second effect was only on sites using an unsupported tracking configuration with multiple trackers.

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 or ga:adGroup cannot be combined with ga:impressions .

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

Changes to session calculations:

  • One campaign per session: If a new campaign is started during an existing session, the tracking script will now automatically start a new session. A new campaign will be triggered by a change to any of the following fields: campaign id, name, source, medium, term, content, or gclid.
  • The tracking script no longer starts a new session in the event that a user closes the browser.

Changes to cross-domain tracking:

  • The call to _setAllowHash(false) is no longer required when configuring cross-domain tracking. Pages that already include a call to _setAllowHash(false) will continue to work, but it is no longer required when setting up a new site.
  • The tracking script will now attempt to repair linker parameters that have been mangled by HTTP redirectors and browsers. Approximately 85% of linker values that are currently discarded due to encoding changes introduced by redirectors and browsers should now be successfully restored and accepted by the tracking script.

This release contains:

  • Bug Fixes:
    • Fixed several issues in database handling.
    • Fixed exceptions while using custom variables.
    • Hold the application context instead of the context passed into it.
    • Removed the ability to accidently create phantom sessions.
  • ویژگی های جدید:
    • Added the ability to set campaign referrals at any time
    • Added sampleRate flag
    • Added anonymizeIp flag

This release contains one new feature:

  • The tracking code now postpones hits for prerendered pages until those pages are viewed by the user. If a prerendered page is never viewed, no hits are sent. This feature is only available to sites using the async tracking script. You can learn more about prerendering in Google Webmaster Central Blog .

This release contains a variety of bug fixes and refactorings, and one new feature:

This release deprecates the confidence interval value in metrics.

از بین بردن فاصله اطمینان

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

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

This release contains:

  • Bug Fixes:
    • Fixed crash when using custom variables.
    • Fixed memory leaks when using custom variables.
  • ویژگی های جدید:
    • Added support for Ecommerce hits.
    • Added Debug flag.
    • Added DryRun flag.
    • More descriptive error information on SQLite3 failures

This release contains:

  • Bug Fixes:

    • Fixed badly formatted userAgent String.

  • ویژگی های جدید:

    • Added support for Ecommerce tracking
    • Added debug flag
    • Added dryRun flag

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

به روز رسانی داده های جدید

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

Metric Updates

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

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

This release contains the following bug fixes.

  • Fixed a bug in cross domain tracking that caused incorrect encoding of campaign data in some cases.
  • Fixed a bug in cross domain tracking that caused cookies to be loaded from the URL more than once, causing incorrect cookies in some cases.
  • Fixed a bug in Custom Variables that caused some values to be encoded in reports.

This release contains:

  • Bug Fixes:

    • Fixed improper encoding of spaces.
    • SQLiteExceptions no longer cause apps to crash.

  • ویژگی های جدید:

    • Added support for custom variables

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

ارتقای کارایی

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

به روز رسانی داده های جدید

  • 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.

تغییرات آتی

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

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

This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.

This release contains updates and one new feature.

  • POST support:

    • The tracking code can now send much larger tracking beacons. Traditionally, beacons have been sent via HTTP GET requests, which are limited to 2048 characters by some browsers and proxies. Requests over this limit were dropped and the data never reached Google Analytics. Starting with this release, requests longer than 2048 characters will be sent via HTTP POST , which has no such limit. The tracking code will now support beacons up to 8192 characters.

This release adds more data to the Data Feed:

به روز رسانی داده های جدید

  • 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

تغییرات آتی

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

This release contains the following bug fixes.

  • Fixed a bug that prevented _addIgnoredOrganic and _addIgnoredRef from working properly on the first visit to a site.
  • Fixed an issue related to tracking code running across multiple iframes.

This release contains:

  • ویژگی های جدید:
    • Added support for custom variables.
    • Added NoThumb version of the library.

This release adds significantly more data to the Data Feed:

به روز رسانی داده های جدید

  • 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.

معیارهای جدید محاسبه شده

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

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

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

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

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

This release adds a new feature to the Data Feed:

ویژگی های جدید

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

This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.

This release contains:

  • ویژگی های جدید:

    • Added iOS4 support

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).

This is the beta release of the Google Analytics Management API!

اطلاعات جدید

کتابخانه های مشتری به روز شده

  • The Management API is being released in the same library as the Google Analytics Data Export API. Both Google Data Java and JavaScript libraries have been updated. Each feed can be accessed by specifying the appropriate feed URI to the libraries getManagementFeed() method.

مستندات جدید

  • A new section of the Google Analytics developer docs has been created to describe how the new Management API works.

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 .

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.

This release contains bug fixes and API cleanup.

  • رفع اشکال:

    • Fixed event tracking bug. Calling _trackEvent no longer requires calling _initData or _trackPageview first.
    • Updated async snippet so that it can be placed in the head on any page without causing problems in IE 6 and 7. See the Asynchronous Tracking Guide for the new snippet. This update occurred on 3/22/2010.
    • Expanded async syntax to support calling methods on the _gat object.

  • Updated tracker initialization APIs to be consistent with async syntax. Also deprecated old functions.

    • Added _gat._createTracker(opt_account, opt_name) function. Allows trackers to be named and later retrieved by their name.Use this instead of _gat._getTracker(account) .
    • Added _gat._getTrackerByName(name) . Retrieves the tracker with the given name.
    • Added tracker._getName() . Returns the name given to the tracker when it was created.
    • Deprecated _gaq._createAsyncTracker(account, opt_name) . Use _gat._createTracker instead.
    • Deprecated _gaq._getAsyncTracker(name) . Use _gat._getTrackerByName instead.

  • See the Tracker Reference for details on these API changes.

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 and ga:previousPagePath are now part of the D3. Content group. D8. Custom Variable group is now called the D6. 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 either INF or a number from 0 to 1. Now all confidence intervals will have a value of either INF or a number greater than or equal to 0.

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

یادآوری منسوخ شدن ابعاد و معیارها

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

This release adds a number of new features:

این نسخه شماره نسخه اصلی را به 2 افزایش می دهد

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

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

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

پشتیبانی از بخش بندی پیشرفته

  • 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:

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>

  • 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 .

داده های هدف جدید در دسترس است

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

    • <ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
    • <ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
    • <ga:step number="1" name="Login" path="/login.html"></ga:step>
    • <ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>

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

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

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

داده های متغیر سفارشی جدید

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

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>

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

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

Deprecated dimensions & metrics to be removed!

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

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

  • The following dimensions have been renamed:

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

This release contains updates to the default search engine list and new functions to control cookie timeouts. In addition, the asynchronous GA snippet is launched that reduces the ga.js latency impact on the page.

  • Updated the default search engine list

    • Added Naver, Eniro and Daum search engines.
    • Removed Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum and Ilse from the list.

  • Added functions to control cookie expiration times for all stored cookies. Deprecated existing cookie timeout functions. See the JS API documentation for more details.

    • _setVisitorCookieTimeout(cookieTimeoutMillis) replaces the _setCookiePersistence function.
    • _setSessionCookieTimeout(cookieTimeoutMillis) replaces the _setSessionTimeout function.
    • _setCampaignCookieTimeout(cookieTimeoutMillis) replaces the _setCookieTimeout function.

  • Launched asynchronous GA snippet. See documentation on how to try it out.

  • _setVar function is now deprecated. Custom Variables feature replaces _setVar . برای جزئیات بیشتر به مستندات مراجعه کنید.

This release contains:

  • Added a new function to retrieve visitor level custom variables. See the function documentation for more details.

    • _getVisitorCustomVar(index)

  • Instead of waiting for window.onload, Site Overlay content is loaded as soon as ga.js is executed.

This release contains a new feature:

  • Added an optional boolean parameter to _addOrganic function to specify if new organic sources are added to the beginning or the end of the organic source list. برای جزئیات بیشتر به مستندات مراجعه کنید.

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

This release contains regular maintenance for performance improvements and refactorings. There is no change to the public APIs or functionality.

This release adds new features and deprecates some old functionality:

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

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

  • The following Dimensions have been renamed:

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

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

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

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

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

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

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

    D3. Content * ga:landingPagePath * ga:secondPagePath

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

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

    • ga:visitLength

This release contains multiple bug fixes and performance improvements:

  • Proper encoding for search terms for organic searches, web page path info for (utmp), and user defined values when used with the linker feature (ie: _link and _linkByPost functions).
  • The search engine Rambler is added to the organic search list
  • Organic search parsing is corrected for search engine http://kvasir.no
  • New organic search engines defined by the user are now added to the top of the list
  • Removed deprecated _trackEvent(action, label, value) function and replaced it with _trackEvent(category, action, label, value)
  • Referrer URLs are now stored as case sensitive. For example: www.domain.com/PaGe.HtMl will be reported with case information.
  • Added a 1200 character limitation to GASO token size.
  • New function was added to allow overriding the default timeouts for cookies: _setCookiePersistence(timeout)

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

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

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

  • The Account Feed now returns two new data elements for each Table ID (currency and timezone).
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

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

  • All previous deprecation changes have taken effect.

This release removes deprecated features from our private beta:

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

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

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

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

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

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