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

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

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

تفعيل تصدير بيانات "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 من خلال الانتقال إلى إحصاءات Google > لوحة بيانات الأحداث واستخدام الرابط عرض الأحداث الأولية في BigQuery في أسفل الصفحة.

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

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

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

    سيظهر مثال على طلب بحث تم إنشاؤه تلقائيًا.

  4. لعرض أحداث التخصيص والبيانات المرتبطة بها، عدِّل طلب البحث لاختيار أحداث personalization_assignment. سيعرض مثال طلب البحث التالي حدثًا كاملاً لتحديد التخصيص لشريحة تاريخ معيّنة، مع حصر النتائج بـ 10:

    # 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 لـ Firebase" التي يتم تصديرها إلى BigQuery. ستكون مهتمًا في الغالب بـ user_pseudo_id (الذي يمكن استخدامه للتمييز بين المستخدمين المختلفين) والطوابع الزمنية للأحداث وخصائص المستخدمين الأخرى.

يتم تخزين التفاصيل الخاصة بالتخصيص في حقل 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_ID.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10