Bài viết này dành cho những nhà phát triển muốn lưu trữ tính năng gắn thẻ phía máy chủ trong cùng một bối cảnh của bên thứ nhất với trang web của họ. Phân phát cùng nguồn gốc là một phương pháp hay nhất giúp bạn tận dụng các lợi ích về tính bảo mật và bền vững của cookie do máy chủ đặt. Hướng dẫn bên dưới áp dụng cho việc thiết lập tính năng phân phát cùng nguồn gốc bất kể thẻ Google được triển khai trên trang web của bạn là gtag.js hay gtm.js.
Trong lần đầu tiên thiết lập máy chủ gắn thẻ, máy chủ này sẽ được lưu trữ trên một miền do nhà cung cấp dịch vụ đám mây cung cấp. Khi bạn sử dụng điểm cuối mặc định, điểm cuối này sẽ phân phối dữ liệu đến vùng chứa máy chủ, nhưng chạy trong ngữ cảnh của bên thứ ba. Để khai thác các lợi ích của bối cảnh của bên thứ nhất, chẳng hạn như cookie bền hơn, máy chủ gắn thẻ và trang web của bạn phải chạy trên cùng một miền.
Bảng dưới đây minh hoạ cách bạn có thể lưu trữ máy chủ gắn thẻ khi trang web gốc được lưu trữ trên www.example.com:
| Cùng một nguồn gốc (phương pháp hay nhất) | Miền con | Miền mặc định | |
|---|---|---|---|
| URL mẫu | https:/ |
https:/ |
https:/ |
| Quyền truy cập cookie do máy chủ đặt | Có toàn quyền sử dụng các lợi ích về bảo mật và độ bền. | Có toàn quyền sử dụng các lợi ích về bảo mật và độ bền. | Không có. Chỉ có thể đặt cookie Javascript. |
| Độ phức tạp của việc thiết lập | Định cấu hình CDN hoặc trình cân bằng tải để chuyển tiếp yêu cầu. Có thể cần cập nhật các mục DNS. | Cập nhật mục nhập DNS. | Được định cấu hình sẵn. |
Chọn phương thức triển khai để bắt đầu.
Điều kiện tiên quyết
Hướng dẫn này giả định rằng bạn đã:
- Thiết lập vùng chứa máy chủ trong Trình quản lý thẻ
- Thiết lập máy chủ gắn thẻ
- CDN hoặc trình cân bằng tải có thể chuyển tiếp yêu cầu.
- Nếu bạn sử dụng App Engine: Máy chủ gắn thẻ phải chạy phiên bản 2.2.0 trở lên. Để đảm bảo máy chủ gắn thẻ của bạn luôn hoạt động ổn định trong tương lai, hãy di chuyển sang Cloud Run.
Định cấu hình miền tuỳ chỉnh
Bạn có thể thiết lập vùng chứa phía máy chủ để chạy trên một đường dẫn từ cùng một miền với trang web của mình. Ví dụ: nếu trang web của bạn phân phát lưu lượng truy cập web tại www.example.com, hãy đặt trước một đường dẫn như www.example.com/metrics cho vùng chứa phía máy chủ của bạn.
1. Chọn một đường dẫn của miền để sử dụng cho máy chủ gắn thẻ
Đường dẫn này sẽ được dành riêng cho việc triển khai phân phát của bên thứ nhất. Hãy đảm bảo bạn chọn một đường dẫn mà bạn chưa sử dụng.
Sau đây là một số ví dụ về đường dẫn mà bạn có thể muốn sử dụng: /collect, /metrics, /data
Ghi lại chuỗi đường dẫn này. Bạn sẽ sử dụng lớp này trong các bước tiếp theo thay vì /metrics bất cứ khi nào bạn thấy: /metrics
2. Định tuyến lưu lượng truy cập đến máy chủ gắn thẻ
Nếu trang web của bạn đã được thiết lập với một Mạng phân phối nội dung (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, hãy chuyển đến bước 4.
- Thêm một nguồn gốc hoặc phần phụ trợ trỏ đến trang web của bạn.
- Ghi đè tiêu đề Máy chủ lưu trữ thành tên máy chủ của trang web, chẳng hạn như
example.com - Cho phép chuyển tiếp tất cả cookie và chuỗi truy vấn. Nếu nền tảng không cung cấp lựa chọn này, thì hệ thống có khả năng sẽ chuyển tiếp theo mặc định.
- Thêm một nguồn gốc hoặc phần phụ trợ khác trỏ đến máy chủ gắn thẻ của bạn. Đây có thể là miền do nhà cung cấp dịch vụ đám mây cung cấp, chẳng hạn như
metrics.run.app - Ghi đè tiêu đề Máy chủ lưu trữ thành miền được chỉ định ở trên. Cho phép chuyển tiếp tất cả cookie và chuỗi truy vấn.
- Thêm một quy tắc về đường dẫn (chẳng hạn như
/metrics/*) để định tuyến lưu lượng truy cập đến máy chủ gắn thẻ. - Định cấu hình đường dẫn gắn thẻ phía máy chủ dành riêng có mức độ ưu tiên cao hơn so với quy tắc mặc định.
- Cập nhật Hệ thống tên miền (DNS) của bạn để trỏ đến CDN hoặc trình cân bằng tải nếu chưa thực hiện. Có thể mất chút thời gian để các bản cập nhật DNS có hiệu lực.
- Truy cập vào điểm cuối
/healthytrên miền mà bạn vừa thiết lập, chẳng hạn nhưhttps://example.com/metrics/healthy. Bạn sẽ thấy mộtok.
3. Cập nhật URL máy chủ trong Trình quản lý thẻ của Google
Bạn cần cập nhật cấu hình vùng chứa máy chủ để vùng chứa này có thể xác định tiền tố đường dẫn và xử lý các yêu cầu một cách chính xác.
Cách cập nhật lên điểm cuối mới:
- Mở Trình quản lý thẻ của Google
- Mở vùng chứa máy chủ được thiết lập trên cùng một nguồn gốc với trang web.
- Trong thẻ Quản trị > Cài đặt vùng chứa, hãy xoá tất cả URL trước đó. Việc này là cần thiết vì tất cả URL vùng chứa máy chủ phải có cùng một đường dẫn.
- Nhấp vào Thêm URL rồi nhập URL của bạn, bao gồm cả tiền tố đường dẫn.
- Lưu rồi quay lại không gian làm việc.
- Nhấp vào nút Xem trước để bắt đầu một phiên gỡ lỗi mới và gửi yêu cầu trên một thẻ riêng.
- Nhấp vào yêu cầu đã gửi. Đảm bảo ứng dụng của bạn đã xác nhận yêu cầu đến.
Khắc phục các sự cố thường gặp
- Bản xem trước không hiển thị các yêu cầu đến
- Chuyển đến trình khám phá nhật ký của dự án trên đám mây. Xác minh rằng quá trình triển khai tính năng gắn thẻ phía máy chủ đang nhận được lưu lượng truy cập. Nếu không, hãy làm theo hướng dẫn trong bước 1.
- Xác nhận rằng CDN hoặc trình cân bằng tải đang chuyển tiếp cookie.
- Xác minh rằng bạn có một máy chủ xem trước và các máy chủ gắn thẻ có
PREVIEW_SERVER_URL. - Xác nhận rằng máy chủ xem trước đang chạy bằng cách chuyển đến
PREVIEW_SERVER_URL+/healthy. Bạn sẽ thấy mộtok.
- Ứng dụng không nhận yêu cầu – Cập nhật URL trong phần Cài đặt vùng chứa để sử dụng đường dẫn được đặt trước. Nếu URL không chứa đường dẫn hoặc nếu đường dẫn khác nhau, thì ứng dụng sẽ không hoạt động đúng cách.