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

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

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

فعال کردن برون‌برد BigQuery برای Google Analytics برای Firebase

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

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

  1. در کنسول Firebase، به تنظیمات > ادغام‌ها بروید.

  2. در کارت BigQuery، روی پیوند کلیک کنید. یا اگر ازقبل از BigQuery با سرویس‌های دیگر Firebase استفاده می‌کنید، روی مدیریت کلیک کنید.

  3. درباره پیوند دادن Firebase به BigQuery را مرور کنید، سپس روی بعدی کلیک کنید.

  4. در بخش پیکربندی ادغام، کلید Google Analytics را فعال کنید.

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

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

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

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

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

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

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

  2. پروژه Firebase را انتخاب کنید و آن را ازهم باز کنید، سپس ورودی analytics_ANALYTICS_PROPERTY_ID را ازهم باز کنید و روی events_ کلیک کنید.

    دسترسی به رویدادهای شخصی‌سازی در کنسول Cloud

  3. از منو کرکره‌ای پرس‌وجو، در برگه جدید را انتخاب کنید.

    یک پُرسمان نمونه به‌طور خودکار تولید می‌شود.

  4. برای مشاهده رویدادهای شخصی‌سازی و داده‌های مرتبط، پُرسمان را به‌روز کنید تا رویدادهای personalization_assignment را انتخاب کنید. پرس‌وجوی نمونه زیر یک رویداد کامل واگذاری شخصی‌سازی را برای یک بخش تاریخ خاص برمی‌گرداند و نتایج را به ۱۰ محدود می‌کند:

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

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

  5. در سازنده پُرسمان، اجرای پُرسمان را انتخاب کنید. نتایج در قاب پایینی نشان داده می‌شود.

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

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

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

فیلدهای اصلی ارائه‌شده در رویداد شخصی‌سازی همانند هر رویداد Analytics دیگری است که در داده‌های «Google Analytics برای Firebase» که به BigQuery صادر می‌شود شرح داده شده است. بیشتر با user_pseudo_id (که می‌تواند برای متمایز کردن کاربران مختلف استفاده شود)، مُهرهای زمان رویداد، و دیگر ویژگی‌های کاربر سروکار خواهید داشت.

جزئیات مربوط به شخصی‌سازی در فیلد event_params ذخیره می‌شود و در جدول زیر شرح داده شده است:

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

نمونه پُرسمان‌ها

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

    # 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_ID.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10