Đặt giá thầu trong phiên đấu giá để mua vùng quảng cáo

Là người mua quảng cáo (DSP và nhà quảng cáo), bạn có thể muốn tham gia một phiên đấu giá quảng cáo Protected Audience trên trang web của nhà xuất bản để nhắm mục tiêu quảng cáo đến nhóm mối quan tâm mà bạn đã xác định trên trang web của nhà quảng cáo. Khi tham gia phiên đấu giá Protected Audience, bạn có thể tiếp cận những khách hàng mà bạn đã xác định trên các trang web khác theo cách bảo đảm quyền riêng tư.

Trong phiên đấu giá Protected Audience, bạn cung cấp logic để tạo giá thầu và trình duyệt sẽ tính toán giá thầu bằng cách sử dụng logic đó. Điều này trái ngược với các cấu trúc đấu giá khác, trong đó bạn gửi giá thầu trực tiếp thay vì cung cấp logic.

Bạn cung cấp logic tạo giá thầu trong hàm JavaScript generateBid() và tệp này được lưu trữ trên máy chủ của bạn. Khi bạn thêm một người dùng vào một nhóm đối tượng có cùng mối quan tâm, vị trí của tệp này sẽ được truyền vào cấu hình nhóm đối tượng có cùng mối quan tâm dưới dạng một biddingLogicUrl.

Trong phiên đấu giá, trình duyệt sẽ tìm nạp logic đặt giá thầu mà bạn chỉ định trong trường biddingLogicUrl và thực thi hàm generateBid() cho từng nhóm lợi ích trong một môi trường biệt lập an toàn, có giới hạn trong việc giao tiếp với ngữ cảnh bên ngoài. Khi generateBid() được thực thi, trình duyệt sẽ truyền các tín hiệu vào hàm dưới dạng đối số. Các tín hiệu này chứa nhiều thông tin từ nhiều nguồn, chẳng hạn như dữ liệu của bên thứ nhất của nhà xuất bản, dữ liệu của người bán, dữ liệu theo thời gian thực, v.v. Bạn có thể sử dụng các tín hiệu này để tính toán giá thầu và giá trị được trả về từ lệnh gọi generateBid(). Sau khi giá thầu được gửi, trình duyệt sẽ thực thi logic tính điểm của người bán trên từng giá thầu để tính điểm mức độ mong muốn của người bán.

generateBid()

Sau đây mô tả các đối số của hàm generateBid() và cấu trúc của giá thầu được trả về từ hàm:

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals, directFromSellerSignals) {
  return {
    ad: adObject,
    adCost: optionalAdCost,
    bid: bidValue,
    bidCurrency: 'USD',
    render: {
      url: renderURL,
      width: renderWidth,
      height: renderHeight
    },
    adComponents: [
      {url: adComponent1, width: componentWidth1, height: componentHeight1},
      {url: adComponent2, width: componentWidth2, height: componentHeight2},
      // ...
    ],
    allowComponentAuction: false,
    modelingSignals: 123 // 0-4095 integer (12-bits)
  };
}

Đối số

generateBid() lấy các đối số sau:

Tín hiệu của trình duyệt

Đối tượng browserSignals có các thuộc tính sau:

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  topLevelSeller: 'https://www.top-level-ssp.com',
  requestedSize: {width: 100, height: 200},  /* if specified in auction config */
  joinCount: 3,
  recency: 3600000,
  bidCount: 17,
  prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
  wasmHelper: ...
  dataVersion: 1,
  adComponentsLimit: 40
}

Tính giá thầu

Để tính toán giá trị giá thầu, mã trong generateBid() có thể sử dụng các thuộc tính của tham số hàm.

Ví dụ:

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
   //  ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    // ...
  }
}

Trả lại giá thầu

generateBid() trả về một đối tượng có các thuộc tính sau: