Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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 các sự kiện được đề xuất và tuỳ chỉnh của Google Analytics.

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

Nếu bạn đang nâng cấp từ Giao thức đo lường của Google Analytics hãy xem bài viết Nâng cấp từ Giao thức đo lường 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:

Chuẩn bị đích đến: Xác định các đối tượng Destination cho trường destinations của yêu cầu thu thập để chỉ định tài khoản đích và đích đến của lượt chuyển đổi hoặc sự kiện. Xem bài viết Chuẩn bị đích đến để biết thông tin chi tiết.
Chuẩn bị dữ liệu sự kiện và giá trị nhận dạng: Điền Event các trường bằng 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ư lượt nhấp vào quảng cáo, giá trị nhận dạng phiên bản ứng dụng hoặc máy khách ). 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 các giá trị nhận dạng theo nguyên tắc định dạng, đồng thời mã hoá các giá trị đó (không bắt buộc). Xem bài viết Chuẩn bị dữ liệu sự kiện để biết thông tin chi tiết.
Tạo và gửi yêu cầu thu thập: Gửi yêu cầu events.ingest có chứa các bản ghi destinations, Event và encryptionInfo nếu bạn đã mã hoá userData. Sử dụng validateOnly: true để kiểm thử tải trọng của bạn về các lỗi nhanh chóng thất bại trước khi gửi dữ liệu sản xuất. 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.
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 thu thập bằng requestStatus.retrieve.

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

Sau đây là một số trường hợp sử dụng để gửi các 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 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 đã băm và địa chỉ thực, trong trường userData của 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à xây dựng đố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 trong Event. Chúng tôi không hỗ trợ 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).
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 bài viết 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.

Lưu ý về việc tích hợp

Khi sử dụng Data Manager API, hãy lưu ý những điều sau.

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ị, userId bạn cần có.

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 các 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 lượt tương tác trực tuyến với các sự kiện Data Manager API bằ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 các lượt tương tác trực tuyến bằ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 về sự đồng ý của người dùng trực tiếp trên từng sự kiện bằng đối tượng consent.

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

Google Analytics tự động kết hợp thông tin mới nhất về thiết bị và vị trí địa lý từ việc gắn thẻ với các sự kiện Data Manager API bằ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 có chứa phương diện về thiết bị và vị trí địa lý.

Nếu bạn muốn một sự kiện Data Manager API phản ánh thông tin về thiết bị và vị trí địa lý 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 về vị trí địa lý và thông tin về 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 chỉ có thể xem một phần báo cáo. Mục đích của Data Manager API là bổ sung cho 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 quá trình 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 quy tắc tạo hoặc đổi tên sự kiện. Ứng dụng của bạn nên 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.

Tiếp

Gửi sự kiện