Catch up on highlights from Firebase at Google I/O 2023. Learn more

Kiểm tra dữ liệu cá nhân hóa bằng BigQuery

Cá nhân hóa cấu hình từ xa ghi lại sự kiện personalization_assignment Analytics khi hoạt động cá nhân hóa được chỉ định cho người dùng, cho phép bạn sử dụng BigQuery để kiểm tra và phân tích các sự kiện cá nhân hóa cũng như các sự kiện liên quan.

Các phần sau đây mô tả cách bật tính năng xuất BigQuery cho các sự kiện Analytics, cách các sự kiện cá nhân hóa được lưu trữ và cung cấp một số truy vấn cơ bản để giúp bạn bắt đầu.

Bật tính năng xuất BigQuery cho Google Analytics cho Firebase

Nếu đang sử dụng gói Spark, bạn có thể sử dụng hộp cát BigQuery để truy cập BigQuery miễn phí, tuân theo các giới hạn của Hộp cát . Xem Giá và hộp cát BigQuery để biết thêm thông tin.

Trước tiên, hãy đảm bảo rằng bạn đang xuất dữ liệu Analytics của mình sang BigQuery:

  1. Mở tab Tích hợp mà bạn có thể truy cập bằng cách sử dụng > Cài đặt dự án trong bảng điều khiển Firebase .
  2. Nếu bạn đang sử dụng BigQuery với các dịch vụ Firebase khác, hãy nhấp vào Quản lý . Nếu không, hãy nhấp vào Liên kết .
  3. Xem lại Giới thiệu về liên kết Firebase với BigQuery , sau đó nhấp vào Tiếp theo .
  4. Trong phần Định cấu hình tích hợp , bật chuyển đổi Google Analytics .
  5. Chọn một khu vực và chọn xuất cài đặt.

  6. Nhấp vào Liên kết tới BigQuery .

Tùy thuộc vào cách bạn chọn xuất dữ liệu, có thể mất đến một ngày để các bảng có sẵn. Để biết thêm thông tin về cách xuất dữ liệu dự án sang BigQuery, hãy xem Xuất dữ liệu dự án sang BigQuery .

Tiếp theo, hãy truy cập và kiểm tra các sự kiện cá nhân hóa của chúng tôi trong BigQuery.

Truy cập dữ liệu cá nhân hóa Cấu hình từ xa bằng BigQuery

Để truy vấn dữ liệu phân tích cho một thử nghiệm:

  1. Mở BigQuery trong Google Cloud Console . Bạn cũng có thể mở nó trực tiếp từ Sự kiện Analytics bằng cách sử dụng chế độ xem các sự kiện thô của bạn trong liên kết BigQuery ở cuối trang.
  2. Chọn dự án Firebase của bạn và mở rộng dự án đó, sau đó mở rộng mục nhập analytics_ ANALYTICS_PROPERTY_ID và nhấp vào events_ .

    Access personalization events in the Cloud console

  3. Từ trình đơn thả xuống Truy vấn , hãy chọn Trong tab mới .

    Truy vấn ví dụ được tạo tự động sẽ xuất hiện.

  4. Để xem các sự kiện cá nhân hóa và dữ liệu liên quan, hãy cập nhật truy vấn để chọn các sự kiện personalization_assignment . Truy vấn mẫu sau đây sẽ trả về một sự kiện chỉ định cá nhân hóa hoàn chỉnh cho một phân đoạn ngày cụ thể, giới hạn kết quả ở 10:

    # Select all personalization_assignment events
    SELECT *
    FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10
    

    Mẹo: Để tìm kiếm tất cả các bảng sự kiện thay vì bảng được phân đoạn, bạn có thể thay thế ngày của bảng sự kiện bằng dấu hoa thị (ví dụ: PROJECT_NAME .analytics_ ANALYTICS_PROPERTY_ID .events_* ). Điều này không được khuyến nghị trong các tình huống không thử nghiệm hoặc đối với các tập dữ liệu lớn.

  5. Trong trình soạn thảo truy vấn, chọn Chạy truy vấn. Kết quả xuất hiện ở khung bên dưới.

Trong phần tiếp theo, chúng ta sẽ thảo luận chi tiết hơn về những gì có trong một sự kiện chuyển nhượng cá nhân hóa.

Dữ liệu cá nhân hóa nào được xuất sang BigQuery?

Dữ liệu cá nhân hóa được bao gồm trong các bảng Google Analytics trong BigQuery và được lưu trữ trong các sự kiện personalization_assignment .

Các trường cơ bản được cung cấp trong một sự kiện cá nhân hóa giống với mọi sự kiện Analytics như được mô tả trong [GA4] giản đồ BigQuery Export . Bạn sẽ quan tâm chủ yếu đến user_pseudo_id i (có thể được sử dụng để phân biệt những người dùng khác nhau), dấu thời gian của sự kiện và các thuộc tính người dùng khác.

Các chi tiết dành riêng cho hoạt động cá nhân hóa được lưu trữ trong trường event_params và được mô tả trong bảng sau:

Tham số Loại dữ liệu Sự miêu tả
cá nhân hóa_id SỢI DÂY Cung cấp mã định danh duy nhất toàn cầu (UUID) của hoạt động cá nhân hóa được chỉ định.
nhóm SỢI DÂY Cho biết người dùng được chỉ định vào nhóm cá nhân hóa (P13N) hay nhóm cơ sở (BASELINE).
arm_index số nguyên Biểu thị giá trị thay thế được gán cho người dùng, một số nguyên từ 0 đến 4.
arm_key SỢI DÂY Chứa tên tham số được cá nhân hóa sử dụng.
arm_value SỢI DÂY Chứa chuỗi giá trị thay thế được chỉ định bởi cá nhân hóa.
đính hôn_session_event số nguyên Bao gồm số phiên mà người dùng tham gia. Xem Giới thiệu về phiên để biết thêm thông tin.
firebase_event_origin SỢI DÂY Cho biết nguồn gốc của sự kiện. Đây sẽ luôn là fp cho các sự kiện personalization_assignment .
firebase_screen_class SỢI DÂY Cung cấp tên lớp của màn hình mà người dùng đang hoạt động khi quá trình gán cá nhân hóa diễn ra. Xem Sự kiện được thu thập tự động để biết thêm thông tin.
firebase_screen_id số nguyên Hiển thị ID của màn hình mà người dùng đã bật khi quá trình chỉ định cá nhân hóa diễn ra. Xem Sự kiện được thu thập tự động để biết thêm thông tin.
first_open_time SỢI DÂY Cung cấp dấu thời gian, tính bằng mili giây UTC, của lần đầu tiên người dùng mở ứng dụng. Xem Sự kiện được thu thập tự động để biết thêm thông tin.
ga_session_id số nguyên Cung cấp ID phiên Google Analytics. Xem Giới thiệu về phiên để biết thêm thông tin. Bạn có thể sử dụng điều này để tương quan sự kiện personalization_assignment với các sự kiện Analytics khác.
ga_session_number số nguyên Cung cấp số phiên Google Analytics. Xem Giới thiệu về phiên để biết thêm thông tin.

truy vấn ví dụ

Bạn có thể sử dụng câu lệnh SQL như sau để trích xuất các tham số dành riêng cho hoạt động cá nhân hóa từ các sự kiện 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