«پروتکل اندازه‌گیری Google Analytics» به شما امکان می‌دهد علاوه‌بر داده‌هایی که ازقبل با برچسب‌گذاری یا «کیت توسعه نرم‌افزار Firebase» جمع‌آوری می‌کنید، داده‌های آفلاین را به جریان «وب» یا «برنامه» خود ارسال کنید.
این راهنما موارد استفاده رایج از «پروتکل اندازه‌گیری Google Analytics» و الزامات آن‌ها را شرح می‌دهد.
خلاصه الزامات
این جدول مرجع سریعی از الزامات برای هر مورد استفاده ارائه می‌دهد. روال‌های مطلوب زیر را به‌خاطر داشته باشید:
timestamp_microsرویدادها و مشخصه‌های کاربر به‌طور پیش‌فرض روی زمان درخواست تنظیم می‌شود. هنگام ارسال رویداد یا تغییر مشخصه کاربر که در گذشته رخ داده است، مهر زمان را همان‌طور که در راهنمای ارسال رویدادها و راهنمای مشخصه‌های کاربر توضیح داده شده است ملغی کنید.برای گزارش‌های «هم‌زمان» دقیق و سنجه‌های تعامل، پارامتر رویداد
engagement_time_msecرا که روی میلی‌ثانیه‌های سپری‌شده از رویداد قبلی تنظیم شده است اضافه کنید.
| کاربرد | شناسه جلسه | شرط زمان درخواست | شرط timestamp_micros |
|---|---|---|---|
| اختصاص دادن «شناسه کاربر» به رویدادها | الزامی | <= پایان روز کاری شروع جلسه | >= شروع جلسه و <= پایان جلسه |
| ارجاع جلسه | الزامی | <= شروع جلسه + ۲۴ ساعت | >= شروع جلسه و <= پایان جلسه |
| صادر کردن رویدادها به پلاتفرم‌های تبلیغات | الزامی نیست | <= روز جلسه آخر + ۶۳ روز | >= زمان درخواست منهای ۷۲ ساعت و <= زمان درخواست |
| ارسال رویدادها یا دارایی‌های کاربر برای ساختن مخاطب | الزامی نیست | وب: <= جدیدترین زمان رویداد آنلاین + ۳۰ روز برنامه: <= جدیدترین زمان رویداد آنلاین + ۴۲ روز |
>= زمان درخواست منهای ۷۲ ساعت و <= زمان درخواست |
اختصاص دادن «شناسه کاربر» به رویدادها
از Measurement Protocol برای ارائه رویدادهای آنلاین یا آفلاین با شناسه کاربر استفاده کنید.
در اینجا چند نمونه از موارد استفاده برای افزودن «شناسه کاربر» به رویداد آورده شده است:
اندازه‌گیری آنلاین شما فاقد اطلاعات لازم برای جستجوی «شناسه کاربر» برای رویدادهای آنلاین است، اما خط لوله پردازش رویدادی دارید که می‌تواند ارتباط بین جلسه آنلاین و «شناسه کاربر» را برقرار کند.
در این سناریو، از Measurement Protocol برای ارائه رویدادهای آنلاین با «شناسه کاربر» استفاده می‌کنید.
«شناسه کاربر» را برای رویدادهایی که با «پروتکل اندازه‌گیری» ارسال می‌کنید ندارید، اما می‌خواهید این رویدادها با «شناسه کاربر» منسوب شوند اگر کاربر درطول جلسه به‌صورت آنلاین به سیستم وارد شود.
در این سناریو، از رویدادهای آنلاین برای ارائه رویدادهای Measurement Protocol با «شناسه کاربر» استفاده می‌کنید.
در اینجا الزامات افزودن «شناسه کاربر» به رویداد آمده است:
-
session_idرا در فهرست پارامتر رویداد بگنجانید. - رویدادهای Measurement Protocol را در همان روز کاری که جلسه آنلاین برگزار می‌شود ارسال کنید.
- اگر
timestamp_microsرا ملغی می‌کنید، آن را روی مُهر زمانی بین زمان شروع و پایان جلسه آنلاین تنظیم کنید. - اگر هدف شما ارائه «شناسه کاربر» برای رویدادهای آنلاین است،
user_idرا در درخواست تنظیم کنید. - اگر هدف شما این است که هر رویداد Measurement Protocol دارای User-ID
از جلسه آنلاین مربوطه باشد، نیازی نیست
user_idرا تنظیم کنید.
ارجاع جلسه
رویدادهای «پروتکل اندازه‌گیری» که الزامات خاصی را برآورده می‌کنند در گزارش‌ها با همان مشخصه‌های جلسه (مثل اطلاعات جغرافیایی، منبع، رسانه، و پویش) به‌عنوان رویدادهای آنلاین از همان جلسه نشان داده می‌شوند.
در اینجا الزامات اسنادی جلسه آورده شده است:
-
session_idرا در فهرست پارامتر رویداد بگنجانید. درخواست را حداکثر تا ۲۴ ساعت پس‌از شروع جلسه آنلاین ارسال کنید.
برای مثال، اگر جلسه در ساعت ۱۱:۱۵ صبح دوشنبه در منطقه زمانی دارایی‌تان شروع شده است، درخواست را قبل‌از ساعت ۱۱:۱۵ صبح سه‌شنبه ارسال کنید.
اگر
timestamp_microsرا ملغی می‌کنید، آن را روی مُهر زمانی بین زمان شروع و پایان جلسه آنلاین تنظیم کنید.
صادر کردن رویدادها به پلاتفرم‌های تبلیغات
Google Analytics رویدادهایی را که بااستفاده از «پروتکل اندازه‌گیری» ارسال می‌کنید در بروندادهای محصولات تبلیغاتی پیوندشده مثل Google Ads یا «مدیر پویش» ۳۶۰ اضافه می‌کند.
چند سناریو رایج که در آن‌ها این ویژگی مفید است عبارت‌اند از:
- کسب‌وکارتان رویدادهای آفلاینی دارد که می‌خواهید در اسناد استنادی و گزارش‌دهی تبلیغات لحاظ شود.
- رویدادهای دیگری در سیستمی دارید که برای برچسب‌گذاری یا «کیت توسعه نرم‌افزار Firebase» دردسترس نیست، اما همچنان می‌خواهید آن رویدادها را در محصولات پیوندشده بگنجانید.
در اینجا الزامات صادر کردن رویدادها به پلاتفرم‌های تبلیغات آورده شده است:
درخواست را حداکثر تا ۶۳ روز پس‌از جدیدترین رویداد آنلاین ارسال کنید، حتی اگر پنجره اسنادی رویداد کلیدی بیش‌از ۶۳ روز باشد. رویداد باید همچنین در پنجره اسنادی رویداد کلیدی برسد. ببینید چگونه تنظیمات پنجره اسنادی را پیکربندی کنید.
برای مثال، اگر جدیدترین رویداد آنلاین برای
client_idیاapp_instance_idدر ۱ مارس رخ داده است، رویداد Measurement Protocol را حداکثر تا ۳ مه ارسال کنید.اگر
timestamp_microsرا ملغی می‌کنید، آن را روی مُهر زمان در ۷۲ ساعت گذشته تنظیم کنید.
ارسال رویدادها یا دارایی‌های کاربر برای ساختن مخاطب
اگر چند شرط را رعایت کنید، رویدادها و دارایی‌های کاربری که بااستفاده از Measurement Protocol ارسال می‌شوند در ارزیابی شرایط مخاطب گنجانده می‌شوند.
در اینجا الزامات ارسال رویدادها یا دارایی‌های کاربر برای ایجاد مخاطب آورده شده است:
درخواست را حداکثر ۳۰ روز پس‌از جدیدترین رویداد آنلاین برای همان
client_idبه جاری‌سازی وب ارسال کنید.برای مثال، اگر آخرین رویداد آنلاین برای
client_idدر ۱ مارس رخ داده است، رویداد Measurement Protocol را حداکثر تا ۳۱ مارس ارسال کنید.درخواست را حداکثر تا ۴۲ روز پس‌از جدیدترین رویداد آنلاین برای همان
app_instance_idبه «جاری‌سازی برنامه» ارسال کنید.برای مثال، اگر آخرین رویداد آنلاین برای
app_instance_idدر ۱ مارس رخ داده است، رویداد «پروتکل اندازه‌گیری» را حداکثر تا ۱۲ آوریل ارسال کنید.اگر
timestamp_microsرا ملغی می‌کنید، آن را روی مُهر زمان در ۷۲ ساعت گذشته تنظیم کنید.