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 đố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 dành cho nhà phát triển để biết toàn bộ vòng đời của Protected Audience API, đồng thời tham khảo tài liệu giải thích về Protected Audience API để biết đề xuất chi tiết về cách trình duyệt ghi lại các nhóm 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 đối tượng có cùng mối quan tâm trong Protected Audience API

Một nhóm 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 đối tượng 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 đố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. Trình duyệt sẽ lưu trữ thông tin về việc tham gia nhóm đối tượng có cùng mối quan tâm trên thiết bị của người dùng và không 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

Sau đây là ví dụ trong hướng dẫn về cách xác định dữ liệu đối tượng, cho biết 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 của nhóm lợi ích. Tham số 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 của nhóm lợi ích, tương ứng với đối tượng nhóm lợi ích được truyền đến joinAdInterestGroup().

Điều này cho phép chủ sở hữu nhóm định kỳ cập nhật các thuộc tính của nhóm đối tượng có cùng mối quan tâm. Trong 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

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 việc gọi navigator.joinAdInterestGroup() sẽ ghi đè mọi nhóm mối quan tâm hiện có.

Bản cập nhật là nỗ lực tốt nhất và có thể không thành công trong các trường hợp 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 phân tích cú pháp được JSON.

Tần suất cập nhật bị giới hạn 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 tục để cập nhật, mặc dù điều này không áp đặt bất kỳ giới hạn tốc độ 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 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 các bản cập nhật cho nhóm mối quan tâm thuộc quyền sở hữu của nguồn gốc khung hiện tại theo cách thủ công bằng cách sử dụng navigator.updateAdInterestGroups().

Tính năng giới hạn tốc độ ngăn các bản 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 có tác dụng cho đến khi hết khoảng thời gian giới hạn tốc độ (hiện là một ngày).

Giới hạn về tốc độ 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ẽ tự động cập nhật sau khi phiên đấu giá hoàn tất, tuân theo cùng giới hạn về tốc độ như các bản 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 một phiên đấu giá, thì như thể navigator.updateAdInterestGroups() được gọi từ một iframe có nguồn gốc phù hợp với chủ sở hữu đó.

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