داده های شخصی سازی را با BigQuery بررسی کنید

شخصی‌سازی Remote Config یک رویداد Analytics personalization_assignment را هنگامی که شخصی‌سازی به کاربر اختصاص داده می‌شود، ثبت می‌کند و به شما امکان می‌دهد از BigQuery برای بررسی و تجزیه و تحلیل رویدادهای شخصی‌سازی و رویدادهای مرتبط استفاده کنید.

نکته: همچنین می‌توانید رویدادهای personalization_assignment را در صفحه رویدادهای Firebase Analytics مشاهده کنید و نمودار دقیق نتایج را در صفحه نتایج شخصی‌سازی Remote Config مشاهده کنید.

بخش‌های زیر نحوه فعال کردن صادرات BigQuery برای رویدادهای Analytics ، نحوه ذخیره‌سازی رویدادهای شخصی‌سازی، و ارائه برخی پرس‌و‌جوهای اساسی برای شروع کار را شرح می‌دهند.

صادرات BigQuery برای Google Analytics برای Firebase فعال کنید

اگر از طرح Spark استفاده می‌کنید، می‌توانید از جعبه ایمنی BigQuery برای دسترسی به BigQuery بدون هزینه، مشروط به محدودیت‌های Sandbox استفاده کنید. برای اطلاعات بیشتر به قیمت و جعبه ایمنی BigQuery مراجعه کنید.

ابتدا مطمئن شوید که داده های Analytics خود را به BigQuery صادر می کنید:

1. برگه Integrations را باز کنید، که می توانید با استفاده > تنظیمات پروژه در کنسول Firebase به آن دسترسی داشته باشید.
2. اگر قبلاً از BigQuery با سایر سرویس‌های Firebase استفاده می‌کنید، روی Manage کلیک کنید. در غیر این صورت، روی پیوند کلیک کنید.
3. درباره پیوند Firebase به BigQuery را مرور کنید، سپس روی Next کلیک کنید.
4. در قسمت Configure integration ، ضامن Google Analytics فعال کنید.

5. یک منطقه را انتخاب کنید و تنظیمات صادرات را انتخاب کنید.

   توجه: برای اطلاعات بیشتر در مورد تنظیمات Google Analytics برای Firebase ، به مجموعه داده ها مراجعه کنید.

6. روی پیوند به BigQuery کلیک کنید.

بسته به نحوه صادرات داده‌ها، ممکن است تا یک روز طول بکشد تا جداول در دسترس قرار گیرند. برای اطلاعات بیشتر درباره صادرات داده های پروژه به BigQuery ، به صادرات داده های پروژه به BigQuery مراجعه کنید.

در مرحله بعد، بیایید به رویدادهای شخصی‌سازی خود در BigQuery دسترسی پیدا کرده و آنها را بررسی کنیم.

با استفاده از BigQuery به داده‌های شخصی‌سازی Remote Config دسترسی پیدا کنید

برای پرس و جو از داده های تجزیه و تحلیل برای یک آزمایش:

1. BigQuery در کنسول Google Cloud باز کنید. همچنین می‌توانید آن را مستقیماً از رویدادهای Analytics با استفاده از مشاهده رویدادهای خام خود در پیوند BigQuery در پایین صفحه باز کنید.

2. پروژه Firebase خود را انتخاب کنید و آن را گسترش دهید، سپس ورودی analytics_ ANALYTICS_PROPERTY_ID را گسترش دهید و روی events_ کلیک کنید.

   

3. از منوی کشویی Query ، در یک برگه جدید را انتخاب کنید.

   یک پرس و جو نمونه تولید شده به صورت خودکار ظاهر می شود.

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

   # Select all personalization_assignment events
   SELECT *
   FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
   WHERE event_name = 'personalization_assignment'
   LIMIT 10
   

   نکته: برای جستجوی همه جداول رویداد به جای جدول خرد شده، می‌توانید تاریخ جدول رویدادها را با یک ستاره جایگزین کنید (برای مثال PROJECT_NAME .analytics_ ANALYTICS_PROPERTY_ID .events_* ). این در سناریوهای غیر آزمایشی یا برای مجموعه داده های بزرگ توصیه نمی شود.

5. در query composer، Run query را انتخاب کنید. نتایج در قسمت پایین ظاهر می شود.

توجه: اگر داده‌های Analytics پخش جریانی نمی‌کنید، داده‌های Firebase در BigQuery فقط یک بار در روز به‌روزرسانی می‌شوند. بنابراین، داده‌های موجود در صفحه آزمایش ممکن است به‌روزتر از داده‌های موجود در کنسول BigQuery باشد.

در بخش بعدی، ما با جزئیات بیشتری درباره مواردی که در یک رویداد اختصاصی شخصی سازی گنجانده شده است صحبت خواهیم کرد.

چه داده های شخصی سازی به BigQuery صادر می شود؟

داده های شخصی سازی در جداول Google Analytics در BigQuery گنجانده شده و در رویدادهای personalization_assignment ذخیره می شود.

فیلدهای اساسی ارائه شده در رویداد شخصی‌سازی مانند هر رویداد Analytics است که در [GA4] BigQuery Export schema توضیح داده شده است. شما بیشتر نگران user_pseudo_id i (که می‌تواند برای متمایز کردن کاربران متمایز استفاده شود)، مهرهای زمانی رویداد و سایر ویژگی‌های کاربر خواهید بود.

جزئیات شخصی سازی خاص در قسمت event_params ذخیره می شود و در جدول زیر توضیح داده شده است:

پارامتر	نوع داده	توضیحات
personalization_id	STRING	شناسه منحصر به فرد جهانی (UUID) شخصی سازی اختصاص داده شده را ارائه می دهد.
گروه	STRING	نشان می دهد که آیا کاربر به گروه شخصی سازی (P13N) یا گروه پایه (BASELINE) اختصاص داده شده است.
arm_index	عدد صحیح	نشان دهنده مقدار جایگزین اختصاص داده شده به کاربر، یک عدد صحیح بین 0 و 4 است.
کلید_بازو	STRING	شامل نام پارامتر استفاده شده توسط شخصی سازی است.
arm_value	STRING	شامل رشته مقدار جایگزین است که توسط شخصی سازی اختصاص داده شده است.
engaged_session_event	عدد صحیح	شامل تعداد جلساتی است که کاربر در آن درگیر است. برای اطلاعات بیشتر درباره جلسات را ببینید.
firebase_event_origin	STRING	مبدأ واقعه را نشان می دهد. این همیشه برای رویدادهای personalization_assignment fp خواهد بود.
firebase_screen_class	STRING	نام کلاس صفحه‌ای را ارائه می‌کند که کاربر هنگام انجام تخصیص شخصی‌سازی در آن فعال بوده است. برای اطلاعات بیشتر به رویدادهای جمع آوری خودکار مراجعه کنید.
firebase_screen_id	عدد صحیح	شناسه صفحه‌ای را که کاربر در هنگام انجام تخصیص شخصی‌سازی روی آن قرار داشت را نشان می‌دهد. برای اطلاعات بیشتر به رویدادهای جمع آوری خودکار مراجعه کنید.
first_open_time	STRING	مُهر زمانی اولین باری که کاربر برنامه را باز می‌کند، در UTC میلی‌ثانیه ارائه می‌کند. برای اطلاعات بیشتر به رویدادهای جمع آوری خودکار مراجعه کنید.
ga_session_id	عدد صحیح	شناسه جلسه Google Analytics را ارائه می دهد. برای اطلاعات بیشتر درباره جلسات را ببینید. می توانید از این برای مرتبط کردن رویداد personalization_assignment با سایر رویدادهای Analytics استفاده کنید.
ga_session_number	عدد صحیح	شماره جلسه Google Analytics را ارائه می دهد. برای اطلاعات بیشتر درباره جلسات را ببینید.

پرس و جوهای نمونه

برای استخراج پارامترهای شخصی سازی خاص از رویدادهای personalization_assignment می توانید از یک عبارت SQL مانند زیر استفاده کنید:

    # Expand nested personalization parameters
    SELECT
     timestamp_micros(event_timestamp) AS event_time,
     user_pseudo_id,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'group'
     ) AS personalization_group,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'personalization_id'
     ) AS personalization_id,
     (
       SELECT event_params.value.string_value,
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_key'
     ) AS arm_key,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_value'
     ) AS arm_value,
     (
       SELECT event_params.value.int_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'ga_session_id'
     ) AS ga_session_id,
    FROM `PROJECT_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10