Thiết lập chế độ bên thứ nhất

Tài liệu này dành cho những người dùng muốn triển khai thẻ Google ở chế độ bên thứ nhất. Bạn nên sử dụng chế độ bên thứ nhất để định cấu hình thẻ bền vững nhất.

Tổng quan

Chế độ bên thứ nhất cho phép bạn triển khai thẻ Google bằng cách sử dụng cơ sở hạ tầng của bên thứ nhất của riêng bạn, được lưu trữ trên miền của trang web (ví dụ: example.com). Cơ sở hạ tầng này nằm giữa trang web của bạn và các dịch vụ của Google, giúp cơ sở hạ tầng bên thứ nhất của bạn trở thành công nghệ duy nhất để tương tác trực tiếp với người dùng trang web của bạn. Chế độ bên thứ nhất bổ sung một lớp bảo mật dữ liệu và cho phép thực hiện thêm các chế độ kiểm soát quyền riêng tư đối với dữ liệu (chẳng hạn như làm rối mã nguồn toàn bộ IP) mà không ảnh hưởng đến kết quả đo lường của bạn. Cách thiết lập trong tài liệu này sẽ giúp bạn khôi phục thêm X% tín hiệu đo lường trên trang web của mình. Bạn có thể thiết lập tính năng này bằng cách sử dụng Mạng phân phối nội dung (CDN), trình cân bằng tải hoặc máy chủ web hiện có để bật chế độ bên thứ nhất.

Trong cách thiết lập thẻ Google chuẩn, trang web của bạn yêu cầu một thẻ Google từ một miền Google (ví dụ: www.googletagmanager.com). Khi được kích hoạt, thẻ sẽ gửi các yêu cầu đo lường trực tiếp đến sản phẩm của Google. Ở chế độ bên thứ nhất, trang web của bạn sẽ tải thẻ Google từ miền của bên thứ nhất (ví dụ: example.com). Khi được kích hoạt, thẻ sẽ gửi các yêu cầu đo lường đến miền của bên thứ nhất, nơi các yêu cầu này sẽ được chuyển tiếp đến sản phẩm có liên quan của Google.

Bạn sẽ có thể đo lường liên tục khi chuyển từ cấu hình thẻ Google chuẩn sang cấu hình chế độ bên thứ nhất.

Sơ đồ này thể hiện luồng thông tin ở chế độ bên thứ nhất:

cấu trúc chế độ của bên thứ nhất

Trước khi bắt đầu

Hướng dẫn này giả định rằng trang web của bạn đã được định cấu hình bằng:

1. Chọn đường dẫn phân phát thẻ

Bạn phải đặt trước đường dẫn trên miền trang web để phân phát thẻ. Hãy đảm bảo rằng đường dẫn này chưa được sử dụng trên miền của bạn.

Chọn bất kỳ đường dẫn nào mà bạn muốn để thiết lập chế độ bên thứ nhất. Ví dụ về các đường dẫn bạn có thể muốn sử dụng bao gồm: /metrics, /securemetric, /analytics hoặc tốt nhất là một chuỗi chữ và số ngẫu nhiên mà bạn chưa sử dụng trên trang web của mình.

Điền vào các trường sau để điền các ví dụ trong tài liệu này.

Your domain: example.com
Google tag ID: GTM-123456
Tag serving path: /metrics

2. Giao thông tuyến đường

Phần này giả định rằng trang web của bạn đang sử dụng một CDN hoặc trình cân bằng tải có hỗ trợ định tuyến lưu lượng truy cập theo đường dẫn.

Google Cloud

Bạn cần thiết lập một phần phụ trợ mới giúp tra cứu vị trí địa lý gần đúng của khách truy cập trang web và tạo các quy tắc định tuyến trong Trình cân bằng tải ứng dụng bên ngoài hiện tại.

Tạo phần phụ trợ mới

  1. Mở trình cân bằng tải GCP

  2. Trong trình cân bằng tải, hãy mở phần Backend configuration (Cấu hình phụ trợ). Tạo một dịch vụ phụ trợ mới. Ảnh chụp màn hình chế độ cài đặt cấu hình phụ trợ

  3. Định cấu hình dịch vụ phụ trợ mới bằng thông tin về vị trí địa lý:

    • Chỉ định một tên, chẳng hạn như measurement-be-svc.
    • Đặt Loại phụ trợ thành Nhóm thiết bị đầu cuối mạng Internet.
    • Đặt Giao thức thành HTTPS và để Thời gian chờ làm giá trị được điền sẵn.
    • Trong phần Phụ trợ, hãy nhấp vào trình đơn thả xuống Nhóm thiết bị đầu cuối mạng Internet rồi tạo một nhóm thiết bị đầu cuối mới trên mạng Internet:
      • Đặt Loại nhóm thiết bị đầu cuối mạng thành Internet NEG (Toàn cầu, theo khu vực).
      • Đặt Phạm vi thành Toàn cầu.
      • Đặt tuỳ chọn Add through (Thêm thông qua) thành Cổng và tên miền đủ điều kiện.
      • Đặt Tên miền đủ điều kiện thành GTM-123456.fps.goog.
      • Nhấp vào TẠO để tạo điểm cuối.
      • Đóng thẻ Nhóm thiết bị đầu cuối mạng để quay lại thẻ Dịch vụ phụ trợ mới.
    • Tìm tên của nhóm thiết bị đầu cuối trên mạng mới rồi chọn nhóm đó.
    • Mở phần Cấu hình nâng cao. Thêm các tiêu đề tuỳ chỉnh sau đây cho yêu cầu.
      Tên tiêu đề Giá trị tiêu đề
      Host GTM-123456.fps.goog
      X-Gclb-Country {client_region}
      X-Gclb-Region {client_region_subdivision}
    • Xem lại các chế độ cài đặt khác. Bạn không cần phải sử dụng Cloud CDN và Cloud Armor cho tính năng tích hợp này. Vì vậy, bạn có thể tắt cả hai tuỳ chọn một cách an toàn.
    • Lưu dịch vụ phụ trợ mới.

Định cấu hình quy tắc định tuyến

  1. Trong trình cân bằng tải, hãy mở phần Quy tắc định tuyến.

  2. Thêm các quy tắc đường dẫn và máy chủ lưu trữ sau đây:

    Thành phần lưu trữ Đường dẫn Phần phụ trợ
    * /metrics/* measurement-be-svc

  3. Cập nhật cấu hình trình cân bằng tải.

  4. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang phải có văn bản ok. Xác minh rằng bạn đang thêm thông tin địa lý bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang phải có văn bản ok.

Mây

Để phân phát thẻ ở chế độ bên thứ nhất, bạn sẽ tạo mục nhập CNAME cho miền con mới, tạo Quy tắc gốc để chuyển tiếp yêu cầu và tạo Quy tắc chuyển đổi để bao gồm thông tin vị trí địa lý.

Tạo mục CNAME

Chọn một miền con để đặt trước cho mục nhập CNAME. Hãy điền thông tin sau đây để điền sẵn các ví dụ trong suốt tài liệu này. CNAME này không bao giờ được hiển thị bên ngoài cấu hình Cloudflare của bạn, vì vậy, bạn có thể tuỳ ý đặt tên.

CNAME subdomain: fps
  1. Trong thẻ DNS, hãy mở phần Bản ghi.
  2. Thêm một bản ghi mới có cấu hình như sau:
    • Đặt Type (Loại) thành CNAME.
    • Đặt Name (Tên) thành fps.
    • Đặt Target (Mục tiêu) thành GTM-123456.fps.goog.
  3. Lưu bản ghi CNAME.

Tạo quy tắc điểm gốc

  1. Trong thẻ Quy tắc, hãy mở Quy tắc gốc rồi tạo quy tắc.
  2. Nhập tên quy tắc, chẳng hạn như Route measurement.
  3. So khớp các yêu cầu nhận được dựa trên Biểu thức bộ lọc tuỳ chỉnh và nhấp vào Chỉnh sửa biểu thức.
  4. Dán biểu thức sau vào trình tạo: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
  5. Cập nhật Tiêu đề máy chủ lưu trữ thành Viết lại thành... GTM-123456.fps.goog.
  6. Cập nhật Bản ghi DNS thành Ghi đè tới... fps.example.com.
  7. Lưu quy tắc nguồn gốc.
  8. Nếu có các Quy tắc gốc khác, hãy tăng vị trí của Quy tắc mới tạo để chạy sau mọi đường dẫn ký tự đại diện khác.
  9. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang phải có ok.

Bao gồm thông tin vị trí địa lý

  1. Trong tab Quy tắc, mở Quy tắc chuyển đổi.
  2. Tạo quy tắc Modify Request Header (Sửa đổi tiêu đề của yêu cầu).
  3. Áp dụng quy tắc cho Tất cả yêu cầu được gửi đến.
  4. Sửa đổi tiêu đề của yêu cầu bằng cấu hình sau:
    • Đặt toán tử thành Đặt động.
    • Đặt Header name (Tên tiêu đề) thành X-CfIpCountryRegion.
    • Đặt Giá trị thành ip.src.subdivision_1_iso_code.
  5. Triển khai quy tắc biến đổi.
  6. Đợi vài phút để quy tắc này có hiệu lực. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang sẽ có nội dung ok.

(Không bắt buộc) Xoá tiêu đề IP của khách truy cập

Chế độ bên thứ nhất không yêu cầu IP của khách truy cập để hoạt động chính xác. Bạn có thể xoá tất cả tiêu đề IP của khách truy cập bằng cách sử dụng Xoá tiêu đề IP của khách truy cập được Quản lý.

Khác

Để phân phát thẻ ở chế độ bên thứ nhất, bạn cần định cấu hình CDN hoặc trình cân bằng tải để định tuyến yêu cầu đến điểm cuối của chế độ bên thứ nhất.

  1. Thêm một nguồn gốc hoặc phần phụ trợ trỏ đến GTM-123456.fps.goog.
  2. Ghi đè tiêu đề Máy chủ lưu trữ thành GTM-123456.fps.goog. Cho phép chuyển tiếp tất cả cookie và chuỗi truy vấn.
  3. Thêm quy tắc về đường dẫn cho /metrics/* để định tuyến lưu lượng truy cập đến chế độ của bên thứ nhất.
  4. Định cấu hình đường dẫn dành riêng có mức độ ưu tiên cao hơn so với quy tắc mặc định.
  5. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang phải có ok.

Bước 3: Cập nhật tập lệnh trên trang web để sử dụng Lộ trình đo lường

Thay thế các tập lệnh trên mỗi trang của trang web bằng một trong các tập lệnh sau:

gtag.js

Ở đầu mục <head>, hãy tìm hai dòng tập lệnh có mã thẻ Google của bạn:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GTM-123456"></script>

và thay thế chúng bằng lộ trình đo lường:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

Ở đầu mục <head>, hãy thay thế đoạn mã Trình quản lý thẻ bằng đoạn mã sau:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Bước 4: Kiểm tra chế độ thiết lập tính năng đo lường

Để kiểm thử chế độ thiết lập tính năng đo lường, hãy định cấu hình vùng chứa để có ít nhất một thẻ được kích hoạt.

  1. Chuyển đến Tag Assistant rồi xem trước vùng chứa của bạn. Di chuyển trong trang web của bạn để kích hoạt thẻ.

  2. Trong thẻ Tóm tắt > Kết quả > Số lần truy cập đã gửi, hãy xác minh rằng các lượt truy cập được chuyển đến /metrics.

    Ảnh chụp màn hình xác minh chế độ thiết lập

Bước 5: Phản hồi

Hãy cung cấp ý kiến phản hồi về chế độ bên thứ nhất thông qua biểu mẫu phản hồi.