Google Analytics Real Time Reporting API Changelog

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

این صفحه هر گونه تغییر ایجاد شده در Google Analytics Real Time Reporting API را که ممکن است بر برنامه شما تأثیر بگذارد، مستند می کند. توصیه می‌کنیم توسعه‌دهندگان API به‌طور دوره‌ای این فهرست را برای اطلاعیه‌های جدید بررسی کنند. همچنین می توانید از طریق فیدهای فهرست شده در بخش اشتراک در زیر، در تغییرات مشترک شوید.

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

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

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

همه گزارش تغییرات API
–
اشتراک درrss

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

گزارش تغییرات API در زمان واقعی
–
اشتراک درrss

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

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

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

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

زمان

  • Dimension - rt:minutesAgo - تعداد دقیقه‌های قبل که ضربه‌ای اتفاق افتاده است.

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

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

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

کاربر

  • Dimension - rt:visitorType - به جای آن rt:userType استفاده کنید.
  • متریک - rt:activeVisitors - به جای آن از rt:activeUsers استفاده کنید.

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

پیشوند ga: برای همه ابعاد و معیارهای زمان واقعی منسوخ شده است و با پیشوند جدید rt: جایگزین شده است. درخواست‌های API که از پیشوند ga: استفاده می‌کنند به مدت ۶ ماه به کار خود ادامه می‌دهند و پس از آن یک خطا برگردانده می‌شود.

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

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

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

  • بعد - rt:eventAction - عمل رویداد.
  • Dimension - rt:eventCategory - دسته رویداد.
  • Dimension - rt:eventLabel - برچسب رویداد.
  • بعد - rt:totalEvents - تعداد کل رویدادها برای نمایه، در همه دسته‌ها.

ردیابی هدف

  • بعد - rt:goalId - رشته ای مطابق با شناسه هدف.
  • متریک - rt:goalXXValue - مقدار عددی کل برای شماره هدف درخواستی، که در آن XX عددی بین 1 تا 20 است.
  • متریک - rt:goalValueAll - مقدار عددی کل برای همه اهداف تعریف شده برای نمایه شما.
  • متریک - rt:goalXXCompletions - تعداد کل تکمیل‌ها برای شماره هدف درخواستی، که در آن XX عددی بین 1 تا 20 است.
  • متریک - rt:goalCompletionsAll - تعداد کل تکمیل‌ها برای همه اهداف تعریف شده برای نمایه شما.

ردیابی صفحه

  • متریک - rt:pageViews - تعداد کل بازدیدهای صفحه.

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

  • متریک - rt:screenViews - تعداد کل بازدیدهای صفحه.

این نسخه اولیه API گزارش زمان واقعی در نسخه بتا محدود است:

  • Real Time Reporting API به شما این امکان را می دهد که در مورد فعالیتی که در حال حاضر در ملک شما رخ می دهد گزارش دهید. می‌توانید از API گزارش‌دهی بی‌درنگ برای پرس و جو برای ابعاد و معیارها استفاده کنید تا ویجت‌ها و داشبوردهای وب رو به روی مشتری بسازید. برای جزئیات بیشتر به نمای کلی API Reporting Real Time مراجعه کنید.