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

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

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

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

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

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

  1. تب Integrations را باز کنید، که می‌توانید با استفاده از > Project settings در کنسول Firebase به آن دسترسی پیدا کنید.
  2. اگر از قبل از BigQuery با سایر سرویس‌های Firebase استفاده می‌کنید، روی Manage کلیک کنید. در غیر این صورت، روی Link کلیک کنید.
  3. درباره اتصال Firebase به BigQuery نظر بدهید، سپس روی Next کلیک کنید.
  4. در بخش پیکربندی ادغام ، گزینه‌ی Google Analytics را فعال کنید.
  5. یک منطقه را انتخاب کنید و تنظیمات صادرات را انتخاب کنید.

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

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

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

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

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

  1. BigQuery در کنسول Google Cloud باز کنید. همچنین می‌توانید آن را مستقیماً از Analytics Events با استفاده از لینک view your raw events in BigQuery در پایین صفحه باز کنید.
  2. پروژه Firebase خود را انتخاب کرده و آن را باز کنید، سپس ورودی analytics_ ANALYTICS_PROPERTY_ID را باز کرده و روی events_ کلیک کنید.

    Access personalization events in the Cloud console

  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 را انتخاب کنید. نتایج در پنل پایین نمایش داده می‌شوند.

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

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

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

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

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

پارامتر نوع داده توضیحات
شخصی‌سازی_id رشته شناسه منحصر به فرد جهانی (UUID) مربوط به شخصی‌سازی اختصاص داده شده را ارائه می‌دهد.
گروه رشته نشان می‌دهد که آیا کاربر به گروه شخصی‌سازی (P13N) یا گروه پایه (BASELINE) اختصاص داده شده است.
arm_index عدد صحیح مقدار جایگزین اختصاص داده شده به کاربر را نشان می‌دهد، یک عدد صحیح بین ۰ تا ۴.
کلید_بازو رشته شامل نام پارامتر مورد استفاده توسط شخصی‌سازی است.
مقدار_بازو رشته شامل رشته‌ی مقدار جایگزین اختصاص داده شده توسط شخصی‌سازی است.
رویداد_جلسه_مشغول عدد صحیح شامل تعداد جلساتی است که کاربر در آن مشغول است. برای اطلاعات بیشتر به «درباره جلسات» مراجعه کنید.
firebase_event_origin رشته مبدأ رویداد را نشان می‌دهد. این مقدار برای رویدادهای personalization_assignment همیشه fp خواهد بود.
کلاس firebase_screen رشته نام کلاس صفحه‌ای را که کاربر هنگام انجام وظیفه شخصی‌سازی در آن فعال بوده است، ارائه می‌دهد. برای اطلاعات بیشتر به بخش رویدادهای جمع‌آوری‌شده خودکار مراجعه کنید.
firebase_screen_id عدد صحیح شناسه صفحه‌ای را که کاربر هنگام انجام وظیفه شخصی‌سازی در آن بوده است، نمایش می‌دهد. برای اطلاعات بیشتر به بخش «رویدادهای جمع‌آوری‌شده خودکار» مراجعه کنید.
اولین_زمان_باز شدن رشته مهر زمانی (برحسب میلی‌ثانیه UTC) اولین باری که کاربر برنامه را باز کرده است را ارائه می‌دهد. برای اطلاعات بیشتر به بخش «رویدادهای جمع‌آوری‌شده خودکار» مراجعه کنید.
شناسه_جلسه_ga عدد صحیح شناسه جلسه Google Analytics را ارائه می‌دهد. برای اطلاعات بیشتر به «درباره جلسات» مراجعه کنید. می‌توانید از این برای مرتبط کردن رویداد personalization_assignment با سایر رویدادهای Analytics استفاده کنید.
شماره_جلسه_ga عدد صحیح شماره جلسه 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_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10