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 mối quan tâm Protected Audience API. Đọ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 chi tiết 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 là nhà phát triển? Hãy tham khảo tổng quan về Protected Audience API.

Nhóm mối quan tâm Protected Audience API

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

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

Các hàm API

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

Sau đây là ví dụ về cách xác định dữ liệu đối tượng, trong đó trình bà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ề các thuộc tính nhóm mối quan tâm xác định bằng JSON, 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 cách 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

Bất kỳ trường nào không được chỉ định trong JSON sẽ không bị ghi đè mà chỉ các trường được chỉ định trong JSON mới được cập nhật, trong khi việc gọi navigator.joinAdInterestGroup() sẽ ghi đè mọi nhóm mối quan tâm hiện có.

Chúng tôi cố gắng hết sức để cập nhật và có thể không cập nhật được trong các điều kiện sau:

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

Các bản cập nhật được giới hạn tốc độ tối đa là một lần mỗi ngày.

Bạn có thể huỷ các bản cập nhật nếu đã dành quá nhiều thời gian liền kề để cập nhật, mặc dù việc này không áp dụng bất kỳ giới hạn số lượng nào đối với các bản cập nhật đã huỷ (còn lại). Những 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òn những 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 có kết nối lại.

Cập nhật thủ công

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

Giới hạn số lượng yêu cầu ngăn quá trình 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() sẽ không thực hiện hành động nào cho đến khi đã hết khoảng thời gian giới hạn tốc độ (hiện là một ngày).

Hạn mức 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 phiên đấu giá đều đượ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ư cập nhật 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á, như thể navigator.updateAdInterestGroups() được gọi từ một iframe có nguồn gốc khớp với chủ sở hữu đó.

Tất cả tài liệu tham khảo 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.