Measurement Protocol của Google Analytics cho phép bạn gửi dữ liệu ngoại tuyến đến Luồng web hoặc ứng dụng, theo ngoài dữ liệu mà bạn đã thu thập bằng cách sử dụng tính năng gắn thẻ hoặc Firebase SDK.
Hướng dẫn này mô tả các trường hợp sử dụng Google Analytics Measurement Protocol phổ biến và yêu cầu của các trường hợp đó.
Tóm tắt các yêu cầu
Bảng này cung cấp thông tin tham khảo nhanh về yêu cầu đối với mỗi trường hợp sử dụng trường hợp. Hãy ghi nhớ các phương pháp hay nhất sau đây:
timestamp_microscủa sự kiện và thuộc tính người dùng được đặt mặc định là yêu cầu bất cứ lúc nào. Khi gửi một sự kiện hoặc thay đổi về thuộc tính người dùng xảy ra trong qua, ghi đè dấu thời gian như mô tả trong hướng dẫn gửi sự kiện và hướng dẫn về thuộc tính người dùng.Để có Báo cáo theo thời gian thực và chỉ số tương tác chính xác, hãy thêm Đã đặt thông số sự kiện
engagement_time_msecthành mili giây trôi qua kể từ sự kiện trước đó.
| Trường hợp sử dụng | Mã phiên | Yêu cầu về thời gian yêu cầu | timestamp_micros yêu cầu |
|---|---|---|---|
| Chỉ định User-ID cho sự kiện | Bắt buộc | <= kết thúc ngày làm việc của ngày bắt đầu phiên | >= bắt đầu phiên và <= kết thúc phiên |
| Phân bổ phiên | Bắt buộc | <= thời gian bắt đầu phiên + 24 giờ | >= bắt đầu phiên và <= kết thúc phiên |
| Xuất sự kiện sang nền tảng quảng cáo | Không bắt buộc | <= ngày làm việc của phiên hoạt động gần đây nhất + 63 ngày | <= thời gian yêu cầu |
| Gửi sự kiện hoặc thuộc tính người dùng cho đối tượng sáng tạo | Không bắt buộc | Web: <= thời gian sự kiện trực tuyến mới nhất + 30 ngày Ứng dụng: <= thời gian sự kiện trực tuyến mới nhất + 42 ngày |
<= thời gian yêu cầu |
Chỉ định User-ID cho sự kiện
Sử dụng Measurement Protocol để cung cấp các sự kiện trực tuyến hoặc ngoại tuyến có User-ID.
Dưới đây là một số ví dụ về trường hợp sử dụng việc thêm User-ID vào một sự kiện:
Dịch vụ đo lường trực tuyến của bạn thiếu thông tin cần thiết để tra cứu User-ID cho các sự kiện trực tuyến, nhưng bạn có một quy trình xử lý sự kiện có thể tạo mối liên kết giữa phiên trực tuyến và User-ID.
Trong trường hợp này, bạn đang sử dụng Measurement Protocol để cung cấp trực tuyến có User-ID.
Bạn chưa có User-ID cho các sự kiện mà bạn đang gửi bằng Measurement Protocol, nhưng bạn muốn liên kết các sự kiện đó với một User-ID nếu người dùng đăng nhập trực tuyến trong suốt phiên.
Trong trường hợp này, bạn đang sử dụng sự kiện trực tuyến để cung cấp Các sự kiện Measurement Protocol có User-ID.
Dưới đây là các yêu cầu để thêm User-ID vào một sự kiện:
- Thêm
session_idvào danh sách thông số của sự kiện. - Gửi các sự kiện Measurement Protocol trong cùng một ngày làm việc với phiên trực tuyến.
- Nếu bạn ghi đè
timestamp_micros, hãy đặt thành một dấu thời gian giữa thời gian bắt đầu và kết thúc của phiên trực tuyến. - Nếu mục tiêu của bạn là cung cấp User-ID cho các sự kiện trực tuyến, hãy đặt
user_idtrong yêu cầu. - Nếu mục tiêu của bạn là muốn có User-ID cho mỗi sự kiện trên Measurement Protocol
từ phiên trực tuyến tương ứng, bạn không cần đặt
user_id.
Phân bổ phiên
Những sự kiện trên Measurement Protocol đáp ứng các yêu cầu cụ thể sẽ xuất hiện trong báo cáo có cùng các thuộc tính phiên (chẳng hạn như thông tin địa lý, nguồn, phương tiện và chiến dịch) dưới dạng sự kiện trực tuyến trong cùng một phiên.
Dưới đây là các yêu cầu đối với mô hình phân bổ phiên:
- Thêm
session_idvào danh sách thông số của sự kiện. Gửi yêu cầu trong vòng 24 giờ sau khi bắt đầu hoạt động trực tuyến phiên hoạt động.
Ví dụ: nếu phiên hoạt động bắt đầu lúc 11:15 sáng thứ Hai trong tài sản của bạn múi giờ, hãy gửi yêu cầu trước 11:15 sáng thứ Ba.
Nếu bạn ghi đè
timestamp_micros, hãy đặt thành một dấu thời gian giữa thời gian bắt đầu và kết thúc của phiên trực tuyến.
Xuất sự kiện sang nền tảng quảng cáo
Google Analytics bao gồm các sự kiện mà bạn gửi bằng Measurement Protocol khi xuất sang các sản phẩm quảng cáo được liên kết như Google Ads hoặc Campaign Manager 360 độ.
Một vài trường hợp phổ biến mà việc này hữu ích bao gồm:
- Doanh nghiệp của bạn có các sự kiện ngoại tuyến mà bạn muốn đưa vào quảng cáo phân bổ và báo cáo.
- Bạn có các sự kiện khác trong hệ thống không thể gắn thẻ hoặc Firebase SDK, nhưng bạn vẫn muốn đưa những sự kiện đó vào của Google dành cho doanh nghiệp.
Dưới đây là các yêu cầu để xuất sự kiện sang nền tảng quảng cáo:
Gửi yêu cầu chậm nhất là vào cuối ngày làm việc sau 63 ngày sự kiện trực tuyến mới nhất, ngay cả khi khoảng thời gian phân bổ của sự kiện chính hơn 63 ngày.
Ví dụ: nếu sự kiện trực tuyến mới nhất cho
client_idhoặcapp_instance_idđã xảy ra vào ngày 1 tháng 3, hãy gửi Measurement Protocol muộn nhất là vào cuối ngày làm việc vào ngày 3 tháng 5.Nếu bạn ghi đè
timestamp_micros, hãy đặt thành một dấu thời gian nhỏ hơn hoặc bằng vào thời gian yêu cầu.
Gửi sự kiện hoặc thuộc tính người dùng để tạo đối tượng
Các sự kiện và thuộc tính người dùng được gửi bằng Measurement Protocol sẽ được đưa vào việc đánh giá các điều kiện về đối tượng nếu bạn tuân thủ một số yêu cầu.
Dưới đây là các yêu cầu để gửi sự kiện hoặc thuộc tính người dùng cho đối tượng quá trình tạo:
Gửi yêu cầu tới một luồng dữ liệu web chậm nhất là vào cuối ngày làm việc 30 ngày sau sự kiện trực tuyến mới nhất cho cùng một
client_id.Ví dụ: nếu sự kiện trực tuyến mới nhất cho
client_idxảy ra vào Ngày 1 tháng 3, hãy gửi sự kiện Measurement Protocol muộn nhất là khi ngày làm việc vào ngày 31 tháng 3.Gửi yêu cầu tới Luồng ứng dụng muộn nhất vào cuối ngày làm việc 42 ngày sau sự kiện trực tuyến mới nhất cho cùng một
app_instance_id.Ví dụ: nếu sự kiện trực tuyến mới nhất cho
app_instance_idxảy ra vào ngày 1 tháng 3, hãy gửi sự kiện Measurement Protocol chậm nhất là vào cuối ngày ngày làm việc vào ngày 12 tháng 4.Nếu bạn ghi đè
timestamp_micros, hãy đặt thành một dấu thời gian nhỏ hơn hoặc bằng vào thời gian yêu cầu.