[GA4] Nhập các sự kiện ngoại tuyến

Giới thiệu về dữ liệu sự kiện ngoại tuyến

Bạn có thể nhập các sự kiện ngoại tuyến từ những nguồn không có kết nối Internet hoặc không thể hỗ trợ thu thập sự kiện theo thời gian thực thông qua SDK hoặc Measurement Protocol. Sau khi bạn tải các sự kiện lên, hệ thống sẽ xử lý chúng như thể chúng được thu thập thông qua các SDK của chúng tôi. Các sự kiện đó sẽ sử dụng dấu thời gian mà bạn cung cấp hoặc dấu thời gian của quá trình tải lên (nếu bạn không cung cấp).

Bạn có thể nhập bất kỳ sự kiện nào khớp với các sự kiện mà Analytics tự động thu thập hoặc các sự kiện chúng tôi đề xuất cho các danh mục khác nhau hay bất kỳ sự kiện, thông số hoặc thuộc tính người dùng tùy chỉnh nào có định dạng hợp lệ. Tìm hiểu thêm

Để xoá dữ liệu này, bạn cần phải tạo một yêu cầu xoá dữ liệu hoặc xoá người dùng.

Cách nhập dữ liệu sự kiện ngoại tuyến

Để nhập sự kiện ngoại tuyến, bạn cần tạo tệp CSV khớp với giản đồ sự kiện Analytics. Xem ví dụ về mẫu bên dưới.

Tạo phương diện tuỳ chỉnh

Nếu đang nhập giá trị cho các phương diện chưa tồn tại trong Analytics và muốn xem dữ liệu đó trong báo cáo, thì bạn cần phải tạo các phương diện đó trước khi tải dữ liệu lên. Tìm hiểu thêm

Sau khi bạn tạo phương diện tùy chỉnh, Analytics cần tối đa 4 giờ để sẵn sàng nhận dạng dữ liệu mà bạn nhập. (Bạn có thể xác minh xem các phương diện tùy chỉnh đã được xử lý chưa bằng cách mở một dữ liệu khám phá và kiểm tra xem liệu các phương diện đó có trong bộ chọn phương diện hay không.)

Tạo tệp CSV

Tạo một tệp CSV chứa dữ liệu sự kiện bằng cách sử dụng mẫu bên dưới làm hướng dẫn.

Tải dữ liệu lên

Quy trình tải lên chung được nêu trong bài viết Giới thiệu về tính năng Nhập dữ liệu.

Khi bạn tạo nguồn dữ liệu, hãy chọn Dữ liệu sự kiện ngoại tuyến.

Đối với các sự kiện ngoại tuyến, các trường mà bạn đã nhập sẽ tự động được liên kết với các trường trong Analytics.

Sau khi bạn tải dữ liệu của mình lên, có thể mất tới 24 giờ để Analytics hiển thị dữ liệu đó trong báo cáo, đối tượng và dữ liệu khám phá.

Khi bạn xoá một nguồn dữ liệu khỏi dịch vụ tải dữ liệu lên, dữ liệu đã tải lên sẽ không bị xoá. Nếu cần (giống như tất cả các phương pháp thu thập khác), bạn có thể phải tiếp tục yêu cầu xóa dữ liệu để xóa dữ liệu mà mình đã tải lên thông qua tính năng Nhập dữ liệu.

Lưu ý: Tuỳ thuộc vào loại nguồn tải lên hoặc nguồn nhập dữ liệu, bạn có thể chỉnh sửa tên trường hoặc không.

Thông tin chi tiết về nguồn dữ liệu

Legend

Phạm vi Sự kiện
Các trường bắt buộc

[một trong số] client_id hoặc app_instance_id

[một trong số] measurement_id hoặc firebase_app_id

(measurement_id và client_id) hoặc (firebase_app_id và app_instance_id)

event_name

Dữ liệu đã nhập

Bạn có thể tải mọi dữ liệu sự kiện, tham số, mục hoặc thuộc tính người dùng lên bằng cách sử dụng các định dạng tiêu đề sau:

  • timestamp_micros (không bắt buộc; phải trong vòng 72 giờ kể từ khi xảy ra sự kiện; dùng dấu thời gian của quá trình tải lên nếu không được cung cấp)
  • user_id (không bắt buộc nhưng nên dùng khi có sẵn)
  • tín hiệu về sự đồng ý (không bắt buộc, nhưng nên dùng khi có thể. Tìm hiểu thêm)
  • event_param.<xxxxx> (nhập bất kỳ thông số nào với một tên bất kỳ)
  • user_property.<yyyyy> (nhập bất kỳ thuộc tính người dùng nào với bất kỳ tên nào)
  • item<x>.<item_param> (ví dụ: item2.item_name)
Ghi chú Bạn không được tải lên hoặc liên kết thông tin nhận dạng cá nhân với tính năng nhập sự kiện ngoại tuyến. Tìm hiểu thêm

 

Mẫu

Dưới đây là một ví dụ về mẫu CSV cho dữ liệu sự kiện. Nếu bạn cần tự tạo tệp tải lên, hãy dựa vào hướng dẫn trong ví dụ này.

measurement_id client_id user_id timestamp_micros ad_personalization ad_user_data event_name event_param.page_location event_param.page_referrer event_param.page_title event_param.screen_resolution user_property.color_score event_param.foo item1.item_id item1.item_name item1.category item1.item_list_id item1.item_list_name item1.index item1.quantity item1.price item2.item_id item2.item_name item2.quantity item2.price event_param.transaction_id event_param.value event_param.tax event_param.shipping event_param.currency
G-12345ABCDE 1234567890.0987654321 1000001 1609488000000000 granted denied page_view /home referrer.com Trang chủ 1600x900 blue 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 denied denied page_view /video_detail   Người xem video 1600x900 blue 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 denied granted video_play /video_detail   Người xem video 1600x900 blue                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 denied granted page_view /home referrer.com Trang chủ 2560x1440 màu xanh lục 2–2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 denied granted page_view /product_detail   Chi tiết sản phẩm 2560x1440 màu xanh lục 2–16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 granted granted page_view /product_detail   Chi tiết sản phẩm 2560x1440 màu xanh lục                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 granted granted page_view /camp_lp_1 referrer.com Giảm giá mùa hè! 2560x1440 blue 3–1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 granted denied view_item_list /camp_lp_1   Giảm giá mùa hè! 2560x1440 blue   123abc red_shoe giày list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30,00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 granted granted select_item /camp_lp_1   Giảm giá mùa hè! 2560x1440 blue   234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 granted granted page_view /product_detail   Chi tiết sản phẩm 2560x1440 blue 3-5 234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 denied granted view_item /product_detail   Chi tiết sản phẩm 2560x1440 blue 3–17 234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 denied denied add_to_cart /product_detail   Chi tiết sản phẩm 2560x1440 blue   234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 granted denied begin_checkout /product_detail   Chi tiết sản phẩm 2560x1440 blue   234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 granted denied page_view /purchase_confirmation   Xin chúc mừng! 2560x1440 blue 3–21 234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 granted denied purchase /purchase_confirmation   Xin chúc mừng! 2560x1440 màu tím 3–21 234bcd blue_shoe giày list_123 colorful_shoes 2 1 30,00         t12345 37,49 2,50 4,99 USD

 

 

Hạn mức

Những sự kiện, tham số và thuộc tính người dùng sử dụng tên dành riêng sẽ bị từ chối.

Những thông số item-event (ví dụ: item_list_name) không có giá trị sẽ bị từ chối. Những thông số item-event được hỗ trợ cho một nhóm nhỏ các sự kiện đề xuất (ví dụ: Thương mại điện tử, Việc làm, Du lịch).

Tên sự kiện và thông số cần phải tuân thủ các quy tắc sau:

  • Sự kiện có thể có tối đa 25 thông số.
  • Sự kiện có thể có tối đa 25 thuộc tính người dùng.
  • Tên thuộc tính người dùng chỉ được có tối đa 24 ký tự.
  • Giá trị thuộc tính người dùng chỉ được có tối đa 36 ký tự.
  • Tên sự kiện chỉ được có tối đa 40 ký tự, chỉ được chứa các ký tự chữ và số, dấu gạch dưới và phải bắt đầu bằng một ký tự chữ cái.
  • Tên thông số (bao gồm cả thông số mục) chỉ được có tối đa 40 ký tự, chỉ được chứa ký tự chữ và số, dấu gạch dưới và phải bắt đầu bằng một ký tự chữ cái.
  • Giá trị tham số (kể cả giá trị tham số của mặt hàng) chỉ được có tối đa 100 ký tự.

Các giới hạn của tính năng nhập dữ liệu sự kiện ngoại tuyến

Bạn có thể tạo tối đa 10 nguồn dữ liệu cho dữ liệu sự kiện ngoại tuyến.

Thông tin này có hữu ích không?

Chúng tôi có thể cải thiện trang này bằng cách nào?
Tìm kiếm
Xóa nội dung tìm kiếm
Đóng tìm kiếm
Các ứng dụng của Google
Trình đơn chính
16321390764160929598
true
Tìm kiếm trong Trung tâm trợ giúp
true
true
true
true
true
69256
false
false
false
false