فحص بيانات التخصيص باستخدام BigQuery

تسجِّل ميزة Remote Config "التخصيص" حدث personalization_assignment Analytics عند تخصيص تجربة لمستخدم، ما يتيح لك استخدام BigQuery لفحص أحداث التخصيص والأحداث المرتبطة بها وتحليلها.

توضِّح الأقسام التالية كيفية تفعيل ميزة BigQuery Export لأحداث Analytics وكيفية تخزين أحداث التخصيص، وتقدّم بعض طلبات البحث الأساسية لمساعدتك في البدء.

تفعيل ميزة BigQuery Export لخدمة 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 ConfigBigQuery

لطلب بيانات "إحصاءات Google" لتجربة:

  1. افتح BigQuery في الـ Google Cloud كونسول. You can also open BigQuery directly from the Firebase console by navigating to the Analytics > Events dashboard and using the view your raw events in BigQuery link at the bottom of the page.

  2. اختَر مشروعك Firebase ووسِّعه، ثم وسِّع الإدخال analytics_ANALYTICS_PROPERTY_ID وانقر على events_.

    الوصول إلى أحداث التخصيص في Cloud Console

  3. من القائمة المنسدلة طلب البحث ، اختَر في علامة تبويب جديدة.

    يظهر نموذج لطلب بحث تم إنشاؤه تلقائيًا.

  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. في أداة إنشاء طلب البحث، انقر على تنفيذ طلب البحث. تظهر النتائج في الجزء السفلي.

في القسم التالي، سنناقش بالتفصيل البيانات المضمّنة في حدث تخصيص تجربة.

ما هي بيانات التخصيص التي يتم تصديرها إلى BigQuery؟

يتم تضمين بيانات التخصيص في Google Analytics جداول في BigQuery وتخزينها في personalization_assignment أحداث.

تكون الحقول الأساسية المتوفّرة في حدث التخصيص هي نفسها أي Analytics حدث كما هو موضّح في [إحصاءات Google‏ 4] BigQuery مخطط Export. ستكون مهتمًا في الغالب بـ user_pseudo_id(الذي يمكن استخدامه للتمييز بين المستخدمين المختلفين) والطوابع الزمنية للأحداث وخصائص المستخدم الأخرى.

يتم تخزين التفاصيل الخاصة بالتخصيص في حقل event_params وهي موضّحة في الجدول التالي:

المعلَمة نوع البيانات الوصف
personalization_id سلسلة يوفّر المعرّف الفريد عالميًا (UUID) للتخصيص الذي تم تعيينه.
group سلسلة يشير إلى ما إذا تم تعيين المستخدم لمجموعة التخصيص (P13N) أو المجموعة الأساسية (BASELINE).
arm_index عدد صحيح يمثّل القيمة البديلة التي تم تعيينها للمستخدم، وهي عدد صحيح يتراوح بين 0 و4.
arm_key سلسلة يحتوي على اسم المعلَمة التي يستخدمها التخصيص.
arm_value سلسلة يحتوي على سلسلة القيمة البديلة التي تم تعيينها من خلال التخصيص.
engaged_session_event عدد صحيح يتضمّن عدد الجلسات التي يتفاعل فيها المستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن الجلسات.
firebase_event_origin سلسلة يشير إلى مصدر الحدث. سيكون هذا الحقل دائمًا fp لأحداث personalization_assignment
firebase_screen_class سلسلة يوفّر اسم فئة الشاشة التي كان المستخدم نشطًا عليها عند حدوث تخصيص التجربة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الأحداث المجمّعة تلقائيًا.
firebase_screen_id عدد صحيح يعرض رقم تعريف الشاشة التي كان المستخدم عليها عند حدوث تخصيص التجربة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الأحداث المجمّعة تلقائيًا.
first_open_time سلسلة يوفّر الطابع الزمني، بالملّي ثانية حسب التوقيت العالمي المنسَّق، لأول مرة فتح فيها المستخدم التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الأحداث المجمّعة تلقائيًا.
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_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10