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

Khi tạo đối tượng tuỳ chỉnh, bạn có thể chỉ định một số hoặc tất cả siêu dữ liệu đối tượng tuỳ chỉnh. Bạn có thể truyền trực tiếp thông tin này khi tạo đối tượng CustomAudience. CustomAudience.Builder cũng hỗ trợ trường dailyUpdateUri có thể cung cấp và cập nhật siêu dữ liệu. Nền tảng sẽ chạy một công việc trong nền mỗi 24 giờ để tìm nạp siêu dữ liệu đã cập nhật từ dailyUpdateUri hoặc mỗi 4 giờ nếu đối tượng tuỳ chỉnh chưa có AdData cần thiết để tham gia phiên đấu giá. Nền tảng có thể cập nhật các siêu dữ liệu đối tượng tuỳ chỉnh sau đây:

  • Tín hiệu đặt giá thầu của người dùng
  • Dữ liệu đặt giá thầu đáng tin cậy
  • Danh sách AdData

Để cập nhật siêu dữ liệu này, quy trình cập nhật hằng ngày ở chế độ nền sẽ truy vấn dailyUpdateUri được xác định trong đối tượng tuỳ chỉnh. Quy trình này có thể trả về phản hồi JSON.

  • Phản hồi JSON có thể chứa bất kỳ trường siêu dữ liệu nào được hỗ trợ cần được cập nhật.
  • Mỗi trường JSON sẽ được xác thực một cách độc lập. Ứng dụng sẽ bỏ qua mọi trường không đúng định dạng, điều này dẫn đến việc không cập nhật trường cụ thể đó trong phản hồi.
  • Phản hồi HTTP trống hoặc đối tượng JSON trống "{}" sẽ dẫn đến việc không cập nhật siêu dữ liệu.
  • Kích thước của thông báo phản hồi phải được giới hạn ở mức 10 KB.
  • Bạn cần phải có tất cả các URI để sử dụng HTTPS.
  • trusted_bidding_uri phải chia sẻ cùng một ETLD+1 với người mua.

Ví dụ: phản hồi JSON cho tính năng cập nhật hằng ngày ở chế độ nền

{
    "user_bidding_signals" : { ... },  // Valid JSON object
    "trusted_bidding_data" : {
        "trusted_bidding_uri" : "example-dsp1-key-value-service.com",
        "trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
    },
    "ads" : [
        {
            "render_uri" : "www.example-dsp1.com/.../campaign123.html",
            "metadata" : { ... }  // Valid JSON object
        },
        {
            "render_uri" : "www.example-dsp1.com/.../campaign456.html",
            "metadata" : { ... }  // Valid JSON object
        },
        ...
    ]
}

Hãy xem định nghĩa máy chủ mô phỏng này để biết ví dụ về loại dữ liệu có thể có trong phản hồi.