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

يُسجِّل التخصيص في ميزة "الإعداد عن بُعد" personalization_assignment حدث في "إحصاءات Google" عند تخصيص عملية تخصيص لمستخدم، ما يسمح لك استخدام BigQuery لفحص وتحليل أحداث التخصيص والأحداث المرتبطة بها

تصف الأقسام التالية كيفية تفعيل BigQuery Export لأجل أحداث "إحصاءات Google" وكيفية تخزين أحداث التخصيص وتوفير بعض والاستعلامات الأساسية للبدء.

تفعيل ميزة BigQuery Export لخدمة "إحصاءات Google لبرنامج Firebase"

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

أولاً، تأكّد من تصدير بيانات "إحصاءات Google" إلى BigQuery:

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

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

  6. انقر على الربط بأداة BigQuery.

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

لنتمكن بعد ذلك من الوصول إلى أحداث التخصيص في BigQuery وفحصها.

الوصول إلى بيانات التخصيص في "الإعداد عن بُعد" باستخدام BigQuery

لطلب بيانات الإحصاءات الخاصة بتجربة ما:

  1. افتح BigQuery في وحدة تحكُّم Google Cloud يمكنك أيضًا فتح مباشرةً من أحداث "إحصاءات Google" باستخدام رابط عرض الأحداث الأولية في 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. في مؤلف طلب البحث، اختَر Run query (تنفيذ طلب البحث). تظهر النتائج في الأسفل اللوحة.

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

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

يتم تضمين بيانات التخصيص في جداول "إحصاءات Google" في BigQuery وتم تخزينها في حدثَين (personalization_assignment).

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

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

المعلَمة نوع البيانات الوصف
معرّف_التخصيص سلسلة يتم تقديم المعرّف الفريد العام للتخصيص الذي تم تخصيصه. (UUID).
مجموعة سلسلة تشير هذه السمة إلى ما إذا كان المستخدم قد تم إسناده إلى مجموعة التخصيص. (P13N) أو المجموعة المرجعية (BASELINE).
مؤشر_الذراع عدد صحيح يمثل القيمة البديلة المحددة للمستخدم، عدد صحيح بين 0 و4.
مفتاح_الذراع سلسلة يحتوي على اسم المَعلمة المستخدَم في عملية التخصيص.
قيمة_المجموعة سلسلة يحتوي على سلسلة القيمة البديلة التي تم تحديدها من خلال التخصيص.
حدث جلسة تفاعل عدد صحيح يتضمّن عدد الجلسات التي يتفاعل فيها المستخدم. عرض لمحة الجلسات لمزيد من المعلومات.
firebase_event_origin سلسلة تشير إلى أصل الحدث. ستكون هذه الحالة دائمًا fp. لـ personalization_assignment حدث.
firebase_screen_class سلسلة يوفر هذا الحقل اسم فئة الشاشة التي كان المستخدم نشطًا عليها عند حدث تخصيص التخصيص. عرض تلقائيًا الأحداث التي تم جمعها للحصول على مزيد من المعلومات.
firebase_screen_id عدد صحيح يعرض رقم تعريف الشاشة التي كان المستخدم عليها عند التخصيص. حدث التعيين. عرض تلقائيًا الأحداث التي تم جمعها للحصول على مزيد من المعلومات.
first_open_time سلسلة يوفّر الطابع الزمني بالمللي ثانية بالتوقيت العالمي المنسّق من المرة الأولى التي سجَّل فيها المستخدم. فتح التطبيق. عرض تلقائيًا الأحداث التي تم جمعها للحصول على مزيد من المعلومات.
ga_session_id عدد صحيح توفّر رقم تعريف جلسة "إحصاءات Google". عرض لمحة الجلسات لمزيد من المعلومات. يمكنك استخدام هذا لربط حدث واحد (personalization_assignment) مع أحداث أخرى في "إحصاءات Google".
ga_session_number عدد صحيح يتم تقديم رقم جلسة "إحصاءات Google". عرض لمحة الجلسات لمزيد من المعلومات.

أمثلة على طلبات البحث

يمكنك استخدام عبارة 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