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

Tài liệu này mô tả các cách gửi sự kiện đến một 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ủ.

Tài liệu này thảo luận về cách:

  • Gửi dữ liệu từ một trang web đến vùng chứa phía máy chủ
  • Gửi thêm dữ liệu đến một vùng chứa phí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 đã:

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ủ bằng Trình quản lý thẻ hoặc gtag.js. Chọn phương án triển khai.

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

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

Bạn có thể gửi thêm hai loại tham số bổ sung: Tham số ở cấp cấu hình và tham số ở cấp sự kiện. Tham số cấu hình ảnh hưởng đến cách hoạt động của thẻ Google hoặc thẻ đích đến Google Analytics và chỉ có thể được đặt ở cấp thẻ Google hoặc thẻ đích đến Google Analytics.

Tham 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, chọn sự kiện hoặc sự kiện page_view.

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

Đề xuất về cách thiết lập

Bạn nên sử dụng thẻ Google Analytics trên một trang web để gửi dữ liệu đến vùng chứa phí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 tốt nhất. Các phương thức này bao gồm nhưng không giới hạn ở

  • Điểm ảnh
  • API Tìm nạp
  • 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ủ.

Để đảm bảo rằng tất 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 vùng chứa phía máy chủ.

Hãy tham khảo https://developers.google.com/tag-platform/security/guides/csp để biết các chính sách cụ thể cho 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 phía máy chủ, một ứng dụng phải xác nhận yêu cầu đó.

Cách xem danh sách các ứng dụng có sẵn:

  1. Mở Trình quản lý thẻ của Google

  2. Mở vùng chứa phía máy chủ.

  3. Trong thanh điều hướng ở bên trái, hãy nhấp vào Ứng dụng. Ứng dụng Google Analytics được cài đặt trước trên vùng chứa phía máy chủ theo mặc định.

  4. Nhấp vào tên của ứng dụng để xem hoặc chỉnh sửa thông tin chi tiết.

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

Trong hầu hết các trường hợp, ứng dụng sẽ không yêu cầu sửa đổi. 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 ứng dụng có mức độ ưu tiên cao hơn sẽ chạy trước và ứng dụng đầu tiên trùng khớp với yêu cầu đang đế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 để có thể phân phát tập lệnh JavaScript gtag.js thông qua URL của vùng chứa phía máy chủ. 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 thêm tham số, bạn cần thiết lập ứng dụng Google Analytics trong vùng chứa phía máy chủ để phân tích cú pháp các tham số bổ sung và tạo dữ liệu sự kiện từ các tham số đó.

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

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

  1. Trong vùng chứa phía máy chủ, hãy nhấp vào Biến trong trình đơn điều hướng bên trái.
  2. Tạo một Biến do người dùng xác định mới.
  3. Trong Cấu hình biến, hãy chọn loại biến Dữ liệu sự kiện.
  4. Trong Đường dẫn khoá, hãy nhập tên của tham số.
  5. Đặt tên cho biến rồi 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 phí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 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 các sự kiện đó đến Google Analytics bằng cùng một cơ chế như tất cả các sự kiện SGTM khác.

Tuỳ 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ư 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 ứng dụng 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 tùy chỉnh và định cấu hình thẻ đó để sử dụng Measurement Protocol:

  1. Trong vùng chứa di động (Android hoặc iOS), hãy nhấp vào Thẻ > Mới.
  2. Trong Cấu hình thẻ , hãy chọn loại thẻ Hình ảnh tuỳ chỉnh.
  3. Đặt giá trị của URL hình ảnh thành hình ảnh pixel trên vùng chứa phía máy chủ theo đườ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:
    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
  4. Bỏ chọn Bật tính năng chặn truy xuất bộ nhớ đệm.
  5. Lưu thẻ rồi xuất bản vùng chứa.
  6. Trong vùng chứa phía máy chủ, hãy nhấp vào Ứng dụng > Mới.
  7. Trong Cấu hình ứng dụng, hãy chọn loại ứng dụng Measurement Protocol.
  8. Đặ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.
  9. Lưu cấu hình ứng dụng rồi 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 phí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 phí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 bản cài đặt Trình quản lý thẻ phía máy chủ bằng một ứng dụng Measurement Protocol:

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

Các bước tiếp theo

Để gửi dữ liệu với tư cách là 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 bạn.

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