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

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

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

تفعيل تصدير BigQuery لـ Google Analytics في Firebase

إذا كنت مشتركًا في خطة Spark، يمكنك استخدام وضع الحماية في BigQuery للوصول إلى BigQuery بدون أي تكلفة، مع مراعاة حدود وضع الحماية. اطّلِع على مزيد من المعلومات في مقالة الأسعار ووضع الحماية في BigQuery.

أولاً، تأكَّد من تصدير بيانات Analytics إلى BigQuery:

  1. افتح علامة التبويب عمليات الدمج، التي يمكنك الوصول إليها باستخدام > إعدادات المشروع في وحدة تحكّم Firebase.
  2. إذا كنت تستخدم BigQuery مع خدمات Firebase أخرى، انقر على إدارة. بخلاف ذلك، انقر على ربط.
  3. راجِع لمحة عن ربط Firebase بخدمة BigQuery، ثم انقر على التالي.
  4. في قسم Configure integration (ضبط عملية الدمج)، فعِّل زر التبديل Google Analytics.

  5. اختَر منطقة واختَر إعدادات التصدير.

  6. انقر على ربط بـ BigQuery.

استنادًا إلى الطريقة التي اخترت بها تصدير البيانات، قد يستغرق الأمر ما يصل إلى يوم واحد لتصبح الجدولَين متاحة. لمزيد من المعلومات عن تصدير بيانات المشروع إلى BigQuery، اطّلِع على مقالة تصدير بيانات المشروع إلى BigQuery.

بعد ذلك، لنطّلِع على أحداث التخصيص ونفحصها في BigQuery.

الوصول إلى بيانات تخصيص Remote Config باستخدام BigQuery

لإجراء طلب بحث في بيانات الإحصاءات لتجربة:

  1. افتح BigQuery في وحدة تحكّم Google Cloud. يمكنك أيضًا فتحه مباشرةً من Analytics الأحداث باستخدام رابط عرض الأحداث الأوّلية في BigQuery في أسفل الصفحة.

  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 مخطّط التصدير. ستهتم في الغالب بـ user_pseudo_id i(التي يمكن استخدامها لتمييز المستخدِمين المختلفين) والطابع الزمني للأحداث وخصائص المستخدِمين الأخرى.

يتم تخزين التفاصيل المتعلّقة بالتخصيص في حقل event_params ويتم описанها في الجدول التالي:

المعلَمة نوع البيانات الوصف
personalization_id سلسلة يوفّر المعرّف الفريد عالميًا (UUID) للإعدادات المخصّصة المخصّصة.
مجموعة سلسلة تشير إلى ما إذا تم تعيين المستخدِم إلى مجموعة التخصيص (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