Bài viết này giải thích định dạng và giản đồ của dữ liệu tài sản Google Analytics 4 cũng như dữ liệu Google Analytics cho Firebase được xuất sang BigQuery.
Tập dữ liệu
Đối với mỗi tài sản Google Analytics 4 và mỗi dự án Firebase liên kết với BigQuery, hệ thống sẽ thêm một tập dữ liệu “analytics_<property_id>” vào dự án BigQuery của bạn. Mã tài sản là mã tài sản Analytics, có trong mục cài đặt tài sản cho tài sản Google Analytics 4 và trong mục Cài đặt phân tích ứng dụng trong Firebase. Mỗi tài sản Google Analytics 4 và mỗi ứng dụng đã bật tính năng xuất BigQuery sẽ xuất dữ liệu của mình sang tập dữ liệu đó.
Bảng
Trong mỗi tập dữ liệu, bảng được nhập cho mỗi ngày xuất. Các bảng này có định dạng “events_YYYYMMDD”.
Ngoài ra, một bảng khác được nhập cho các sự kiện trong ứng dụng đã nhận được trong suốt ngày hiện tại. Bảng này có tên là “events_intraday_YYYYMMDD” và bảng sẽ nhập dữ liệu theo thời gian thực khi các sự kiện được thu thập.
Nếu bạn đang sử dụng hộp cát BigQuery, thì hệ thống sẽ không nhập sự kiện trong ngày và áp dụng giới hạn bổ sung.
Nâng cấp từ hộp cát nếu bạn muốn nhập trong ngày.
Hàng
Mỗi hàng trong một bảng tương ứng với một sự kiện do SDK Analytics tải lên.
Cột
Dưới đây là danh sách liệt kê các cột bên trong dữ liệu xuất ra.
Tên trường | Loại dữ liệu | Nội dung mô tả |
|---|---|---|
Ứng dụng |
|
|
app_info | RECORD | Bản ghi thông tin về ứng dụng. |
app_info.id | STRING | Tên gói hoặc mã nhận dạng gói của ứng dụng. |
app_info.firebase_app_id | STRING | Mã ứng dụng Firebase được liên kết với ứng dụng |
app_info.install_source | STRING | Cửa hàng đã cài đặt ứng dụng. |
app_info.version | STRING | versionName của ứng dụng (Android) hoặc phiên bản gói dạng ngắn. |
Thiết bị |
|
|
device | RECORD | Bản ghi thông tin thiết bị. |
device.category | STRING | Loại thiết bị (điện thoại di động, máy tính bảng, máy tính). |
device.mobile_brand_name | STRING | Tên thương hiệu của thiết bị. |
device.mobile_model_name | STRING | Tên mẫu thiết bị. |
device.mobile_marketing_name | STRING | Tên tiếp thị của thiết bị. |
device.mobile_os_hardware_model | STRING | Thông tin về mẫu thiết bị được truy xuất trực tiếp từ hệ điều hành. |
device.operating_system | STRING | Hệ điều hành của thiết bị. |
device.operating_system_version | STRING | Phiên bản hệ điều hành. |
device.vendor_id | STRING | IDFV (chỉ có khi IDFA không được thu thập). |
device.advertising_id | STRING | Mã nhận dạng cho quảng cáo/IDFA. |
device.language | STRING | Ngôn ngữ hệ điều hành. |
device.time_zone_offset_seconds | INTEGER | Thời gian chênh lệch so với giờ GMT tính bằng giây. |
device.is_limited_ad_tracking | BOOLEAN | Chế độ cài đặt Giới hạn theo dõi quảng cáo của thiết bị.Trên iOS 14 trở lên, trả về false nếu IDFA khác 0. |
Luồng và nền tảng |
|
|
stream_id | STRING | Mã dạng số của luồng. |
platform | STRING | Nền tảng tạo ứng dụng. |
Người dùng |
|
|
user_first_touch_timestamp | INTEGER | Thời lượng (tính theo micrô giây) mà người dùng mở ứng dụng hoặc truy cập trang web lần đầu tiên. |
user_id | STRING | Mã nhận dạng người dùng đã đặt thông qua API setUserId. |
user_pseudo_id | STRING | Mã dạng biệt danh (ví dụ: Mã bản sao ứng dụng) cho người dùng. |
user_properties | RECORD | Bản ghi lặp lại về các thuộc tính người dùng đã đặt thông qua API setUserProperty. |
user_properties.key | STRING | Tên của thuộc tính người dùng. |
user_properties.value | RECORD | Bản ghi giá trị thuộc tính người dùng. |
user_properties.value.string_value | STRING | Giá trị kiểu chuỗi của thuộc tính người dùng. |
user_properties.value.int_value | INTEGER | Giá trị kiểu số nguyên của thuộc tính người dùng. |
user_properties.value.double_value | FLOAT | Giá trị gấp đôi của thuộc tính người dùng. |
user_properties.value.float_value | FLOAT | Hiện tại, trường này chưa được sử dụng. |
user_properties.value.set_timestamp_micros | INTEGER | Thời gian gần đây nhất (tính bằng micrô giây) mà thuộc tính người dùng được đặt. |
user_ltv | RECORD | Bản ghi thông tin Giá trị vòng đời của người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
user_ltv.revenue | FLOAT | Giá trị vòng đời (doanh thu) của người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
user_ltv.currency | STRING | Giá trị vòng đời (đơn vị tiền tệ) của người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
Chiến dịch |
| Lưu ý: Mô hình phân bổ traffic_source dựa trên lượt nhấp gần đây nhất trên nhiều kênh. Các giá trị traffic_source không thay đổi nếu người dùng tương tác với các chiến dịch tiếp theo sau khi cài đặt. |
traffic_source | RECORD | Tên của nguồn lưu lượng truy cập đầu tiên thu nạp được người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
traffic_source.name | STRING | Tên của chiến dịch tiếp thị đầu tiên thu nạp được người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
traffic_source.medium | STRING | Tên của phương tiện (lượt tìm kiếm có trả tiền, lượt tìm kiếm không phải trả tiền, email và các phương tiện khác) đầu tiên thu nạp được người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
traffic_source.source | STRING | Tên của mạng đầu tiên thu nạp được người dùng. Ở các bảng trong ngày, trường này không được nhập dữ liệu. |
Địa lý |
|
|
geo | RECORD | Bản ghi thông tin vị trí địa lý của người dùng. |
geo.continent | STRING | Lục địa mà từ đó các sự kiện được báo cáo, dựa trên địa chỉ IP. |
geo.sub_continent | STRING | Tiểu lục địa mà từ đó các sự kiện được báo cáo, dựa trên địa chỉ IP. |
geo.country | STRING | Quốc gia mà từ đó các sự kiện được báo cáo, dựa trên địa chỉ IP. |
geo.region | STRING | Khu vực mà từ đó các sự kiện được báo cáo, dựa trên địa chỉ IP. |
geo.metro | STRING | Thành phố lớn mà từ đó các sự kiện được báo cáo, dựa trên địa chỉ IP. |
geo.city | STRING | Thành phố mà từ đó các sự kiện được báo cáo, dựa trên địa chỉ IP. |
Sự kiện |
|
|
event_date | STRING | Ngày mà sự kiện này được ghi lại (định dạng YYYYMMDD theo múi giờ đã đăng ký của ứng dụng). |
event_timestamp | INTEGER | Thời gian (tính bằng micrô giây, giờ UTC) khi sự kiện được ghi lại trên ứng dụng khách. |
event_previous_timestamp | INTEGER | Thời gian (tính bằng micrô giây, giờ UTC) khi sự kiện được ghi lại trên ứng dụng khách ở lần trước. |
event_name | STRING | Tên của sự kiện. |
event_params | RECORD | Bản ghi lặp lại về các thông số liên quan đến sự kiện này. |
event_params.key | STRING | Khóa của thông số sự kiện. |
event_params.value | RECORD | Bản ghi giá trị của thông số sự kiện. |
event_params.value.string_value | STRING | Giá trị kiểu chuỗi của thông số sự kiện. |
event_params.value.int_value | INTEGER | Giá trị kiểu số nguyên của thông số sự kiện. |
event_params.value.double_value | FLOAT | Giá trị gấp đôi của thông số sự kiện. |
event_params.value.float_value | FLOAT | Giá trị kiểu số thực của thông số sự kiện. Hiện tại, trường này chưa được sử dụng. |
event_value_in_usd | FLOAT | Giá trị quy đổi tiền tệ (bằng USD) của thông số “giá trị” của sự kiện. |
event_bundle_sequence_id | INTEGER | Mã trình tự của nhóm mà các sự kiện này đã được tải lên. |
event_server_timestamp_offset | INTEGER | Chênh lệch dấu thời gian giữa thời gian thu thập và thời gian tải lên (tính theo micrô giây). |
Thương mại điện tử |
|
|
thương mại điện tử | RECORD | Bản ghi thông tin về thương mại điện tử. |
ecommerce.total_item_quantity | INTEGER | Tổng số mặt hàng trong sự kiện này và là tổng của trường items.quantity. |
ecommerce.purchase_revenue_in_usd | FLOAT | Doanh thu của sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là đô la. Chỉ được điền cho sự kiện mua. |
ecommerce.purchase_revenue | FLOAT | Doanh thu của sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là nội tệ. Chỉ được điền cho sự kiện mua. |
ecommerce.refund_value_in_usd | ecommerce.refund_value_in_usd | Số tiền hoàn lại trong sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là đô la. Chỉ được điền cho sự kiện hoàn tiền. |
ecommerce.refund_value | FLOAT | Số tiền hoàn lại trong sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là nội tệ. Chỉ được điền cho sự kiện hoàn tiền. |
ecommerce.shipping_value_in_usd | FLOAT | Phí vận chuyển trong sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là đô la. |
ecommerce.shipping_value | FLOAT | Phí vận chuyển trong sự kiện này, được thể hiện bằng đơn vị là nội tệ. |
ecommerce.tax_value_in_usd | FLOAT | Tiền thuế trong sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là đô la. |
ecommerce.tax_value | FLOAT | Tiền thuế trong sự kiện này, được thể hiện bằng đơn vị tiêu chuẩn là nội tệ. |
ecommerce.transaction_id | STRING | Mã giao dịch của giao dịch thương mại điện tử. |
ecommerce.unique_items | INTEGER | Số lượng các mặt hàng khác biệt trong sự kiện này (dựa trên item_id, item_name và item_brand). |
Mặt hàng |
|
|
items | RECORD | Bản ghi lặp lại về các mặt hàng có trong sự kiện này. |
items.item_id | STRING | Mã của mặt hàng. |
items.item_name | STRING | Tên mặt hàng. |
items.item_brand | STRING | Thương hiệu của mặt hàng. |
items.item_variant | STRING | Các loại của mặt hàng. |
items.item_category | STRING | Danh mục của mặt hàng. |
items.item_category2 | STRING | Danh mục phụ của mặt hàng. |
items.item_category3 | STRING | Danh mục phụ của mặt hàng. |
items.item_category4 | STRING | Danh mục phụ của mặt hàng. |
items.item_category5 | STRING | Danh mục phụ của mặt hàng. |
items.price_in_usd | FLOAT | Giá của mặt hàng, theo đơn vị tiêu chuẩn là đô la. |
items.price | FLOAT | Giá của mặt hàng theo đơn vị là nội tệ. |
items.quantity | INTEGER | Số lượng của mặt hàng. |
items.item_revenue_in_usd | FLOAT | Doanh thu của mặt hàng này (tính theo công thức: price_in_usd * số lượng). Thông tin này chỉ được điền cho sự kiện mua, theo đơn vị tiêu chuẩn là đô la. |
items.item_revenue | FLOAT | Doanh thu của mặt hàng này (tính theo công thức giá * số lượng). Thông tin này chỉ được điền cho sự kiện mua hàng, theo đơn vị tiêu chuẩn là nội tệ. |
items.item_refund_in_usd | FLOAT | Giá trị hoàn lại của mặt hàng này, tính theo công thức: price_in_usd * số lượng. Thông tin này chỉ được điền cho sự kiện hoàn tiền, theo đơn vị tiêu chuẩn là đô la. |
items.item_refund | FLOAT | Giá trị hoàn lại của mặt hàng này (tính theo công thức: giá * số lượng). Thông tin này chỉ được điền cho sự kiện hoàn lại tiền, theo đơn vị tiêu chuẩn là nội tệ. |
items.coupon | STRING | Mã giảm giá đã áp dụng cho mặt hàng này. |
items.affiliation | STRING | Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực tế. |
items.location_id | STRING | Vị trí liên kết với mặt hàng. |
items.item_list_id | STRING | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. |
items.item_list_name | STRING | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. |
Items.item_list_index | STRING | Vị trí của mặt hàng trong danh sách. |
items.promotion_id | STRING | Mã chương trình khuyến mại của sản phẩm. |
items.promotion_name | STRING | Tên của chương trình khuyến mại sản phẩm. |
items.creative_name | STRING | Tên của tệp sáng tạo dùng trong vị trí khuyến mại. |
items.creative_slot | STRING | Tên của một vùng tệp sáng tạo. |
Web |
|
|
web_info | RECORD | Bản ghi thông tin cho dữ liệu web. |
web_info.hostname | STRING | Tên máy chủ liên kết với sự kiện đã ghi nhật ký. |
web_info.browser | STRING | Trình duyệt mà người dùng sử dụng để xem nội dung. |
web_info.browser_version | STRING | Phiên bản của trình duyệt mà người dùng sử dụng để xem nội dung. |
Thông tin về quyền riêng tư |
|
|
privacy_info.ads_storage | STRING | Liệu tính năng nhắm mục tiêu quảng cáo có được bật cho người dùng hay không.Bạn có thể sử dụng các giá trị sau: Có, Không, Chưa đặt |
privacy_info.analytics_storage | STRING | Liệu bộ nhớ Analytics có được bật cho người dùng hay không.Bạn có thể sử dụng các giá trị sau: Có, Không, Chưa đặt |
privacy_info.uses_transient_token | STRING | Liệu một người dùng web có từ chối bộ nhớ Analytics và nhà phát triển đã bật tính năng đo lường mà không cần cookie dựa trên mã thông báo tạm thời trong dữ liệu máy chủ hay chưa.Bạn có thể sử dụng các giá trị sau: Có, Không, Chưa đặt |
Nguồn: Analytics Help Center
