Cho phép thẻ hoạt động theo khu vực cụ thể

Bài viết này dành cho những nhà phát triển phân phát tập lệnh Google từ máy chủ của riêng họ. Bạn nên bật hành vi theo khu vực cho thẻ để sử dụng các tính năng như chế độ đồng ý nâng cao và để kiểm soát hành vi của thẻ dựa trên vị trí của người dùng.

Trước khi bắt đầu

Hướng dẫn này giả định rằng bạn đã làm xong những việc sau:

Bước 1: Thiết lập tiêu đề yêu cầu

Bạn cần gửi các tiêu đề yêu cầu cụ thể chứa thông tin về khu vực của người dùng, như mô tả trong các phần dưới đây.

Bạn có thể bắt đầu ngay từ Bước 2 nếu:

  • Bạn sử dụng App Engine. App Engine tự động gửi tiêu đề địa lý.
  • Bạn sử dụng một nhà cung cấp cơ sở hạ tầng khác với những nhà cung cấp được liệt kê bên dưới. Bạn cần thiết lập tiêu đề tuỳ chỉnh.

Cloud Run với Trình cân bằng tải GCP

Bạn có thể gửi thông tin vị trí địa lý bằng tất cả tiêu đề yêu cầu HTTP hoặc cho các yêu cầu cụ thể. Vì việc thêm tiêu đề yêu cầu tuỳ chỉnh sẽ phải trả phí trên cơ sở mỗi 1 triệu yêu cầu, nên bạn chỉ nên thêm thông tin vị trí địa lý cho các yêu cầu phân phát tập lệnh của Google. Ban đầu, tuỳ chọn này đòi hỏi bạn phải thiết lập nhiều hơn nhưng giúp bạn vận hành cơ sở hạ tầng một cách tiết kiệm nhất có thể.

Yêu cầu tập lệnh

Để chỉ đưa tiêu đề địa lý vào các yêu cầu tập lệnh, bạn cần thiết lập một phần phụ trợ mới và tạo các quy tắc định tuyến.

Cách tạo phần phụ trợ mới:

  1. Trình cân bằng tải GCP mở
  2. Trong bộ cân bằng tải, hãy mở phần 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:
    • Loại phần phụ trợ: chọn loại nhóm điểm cuối của mạng mà ứng dụng của bạn sử dụng. Nếu bạn sử dụng Cloud Run, hãy chọn Nhóm điểm cuối mạng không có máy chủ.
    • Trong phần Phần phụ trợ mới, hãy chọn nhóm điểm cuối của mạng trong quá trình triển khai Trình quản lý thẻ phía máy chủ.
      Ảnh chụp màn hình dịch vụ phụ trợ mới
  4. Mở phần Cấu hình nâng cao. Thêm tiêu đề yêu cầu tuỳ chỉnh.
    Tên tiêu đề Giá trị tiêu đề
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Lưu dịch vụ phụ trợ mới.

Cách định cấu hình quy tắc định tuyến:

  1. Trong bộ cân bằng tải, hãy mở mục Quy tắc định tuyến. Chọn chế độ Quy tắc và đường dẫn máy chủ lưu trữ nâng cao.
  2. Cập nhật tham số pathRules để liên kết gtm.js, /gtag/js và /gtag/destination với dịch vụ phụ trợ mới.
    pathRules:
- paths:
  - /gtm.js
  - /gtag*
  service: projects/project_id/global/backendServices/new backend service
- paths:
  - /*
  service: projects/project_id/global/backendServices/original backend service
  3. Lưu các thay đổi.

Tất cả yêu cầu

Để gửi thông tin vị trí địa lý với tất cả các yêu cầu HTTP, bạn cần thêm tiêu đề yêu cầu tuỳ chỉnh vào dịch vụ phụ trợ hiện có, hãy xem tài liệu về Google Cloud. Tạo một tiêu đề yêu cầu tuỳ chỉnh mới cho mỗi tiêu đề bên dưới:

Tên tiêu đề Giá trị tiêu đề
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

Trình cân bằng tải GCP

Bạn có thể gửi thông tin vị trí địa lý bằng tất cả tiêu đề yêu cầu HTTP hoặc cho các yêu cầu cụ thể. Vì việc thêm tiêu đề yêu cầu tuỳ chỉnh sẽ phải trả phí trên cơ sở mỗi 1 triệu yêu cầu, nên bạn chỉ nên thêm thông tin vị trí địa lý cho các yêu cầu phân phát tập lệnh của Google. Ban đầu, tuỳ chọn này đòi hỏi bạn phải thiết lập nhiều hơn nhưng giúp bạn vận hành cơ sở hạ tầng một cách tiết kiệm nhất có thể.

Yêu cầu tập lệnh

Để chỉ đưa tiêu đề địa lý vào các yêu cầu tập lệnh, bạn cần thiết lập một phần phụ trợ mới và tạo các quy tắc định tuyến.

Cách tạo phần phụ trợ mới:

  1. Trình cân bằng tải GCP mở
  2. Trong bộ cân bằng tải, hãy mở phần 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:
    • Loại phần phụ trợ: chọn loại nhóm điểm cuối của mạng mà ứng dụng của bạn sử dụng. Nếu bạn sử dụng Cloud Run, hãy chọn Nhóm điểm cuối mạng không có máy chủ.
    • Trong phần Phần phụ trợ mới, hãy chọn nhóm điểm cuối của mạng trong quá trình triển khai Trình quản lý thẻ phía máy chủ.
      Ảnh chụp màn hình dịch vụ phụ trợ mới
  4. Mở phần Cấu hình nâng cao. Thêm tiêu đề yêu cầu tuỳ chỉnh.
    Tên tiêu đề Giá trị tiêu đề
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Lưu dịch vụ phụ trợ mới.

Cách định cấu hình quy tắc định tuyến:

  1. Trong bộ cân bằng tải, hãy mở mục Quy tắc định tuyến. Chọn chế độ Quy tắc và đường dẫn máy chủ lưu trữ nâng cao.
  2. Cập nhật tham số pathRules để liên kết gtm.js, /gtag/js và /gtag/destination với dịch vụ phụ trợ mới.
    pathRules:
- paths:
  - /gtm.js
  - /gtag*
  service: projects/project_id/global/backendServices/new backend service
- paths:
  - /*
  service: projects/project_id/global/backendServices/original backend service
  3. Lưu các thay đổi.

Tất cả yêu cầu

Để gửi thông tin vị trí địa lý với tất cả các yêu cầu HTTP, bạn cần thêm tiêu đề yêu cầu tuỳ chỉnh vào dịch vụ phụ trợ hiện có, hãy xem tài liệu về Google Cloud. Tạo một tiêu đề yêu cầu tuỳ chỉnh mới cho mỗi tiêu đề bên dưới:

Tên tiêu đề Giá trị tiêu đề
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

CloudFront của Amazon Web Services (AWS)

Tạo chính sách yêu cầu nguồn gốc để thêm tiêu đề CloudFront-Viewer-Country và CloudFront-Viewer-Country-Region vào yêu cầu.

Thao tác này sẽ tự động thêm các tiêu đề sau cùng với giá trị của các tiêu đề đó:

Tên tiêu đề Giá trị tiêu đề
CloudFront-Viewer-Country Quốc gia của người dùng
CloudFront-Viewer-Country-Region Phân khu của người dùng
Chế độ cài đặt tiêu đề trong AWS CloudFront

Azure Front Door

Sử dụng Rule Engine (Công cụ quy tắc), hãy tạo một nhóm quy tắc bằng thao tác sửa đổi tiêu đề yêu cầu với mối liên kết sau:

Tên tiêu đề Giá trị tiêu đề
X-Azure-Country {geo_country}
Ảnh chụp màn hình cấu hình của Azure Front Door

Cloudflare

Bật tuỳ chọn "Thêm tiêu đề vị trí của khách truy cập" trong phần phép biến đổi được quản lý:

Thao tác này sẽ tự động thêm tiêu đề sau cùng với giá trị của tiêu đề đó:

Tên tiêu đề Giá trị tiêu đề
CF-IPCountry Quốc gia của người dùng
Ảnh chụp màn hình cấu hình cloudflare

Bước 2: Thiết lập biến Khu vực của khách truy cập

Nếu bạn đã thiết lập tiêu đề địa lý như đã chỉ định ở trên, Trình quản lý thẻ sẽ tự động phát hiện khu vực hoặc quốc gia bằng cách đọc tiêu đề yêu cầu HTTP. Ngoài ra, bạn có thể thiết lập tiêu đề tuỳ chỉnh.

Tự động phát hiện

  1. Mở Trình quản lý thẻ của Google
  2. Mở vùng chứa máy chủ.
  3. Trong trình đơn Variables (Biến), hãy Configure (Định cấu hình) danh sách các biến tích hợp.
  4. Chọn Khu vực của khách truy cập.

Giờ đây, bạn có thể sử dụng tiêu đề địa lý trong biến Khu vực của khách truy cập.

Tiêu đề tuỳ chỉnh

  1. Mở Trình quản lý thẻ của Google
  2. Mở vùng chứa máy chủ.
  3. Trong trình đơn Biến, hãy tạo một biến Mới do người dùng xác định thuộc loại Khu vực của khách truy cập.
  4. Trong phần Cấu hình biến, hãy chọn Biến tuỳ chỉnh.

  5. Trong trình đơn Variables (Biến), hãy tạo hai biến Request header (Tiêu đề yêu cầu) mới: Một biến cho quốc gia của bạn và một biến cho mã phân khu. Điền các giá trị bằng mã quốc gia trong(các) tiêu đề yêu cầu HTTP.

  6. Sử dụng các biến bạn đã tạo trong biến Khu vực của khách truy cập như minh hoạ trong ảnh chụp màn hình.

    Ảnh chụp màn hình chế độ cài đặt biến

  7. Đặt tên cho biến rồi Lưu.

Bước 3: Bật chế độ cài đặt theo khu vực cụ thể trong ứng dụng

Để sử dụng khu vực của khách truy cập nhằm xử lý các yêu cầu HTTP đến, bạn phải thêm khu vực đó vào ứng dụng.

  1. Chọn ứng dụng hoặc tạo ứng dụng mới mà bạn muốn áp dụng chế độ cài đặt khu vực. Các ứng dụng được hỗ trợ là:

    • Trình quản lý thẻ của Google: Vùng chứa trên web
    • Google Analytics: GA4

  2. Nếu bạn đang định cấu hình ứng dụng GA4, hãy đánh dấu vào hộp Đường dẫn gtag.js mặc định cho các mã nhận dạng cụ thể rồi nhập mã đo lường của vùng chứa web.

  3. Đánh dấu vào Bật chế độ cài đặt theo khu vực cụ thể. Thêm biến {{Khu vực của khách truy cập}} mà bạn đã tạo ở bước trước vào trường Khu vực.

  4. Lưu ứng dụng khách.

Bước 4: Xác minh rằng chế độ cài đặt theo khu vực có áp dụng hay không

Cách kiểm tra xem chế độ cài đặt của bạn có hoạt động hay không:

  1. Mở Chế độ xem trước cho vùng chứa máy chủ.
  2. Tải trang web của bạn trong khi sử dụng tính năng phân phát của bên thứ nhất.
  3. Trong cửa sổ xem trước, hãy nhấp vào ứng dụng Google Analytics GA4 Đã xác nhận quyền sở hữu. Ảnh chụp màn hình ứng dụng
  4. Để xem vùng thực tế, hãy thay đổi nút chọn Display Variables (Hiển thị biến) thành giá trị. Ảnh chụp màn hình trường khu vực của khách truy cập
    • ✅ Bạn đã triển khai đúng cách nếu thuộc tính Khu vực hiển thị mã quốc gia.
    • ❌ Nếu thuộc tính Khu vực hiển thị undefined hoặc bị thiếu, thì máy chủ của bạn sẽ không nhận được dữ liệu khu vực nào. Kiểm tra xem tiêu đề HTTP của máy chủ có được thiết lập theo các biến được xác định trước mà Trình quản lý thẻ của Google đang tìm kiếm hay không, hãy xem phần Thiết lập tiêu đề yêu cầu.

Các bước tiếp theo