Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

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

بخش‌های زیر نحوه فعال کردن صادرات 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. یک منطقه را انتخاب کنید و تنظیمات صادرات را انتخاب کنید.

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

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

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

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

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

  1. BigQuery را در Google Cloud Console باز کنید. همچنین می‌توانید آن را مستقیماً از رویدادهای Analytics با استفاده از مشاهده رویدادهای خام خود در پیوند 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 ذخیره می شود و در جدول زیر توضیح داده شده است:

پارامتر نوع داده شرح
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