Các trường hợp sử dụng Measurement Protocol (original) (raw)
Bộ quy tắc đo lường 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, ngoài dữ liệu bạn đang thu thập bằng tính năng gắn thẻ hoặc SDK Firebase.
Hướng dẫn này mô tả các trường hợp sử dụng phổ biến của Measurement Protocol trong Google Analytics và các yêu cầu đối với các trường hợp sử dụng đó.
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ề các yêu cầu cho từng trường hợp sử dụng. Hãy ghi nhớ các phương pháp hay nhất sau đây:
timestamp_micros
của các sự kiện và thuộc tính người dùng mặc định là thời gian yêu cầu. Khi gửi một sự kiện hoặc thay đổi thuộc tính người dùng đã xảy ra trong quá khứ, hãy 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 bao gồm tham số sự kiện
engagement_time_msec
được đặt thành số 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 đối với thời gian yêu cầu | Yêu cầu timestamp_micros |
---|---|---|---|
Chỉ định User-ID cho người dùng | Bắt buộc | <= kết thúc phiên là lúc bắt đầu ngày làm việc (kinh doanh) | >= bắt đầu phiên và <= kết thúc phiên |
Phân bổ phiên | Bắt buộc | <= 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 các nền tảng quảng cáo | Không bắt buộc | <= ngày làm việc có phiên gần đây nhất + 63 ngày | >= thời gian yêu cầu trừ đi 2 ngày làm việc và <= 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 | Không bắt buộc | Web: <= thời gian diễn ra sự kiện trực tuyến mới nhất + 30 ngàyỨng dụng: <= thời gian diễn ra sự kiện trực tuyến mới nhất + 42 ngày | >= thời gian yêu cầu trừ đi 2 ngày làm việc và <= thời gian yêu cầu |
Chỉ định User-ID cho người dùng
Sử dụng Measurement Protocol để cung cấp Mã nhận dạng người dùng cho các sự kiện trực tuyến hoặc ngoại tuyến.
Dưới đây là một số trường hợp sử dụng mẫu để thêm Mã nhận dạng người dùng vào một sự kiện:
- Phương pháp đo lường trực tuyến của bạn thiếu thông tin cần thiết để tra cứu Mã nhận dạng người dùng 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ể liên kết giữa một phiên trực tuyến và một Mã nhận dạng người dùng.
Trong trường hợp này, bạn đang sử dụng Measurement Protocol để cung cấp các sự kiện trực tuyến bằng Mã nhận dạng người dùng. - Bạn không có User-ID cho các sự kiện mà bạn đang gửi bằng Đo lường giao thức, nhưng bạn muốn các sự kiện đó được liên kết 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 các sự kiện trực tuyến để cung cấp mã nhận dạng người dùng cho các sự kiện Measurement Protocol.
Sau đây là các yêu cầu để thêm Mã nhận dạng người dùng vào một sự kiện:
- Thêm
session_id
vào danh sách tham số của sự kiện. - Gửi các sự kiện Measurement Protocol vào cùng ngày làm việc với phiên trực tuyến.
- Nếu bạn ghi đè
timestamp_micros
, hãy đặt giá trị này thành 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_id
trong yêu cầu. - Nếu mục tiêu của bạn là mỗi sự kiện Measurement Protocol đều có Mã nhận dạng người dùng từ phiên trực tuyến tương ứng, thì bạn không cần thiết lập
user_id
.
Phân bổ phiên
Những sự kiện Measurement Protocol đáp ứng các yêu cầu cụ thể sẽ xuất hiện trong báo cáo với các thuộc tính phiên giống như sự kiện trực tuyến từ cùng một 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 đây là các yêu cầu đối với mô hình phân bổ phiên:
- Thêm
session_id
vào danh sách tham số của sự kiện. - Gửi yêu cầu muộn nhất là 24 giờ sau khi bắt đầu phiên trực tuyến.
Ví dụ: nếu phiên bắt đầu lúc 11:15 thứ Hai theo múi giờ của tài sản, hãy gửi yêu cầu trước 11:15 thứ Ba. - Nếu bạn ghi đè
timestamp_micros
, hãy đặt giá trị này thành 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 các nền tảng quảng cáo
Google Analytics sẽ đưa các sự kiện mà bạn gửi bằng Measurement Protocol vào dữ liệu xuất sang các sản phẩm quảng cáo được liên kết, chẳng hạn như Google Ads hoặc Campaign Manager 360.
Sau đây là một số trường hợp phổ biến mà tính năng này hữu ích:
- 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 tính năng phân bổ và báo cáo quảng cáo.
- Bạn có các sự kiện bổ sung trong một hệ thống không hỗ trợ tính năng gắn thẻ hoặc SDK Firebase, nhưng bạn vẫn muốn đưa các sự kiện đó vào các sản phẩm được liên kết.
Sau đây là các yêu cầu để xuất sự kiện sang các nền tảng quảng cáo:
- Gửi yêu cầu muộn nhất vào cuối ngày làm việc 63 ngày sau sự kiện trực tuyến mới nhất, ngay cả khi giai đoạn phân bổ của sự kiện chính dài hơn 63 ngày.
Ví dụ: nếu sự kiện trực tuyến mới nhất choclient_id
hoặcapp_instance_id
xảy ra vào ngày 1 tháng 3, hãy gửi sự kiện theo Measurement Protocol muộn nhất 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 giá trị này thành dấu thời gian trong vòng 3 ngày làm việc gần nhất.
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 quá trình đánh giá điều kiện đố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 nhằm tạo đối tượng:
- Gửi yêu cầu đến luồng Web muộn nhất 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 củaclient_id
xảy ra vào ngày 1 tháng 3, hãy gửi sự kiện Measurement Protocol muộn nhất vào cuối ngày làm việc vào ngày 31 tháng 3. - Gửi yêu cầu đến 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 choapp_instance_id
xảy ra vào ngày 1 tháng 3, hãy gửi sự kiện Measurement Protocol muộn nhất vào cuối ngày làm việc vào ngày 12 tháng 4. - Nếu bạn ghi đè
timestamp_micros
, hãy đặt giá trị này thành dấu thời gian trong vòng 3 ngày làm việc gần nhất.