موارد استفاده از Measurement Protocol

«پروتکل اندازه‌گیری Google Analytics» به شما امکان می‌دهد داده‌های آفلاین را به جاری‌سازی «وب» یا «برنامه» خود ارسال کنید، علاوه‌بر داده‌هایی که قبلاً با برچسب‌گذاری یا کیت توسعه نرم‌افزار Firebase جمع‌آوری کرده‌اید.

این راهنما موارد استفاده رایج «پروتکل اندازه‌گیری Google Analytics» و الزامات آن‌ها را شرح می‌دهد.

خلاصه الزامات

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

  1. timestamp_micros رویدادها و مشخصه‌های کاربر به‌طور پیش‌فرض روی زمان درخواست تنظیم شده است. هنگام ارسال رویداد یا تغییر مشخصه کاربر که در گذشته رخ داده است، مهر زمان را طبق آنچه در راهنمای ارسال رویدادها و راهنمای مشخصه‌های کاربر توضیح داده شده است لغو کنید.

  2. برای گزارش‌های «بلادرنگ» و سنجه‌های تعامل دقیق، پارامتر رویداد engagement_time_msec را که روی میلی‌ثانیه‌های سپری‌شده از رویداد قبلی تنظیم شده است اضافه کنید.

کاربرد شناسه جلسه درخواست زمان موردنیاز شرط timestamp_micros
اختصاص دادن شناسه کاربر به رویدادها الزامی <= پایان روز کاری شروع جلسه >= شروع جلسه و <= پایان جلسه
ارجاع جلسه الزامی <= شروع جلسه + ۲۴ ساعت >= شروع جلسه و <= پایان جلسه
صادر کردن رویدادها به پلاتفرم‌های تبلیغات الزامی نیست <= روز آخرین جلسه + ۶۳ روز >= زمان درخواست منهای ۷۲ ساعت و <= زمان درخواست
ارسال رویدادها یا ویژگی‌های کاربر برای ایجاد مخاطب الزامی نیست وب: <= آخرین زمان رویداد آنلاین + ۳۰ روز
برنامه: <= آخرین زمان رویداد آنلاین + ۴۲ روز
>= زمان درخواست منهای ۷۲ ساعت و <= زمان درخواست

اختصاص دادن شناسه کاربر به رویدادها

از Measurement Protocol برای ارائه رویدادهای آنلاین یا آفلاین با شناسه کاربر استفاده کنید.

در اینجا چند نمونه مورد استفاده برای افزودن «شناسه کاربر» به رویداد آورده شده است:

  1. سنجش آنلاین شما فاقد اطلاعات لازم برای جستجوی «شناسه کاربر» برای رویدادهای آنلاین است، اما شما یک خط لوله پردازش رویداد دارید که می‌تواند ارتباط بین یک جلسه آنلاین و یک «شناسه کاربر» را برقرار کند.

    در این سناریو، شما از Measurement Protocol برای ارائه رویدادهای آنلاین با شناسه کاربر استفاده می‌کنید.

  2. «شناسه کاربر» را برای رویدادهایی که با Measurement Protocol ارسال می‌کنید ندارید، اما می‌خواهید آن رویدادها با «شناسه کاربر» مرتبط شوند، درصورتی‌که کاربر درطول جلسه به‌صورت آنلاین به سیستم وارد شده باشد.

    در این سناریو، شما از رویدادهای آنلاین برای ارائه رویدادهای Measurement Protocol با شناسه کاربر استفاده می‌کنید.

شرایط لازم برای افزودن «شناسه کاربر» به رویداد در اینجا آمده است:

  • session_id را در فهرست پارامترهای رویداد اضافه کنید.
  • رویدادهای Measurement Protocol را در همان روز کاری جلسه آنلاین ارسال کنید.
  • اگر timestamp_micros را لغو می‌کنید، آن را روی مُهر زمانی بین زمان شروع و پایان جلسه آنلاین تنظیم کنید.
  • اگر هدفتان ارائه شناسه کاربر برای رویدادهای آنلاین است، user_id را در درخواست تنظیم کنید.
  • اگر هدفتان این است که هر رویداد Measurement Protocol دارای User-ID از جلسه آنلاین مربوطه باشد، نیازی به تنظیم user_id ندارید.

ارجاع جلسه

رویدادهای Measurement Protocol که الزامات خاصی را برآورده می‌کنند، در گزارش‌ها با همان مشخصه‌های جلسه (مانند اطلاعات جغرافیایی، منبع، رسانه، و پویش) به‌عنوان رویدادهای آنلاین از همان جلسه ظاهر می‌شوند.

الزامات ارجاع جلسه در اینجا آمده است:

  • session_id را در فهرست پارامترهای رویداد اضافه کنید.
  • درخواست را حداکثر ۲۴ ساعت پس‌از شروع جلسه آنلاین ارسال کنید.

    برای مثال، اگر جلسه در ساعت ۱۱:۱۵ صبح دوشنبه در منطقه زمانی دارایی‌تان شروع شده است، درخواست را قبل‌از ساعت ۱۱:۱۵ صبح سه‌شنبه ارسال کنید.

  • اگر timestamp_micros را لغو می‌کنید، آن را روی مُهر زمانی بین زمان شروع و پایان جلسه آنلاین تنظیم کنید.

صادر کردن رویدادها به پلاتفرم‌های تبلیغات

Google Analytics رویدادهایی را که بااستفاده از Measurement Protocol ارسال می‌کنید در برون‌بردها به محصولات تبلیغاتی پیوندشده مانند Google Ads یا Campaign Manager 360 لحاظ می‌کند.

چند سناریو رایج که در آن‌ها این کار مفید است عبارتند از:

  • کسب‌وکارتان رویدادهای آفلاینی دارد که می‌خواهید در اسناد و گزارش‌دهی تبلیغات گنجانده شود.
  • رویدادهای دیگری در سیستمی دارید که برای برچسب‌گذاری یا کیت توسعه نرم‌افزار Firebase دردسترس نیست، اما همچنان می‌خواهید آن رویدادها را در محصولات پیوندشده بگنجانید.

الزامات صادر کردن رویدادها به پلاتفرم‌های تبلیغاتی در اینجا آمده است:

  • درخواست را حداکثر ۶۳ روز پس‌از آخرین رویداد آنلاین ارسال کنید، حتی اگر پنجره ثبت خرید رویداد کلیدی بیشتر از ۶۳ روز باشد. رویداد باید در پنجره ثبت خرید رویداد کلیدی نیز وارد شود. با نحوه پیکربندی تنظیمات پنجره ثبت خرید آشنا شوید.

    برای مثال، اگر آخرین رویداد آنلاین برای client_id یا app_instance_id در ۱ مارس اتفاق افتاده است، رویداد Measurement Protocol را حداکثر تا ۳ مه ارسال کنید.

  • اگر timestamp_micros را لغو می‌کنید، آن را روی مُهر زمانی در ۷۲ ساعت گذشته تنظیم کنید.

ارسال رویدادها یا ویژگی‌های کاربر برای ایجاد مخاطب

رویدادها و ویژگی‌های کاربر ارسال‌شده بااستفاده از Measurement Protocol در ارزیابی شرایط مخاطب گنجانده می‌شوند اگر چند شرط را رعایت کنید.

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

  • درخواست را حداکثر ۳۰ روز پس‌از آخرین رویداد آنلاین برای همان client_id به جاری‌سازی وب ارسال کنید.

    برای مثال، اگر آخرین رویداد آنلاین برای client_id در ۱ مارس رخ داده باشد، رویداد Measurement Protocol را حداکثر تا ۳۱ مارس ارسال کنید.

  • درخواست را حداکثر ۴۲ روز پس‌از آخرین رویداد آنلاین برای همان app_instance_id به «جاری‌سازی برنامه» ارسال کنید.

    برای مثال، اگر آخرین رویداد آنلاین برای app_instance_id در ۱ مارس رخ داده است، رویداد Measurement Protocol را حداکثر تا ۱۲ آوریل ارسال کنید.

  • اگر timestamp_micros را لغو می‌کنید، آن را روی مُهر زمانی در ۷۲ ساعت گذشته تنظیم کنید.