Chọn mục Tổng quan về URL

Select URL cho phép bạn chọn nội dung sẽ hiển thị cho người dùng dựa trên dữ liệu SharedStorage của họ mà không tiết lộ dữ liệu cơ bản được lưu trữ.

Trong trường hợp muốn hiển thị nội dung dựa trên dữ liệu trên nhiều trang web theo cách tích cực về quyền riêng tư, bạn có thể sử dụng Select URL API. API Chọn URL hoạt động hiệu quả cho các trường hợp sử dụng như:

• Nội dung thử nghiệm A/B để mang lại trải nghiệm nhất quán cho người dùng trên nhiều trang web.
• Hiện nút đăng nhập khác cho người dùng có tài khoản và người dùng không có tài khoản.
• Luân phiên các mẫu quảng cáo để giới hạn tần suất người dùng nhìn thấy cùng một quảng cáo trên nhiều trang web.

Select URL API là gì?

Select URL API cho phép bạn chọn trong số một nhóm URL dựa trên dữ liệu trên nhiều trang web. API này được xây dựng dựa trên Bộ nhớ dùng chung và sử dụng SharedStorageWorklet để đọc dữ liệu có sẵn trên nhiều trang web và chọn một trong các URL được cung cấp. URL đã chọn sẽ được trả về cho phương thức gọi theo cách ngăn phương thức gọi đọc URL đó, ngoại trừ trong một khung được phân vùng. URL này cũng có thể được hiển thị trong iframe cho đến ít nhất là năm 2026.

Trong sơ đồ trước đó, trang web shoes.example có thể được nhúng vào các trang web khác của nhà xuất bản như news.example và vẫn truy cập vào cùng một dữ liệu bằng cách sử dụng SelectURL với Shared Storage để chọn nội dung phù hợp cần nhúng.

Cách hoạt động của tính năng Chọn URL

Bạn có thể sử dụng Select URL API để chọn một URL sẽ được hiển thị trong một khung được phân vùng hoặc iframe bằng cách sử dụng dữ liệu trên nhiều trang web. Sử dụng JavaScript để đọc và ghi dữ liệu trên nhiều trang web trong SharedStorage, sau đó chọn một URL trong danh sách được cung cấp dựa trên dữ liệu đã lưu trữ.

URL được hiển thị có thể bao gồm mọi loại nội dung: quảng cáo, bài viết, hình ảnh, HTML, lời kêu gọi hành động (chẳng hạn như nút) và nhiều nội dung khác.

Trong ví dụ này, bạn điều hành một trang web du lịch và đang chạy một chiến dịch quảng cáo có 3 mẫu quảng cáo khác nhau. Bạn muốn tạo trình tự cho các mẫu quảng cáo này dựa trên lượt tương tác của người dùng (xem hoặc nhấp).

Khi một trang web lần đầu tiên quan sát thấy một khoảng không quảng cáo chiến thắng, bạn có thể lưu trữ một mã nhận dạng và trạng thái nhấp cho mẫu quảng cáo đó trong Bộ nhớ dùng chung.

Ví dụ:

await sharedStorage.set('last-creative', 'globe');
await sharedStorage.set('click', 'true');

Điều này có nghĩa là khi thắng một phiên đấu giá quảng cáo trên những trang web khác mà người dùng này truy cập, bạn có thể hiển thị một quảng cáo khác dựa trên dữ liệu đó.

JavaScript của bạn chạy trong một SharedStorageWorklet để truy xuất thông tin này, nhưng mã của bạn không thể tương tác hoặc giao tiếp bên ngoài iframe hoặc khung được giới hạn trên trang mẹ.

Một ví dụ khác là bạn có thể muốn kiểm thử xem bài viết nào sẽ hoạt động hiệu quả hơn trong một ngữ cảnh được nhúng. Để kiểm thử điều này, bạn có thể chỉ định một người dùng vào một nhóm thử nghiệm khi thấy người dùng đó trên trang web của mình, sau đó lưu trữ mã nhận dạng nhóm đó trong Shared Storage để truy cập trong bối cảnh trên nhiều trang web. Trên một trang web khác, bạn có thể sử dụng Select URL API để chọn URL phù hợp nhất sẽ được hiển thị trong một khung được bao bọc, dựa trên nhóm thử nghiệm của người dùng đó như được lưu trữ bằng Shared Storage.

Khi sử dụng Select URL, bạn có thể đưa ra quyết định sáng suốt dựa trên dữ liệu trên nhiều trang web mà không cần chia sẻ thông tin người dùng (chẳng hạn như nhật ký trình duyệt hoặc các thông tin cá nhân khác) với một trang web nhúng hoặc trích xuất dữ liệu sang máy chủ của riêng bạn.

Ngân sách

Để giảm thiểu nguy cơ rò rỉ dữ liệu trên nhiều trang web, Select URL API sử dụng một hệ thống lập ngân sách kết hợp giữa ngân sách dài hạn và ngắn hạn:

• Ngân sách dài hạn: Ngân sách dài hạn là 12 bit cho mỗi trang web của người gọi, mỗi ngày khi sử dụng selectURL(). Ngân sách này chỉ được tính phí nếu khung lưu trữ URL đã chọn thực hiện thao tác điều hướng cấp cao nhất, trong đó chi phí được tính là log2(number of URLs). Vì vậy, nếu bạn cung cấp 8 URL để chọn, thì chi phí là 3 bit. Mọi ngân sách còn lại trong ngày được tính là 12 - (sum of bits deducted in the last 24 hours). Nếu không còn đủ ngân sách, URL mặc định (URL đầu tiên trong danh sách) sẽ được trả về và 1 bit sẽ được ghi lại nếu người dùng chuyển đến URL mặc định.

• Ngân sách ngắn hạn: Ngân sách ngắn hạn là các giới hạn bổ sung dựa trên mỗi lần tải trang cho đến khi các khung được phân vùng được thực thi đầy đủ và trong khi báo cáo cấp sự kiện vẫn có sẵn. Có một ngân sách là 6 bit cho mỗi trang web gọi, cho mỗi lần tải trang. Ngân sách này giới hạn lượng thông tin mà một trang web gọi có thể rò rỉ bằng cách sử dụng selectURL(). Ngoài ra, còn có ngân sách 12 bit tổng thể cho mỗi lần tải trang. Đây là giới hạn kết hợp cho tất cả các trang web gọi trên một trang.

  Truy vấn đã lưu cho phép bạn sử dụng lại kết quả selectURL() trước đó trên cùng một trang, giúp giảm mức sử dụng ngân sách ngắn hạn. Khi selectURL() được gọi bằng tên truy vấn đã lưu lần đầu tiên, chỉ mục kết quả sẽ được lưu trữ trong suốt thời gian tồn tại của trang. Khi selectURL() được gọi bằng cùng một tên truy vấn đã lưu cho các lệnh gọi tiếp theo, chỉ mục đã lưu trữ sẽ được trả về và thao tác đã đăng ký không chạy. Trong trường hợp này, ngân sách chỉ được tính phí cho lần sử dụng đầu tiên, nhưng không được tính phí cho bất kỳ lần sử dụng lại nào trong cùng một lần tải trang vì không có thông tin mới nào được tiết lộ.

  Bạn có thể triển khai truy vấn đã lưu bằng cách thêm thuộc tính savedQuery cùng với tên truy vấn đã chọn vào đối tượng tuỳ chọn, như trong ví dụ này.

  const topProductUrls = [
    { url: 'https://ad.example/default-top-product.html' },
    { url: 'https://ad.example/experiment-top-product.html' }];
  const relatedProductUrls = [
    { url: 'https://ad.example/default-related-product.html' },
    { url: 'https://ad.example/experiment-related-product.html' }];
  
  // This is the first call to `selectURL()` with `savedQuery: 'control_or_experiment'`
  // on this page, so it will be charged to both per-page budgets.
  const topProductsConfig = await sharedStorage.selectURL(
    'productExperiment', topProductUrls, {
      savedQuery: 'control_or_experiment',
      keepAlive: true,
      resolveToConfig: true
  });
  document.getElementById('topProductsFencedFrame').config = topProductsConfig;
  
  // This next call with this savedQuery won't charge either of the per-page budgets.
  const relatedProductConfig = await sharedStorage.selectURL(
    'productExperiment', relatedProductUrls, {
      savedQuery: 'control_or_experiment',
      resolveToConfig: true
  });
  document.getElementById("relatedProductFencedFrame").config = relatedProductConfig;
  

Chọn trường hợp sử dụng URL API

Nếu đang tạo một trang web có các tính năng cần hoạt động trên nhiều miền, bạn có thể gặp một trong những trường hợp sử dụng sau:

• Luân phiên mẫu quảng cáo: Giới hạn tần suất người dùng nhìn thấy cùng một quảng cáo trên nhiều trang web bằng cách lưu trữ dữ liệu (chẳng hạn như mã mẫu quảng cáo, số lượt xem và lượt tương tác của người dùng) để xác định mẫu quảng cáo mà người dùng nhìn thấy trên các trang web khác nhau. Điều này giúp bạn cân bằng số lượt xem và tránh tình trạng quá tải một số nội dung để hạn chế trải nghiệm tiêu cực có thể xảy ra cho người dùng. Để biết thêm thông tin về trường hợp sử dụng này, hãy xem phần Xoay vòng mẫu quảng cáo.
• Chọn mẫu quảng cáo theo tần suất: Lưu trữ số lượt xem trình duyệt trong Shared Storage để giới hạn tần suất người dùng nhìn thấy cùng một quảng cáo trên nhiều trang web. Để biết thêm thông tin về trường hợp sử dụng này, hãy xem bài viết Chọn mẫu quảng cáo theo tần suất.
• Tuỳ chỉnh trải nghiệm người dùng cho khách hàng đã biết: Cung cấp trải nghiệm nhất quán trên các miền khác nhau của bạn. Chia sẻ nội dung tuỳ chỉnh và lời kêu gọi hành động dựa trên trạng thái đăng ký của người dùng hoặc các trạng thái khác của người dùng, đồng thời mang đến trải nghiệm nhất quán trên các miền khác nhau của bạn. Để biết thêm thông tin về trường hợp sử dụng này, hãy xem phần Tuỳ chỉnh trải nghiệm người dùng cho khách hàng đã biết.
• Chạy thử nghiệm A/B: Thử nghiệm A/B so sánh hai hoặc nhiều phiên bản của một cấu hình để xác định phiên bản nào hoạt động hiệu quả nhất. Bạn có thể chỉ định một người dùng vào một nhóm thử nghiệm, sau đó lưu trữ nhóm đó trong Bộ nhớ dùng chung để truy cập trên nhiều trang web. Điều này cho phép bạn thu thập thông tin chi tiết về hành vi của người dùng trên mạng lưới trang web của mình mà không cần theo dõi từng cá nhân. Để biết thêm thông tin về trường hợp sử dụng này, hãy xem phần Chạy thử nghiệm A/B.

Select URL API với Shared Storage cho phép bạn phát triển các trường hợp sử dụng này bằng cách có quyền truy cập vào cùng một bộ nhớ trên nhiều trang web cấp cao nhất.

Thử nghiệm với bản minh hoạ

Bạn có thể thử nghiệm với Select URL bằng bản minh hoạ Shared Storage.

Bản minh hoạ này được xây dựng dựa trên góc độ của một nhà quảng cáo, công nghệ quảng cáo, nhà phân phối nội dung hoặc dịch vụ bên thứ ba khác muốn lưu trữ thông tin trên các trang web của nhiều nhà xuất bản. Trong bản minh hoạ, cùng một mã của bên thứ ba sẽ chạy trên cả trang web của Nhà xuất bản A và Nhà xuất bản B cho từng trường hợp sử dụng. Truy cập vào trang của từng nhà xuất bản để xem cách dữ liệu được chia sẻ trong bối cảnh trên nhiều trang web.

Bạn cũng có thể xem mã của bản minh hoạ trên GitHub.

Trạng thái API

API Chọn URL đang ở giai đoạn phát hành rộng rãi. Để sử dụng Select URL API hoặc bật API này cho quá trình phát triển cục bộ, hãy làm theo hướng dẫn để đăng ký Hộp cát về quyền riêng tư.

Tương tác và chia sẻ ý kiến phản hồi

Xin lưu ý rằng đề xuất về Select URL API đang được thảo luận và phát triển tích cực, vì vậy, đề xuất này có thể thay đổi.

Chúng tôi rất mong được biết ý kiến của bạn về Select URL API.

• Đề xuất: Xem xét đề xuất chi tiết.
• Thảo luận: Tham gia cuộc thảo luận đang diễn ra để đặt câu hỏi và chia sẻ hiểu biết của bạn.