Di chuyển sang nội dung gợi ý của ứng dụng tác nhân người dùng

Các chiến lược để di chuyển trang web của bạn từ việc dựa vào chuỗi tác nhân người dùng sang User-Agent Client Hints mới.

Ngày xuất bản: 19 tháng 5 năm 2021

Chuỗi tác nhân người dùng là một bề mặt lấy vân tay số thụ động quan trọng trong trình duyệt, đồng thời cũng khó xử lý. Tuy nhiên, có nhiều lý do chính đáng để thu thập và xử lý dữ liệu tác nhân người dùng, vì vậy, chúng ta cần có một giải pháp hiệu quả hơn. User-Agent Client Hints cung cấp cả cách rõ ràng để khai báo nhu cầu của bạn về dữ liệu tác nhân người dùng và các phương thức để trả về dữ liệu ở định dạng dễ sử dụng.

Sau đây, chúng tôi sẽ hướng dẫn bạn cách kiểm tra quyền truy cập vào dữ liệu tác nhân người dùng và di chuyển việc sử dụng chuỗi tác nhân người dùng sang User-Agent Client Hints.

Browser Support

  • Chrome: 90.
  • Edge: 90.
  • Firefox: not supported.
  • Safari: not supported.

Source

Kiểm tra việc thu thập và sử dụng dữ liệu tác nhân người dùng

Giống như mọi hình thức thu thập dữ liệu, bạn phải luôn hiểu rõ lý do bạn thu thập dữ liệu. Bước đầu tiên, bất kể bạn có thực hiện hành động nào hay không, là tìm hiểu xem bạn đang sử dụng dữ liệu tác nhân người dùng ở đâu và tại sao.

Nếu bạn không biết liệu dữ liệu tác nhân người dùng có đang được sử dụng hay không hoặc được sử dụng ở đâu, hãy cân nhắc tìm kiếm mã giao diện người dùng để sử dụng navigator.userAgent và mã phụ trợ để sử dụng tiêu đề HTTP User-Agent. Bạn cũng nên kiểm tra mã giao diện người dùng để xem có sử dụng các tính năng đã ngừng hoạt động hay không, chẳng hạn như navigator.platform và navigator.appVersion.

Từ góc độ chức năng, hãy nghĩ đến bất kỳ vị trí nào trong mã mà bạn đang ghi lại hoặc xử lý:

  • Tên hoặc phiên bản trình duyệt
  • Tên hoặc phiên bản hệ điều hành
  • Nhà sản xuất hoặc mẫu thiết bị
  • Loại, cấu trúc hoặc số bit của CPU (ví dụ: 64 bit)

Cũng có thể bạn đang sử dụng thư viện hoặc dịch vụ của bên thứ ba để xử lý tác nhân người dùng. Trong trường hợp này, hãy kiểm tra xem họ có đang cập nhật để hỗ trợ User-Agent Client Hints hay không.

Bạn chỉ sử dụng dữ liệu tác nhân người dùng cơ bản?

Bộ User-Agent Client Hints mặc định bao gồm:

  • Sec-CH-UA: tên trình duyệt và phiên bản chính/quan trọng
  • Sec-CH-UA-Mobile: giá trị boolean cho biết thiết bị di động
  • Sec-CH-UA-Platform: tên hệ điều hành

Phiên bản thu gọn của chuỗi tác nhân người dùng được đề xuất cũng sẽ giữ lại thông tin cơ bản này theo cách tương thích ngược. Ví dụ: thay vì Chrome/90.0.4430.85, chuỗi sẽ bao gồm Chrome/90.0.0.0.

Nếu bạn chỉ kiểm tra chuỗi tác nhân người dùng để tìm tên trình duyệt, phiên bản chính hoặc hệ điều hành, thì mã của bạn sẽ tiếp tục hoạt động mặc dù bạn có thể thấy cảnh báo ngừng hoạt động.

Mặc dù có thể và nên di chuyển sang User-Agent Client Hints, nhưng bạn có thể có mã cũ hoặc các quy tắc ràng buộc về tài nguyên khiến bạn không thể thực hiện việc này. Việc giảm thông tin trong chuỗi tác nhân người dùng theo cách tương thích ngược này nhằm đảm bảo rằng mặc dù mã hiện có sẽ nhận được thông tin ít chi tiết hơn, nhưng mã đó vẫn giữ được chức năng cơ bản.

Chiến lược

Có một số chiến lược bạn có thể áp dụng để di chuyển việc sử dụng chuỗi tác nhân người dùng sang User-Agent Client Hints.

API JavaScript phía máy khách theo yêu cầu

Nếu đang sử dụng navigator.userAgent, bạn nên chuyển sang ưu tiên navigator.userAgentData trước khi quay lại phân tích cú pháp chuỗi tác nhân người dùng.

if (navigator.userAgentData) {
  // use new hints
} else {
  // fall back to user-agent string parsing
}

Nếu bạn đang kiểm tra thiết bị di động hoặc máy tính, hãy sử dụng giá trị boolean mobile:

const isMobile = navigator.userAgentData.mobile;

userAgentData.brands là một mảng các đối tượng có thuộc tính brand và version, trong đó trình duyệt có thể liệt kê khả năng tương thích của trình duyệt với các thương hiệu đó. Bạn có thể truy cập trực tiếp vào mảng này hoặc có thể sử dụng lệnh gọi some() để kiểm tra xem có mục cụ thể nào không:

function isCompatible(item) {
  // In real life you most likely have more complex rules here
  return ['Chromium', 'Google Chrome', 'NewBrowser'].includes(item.brand);
}
if (navigator.userAgentData.brands.some(isCompatible)) {
  // browser reports as compatible
}

Nếu cần một trong các giá trị tác nhân người dùng có entropy cao và chi tiết hơn, bạn cần chỉ định giá trị đó và kiểm tra kết quả trong Promise được trả về:

navigator.userAgentData.getHighEntropyValues(['model'])
  .then(ua => {
    // requested hints available as attributes
    const model = ua.model
  });

Bạn cũng có thể sử dụng chiến lược này nếu muốn chuyển từ xử lý phía máy chủ sang xử lý phía máy khách. JavaScript API không yêu cầu quyền truy cập vào tiêu đề của yêu cầu HTTP, vì vậy, bạn có thể yêu cầu giá trị tác nhân người dùng bất cứ lúc nào.

Tiêu đề tĩnh phía máy chủ

Nếu đang sử dụng tiêu đề của yêu cầu User-Agent trên máy chủ và nhu cầu của bạn đối với dữ liệu đó tương đối nhất quán trên toàn bộ trang web, thì bạn có thể chỉ định Client Hints dưới dạng một tập hợp tĩnh trong phản hồi. Đây là một phương pháp tương đối đơn giản vì bạn thường chỉ cần định cấu hình ở một vị trí. Ví dụ: bạn có thể thêm tiêu đề vào cấu hình máy chủ web, cấu hình lưu trữ hoặc cấu hình cấp cao nhất của khung hoặc nền tảng mà bạn sử dụng cho trang web của mình.

Hãy cân nhắc chiến lược này nếu bạn đang chuyển đổi hoặc tuỳ chỉnh các phản hồi được phân phát dựa trên dữ liệu tác nhân người dùng.

Trình duyệt hoặc các ứng dụng khác có thể chọn cung cấp các gợi ý mặc định khác nhau, vì vậy, bạn nên chỉ định mọi thứ mình cần, ngay cả khi thông tin đó thường được cung cấp theo mặc định.

Ví dụ: các giá trị mặc định hiện tại cho Chrome sẽ được biểu thị như sau:

⬇️ Tiêu đề phản hồi

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA

Nếu cũng muốn nhận mẫu thiết bị trong phản hồi, bạn sẽ gửi:

⬇️ Tiêu đề phản hồi

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA

Khi xử lý việc này ở phía máy chủ, trước tiên, bạn nên kiểm tra xem tiêu đề Sec-CH-UA mong muốn đã được gửi hay chưa, sau đó quay lại phân tích cú pháp tiêu đề User-Agent nếu tiêu đề đó không có sẵn.

Uỷ quyền gợi ý cho các yêu cầu trên nhiều nguồn gốc

Nếu đang yêu cầu các tài nguyên phụ khác nguồn gốc hoặc trên nhiều trang web cần gửi User-Agent Client Hints trong yêu cầu, thì bạn cần chỉ định rõ ràng các gợi ý mong muốn bằng Chính sách về quyền.

Ví dụ: giả sử https://blog.site lưu trữ tài nguyên trên https://cdn.site, nơi có thể trả về tài nguyên được tối ưu hoá cho một thiết bị cụ thể. https://blog.site có thể yêu cầu gợi ý Sec-CH-UA-Model, nhưng cần uỷ quyền rõ ràng cho https://cdn.site bằng cách sử dụng tiêu đề Permissions-Policy. Danh sách các gợi ý do chính sách kiểm soát có trong bản nháp Cơ sở hạ tầng Client Hints

⬇️ Phản hồi từ blog.site uỷ quyền gợi ý

Accept-CH: Sec-CH-UA-Model
Permissions-Policy: ch-ua-model=(self "https://cdn.site")

⬆️ Yêu cầu đối với tài nguyên phụ trên cdn.site bao gồm gợi ý được uỷ quyền

Sec-CH-UA-Model: "Pixel 5"

Bạn có thể chỉ định nhiều gợi ý cho nhiều nguồn gốc, chứ không chỉ từ dải ô ch-ua:

⬇️ Phản hồi từ blog.site uỷ quyền nhiều gợi ý cho nhiều nguồn gốc

Accept-CH: Sec-CH-UA-Model, DPR
Permissions-Policy: ch-ua-model=(self "https://cdn.site"),
                    ch-dpr=(self "https://cdn.site" "https://img.site")

Uỷ quyền gợi ý cho iframe

Iframe khác nguồn gốc hoạt động theo cách tương tự như tài nguyên khác nguồn gốc, nhưng bạn chỉ định các gợi ý mà bạn muốn uỷ quyền trong thuộc tính allow.

⬇️ Phản hồi của blog.site

Accept-CH: Sec-CH-UA-Model

HTML cho blog.site

<iframe src="https://widget.site" allow="ch-ua-model"></iframe>

⬆️ Yêu cầu gửi đến widget.site

Sec-CH-UA-Model: "Pixel 5"

Thuộc tính allow trong iframe sẽ ghi đè mọi tiêu đề Accept-CH mà widget.site có thể tự gửi, vì vậy, hãy đảm bảo bạn đã chỉ định mọi thứ mà trang web của iframe cần.

Gợi ý động phía máy chủ

Nếu có những phần cụ thể trong hành trình của người dùng mà bạn cần nhiều gợi ý hơn so với phần còn lại của trang web, bạn có thể chọn yêu cầu các gợi ý đó theo nhu cầu thay vì yêu cầu tĩnh trên toàn bộ trang web. Cách này phức tạp hơn để quản lý, nhưng nếu bạn đã đặt các tiêu đề khác nhau trên cơ sở mỗi tuyến, thì cách này có thể khả thi.

Điều quan trọng cần nhớ ở đây là mỗi thực thể của tiêu đề Accept-CH sẽ ghi đè một cách hiệu quả tập hợp hiện có. Vì vậy, nếu bạn đang đặt tiêu đề một cách linh động, thì mỗi trang phải yêu cầu toàn bộ gợi ý cần thiết.

Ví dụ: bạn có thể có một phần trên trang web mà bạn muốn cung cấp các biểu tượng và chế độ điều khiển phù hợp với hệ điều hành của người dùng. Để làm việc này, bạn có thể cần phải kéo thêm Sec-CH-UA-Platform-Version để phân phát các tài nguyên phụ thích hợp.

⬇️ Tiêu đề phản hồi cho /blog

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA

⬇️ Tiêu đề phản hồi cho /app

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA

Cần có gợi ý phía máy chủ về địa chỉ trong yêu cầu đầu tiên

Có thể có trường hợp bạn cần nhiều hơn tập hợp gợi ý mặc định trong yêu cầu đầu tiên, tuy nhiên, trường hợp này có thể hiếm gặp, vì vậy, hãy đảm bảo bạn đã xem xét lý do.

Yêu cầu đầu tiên thực sự có nghĩa là yêu cầu cấp cao nhất đầu tiên cho nguồn gốc đó được gửi trong phiên duyệt web đó. Tập hợp gợi ý mặc định bao gồm tên trình duyệt kèm theo phiên bản lớn, nền tảng và chỉ báo thiết bị di động. Vì vậy, câu hỏi cần đặt ra ở đây là, bạn có cần dữ liệu mở rộng trong lần tải trang đầu tiên không?

Có hai lựa chọn để xem thêm gợi ý về yêu cầu đầu tiên. Trước tiên, bạn có thể sử dụng tiêu đề Critical-CH. Tiêu đề này có cùng định dạng với Accept-CH nhưng cho trình duyệt biết rằng trình duyệt nên thử gửi lại yêu cầu ngay lập tức nếu yêu cầu đầu tiên được gửi mà không có gợi ý quan trọng.

⬆️ Yêu cầu ban đầu

[With default headers]

⬇️ Tiêu đề phản hồi

Accept-CH: Sec-CH-UA-Model
Critical-CH: Sec-CH-UA-Model

🔃 Trình duyệt thử lại yêu cầu ban đầu bằng tiêu đề bổ sung

[With default headers + …]
Sec-CH-UA-Model: Pixel 5

Điều này làm phát sinh chi phí thử lại cho yêu cầu đầu tiên, nhưng chi phí triển khai tương đối thấp. Gửi tiêu đề bổ sung và trình duyệt sẽ làm phần còn lại.

Đối với những trường hợp bạn thực sự cần thêm gợi ý trong lần tải trang đầu tiên, đề xuất về Độ tin cậy của Client Hints sẽ đưa ra một lộ trình để chỉ định gợi ý trong chế độ cài đặt cấp kết nối. Tính năng này sử dụng tiện ích Cài đặt giao thức lớp ứng dụng (ALPS) cho TLS 1.3 để cho phép truyền sớm các gợi ý này trên kết nối HTTP/2 và HTTP/3. Tính năng này vẫn đang ở giai đoạn đầu, nhưng nếu bạn chủ động quản lý các chế độ cài đặt kết nối và TLS của riêng mình, thì đây là thời điểm lý tưởng để đóng góp.

Hỗ trợ phiên bản cũ

Bạn có thể có mã cũ hoặc mã của bên thứ ba trên trang web phụ thuộc vào navigator.userAgent, bao gồm cả các phần của chuỗi tác nhân người dùng sẽ bị giảm bớt. Bạn nên lên kế hoạch chuyển sang các lệnh gọi navigator.userAgentData tương đương, nhưng có một giải pháp tạm thời.

UA-CH retrofill là một thư viện nhỏ cho phép bạn ghi đè navigator.userAgent bằng một chuỗi mới được tạo từ các giá trị navigator.userAgentData được yêu cầu.

Ví dụ: mã này tạo ra một chuỗi tác nhân người dùng, đồng thời bao gồm gợi ý "model":

import { overrideUserAgentUsingClientHints } from './uach-retrofill.js';
overrideUserAgentUsingClientHints(['model'])
  .then(() => { console.log(navigator.userAgent); });

Chuỗi kết quả sẽ hiển thị mẫu Pixel 5, nhưng vẫn hiển thị 92.0.0.0 đã giảm vì gợi ý uaFullVersion không được yêu cầu:

Mozilla/5.0 (Linux; Android 10.0; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.0.0 Mobile Safari/537.36

Hỗ trợ thêm

Nếu những chiến lược này không giải quyết được trường hợp sử dụng của bạn, hãy bắt đầu một Cuộc thảo luận trong kho lưu trữ privacy-sandbox-dev-support để chúng ta có thể cùng nhau tìm hiểu vấn đề của bạn.