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 chế độ hoạt động theo khu vực cụ thể cho các thẻ để sử dụng các tính năng như chế độ đồng ý nâng cao, cũng như để 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:

• Thiết lập vùng chứa phía máy chủ trong Trình quản lý thẻ
• Thiết lập máy chủ gắn thẻ
• Thiết lập tính năng phân phát tập lệnh của bên thứ nhất

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

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

Bạn có thể bắt đầu trực tiếp ở Bước 2 nếu:

• Bạn sử dụng App Engine. App Engine tự động gửi tiêu đề địa lý.
• Nhà cung cấp cơ sở hạ tầng mà bạn sử dụ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 bằng Trình cân bằng tải của GCP

Bạn có thể gửi thông tin vị trí địa lý với tất cả tiêu đề của yêu cầu HTTP hoặc đối với các yêu cầu cụ thể. Vì việc thêm tiêu đề của yêu cầu tuỳ chỉnh sẽ phát sinh một khoản phí trên cơ sở 1 triệu yêu cầu, nên bạn chỉ nên cung cấp thông tin địa lý cho các yêu cầu phân phát tập lệnh của Google. Lựa chọn này ban đầu yêu cầu bạn phải thiết lập nhiều hơn nhưng lại giúp bạn chạy cơ sở hạ tầng của mình 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. Mở trình cân bằng tải GCP
2. Trong trình cân bằng tải, hãy mở mục Cấu hình phụ trợ. Tạo một dịch vụ phụ trợ mới.
   
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 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 máy chủ.
   • Trong phần Phần phụ trợ mới, hãy chọn nhóm điểm cuối mạng của quá trình triển khai Trình quản lý thẻ phía máy chủ.
     
4. Mở phần Cấu hình nâng cao. Thêm tiêu đề của yêu cầu tuỳ chỉnh.
   

   Tên tiêu đề	Giá trị tiêu đề
   Quốc gia X-Gclb	{client_region}
   Vùng X-Gclb	{client_region_subdivision}

5. Lưu dịch vụ phụ trợ mới.

Để định cấu hình các 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. 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 để ánh xạ 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 định vị vị trí cùng với tất cả các yêu cầu HTTP, bạn cần thêm tiêu đề của yêu cầu tuỳ chỉnh vào dịch vụ phụ trợ hiện có. Hãy xem tài liệu của 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ý với tất cả tiêu đề của yêu cầu HTTP hoặc đối với các yêu cầu cụ thể. Vì việc thêm tiêu đề của yêu cầu tuỳ chỉnh sẽ phát sinh một khoản phí trên cơ sở 1 triệu yêu cầu, nên bạn chỉ nên cung cấp thông tin địa lý cho các yêu cầu phân phát tập lệnh của Google. Lựa chọn này ban đầu yêu cầu bạn phải thiết lập nhiều hơn nhưng lại giúp bạn chạy cơ sở hạ tầng của mình 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. Mở trình cân bằng tải GCP
2. Trong trình cân bằng tải, hãy mở mục Cấu hình phụ trợ. Tạo một dịch vụ phụ trợ mới.
   
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 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 máy chủ.
   • Trong phần Phần phụ trợ mới, hãy chọn nhóm điểm cuối mạng của quá trình triển khai Trình quản lý thẻ phía máy chủ.
     
4. Mở phần Cấu hình nâng cao. Thêm tiêu đề của yêu cầu tuỳ chỉnh.
   

   Tên tiêu đề	Giá trị tiêu đề
   Quốc gia X-Gclb	{client_region}
   Vùng X-Gclb	{client_region_subdivision}

5. Lưu dịch vụ phụ trợ mới.

Để định cấu hình các 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. 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 để ánh xạ 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 định vị vị trí cùng với tất cả các yêu cầu HTTP, bạn cần thêm tiêu đề của yêu cầu tuỳ chỉnh vào dịch vụ phụ trợ hiện có. Hãy xem tài liệu của 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 đây cùng với các giá trị của chúng:

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 mục của người dùng

Cửa trước Azure

Sử dụng Rules Engine (Công cụ quy tắc) để tạo một bộ quy tắc có thao tác sửa đổi tiêu đề yêu cầu với sơ đồ liên kết sau:

Tên tiêu đề	Giá trị tiêu đề
Quốc gia X-Azure	{geo_country}

Cloudflare

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

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

Tên tiêu đề	Giá trị tiêu đề
Quốc gia CF-IP	Quốc gia của người dùng

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 các tiêu đề địa lý như đã chỉ định ở trên, thì 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 đề của yêu cầu HTTP. Ngoài ra, bạn có thể thiết lập tiêu đề tuỳ chỉnh.

Phát hiện tự động

1. Mở Trình quản lý thẻ của Google
2. Mở vùng chứa phía máy chủ của bạn.
3. Trong trình đơn Biến, hãy Đị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.

Các tiêu đề địa lý hiện đã có sẵn để sử dụng 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 phía máy chủ của bạn.
3. Trong trình đơn Biến, hãy tạo 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 Cấu hình biến, hãy chọn Biến tuỳ chỉnh.

5. Trong trình đơn Biến, hãy tạo 2 biến 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 mục. Điền các giá trị bằng mã quốc gia trong(các) tiêu đề của yêu cầu HTTP.

   Lưu ý: Định dạng này phải tuân thủ ISO-3166-2.

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

   

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 khách của mình.

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

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

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

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

4. Lưu khách hàng của bạn.

Bước 4: Xác minh rằng các chế độ cài đặt khu vực đã được áp dụng

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

1. Mở Chế độ xem trước cho vùng chứa phí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 máy khách Đã xác nhận Google Analytics GA4 hoặc Universal Analytics.
4. Để xem khu vực thực tế, hãy thay đổi nút chọn Biến hiển thị thành các giá trị.
   • ✅ Cách triển khai của bạn là chính xác nếu thuộc tính Region (Khu vực) hiển thị mã quốc gia.
   • ❌ Nếu thuộc tính Region (Khu vực) hiển thị undefined hoặc bị thiếu dữ liệu thì máy chủ của bạn hiện 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 bài viết Thiết lập tiêu đề yêu cầu.

Các bước tiếp theo

• Thiết lập chế độ đồng ý cho một khu vực cụ thể trong vùng chứa trên web