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