پروتکل اندازه‌گیری Google Analytics به شما امکان می‌دهد تا داده‌های آفلاین را به جریان وب یا برنامه خود ارسال کنید، علاوه بر داده‌هایی که قبلاً با برچسب‌گذاری یا Firebase SDK جمع‌آوری می‌کنید.
این راهنما موارد رایج استفاده از پروتکل اندازه‌گیری Google Analytics و الزامات آنها را شرح می‌دهد.
خلاصه الزامات
این جدول یک مرجع سریع از الزامات برای هر مورد استفاده ارائه می دهد. بهترین روش های زیر را در ذهن داشته باشید:
timestamp_microsرویدادها و خصوصیات کاربر به طور پیش‌فرض روی زمان درخواست است. هنگام ارسال یک رویداد یا تغییر ویژگی کاربر که در گذشته رخ داده است، همانطور که در راهنمای رویدادهای ارسال و راهنمای ویژگی های کاربر توضیح داده شده است، مهر زمانی را لغو کنید.برای گزارش‌های بیدرنگ و معیارهای تعامل، پارامتر رویداد
engagement_time_msecرا روی میلی‌ثانیه‌های سپری شده از رویداد قبلی تنظیم کنید.
| مورد استفاده | شناسه جلسه | درخواست زمان مورد نیاز | نیاز timestamp_micros |
|---|---|---|---|
| User-ID را به رویدادها اختصاص دهید | مورد نیاز | <= پایان جلسه در روز کاری شروع | >= شروع جلسه و <= پایان جلسه |
| انتساب جلسه | مورد نیاز | <= شروع جلسه + 24 ساعت | >= شروع جلسه و <= پایان جلسه |
| صادرات رویدادها به سیستم عامل های تبلیغاتی | لازم نیست | <= آخرین جلسه روز کاری + 63 روز | <= زمان درخواست |
| رویدادها یا ویژگی های کاربر را برای ایجاد مخاطب ارسال کنید | لازم نیست | وب: <= آخرین زمان رویداد آنلاین + 30 روز برنامه: <= آخرین زمان رویداد آنلاین + 42 روز | <= زمان درخواست |
User-ID را به رویدادها اختصاص دهید
از پروتکل اندازه گیری برای ارائه رویدادهای آنلاین یا آفلاین با شناسه کاربر استفاده کنید.
در اینجا چند نمونه از موارد استفاده برای افزودن User-ID به یک رویداد آورده شده است:
اندازه‌گیری آنلاین شما فاقد اطلاعات لازم برای جستجوی User-ID برای رویدادهای آنلاین است، اما شما یک خط لوله پردازش رویداد دارید که می‌تواند بین یک جلسه آنلاین و یک User-ID ارتباط برقرار کند.
در این سناریو، شما از پروتکل اندازه گیری برای ارائه رویدادهای آنلاین با User-ID استفاده می کنید.
شما شناسه کاربر رویدادهایی را که با پروتکل اندازه‌گیری ارسال می‌کنید ندارید، اما می‌خواهید در صورتی که کاربر در طول جلسه به صورت آنلاین وارد شده باشد، این رویدادها با شناسه کاربری مرتبط شوند.
در این سناریو، شما از رویدادهای آنلاین برای ارائه رویدادهای پروتکل اندازه گیری با User-ID استفاده می کنید.
در اینجا شرایط لازم برای افزودن User-ID به یک رویداد وجود دارد:
-
session_idدر لیست پارامترهای رویداد قرار دهید. - رویدادهای پروتکل اندازه گیری را در همان روز کاری جلسه آنلاین ارسال کنید.
- اگر
timestamp_microsرا لغو کردید، آن را روی مهر زمانی بین زمان شروع و پایان جلسه آنلاین تنظیم کنید. - اگر هدف شما ارائه User-ID برای رویدادهای آنلاین است،
user_idرا در درخواست تنظیم کنید. - اگر هدف شما این است که هر رویداد پروتکل اندازه‌گیری، User-ID را از جلسه آنلاین مربوطه خود داشته باشد، نیازی به تنظیم
user_idندارید.
انتساب جلسه
رویدادهای پروتکل اندازه‌گیری که الزامات خاصی را برآورده می‌کنند در گزارش‌هایی با ویژگی‌های جلسه مشابه (مانند اطلاعات جغرافیایی، منبع، رسانه و کمپین) مانند رویدادهای آنلاین از همان جلسه ظاهر می‌شوند.
در اینجا شرایط لازم برای انتساب جلسه وجود دارد:
-
session_idدر لیست پارامترهای رویداد قرار دهید. درخواست را حداکثر تا 24 ساعت پس از شروع جلسه آنلاین ارسال کنید.
به عنوان مثال، اگر جلسه در ساعت 11:15 صبح روز دوشنبه در منطقه زمانی ملک شما شروع شده است، درخواست را قبل از ساعت 11:15 صبح روز سه شنبه ارسال کنید.
اگر
timestamp_microsرا لغو کردید، آن را روی مهر زمانی بین زمان شروع و پایان جلسه آنلاین تنظیم کنید.
صادرات رویدادها به سیستم عامل های تبلیغاتی
Google Analytics شامل رویدادهایی است که با استفاده از پروتکل اندازه گیری در صادرات به محصولات تبلیغاتی مرتبط مانند Google Ads یا Campaign Manager 360 ارسال می کنید.
چند سناریو رایج که در آنها مفید است عبارتند از:
- کسب و کار شما رویدادهای آفلاینی دارد که می‌خواهید در اسناد و گزارش‌های تبلیغاتی لحاظ شوند.
- شما رویدادهای دیگری در سیستمی دارید که برای برچسب‌گذاری یا Firebase SDK در دسترس نیست، اما همچنان می‌خواهید آن رویدادها را در محصولات مرتبط قرار دهید.
در اینجا شرایط لازم برای صادرات رویدادها به سیستم عامل های تبلیغاتی وجود دارد:
درخواست را حداکثر تا پایان روز کاری 63 روز پس از آخرین رویداد آنلاین ارسال کنید، حتی اگر پنجره اسناد رویداد کلیدی بیش از 63 روز باشد.
برای مثال، اگر آخرین رویداد آنلاین برای
client_idیاapp_instance_idدر 1 مارس رخ داده است، رویداد Protocol اندازه‌گیری را حداکثر تا پایان روز کاری در 3 مه ارسال کنید.اگر
timestamp_microsرا نادیده بگیرید، آن را روی مهر زمانی کمتر یا مساوی زمان درخواست تنظیم کنید.
رویدادها یا ویژگی های کاربر را برای ایجاد مخاطب ارسال کنید
رویدادها و ویژگی‌های کاربر که با استفاده از پروتکل اندازه‌گیری ارسال می‌شوند، در صورت رعایت چند الزام، در ارزیابی شرایط مخاطب لحاظ می‌شوند.
در اینجا شرایط لازم برای ارسال رویدادها یا ویژگی های کاربر برای ایجاد مخاطب وجود دارد:
درخواست را حداکثر تا پایان روز کاری 30 روز پس از آخرین رویداد آنلاین برای همان
client_idبه یک جریان وب ارسال کنید.به عنوان مثال، اگر آخرین رویداد آنلاین برای
client_idدر 1 مارس رخ داده است، رویداد Protocol اندازه گیری را حداکثر تا پایان روز کاری در 31 مارس ارسال کنید.درخواست را حداکثر تا پایان روز کاری 42 روز پس از آخرین رویداد آنلاین برای همان
app_instance_idبه یک جریان برنامه ارسال کنید.برای مثال، اگر آخرین رویداد آنلاین برای
app_instance_idدر 1 مارس رخ داده است، رویداد پروتکل اندازه‌گیری را حداکثر تا پایان روز کاری در 12 آوریل ارسال کنید.اگر
timestamp_microsرا نادیده بگیرید، آن را روی مهر زمانی کمتر یا مساوی زمان درخواست تنظیم کنید.