Sử dụng Data Manager API để gửi sự kiện được đề xuất và sự kiện tuỳ chỉnh của Google Analytics.
Hãy xem bài viết Gửi sự kiện để biết thông tin chi tiết.
Nếu bạn đang nâng cấp từ Measurement Protocol của Google Analytics, hãy xem bài viết Nâng cấp từ Measurement Protocol lên Data Manager API để biết hướng dẫn.
Trường hợp sử dụng
Sau đây là một số trường hợp sử dụng để gửi sự kiện tuỳ chỉnh và sự kiện được đề xuất bằng Data Manager API:
Liên kết hành vi từ trực tuyến đến ngoại tuyến
Đo lường các lượt tương tác phía máy khách và phía máy chủ.
Gửi những sự kiện xảy ra bên ngoài lượt tương tác của người dùng thông thường, chẳng hạn như lượt chuyển đổi ngoại tuyến.
Gửi sự kiện từ những thiết bị và ứng dụng không có chức năng thu thập dữ liệu tự động, như kiosk và đồng hồ.
Dữ liệu do người dùng cung cấp
Bạn có thể gửi dữ liệu khách hàng của bên thứ nhất (chẳng hạn như địa chỉ email, số điện thoại và địa chỉ thực tế đã băm) trong trường userData của một Event. Điều này giúp cải thiện hoạt động đo lường lượt chuyển đổi, phân bổ và tạo đối tượng trong Google Analytics.
Khi gửi dữ liệu do người dùng cung cấp, hãy lưu ý những điều sau:
Được gửi cùng với sự kiện: Trong Data Manager API, dữ liệu do người dùng cung cấp phải được gửi dưới dạng một phần của
Event. Chúng tôi không hỗ trợ các lượt tải lên độc lập mà không có sự kiện.Định dạng và băm: Giá trị nhận dạng cá nhân (chẳng hạn như địa chỉ email, số điện thoại, tên và địa chỉ đường phố) phải được chuẩn hoá và băm bằng thuật toán SHA-256 trước khi tải lên. Các trường khác (chẳng hạn như thành phố, tiểu bang hoặc tỉnh, mã bưu chính và mã quốc gia) được chuẩn hoá nhưng không được băm. Hãy làm theo hướng dẫn Định dạng dữ liệu người dùng để biết các yêu cầu cụ thể.
Mã hoá: Bạn có thể mã hoá dữ liệu người dùng đã băm (không bắt buộc).
User-ID: Bạn nên cung cấp
userIdcùng vớiuserDatabất cứ khi nào có giá trị nhận dạng người dùng nhất quán.Triển khai: Xem phần Thêm dữ liệu do người dùng cung cấp để biết hướng dẫn về cách tạo yêu cầu.
Những điểm cần cân nhắc khi tích hợp
Khi sử dụng Data Manager API, hãy lưu ý những điểm sau.
Tái tiếp thị
Google Analytics hỗ trợ hoạt động tái tiếp thị trên cùng một thiết bị khi bạn bật các tín hiệu của Google. Đối với hoạt động tái tiếp thị trên nhiều thiết bị, bạn phải có userId.
Ngoài ra, bạn có thể gửi dữ liệu do người dùng cung cấp để bật tính năng so khớp đối tượng của bên thứ nhất.
Mã nhận dạng cho quảng cáo
Google Analytics tự động kết hợp giá trị nhận dạng quảng cáo (chẳng hạn như GBRAID hoặc WBRAID) được thu thập trong các lượt tương tác trực tuyến với các sự kiện Data Manager API bằng cách sử dụng clientId hoặc appInstanceId.
Chế độ cài đặt quyền riêng tư
Google Analytics kết hợp các sự kiện Data Manager API với hoạt động tương tác trực tuyến bằng cách sử dụng clientId hoặc appInstanceId để áp dụng các chế độ cài đặt quyền riêng tư của người dùng, chẳng hạn như "quảng cáo không được cá nhân hoá" và "hạn chế theo dõi quảng cáo".
Bạn cũng có thể chỉ định chế độ cài đặt về sự đồng ý của người dùng trực tiếp trên mỗi sự kiện bằng cách sử dụng đối tượng consent.
Thông tin về vị trí địa lý và thiết bị
Google Analytics tự động kết hợp thông tin gần đây nhất về vị trí địa lý và thiết bị từ hoạt động gắn thẻ với các sự kiện Data Manager API bằng cách sử dụng clientId hoặc appInstanceId.
Điều này đảm bảo rằng các sự kiện Data Manager API của bạn sẽ xuất hiện trong những báo cáo có phương diện về vị trí địa lý và thiết bị.
Nếu bạn muốn một sự kiện Data Manager API phản ánh thông tin về vị trí địa lý và thiết bị từ một phiên cụ thể thay vì thông tin mới nhất cho clientId hoặc appInstanceId, hãy thêm một mục trong additionalEventParameters với parameterName được đặt thành session_id và value được đặt thành mã nhận dạng của phiên cụ thể, đồng thời gửi sự kiện trong vòng 24 giờ kể từ khi bắt đầu phiên.
Bạn có thể cung cấp thông tin địa lý và thông tin thiết bị cho các sự kiện bằng Data Manager API.
Đầy đủ từ máy chủ đến máy chủ
Mặc dù bạn có thể chỉ gửi sự kiện đến Google Analytics bằng Data Manager API, nhưng bạn có thể chỉ nhận được báo cáo một phần. Mục đích của Data Manager API là tăng cường các sự kiện hiện có được thu thập bằng gtag, Trình quản lý thẻ hoặc Firebase. Một số tên sự kiện và tên tham số được dành riêng để sử dụng thông qua tính năng thu thập tự động và không thể gửi thông qua Data Manager API.
Tạo hoặc đổi tên sự kiện
Các sự kiện được gửi bằng Data Manager API không kích hoạt các quy tắc để tạo hoặc đổi tên sự kiện. Ứng dụng của bạn phải triển khai logic để gửi các sự kiện tuỳ chỉnh thông qua Data Manager API, tương tự như các quy tắc được định cấu hình trong giao diện người dùng Google Analytics.