Gửi dữ liệu đến Trình quản lý thẻ phía máy chủ

Bài viết này mô tả các cách gửi sự kiện đến vùng chứa phía máy chủ. Nếu bạn cần thêm thông tin cơ bản, hãy xem cách hoạt động của tính năng gắn thẻ phía máy chủ.

Bài viết này trình bày cách:

Gửi dữ liệu từ một trang web đến vùng chứa phía máy chủ
Gửi dữ liệu bổ sung đến vùng chứa của máy chủ
Nhận dữ liệu trong vùng chứa phía máy chủ
Gửi dữ liệu từ các nguồn không phải là trang web

Trước khi bắt đầu

Hướng dẫn này giả định rằng bạn đã có:

1. Gửi dữ liệu từ một trang web đến vùng chứa phía máy chủ

Bạn có thể định tuyến dữ liệu thông qua một quy trình triển khai phía máy chủ thông qua Trình quản lý thẻ hoặc gtag.js. Chọn phương thức triển khai.

Chọn phương án triển khai.

Không bắt buộc: Gửi thông số bổ sung cho mỗi sự kiện

Bạn có thể gửi thêm 2 loại thông số bổ sung: Thông số ở cấp cấu hình và thông số ở cấp sự kiện. Các thông số cấu hình ảnh hưởng đến cách thẻ Google hoạt động và bạn chỉ có thể đặt các thông số này ở cấp thẻ Google.

Thông số sự kiện chỉ định thông tin bổ sung về một sự kiện và có thể được đặt cho tất cả sự kiện, một số sự kiện hoặc sự kiện page_view.

Chọn phương án triển khai.

Đề xuất thiết lập

Bạn nên sử dụng thẻ GA4 trên một trang web để gửi dữ liệu đến vùng chứa máy chủ. Thẻ này có thể sử dụng nhiều phương thức truyền tải để đảm bảo tỷ lệ phân phối sự kiện cao nhất. Những phương thức như vậy bao gồm nhưng không giới hạn ở

Điểm ảnh hình ảnh
Fetch API
XHR
Trình chạy dịch vụ chạy trong một iframe được tải từ miền vùng chứa phía máy chủ của bạn.

Để đảm bảo rằng tất cả các phương thức đều được hỗ trợ, hãy kiểm tra những điều sau:

Chính sách bảo mật nội dung (CSP)

Chỉ thị	Nội dung	Mục đích
img-src	[SERVER_CONTAINER_URL]	Yêu cầu đo lường
connect-src	[SERVER_CONTAINER_URL]	Yêu cầu đo lường
frame-src	[SERVER_CONTAINER_URL]	Triển khai trình chạy dịch vụ

Ngoài ra, X-Frame-Options không được hạn chế việc tải iframe từ URL của vùng chứa phía máy chủ.

Tham khảo https://developers.google.com/tag-platform/security/guides/csp để biết các chính sách cụ thể theo từng sản phẩm.

2. Nhận dữ liệu trong vùng chứa phía máy chủ

Khi bạn gửi yêu cầu HTTP đến một vùng chứa máy chủ, máy khách phải xác nhận yêu cầu đó.

Cách xem danh sách các ứng dụng khách hiện có:

Mở Trình quản lý thẻ của Google
Mở vùng chứa máy chủ.
Trong thanh điều hướng ở bên trái, hãy nhấp vào Khách hàng. Theo mặc định, ứng dụng GA4 được cài đặt sẵn trên vùng chứa phía máy chủ.
Nhấp vào tên của khách hàng để xem hoặc chỉnh sửa thông tin chi tiết.

Chế độ cài đặt không bắt buộc cho ứng dụng

Trong hầu hết các trường hợp, bạn không cần sửa đổi máy khách. Tuy nhiên, trường hợp sử dụng của bạn có thể khác và bạn có thể muốn chỉnh sửa một trong các chế độ cài đặt sau:

Mức độ ưu tiên: Xác định thứ tự chạy của các ứng dụng. Các số cao hơn sẽ chạy trước và ứng dụng đầu tiên phù hợp với yêu cầu đến sẽ trở thành ứng dụng hoạt động cho yêu cầu đó.
Tiêu chí kích hoạt: Tiêu chí kích hoạt xác định thời điểm ứng dụng sẽ phản hồi các yêu cầu:
- Đường dẫn gtag.js mặc định cho các mã nhận dạng cụ thể: Sử dụng chế độ cài đặt này để bật tính năng phân phát JavaScript gtag.js thông qua URL vùng chứa máy chủ của bạn. Khi được bật, ứng dụng này sẽ kích hoạt theo các yêu cầu đến đường dẫn yêu cầu gtag.js mặc định, ví dụ: /gtag/js?id=TAG_ID. Nhấp vào Thêm mã đo lường để thêm một hoặc nhiều mã nhận dạng đích đến.

Không bắt buộc: Nhận thêm dữ liệu trong Trình quản lý thẻ phía máy chủ

Nếu đang gửi các thông số bổ sung, bạn cần thiết lập máy khách Google Analytics 4 trong vùng chứa máy chủ để phân tích cú pháp các thông số bổ sung và tạo dữ liệu sự kiện từ các thông số đó.

Một số thẻ máy chủ sẽ bao gồm các thông số bổ sung trong yêu cầu gửi đi mà không cần thiết lập. Để loại trừ những thông số đó, hãy tạo một Phép biến đổi để xoá giá trị.

Cách sử dụng các thông số bổ sung trong những thẻ khác:

Trong vùng chứa máy chủ, hãy nhấp vào Biến trong trình đơn điều hướng bên trái.
Tạo một Biến mới do người dùng xác định.
Trong mục Cấu hình biến, hãy chọn loại biến Dữ liệu sự kiện.
Trong Đường dẫn khoá, hãy nhập tên của thông số.
Đặt tên cho biến, rồi nhấp vào Lưu.

Giờ đây, bạn có thể sử dụng tham số sự kiện trong bất kỳ thẻ nào khác trong vùng chứa máy chủ.

3. Không bắt buộc: Gửi dữ liệu từ các nguồn không phải là trang web

Bạn có thể sử dụng Measurement Protocol của Google Analytics để bật tính năng hỗ trợ gắn thẻ phía máy chủ từ các nguồn như ứng dụng di động và ứng dụng từ máy chủ đến máy chủ. Tuỳ chọn này cho phép bạn gửi sự kiện đến vùng chứa ở định dạng Measurement Protocol. Vùng chứa sẽ gửi những sự kiện đó đến Google Analytics bằng cơ chế tương tự như tất cả các sự kiện SGTM khác.

Lựa chọn này không hỗ trợ tất cả các tính năng của điểm cuối Measurement Protocol, chẳng hạn như việc lấy thông tin về vị trí địa lý và thiết bị từ các sự kiện gắn thẻ.

Ứng dụng di động

Để ứng dụng Android hoặc iOS của bạn gửi dữ liệu đến vùng chứa phía máy chủ, bạn sẽ tạo một thẻ hình ảnh tuỳ chỉnh và định cấu hình thẻ đó để sử dụng Measurement Protocol:

Trong vùng chứa dành cho thiết bị di động (Android hoặc iOS), hãy nhấp vào Thẻ > Mới.
Trong phần Cấu hình thẻ, hãy chọn loại thẻ Hình ảnh tuỳ chỉnh.
Đặt giá trị của URL hình ảnh thành một hình ảnh pixel trên vùng chứa máy chủ tại đường dẫn trong ứng dụng Measurement Protocol mà bạn đã chỉ định trước đó. Thêm mọi tham số Measurement Protocol mong muốn vào cuối URL pixel của bạn:
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
Bỏ chọn Bật tính năng chặn truy xuất bộ nhớ đệm.
Lưu thẻ và xuất bản vùng chứa.
Trong vùng chứa phía máy chủ, hãy nhấp vào Khách hàng > Mới.
Trong Cấu hình ứng dụng khách, hãy chọn loại ứng dụng khách Measurement Protocol.
Đặt Đường dẫn kích hoạt thành đường dẫn của điểm cuối thu thập dữ liệu của ứng dụng.
Lưu cấu hình máy khách và xuất bản vùng chứa phía máy chủ.

Ứng dụng máy chủ đến máy chủ

Để gửi dữ liệu giao thức đo lường đến vùng chứa máy chủ, hãy thay thế tên máy chủ www.google-analytics.com bằng tên miền của vùng chứa máy chủ. Ví dụ:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Để nhận lượt truy cập Measurement Protocol, hãy định cấu hình chế độ cài đặt Trình quản lý thẻ phía máy chủ bằng một ứng dụng Measurement Protocol:

Trong vùng chứa phía máy chủ, hãy nhấp vào Khách hàng > Mới.
Trong Cấu hình ứng dụng khách, hãy chọn loại ứng dụng khách Measurement Protocol.
Đặt Đường dẫn kích hoạt thành đường dẫn của điểm cuối trên máy chủ.
Lưu cấu hình ứng dụng và xuất bản vùng chứa.

Các bước tiếp theo

Để gửi dữ liệu trong bối cảnh thực sự của bên thứ nhất, bạn cần phân phát các tập lệnh của Google (chẳng hạn như thư viện Google Analytics) từ máy chủ của riêng mình.

Tải tập lệnh Google thông qua máy chủ của tôi