Cập nhật dữ liệu đối tượng và làm mới quảng cáo

Tìm hiểu cách cập nhật dữ liệu về đối tượng bằng cách định cấu hình URL cập nhật cho một nhóm đối tượng có cùng mối quan tâm Protected Audience API. Hãy đọc hướng dẫn cho nhà phát triển để biết toàn bộ vòng đời của Protected Audience API và tham khảo tài liệu giải thích về Protected Audience API để xem đề xuất chuyên sâu về cách các trình duyệt ghi lại các nhóm mối quan tâm.

Bạn không phải nhà phát triển? Tham khảo tổng quan về Protected Audience API.

Nhóm đối tượng có cùng mối quan tâm Protected Audience API

Nhóm đối tượng có cùng mối quan tâm Protected Audience API đại diện cho một nhóm người có chung mối quan tâm, tương ứng với một danh sách tái tiếp thị. Mỗi nhóm mối quan tâm Protected Audience API đều có một chủ sở hữu.

Chủ sở hữu nhóm đối tượng có cùng mối quan tâm đóng vai trò là người mua trong phiên đấu giá quảng cáo Protected Audience API. Tư cách thành viên của nhóm đối tượng có cùng mối quan tâm được trình duyệt, thiết bị của người dùng lưu trữ và không được chia sẻ với nhà cung cấp trình duyệt hoặc bất kỳ ai khác.

Các hàm API

Ví dụ về cách sử dụng

Dưới đây là ví dụ trong hướng dẫn cách xác định dữ liệu đối tượng, trong đó cho thấy cách tạo một nhóm mối quan tâm và yêu cầu trình duyệt tham gia nhóm.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

updateUrl cung cấp một URL trả về JSON để cập nhật các thuộc tính nhóm mối quan tâm. Thuộc tính này phải có cùng nguồn gốc với owner.

Cập nhật thuộc tính

updateUrl chỉ định một máy chủ web trả về JSON xác định các thuộc tính nhóm mối quan tâm, tương ứng với đối tượng nhóm mối quan tâm được truyền đến joinAdInterestGroup().

Điều này cho phép chủ sở hữu nhóm cập nhật định kỳ các thuộc tính của nhóm mối quan tâm. Trong phương thức triển khai hiện tại, bạn có thể thay đổi các thuộc tính sau:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

Mọi trường không được chỉ định trong JSON sẽ không bị ghi đè – chỉ những trường được chỉ định trong JSON mới được cập nhật. Trong khi đó, thao tác gọi navigator.joinAdInterestGroup() sẽ ghi đè mọi nhóm mối quan tâm hiện có.

Quá trình cập nhật sẽ được thực hiện với nỗ lực tối đa và có thể không thành công trong những điều kiện sau:

  • Thời gian chờ yêu cầu mạng (hiện là 30 giây).
  • Lỗi mạng khác.
  • Không thể phân tích cú pháp JSON.

Giới hạn tỷ lệ tối đa là một bản cập nhật mỗi ngày.

Hệ thống có thể huỷ các bản cập nhật nếu bạn dành quá nhiều thời gian liền nhau để cập nhật, mặc dù việc này không áp dụng giới hạn số lượng yêu cầu đối với các bản cập nhật bị huỷ (còn lại). Các bản cập nhật không thành công do lỗi mạng sẽ được thử lại sau một giờ. Các bản cập nhật không thành công do bị ngắt kết nối Internet sẽ được thử lại ngay khi kết nối lại.

Các bản cập nhật thủ công

Bạn có thể kích hoạt nội dung cập nhật đối với nhóm mối quan tâm do nguồn gốc của khung hiện tại sở hữu theo cách thủ công bằng navigator.updateAdInterestGroups().

Giới hạn số lượng yêu cầu ngăn việc cập nhật diễn ra quá thường xuyên: các lệnh gọi lặp lại đến navigator.updateAdInterestGroups() không thực hiện thao tác nào cho đến khi hết khoảng thời gian giới hạn số lượng yêu cầu (hiện là một ngày).

Giới hạn tỷ lệ sẽ được đặt lại nếu navigator.joinAdInterestGroup() được gọi lại cho cùng một nhóm mối quan tâm owner và name.

Tự động cập nhật

Tất cả các nhóm mối quan tâm được tải cho một phiên đấu giá sẽ được cập nhật tự động sau khi phiên đấu giá hoàn tất, tuân theo cùng giới hạn tỷ lệ như khi cập nhật theo cách thủ công.

Đối với mỗi chủ sở hữu có ít nhất một nhóm mối quan tâm tham gia vào phiên đấu giá, sẽ giống như khi navigator.updateAdInterestGroups() được gọi từ iframe có nguồn gốc khớp với chủ sở hữu đó.

Tất cả tệp tham chiếu Protected Audience API

Hướng dẫn tham khảo API có sẵn:

Thông tin giải thích về Protected Audience API cũng cung cấp thông tin chi tiết về các quy tắc hỗ trợ và các quy tắc ràng buộc của tính năng.