Sự kiện được đề xuất và sự kiện tuỳ chỉnh của Google Analytics

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.

Gửi sự kiện được đề xuất và sự kiện tuỳ chỉnharrow_forward

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.

Tổng quan về quy trình công việc

Để gửi dữ liệu sự kiện bằng Data Manager API, hãy hoàn tất các bước sau:

1. Chuẩn bị đích đến: Xác định các đối tượng Destination cho trường destinations của yêu cầu nhập để chỉ định tài khoản mục tiêu và đích đến của lượt chuyển đổi hoặc sự kiện. Hãy xem phần Chuẩn bị đích đến để biết thông tin chi tiết.

2. Chuẩn bị dữ liệu sự kiện và giá trị nhận dạng: Điền thông tin chi tiết về sự kiện và giá trị nhận dạng bắt buộc (chẳng hạn như giá trị nhận dạng lượt nhấp vào quảng cáo, ứng dụng khách hoặc bản sao ứng dụng) vào các trường Event. Nếu bạn đưa thông tin liên hệ của người dùng vào userData, hãy chuẩn hoá và băm SHA-256 giá trị nhận dạng theo nguyên tắc định dạng, đồng thời mã hoá các giá trị nhận dạng đó (không bắt buộc). Hãy xem bài viết Chuẩn bị dữ liệu sự kiện để biết thông tin chi tiết.

3. Tạo và gửi yêu cầu nhập: Gửi yêu cầu events.ingest chứa destinations, bản ghi Event và encryptionInfo nếu bạn đã mã hoá userData. Sử dụng validateOnly: true để kiểm tra tải trọng của bạn nhằm tìm lỗi không thành công nhanh trước khi gửi dữ liệu chính thức. Hãy xem bài viết Gửi sự kiện để biết các yêu cầu về trường và mã mẫu.

4. Kiểm tra thông tin chẩn đoán: Truy xuất thông tin chẩn đoán về quá trình xử lý không đồng bộ và xác minh trạng thái nhập bằng requestStatus.retrieve.

Trường hợp sử dụng

Dưới đâ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 hoạt động tương tác thông thường của người dù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 Event. Điều này giúp cải thiện khả năng đo lường lượt chuyển đổi, phân bổ và xây dựng đối tượng trong Google Analytics.

Hãy lưu ý những điều sau khi gửi dữ liệu do người dùng cung cấp:

• Đượ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 video tải lên độc lập mà không có sự kiện.

• Định dạng và băm: Bạn phải chuẩn hoá 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ố) 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ể tuỳ ý mã hoá dữ liệu người dùng đã băm.

• Mã nhận dạng người dùng: Bạn nên cung cấp userId cùng với userData bấ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ều cần cân nhắc khi tích hợp

Hãy lưu ý những điểm sau khi sử dụng API Trình quản lý dữ liệu.

Tái tiếp thị

Google Analytics hỗ trợ tính năng tái tiếp thị trên cùng một thiết bị khi bạn bật tín hiệu của Google. Để tái tiếp thị trên nhiều thiết bị, bạn cần 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 mã nhận dạng cho quảng cáo (chẳng hạn như GBRAID hoặc WBRAID) được thu thập trong các hoạt động tương tác trực tuyến với các sự kiện của 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 của Data Manager API với các 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à "giới hạn theo dõi quảng cáo".

Bạn cũng có thể chỉ định chế độ cài đặt sự đồng ý của người dùng ngay trên mỗi sự kiện bằng cách sử dụng đối tượng consent.

Thông tin về địa lý và thiết bị

Google Analytics tự động kết hợp thông tin mới nhất về vị trí địa lý và thiết bị từ việc gắn thẻ với các sự kiện của 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 được phản ánh trong các báo cáo bao gồm phương diện đị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ị của 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, trong đó 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 phiên bắt đầu.

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.

Máy chủ đến máy chủ đầy đủ

Mặc dù bạn có thể gửi sự kiện đến Google Analytics chỉ bằng API Trình quản lý dữ liệu, nhưng có thể bạn chỉ nhận được báo cáo một phần. Mục đích của API Trình quản lý dữ liệu 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à 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 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 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 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.