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

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

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

تمكين تصدير BigQuery لبرنامج Google Analytics for Firebase

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

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

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

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

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

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

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

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

للاستعلام عن البيانات التحليلية لتجربة ما:

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

  2. حدد مشروع Firebase الخاص بك وقم بتوسيعه، ثم قم بتوسيع إدخال analytics_ ANALYTICS_PROPERTY_ID وانقر فوق events_ .

    Access personalization events in the 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 كما هو موضح في مخطط [GA4] BigQuery Export . ستهتم في الغالب بـ user_pseudo_id i (الذي يمكن استخدامه للتمييز بين المستخدمين المختلفين)، والطوابع الزمنية للأحداث، وخصائص المستخدم الأخرى.

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

معامل نوع البيانات وصف
Personalization_id خيط يوفر المعرف الفريد العالمي (UUID) للتخصيص المعين.
مجموعة خيط يشير إلى ما إذا كان المستخدم قد تم تعيينه لمجموعة التخصيص (P13N) أو المجموعة الأساسية (BASELINE).
Arm_index عدد صحيح يمثل القيمة البديلة المخصصة للمستخدم، وهو عدد صحيح بين 0 و4.
com.arm_key خيط يحتوي على اسم المعلمة المستخدمة بواسطة التخصيص.
قيمة الذراع خيط يحتوي على سلسلة القيمة البديلة المعينة بواسطة التخصيص.
engagement_session_event عدد صحيح يتضمن عدد الجلسات التي يشارك فيها المستخدم. راجع حول الجلسات لمزيد من المعلومات.
firebase_event_origin خيط يشير إلى أصل الحدث. سيكون هذا دائمًا fp لأحداث personalization_assignment .
firebase_screen_class خيط يوفر اسم فئة الشاشة التي كان المستخدم نشطًا عليها عند حدوث مهمة التخصيص. راجع الأحداث المجمعة تلقائيًا لمزيد من المعلومات.
firebase_screen_id عدد صحيح يعرض معرف الشاشة التي كان المستخدم عليها عند حدوث مهمة التخصيص. راجع الأحداث المجمعة تلقائيًا لمزيد من المعلومات.
first_open_time خيط يوفر الطابع الزمني، بالمللي ثانية بالتوقيت العالمي المنسق (UTC)، لأول مرة فتح فيها المستخدم التطبيق. راجع الأحداث المجمعة تلقائيًا لمزيد من المعلومات.
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