بررسی اجمالی

این سند API گزارش زمان واقعی Google Analytics را توصیف می کند. برای مرجع دقیق API، مرجع API را بخوانید.

معرفی

Real Time Reporting API شما را قادر می‌سازد تا داده‌های بی‌درنگ (مثلاً فعالیت در زمان واقعی در دارایی خود) را برای یک کاربر تأیید شده درخواست کنید.

می توانید از API گزارش زمان واقعی برای موارد زیر استفاده کنید:

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

Google Analytics superProxy

از Google Analytics superProxy برای رسیدگی به بسیاری از جزئیات پیاده‌سازی کار با APIهای Google Analytics در احراز هویت، ذخیره‌سازی حافظه پنهان و تبدیل پاسخ‌های API به قالب‌هایی که مستقیماً با کتابخانه‌های تجسم و نمودار استفاده می‌شوند، استفاده کنید.

بررسی اجمالی مفهومی

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

  • نحوه ارتباط گزارش ها با کاربران و بازدیدها (نمایه ها).
  • ساختار یک گزارش و نحوه ساخت پرس و جو.
  • کار با پاسخ API.

گزارش ها، کاربران و بازدیدها (نمایه ها)

قبل از اینکه کاربران بتوانند از برنامه شما برای درخواست داده های گزارش خود از یک نمای (نمایه) استفاده کنند، باید:

  1. Google Analytics API را فعال کنید.
  2. برای دسترسی به API برای برنامه خود اعتبارنامه ایجاد کنید.
  3. مدارک را در برنامه خود قرار دهید.

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

یک نما (نمایه) با شناسه View (نمایه) شناسایی می شود. نماها (نمایه ها)، در میان سایر نهادها، بخشی از سلسله مراتب Google Analytics از حساب ها، کاربران، دارایی ها و بازدیدها هستند. برنامه شما می تواند از مدیریت API برای عبور از این سلسله مراتب و به دست آوردن یک نمای (نمایه) استفاده کند.

پرس و جو برای ابعاد و متریک

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

از راهنمای مرجع ابعاد و معیارها برای کاوش در تمام ابعاد و معیارهای [در معرض نمایش] موجود در API استفاده کنید. همچنین، راهنمای مرجع API Reporting Real Time را بخوانید تا نحوه تعیین ابعاد و معیارها در یک پرس و جو API را بیاموزید.

کار با گزارش ها

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

خط مشی سهمیه

Real Time Reporting API میلیون ها عملیات پرس و جو داده را مدیریت می کند. ما از یک سیستم سهمیه بندی استفاده می کنیم تا از سیستم در برابر دریافت عملیات بیشتر از توانش محافظت کنیم و از توزیع عادلانه منابع سیستم اطمینان حاصل کنیم. برای جزئیات بیشتر، راهنمای محدودیت ها و سهمیه ها را بخوانید.

مراحل بعدی

اکنون که می دانید API چگونه کار می کند، برای شروع: