فحص بيانات التخصيص باستخدام 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، كما يتم حفظها كما هو موضح في الجدول التالي:

المعلَمة نوع البيانات الوصف
معرّف_التخصيص سلسلة يتم تقديم المعرّف الفريد العام للتخصيص الذي تم تعيينه. (UUID).
مجموعة سلسلة تشير هذه السمة إلى ما إذا كان المستخدم قد تم إسناده إلى مجموعة التخصيص. (P13N) أو المجموعة المرجعية (BASELINE).
arm_index عدد صحيح يمثّل القيمة البديلة التي تمّ تعيينها للمستخدم، وهي عدد صحيح يتراوح بين 0 و4.
arm_key سلسلة يحتوي على اسم المَعلمة المستخدَمة في التخصيص.
قيمة_المجموعة سلسلة يحتوي على سلسلة القيمة البديلة التي تم تحديدها من خلال التخصيص.
حدث جلسة تفاعُل عدد صحيح يتضمّن عدد الجلسات التي يتفاعل فيها المستخدِم. عرض لمحة الجلسات للحصول على مزيد من المعلومات.
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