Xử lý yêu cầu

Tương tác đặt giá thầu theo thời gian thực bắt đầu khi Google gửi yêu cầu giá thầu đến ứng dụng của bạn. Hướng dẫn này giải thích cách lập trình ứng dụng để xử lý yêu cầu giá thầu.

Phân tích cú pháp yêu cầu

Google gửi một yêu cầu giá thầu được chuyển đổi tuần tự ở định dạng OpenRTB JSON hoặc Protobuf, được đính kèm dưới dạng tải trọng của yêu cầu POST HTTP. Định dạng nhận được sẽ phụ thuộc vào cấu hình của điểm cuối. Xem Yêu cầu giá thầu mẫu để biết ví dụ.

Bạn phải phân tích cú pháp yêu cầu này để nhận BidRequest được chuyển đổi tuần tự. Nếu đang sử dụng định dạng Protobuf, bạn phải tải openrtb.proto và openrtb-adx.proto xuống từ trang dữ liệu tham chiếu, rồi sử dụng các tệp này để tạo một thư viện có thể dùng để phân tích cú pháp thông báo BidRequest. Ví dụ: mã C++ sau đây phân tích cú pháp một yêu cầu dựa trên tải trọng POST trong một chuỗi:

string post_payload = /* the payload from the POST request */;
BidRequest bid_request;
if (bid_request.ParseFromString(post_payload)) {
  // Process the request.
}

Sau khi có BidRequest, bạn có thể làm việc với đối tượng này, trích xuất và diễn giải các trường bạn cần. Ví dụ: trong C++, việc lặp lại các giao dịch trong `BidRequest` OpenRTB có thể có dạng như sau:

for (const BidRequest::Imp::Pmp::Deal& deal : pmp.deals()) {
  DoSomething(deal.id(), deal.wseat());
}

Mã thanh toán

Bạn sẽ nhận được yêu cầu giá thầu khi khoảng không quảng cáo của nhà xuất bản được nhắm mục tiêu theo một hoặc nhiều cấu hình nhắm mục tiêu trước của bạn. BidRequest.imp.ext.billing_id sẽ được điền mã thanh toán của mọi người mua đủ điều kiện và cấu hình nhắm mục tiêu trước có liên quan. Ngoài ra, đối với khoảng không quảng cáo của giao dịch, bạn có thể tìm thấy mã thanh toán liên kết với người mua có liên quan bằng cách sử dụng BidRequest.imp.pmp.deal.ext.billing_id. Bạn chỉ có thể chỉ định mã thanh toán của những người mua có trong yêu cầu giá thầu khi đặt giá thầu.

Nếu yêu cầu giá thầu có nhiều mã thanh toán, bạn phải chỉ định mã thanh toán của người mua mà bạn muốn phân bổ giá thầu bằng trường BidResponse.seatbid.bid.ext.billing_id.

imp {
  ext {
    // The billing IDs of all of your matching pretargeting configs and eligible child seats are
    // stored in a flat list here.
    billing_id: 123
    billing_id: 456
    billing_id: 789
  }
  pmp {
    // All eligible deals are stored in a single flat list.
    deal {
      id: 1000
      ext {
        // The specific billing IDs eligible to bid on this deal are indicated here.
        billing_id: 789
      }
      ...
    }
    deal {
      id: 2000
      ext {
        billing_id: 123
        billing_id: 456
      }
      ...
    }
  }
  ...
}
...

Xác định danh mục bị chặn

Khi bạn đặt giá thầu, mẫu quảng cáo đi kèm không được có danh mục bị phát hiện mà nhà xuất bản đã chặn. Nếu không, giá thầu sẽ bị lọc ra khỏi phiên đấu giá.

Bạn có thể tìm thấy các danh mục bị chặn cho một lượt hiển thị bằng cách xem trường BidRequest.bcat. Trường này được điền sẵn các danh mục trong hệ thống phân loại được định cấu hình cho tài khoản của bạn.

Ví dụ sau đây cho thấy các danh mục bị chặn dựa trên hệ thống phân loại danh mục quảng cáo đã định cấu hình:

Hệ thống phân loại nội dung theo IAB 1.0

// Bid request
{
  // Indicates the blocked categories using IAB Content 1.0 Taxonomy.
  "bcat": [
    "IAB9-9",  // Cigars
    "IAB8-18"  // Wine
  ]
  "imp": {
    ...
  }
}
      
// Bid request
{
  // Indicates the blocked categories using Google Ad Category Taxonomy.
  "bcat": [
    "10138",  // Cigar and tobacco collecting
    "10080",  // Tobacco
    "11649",  // Wine
    "10674",  // Wine collecting
    "13008"   // Wine clubs
  ]
  "imp": {
    ...
  }
}
      

Xác định danh mục theo bối cảnh

Yêu cầu giá thầu có thể bao gồm các trường danh mục theo bối cảnh mô tả trang web hoặc ứng dụng nơi lượt hiển thị diễn ra. Các trường này cũng sử dụng hệ thống phân loại danh mục quảng cáo, nhưng thể hiện bối cảnh của lượt hiển thị, thay vì các quy định hạn chế đối với mẫu quảng cáo. Các trường này có thể không sử dụng cùng một hệ thống phân loại như trường BidRequest.bcat. Google hoặc nhà xuất bản có thể cung cấp các danh mục theo bối cảnh này. Việc sử dụng danh mục theo ngữ cảnh có thể cải thiện khả năng đánh giá lượt hiển thị, nhắm mục tiêu theo ngữ cảnh và đảm bảo an toàn cho thương hiệu.

Danh mục theo bối cảnh do Google phát hiện

Google điền vào các trường sau đây bằng danh mục nội dung IAB được phát hiện cho trang web, ứng dụng hoặc trang:

Trường Mô tả
BidRequest.site.cat Một mảng mã danh mục nội dung mô tả trang web.
BidRequest.site.pagecat Một mảng mã danh mục nội dung mô tả trang hoặc chế độ xem hiện tại của trang web.
BidRequest.app.cat Một mảng mã danh mục nội dung mô tả ứng dụng.
BidRequest.app.pagecat Một mảng mã danh mục nội dung mô tả trang hoặc chế độ xem hiện tại của ứng dụng.

Bạn có thể tìm thấy hệ thống phân loại chính xác được dùng cho các trường này đối với một yêu cầu giá thầu nhất định trong các trường BidRequest.site.cattax hoặc BidRequest.app.cattax. Các trường danh mục theo bối cảnh có thể không phải lúc nào cũng được điền sẵn do lựa chọn ưu tiên của nhà xuất bản hoặc các mối lo ngại về quy định. Để biết thêm thông tin, hãy xem bài viết Danh mục theo bối cảnh của OpenRTB trong Google Ad Manager.

Tín hiệu do nhà xuất bản cung cấp

Ngoài các danh mục theo bối cảnh do Google phát hiện, yêu cầu giá thầu cũng có thể chứa tín hiệu do nhà xuất bản cung cấp, cũng mô tả bối cảnh của một lượt hiển thị. Không giống như các danh mục theo bối cảnh do Google phát hiện, những tín hiệu này chỉ được điền sẵn khi do nhà xuất bản cung cấp. Các tín hiệu này được gửi trong đối tượng BidRequest.site.content và BidRequest.app.content, chẳng hạn như content.data.segment và content.genre. Hệ thống phân loại dùng cho các mục content.data.segment được báo cáo trong content.data.ext.segtax. Để biết thêm thông tin, hãy xem bài viết Tín hiệu do nhà xuất bản cung cấp (PPS) cho tính năng Đặt giá thầu theo thời gian thực (RTB).

Tệp từ điển

Yêu cầu giá thầu sử dụng giá trị nhận dạng được xác định trong tệp từ điển, có trên trang dữ liệu tham chiếu.

Macro URL của bên đặt giá thầu

Nếu muốn, bạn có thể chèn một số thông tin từ BidRequest vào URL điểm cuối đặt giá thầu bằng cách sử dụng macro. Nếu bạn định cấu hình URL điểm cuối bằng một hoặc nhiều macro, thì các macro đó sẽ được mở rộng nếu thông tin đó có trong yêu cầu giá thầu. Ví dụ: điều này có thể hữu ích nếu bạn muốn thực hiện cân bằng tải dựa trên thông tin trong BidRequest. Hãy liên hệ với người quản lý tài khoản của bạn để yêu cầu hỗ trợ cho các macro mới.

MacroMô tả
%%GOOGLE_USER_ID%%

Được thay thế bằng Mã nhận dạng người dùng Google có trong BidRequest.user.id. Ví dụ: URL của bên đặt giá thầu http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%% sẽ được thay thế bằng một URL như http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl tại thời điểm yêu cầu.

Nếu không xác định được Mã nhận dạng người dùng trên Google, thì chuỗi trống sẽ được thay thế, với kết quả tương tự như

http://google.bidder.com/path?gid=
%%HAS_MOBILE%%

Được thay thế bằng 1 để cho biết rằng yêu cầu giá thầu là từ một thiết bị di động, hoặc 0 nếu không phải. Điều này dựa trên giá trị của BidRequest.device.devicetype, trong đó thiết bị di động được biểu thị bằng HIGHEND_PHONE (4) hoặc Tablet (5).

%%HAS_VIDEO%%

Được thay thế bằng 1 để cho biết rằng yêu cầu giá thầu chứa khoảng không quảng cáo trong video, hoặc 0 nếu không. Điều này dựa trên việc BidRequest.imp.video có được điền trong yêu cầu giá thầu hay không.

%%IS_CTV%%

Được thay thế bằng 1 để cho biết rằng yêu cầu giá thầu là từ một thiết bị CTV, hoặc 0 nếu không phải. Giá trị này dựa trên giá trị của BidRequest.device.devicetype. Đối với Protobuf, thiết bị CTV là CONNECTED_TV, CONNECTED_DEVICE hoặc SET_TOP_BOX, tương ứng với các giá trị số nguyên 3, 6 hoặc 7 cho JSON.

%%HOSTED_MATCH_DATA%%

Được thay thế bằng một giá trị dựa trên BidRequest.user.buyeruid.

%%MOBILE_IS_APP%%

Được thay thế bằng 1 để cho biết rằng yêu cầu giá thầu là dành cho khoảng không quảng cáo trên ứng dụng di động, hoặc 0 nếu không phải. Điều này dựa trên việc BidRequest.app có được điền hay không.

Tìm mã ứng dụng di động trong URL giao dịch

Giao dịch ứng dụng di động sẽ báo cáo các URL có dạng như sau:

mbappgewtimrzgyytanjyg4888888.com

Sử dụng bộ giải mã base-32 để giải mã phần chuỗi được in đậm (gewtimrzgyytanjyg4888888).

Bạn có thể sử dụng bộ giải mã trực tuyến, nhưng bạn sẽ phải viết hoa các chữ cái và thay thế các giá trị 8 ở cuối bằng giá trị =.

Vì vậy, khi giải mã giá trị này:

GEWTIMRZGYYTANJYG4======
mang lại:
1-429610587
Chuỗi 429610587 là mã ứng dụng cho ứng dụng iOS iFunny.

Sau đây là một ví dụ khác. URL được báo cáo là:

mbappgewtgmjug4ytmmrtgm888888.com
Giải mã giá trị này:
GEWTGMJUG4YTMMRTGM======
mang lại kết quả:
1-314716233
Kết quả 314716233 là mã ứng dụng cho ứng dụng iOS TextNow.

Tìm tên ứng dụng di động từ URL giao dịch

Sau đây là ví dụ về cách lấy tên ứng dụng. URL được báo cáo như sau:

mbappMFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q888.com
Giải mã giá trị này:
MFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q===
mang lại kết quả:
air.com.hypah.io.slither
Kết quả này tương đương với ứng dụng Android slither.io.

Trường Đặt giá thầu mở

Yêu cầu giá thầu được gửi đến bên đặt giá thầu của mạng và sàn giao dịch tham gia Đặt giá thầu mở tương tự như yêu cầu giá thầu của Authorized Buyers tham gia đặt giá thầu theo thời gian thực chuẩn. Khách hàng Đặt giá thầu mở sẽ nhận được một số ít trường bổ sung và một vài trường hiện có có thể có cách sử dụng khác. Trong đó bao gồm:

OpenRTB Chi tiết
BidRequest.imp.ext.dfp_ad_unit_code

Chứa mã mạng Ad Manager của nhà xuất bản, theo sau là hệ phân cấp đơn vị quảng cáo, được phân tách bằng dấu gạch chéo.

Ví dụ: thông tin này sẽ xuất hiện với định dạng tương tự như: /1234/cruises/mars.

BidRequest.user.data.segment

Các cặp khoá-giá trị lặp lại được gửi từ nhà xuất bản đến bên đặt giá thầu cùng sàn giao dịch.

Bạn có thể xác định rằng các giá trị là cặp khoá-giá trị do nhà xuất bản gửi khi BidRequest.user.data.name được đặt thành “Publisher Passed”.

Khai báo nhà cung cấp được cho phép

Các nhà cung cấp công nghệ cung cấp các dịch vụ như nghiên cứu, tái tiếp thị và phân phát quảng cáo có thể đóng vai trò trong hoạt động tương tác giữa người mua và người bán. Chỉ những nhà cung cấp đã được Google xem xét kỹ lưỡng để tham gia vào các hoạt động tương tác của Authorized Buyers mới được phép.

Để hiểu rõ BidRequest và tạo BidResponse, bạn cần biết hai khả năng khai báo nhà cung cấp công nghệ:

  1. Một số nhà cung cấp không cần phải khai báo; những nhà cung cấp này được liệt kê trong danh sách Nhà cung cấp bên ngoài được chứng nhận của Ad Manager.
  2. Các nhà cung cấp khác chỉ có thể tham gia nếu được khai báo trong BidRequest:
    • Trong BidRequest, trường BidRequest.imp.ext.allowed_vendor_type chỉ định những nhà cung cấp mà người bán cho phép. Các nhà cung cấp sẽ được gửi trong allowed_vendor_type được liệt kê trong tệp từ điển vendors.txt.

Ví dụ về yêu cầu giá thầu

Các ví dụ sau đây trình bày mẫu yêu cầu Protobuf và JSON mà con người có thể đọc được.

OpenRTB Protobuf

OpenRTB JSON

Để chuyển đổi yêu cầu giá thầu thành dạng nhị phân, giống như bạn nhận được từ tải trọng POST trong một yêu cầu thực tế, bạn có thể làm như sau (bằng C++). Tuy nhiên, xin lưu ý rằng điều này không áp dụng cho OpenRTB JSON.

string text_format_example = /* example from above */;
BidRequest bid_request;
if (TextFormat::ParseFromString(text_format_example, &bid_request)) {
  string post_payload;
  if (bid_request.SerializeToString(&post_payload)) {
    // post_payload is a binary serialization of the protocol buffer
  }
}

Phản hồi theo thời gian thực

Tính năng phản hồi theo thời gian thực được cung cấp cho Authorized Buyers, cũng như các sàn giao dịch và mạng sử dụng tính năng Đặt giá thầu mở.

Phản hồi theo thời gian thực sẽ điền sẵn BidRequest.ext.bid_feedback dựa trên kết quả của một hoặc nhiều giá thầu mà bạn đã đặt trước đó và có thể được dùng để tìm thông tin chi tiết, chẳng hạn như liệu giá thầu có thắng phiên đấu giá hay không hoặc giá thầu tối thiểu cần thiết để thắng phiên đấu giá. Hãy liên hệ với người quản lý tài khoản của bạn để bật tính năng phản hồi theo thời gian thực.

Ngoài các trường mặc định được gửi trong Phản hồi giá thầu, bạn cũng có thể gửi dữ liệu tuỳ chỉnh trong giá thầu phản hồi bằng cách sử dụng trường BidResponse.seatbid.bid.ext.event_notification_token. event_notification_token là dữ liệu tuỳ ý mà chỉ bên đặt giá thầu mới biết, có thể giúp gỡ lỗi, ví dụ: mã nhắm mục tiêu mới hoặc mã đặt giá thầu đại diện cho một chiến thuật mới, hoặc siêu dữ liệu liên kết với mẫu quảng cáo mà chỉ bên đặt giá thầu mới biết. Để biết thông tin chi tiết, hãy xem tệp Vùng đệm giao thức của tiện ích OpenRTB.

Khi Authorized Buyers gửi yêu cầu giá thầu cho một bên đặt giá thầu, bên đặt giá thầu sẽ trả lời bằng một BidResponse. Nếu bên đặt giá thầu đã bật tính năng phản hồi theo thời gian thực, thì trong yêu cầu giá thầu tiếp theo, Authorized Buyers sẽ gửi ý kiến phản hồi về giá thầu phản hồi trong thông báo BidFeedback:

message BidFeedback {
  // The unique id from BidRequest.id.
  optional string request_id = 1;

  // The status code for the ad. See creative-status-codes.txt in the
  // technical documentation for a list of ids.
  optional int32 creative_status_code = 2;

  // Deprecated. This field is not populated and will be removed after March,
  // 2025. If the bid won the auction, this is the price paid in your account
  // currency. If the bid participated in the auction but was out-bid, this
  // is the CPM that should have been exceeded in order to win. This is not
  // set if the bid was filtered prior to the auction, if the publisher or
  // winning bidder has opted out of price feedback or if your account has
  // opted out of sharing winning prices with other bidders. For first-price
  // auctions, minimum_bid_to_win is populated instead of this field.
  optional double price = 3 [deprecated = true];

  // The minimum bid value necessary to have won the auction, in your account
  // currency. If your bid won the auction, this is the second highest bid
  // that was not filtered (including the floor price). If your bid didn't win
  // the auction, this is the winning candidate's bid. This field will only be
  // populated if your bid participated in a first-price auction, and will not
  // be populated if your bid was filtered prior to the auction.
  optional double minimum_bid_to_win = 6;

  // Billable event rate multiplier that was applied to this bid during
  // ranking. The adjustment reflects the likelihood that your bid would
  // generate a billable event (namely, the ad renders successfully) if it won
  // the auction, relative to the probability that other bids generate a
  // billable event if they won the auction. This adjustment can be larger or
  // smaller than 1. This affects the final ranking in the auction only; in
  // particular, this multiplier does not affect the payment or whether the
  // bid clears any floor price.
  optional float billable_event_rate_bid_adjustment = 13 [default = 1];

  // When a publisher uses an RTB auction and waterfall-based SDK mediation on
  // the same query, the winner of the real-time auction must also compete in
  // a mediation waterfall (which is ordered by price) to win the impression.
  // If the bid participated in the auction and there was no waterfall, the
  // value of this field is 0. If the bid participated in the auction and
  // there was a waterfall, the value of this field is a price representing a
  // sample bid from the eligible mediation networks that were higher than the
  // auction winner, weighted by expected fill rate. This field can be used
  // in conjunction with minimum_bid_to_win to train bidding models. The CPM
  // is in your account currency.
  optional double sampled_mediation_cpm_ahead_of_auction_winner = 8;

  message EventNotificationToken {
    // The contents of the token.
    optional string payload = 1;
  }

  // The token included in the corresponding bid.
  optional EventNotificationToken event_notification_token = 4;

  // The creative ID included in the corresponding bid.
  optional string buyer_creative_id = 5;
}

Trong thông báo này, trường đầu tiên bạn nên kiểm tra là bid_feedback.creative_status_code; bạn có thể tìm thấy ý nghĩa của mã trong creative-status-codes.txt. Xin lưu ý rằng nếu thắng thầu, bạn có thể chọn không nhận thông tin phản hồi về giá. Để biết thêm thông tin, hãy xem phần Cách chọn không tham gia.

Phản hồi theo thời gian thực bao gồm mã yêu cầu giá thầu và một trong những thông tin sau:

Kết quả đấu giá Phản hồi theo thời gian thực
Bên mua không gửi giá thầu. Miễn phí.
Người mua đã gửi một giá thầu bị lọc ra trước khi đến phiên đấu giá. Mã trạng thái mẫu quảng cáo (creative-status-codes.txt).
Người mua đã gửi giá thầu nhưng thua trong phiên đấu giá. Mã trạng thái mẫu quảng cáo 79 (bị trả giá cao hơn trong phiên đấu giá).
Người mua đã gửi giá thầu thắng phiên đấu giá. Giá thanh toán và mã trạng thái mẫu quảng cáo 1.

Đối với một lượt hiển thị ứng dụng và mã trạng thái mẫu quảng cáo là 83, nhà xuất bản ứng dụng có thể đã sử dụng quy trình dàn xếp kiểu thác nước, do đó giá thầu thắng cuộc sẽ cạnh tranh với nhu cầu khác trong chuỗi thác nước trả về của nhà xuất bản. Tìm hiểu cách sử dụng sampled_mediation_cpm_ahead_of_auction_winner khi đặt giá thầu.

Mẫu

Sau đây là mẫu phản hồi theo thời gian thực như trong các giao thức được hỗ trợ:

OpenRTB Protobuf

OpenRTB JSON

Xây dựng mô hình đặt giá thầu cho phiên đấu giá theo giá đầu tiên

Sau khi đặt giá thầu trong phiên đấu giá theo giá đầu tiên, bạn sẽ nhận được ý kiến phản hồi theo thời gian thực, bao gồm cả các trường minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner nếu giá thầu không bị lọc khỏi phiên đấu giá. Bạn có thể sử dụng các tín hiệu này để thông báo cho logic đặt giá thầu về mức giá thầu cao hơn hoặc thấp hơn mà bạn có thể đặt để giành được lượt hiển thị.

  • minimum_bid_to_win: Giá thầu tối thiểu có thể được đặt để giành chiến thắng trong phiên đấu giá đặt giá thầu theo thời gian thực. Nếu bạn thắng phiên đấu giá, thì đây sẽ là giá thầu thấp nhất mà bạn có thể đặt trong khi vẫn thắng. Nếu bạn thua trong phiên đấu giá, thì đây sẽ là giá thầu thắng cuộc.
  • sampled_mediation_cpm_ahead_of_auction_winner: Nếu có các mạng khác trong chuỗi dàn xếp, thì giá trị của trường này là giá đại diện cho giá thầu mẫu từ một trong các mạng dàn xếp đủ điều kiện cao hơn giá thầu của người thắng cuộc đấu giá, được tính trọng số theo tỷ lệ lấp đầy dự kiến. Giá trị này sẽ được đặt thành 0 nếu không có mạng nào trong chuỗi dàn xếp dự kiến sẽ thực hiện, hoặc nếu nhà xuất bản không sử dụng tính năng dàn xếp SDK.

Cách hoạt động

Để mô tả các phép tính dùng để xác định giá trị có thể có cho minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner, trước tiên, chúng ta cần xác định những điều sau:

  • Sau đây là các CPM trong chuỗi dàn xếp theo thứ tự giảm dần:
    \[C_1, C_2, …, C_n\]
  • Sau đây là tỷ lệ đáp ứng tương ứng cho các CPM trong chuỗi dàn xếp:
    \[f_1, f_2, …, f_n\]
  • Sau đây là hàm dùng để xác định CPM dự kiến và xác suất của CPM đó từ phần tử chuỗi dàn xếp \(i\), dựa trên tỷ lệ lấp đầy đã cho:
    \(X_i = \{C_i\) với xác suất \(f_i\); \(0\) với xác suất \(1 - f_i\}\)
  • Chuỗi dàn xếp chiến thắng cuối cùng sẽ là:
    \[\{C_1, C_2, …, C_K, W\}\]
    trong đó \(W\) là giá thầu thắng cuộc và \(C_K > W >= C_{K+1}\)
  • Giá khởi điểm hoặc giá sàn được ký hiệu là \(F\).
  • Giá thầu của người về nhì được ký hiệu là \(R\).
Cách tính cho người chiến thắng trong phiên đấu giá
Trường Cách tính
minimum_bid_to_win
\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_
of_auction_winner
\(\{C_i\) với xác suất \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
Cho \(1 <= i <= K\).

Cách tính cho bên thua trong phiên đấu giá
Trường Cách tính
minimum_bid_to_win
\(max\{F, W\}\)
sampled_mediation_cpm_ahead_
of_auction_winner
\(max\{X_1, …, X_K\}\)

Ví dụ về chuỗi dàn xếp đơn giản

Giả sử một nhà xuất bản sử dụng cả tính năng đặt giá thầu theo thời gian thực và chuỗi dàn xếp SDK như sau:

Chuỗi dàn xếp SDK CPM dự kiến Tỷ lệ đáp ứng
Mạng 1 \(C_1 = $3.00\) \(f_1 = 5\%\)
Mạng 2 \(C_2 = $2.00\) \(f_2 = 45\%\)
Mạng 3 \(C_3 = $0.50\) \(f_3 = 80\%\)
Mạng 4 \(C_4 = $0.10\) \(f_4 = 85\%\)

Giả sử kết quả của phiên đấu giá RTB như sau:

Phiên đấu giá RTB CPM
Người thắng phiên đấu giá (W) 1 đô la
Người về nhì trong phiên đấu giá (R) 0,05 USD
Giá khởi điểm/Giá sàn (F) $0
Giá thầu đã thắng phiên đấu giá

Sau đây là ví dụ về cách tính giá trị và xác suất cho minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner đối với một giá thầu đã thắng.

minimum_bid_to_win Xác suất
\(max(F, R, C_3) = $0.50\) \(f_3 = 80\%\)
\(max(F, R, C_4) = $0.10\) \((1-f_3) \cdot f_4 = 17\%\)
\(max(F, R, 0) = $0.05\) \((1-f_3) \cdot (1-f_4) = 3\%\)
sampled_mediation_cpm_
ahead_of_auction_winner
Xác suất
\(C_1 = $3.00\) \(f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%\)
\(C_2 = $2.00\) \(((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%\)
Giá thầu thua trong phiên đấu giá

Sau đây là ví dụ về cách tính giá trị và xác suất cho minimum_bid_to_win và sampled_mediation_cpm_ahead_of_auction_winner đối với giá thầu không thắng.

minimum_bid_to_win Xác suất
\(max(F, W) = $1.00\) \(100\%\)
sampled_mediation_cpm_
ahead_of_auction_winner
Xác suất
\(C_1 = $3.00\) \(f_1 = 5\%\)
\(C_2 = $2.00\) \((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\) \((1-f_1) \cdot (1-f_2) =~ 52.2\%\)

Phân tách giá thầu

Phân tách giá thầu là quá trình xử lý một BidRequest phức tạp thành nhiều yêu cầu giá thầu được gửi đến ứng dụng của bạn. Khi một yêu cầu giá thầu được làm phẳng, bạn có thể biết yêu cầu giá thầu nào là một phần của yêu cầu ban đầu vì chúng sẽ có giá trị giống hệt nhau trong trường BidRequest.ext.google_query_id.

Tính năng phân tách giá thầu được bật theo mặc định, nhưng bạn có thể liên hệ với người quản lý tài khoản của mình nếu muốn tắt tính năng này.

Định dạng quảng cáo

Một số cơ hội quảng cáo có thể chấp nhận nhiều định dạng. Khi phân tách giá thầu, mỗi định dạng được gửi trong một yêu cầu giá thầu riêng biệt, trong đó các thuộc tính như mã thanh toán đủ điều kiện có liên quan đến định dạng được chỉ định trong yêu cầu.

Yêu cầu giá thầu chứa các định dạng sau sẽ được làm phẳng thành các yêu cầu giá thầu riêng biệt:

  • Biểu ngữ
  • Video
  • Âm thanh
  • Mã gốc

Ví dụ về việc làm phẳng định dạng quảng cáo

Dưới đây là ví dụ cho thấy một yêu cầu giá thầu JSON OpenRTB đơn giản hoá không có tính năng làm phẳng định dạng quảng cáo so với một nhóm yêu cầu làm phẳng tương đương:

Làm phẳng trước

Sau khi làm phẳng

Ưu đãi

Cơ hội quảng cáo cho một bên đặt giá thầu nhất định có thể áp dụng cho nhiều loại giao dịch, ngoài phiên đấu giá mở. Khi áp dụng tính năng phân tách giá thầu cho giao dịch, một yêu cầu giá thầu sẽ được gửi cho phiên đấu giá mở và một yêu cầu cho mỗi loại giao dịch theo giá cố định. Trên thực tế, các quy tắc ràng buộc về quảng cáo có thể khác nhau giữa phiên đấu giá và các loại giao dịch theo giá cố định. Ví dụ: đối với một cơ hội quảng cáo dạng video nhất định có sẵn cho cả phiên đấu giá mở và giao dịch theo giá cố định, bên đặt giá thầu sẽ nhận được các yêu cầu giá thầu riêng biệt cho từng cơ hội, trong đó các quy tắc ràng buộc như thời lượng quảng cáo tối đa và việc có cho phép quảng cáo có thể bỏ qua hay không có thể khác nhau. Do đó, việc áp dụng quy trình làm phẳng cho cơ hội quảng cáo giúp bạn dễ dàng phân biệt các quy tắc ràng buộc quảng cáo cho phiên đấu giá mở và giao dịch theo giá cố định.

Khả năng bỏ qua và thời lượng video

Thông số kỹ thuật OpenRTB không có các trường riêng biệt để chỉ định thời lượng video tối đa của quảng cáo có thể bỏ qua và quảng cáo không thể bỏ qua. Cách triển khai của Google sử dụng tính năng phân tách giá thầu để phân biệt giữa các trường này bằng cách sử dụng các trường BidRequest.video.maxduration và BidRequest.video.skip hiện có.

Sau đây là ví dụ về cách làm phẳng khoảng không quảng cáo dạng video khi thời lượng tối đa của quảng cáo không thể bỏ qua là 15 và thời lượng tối đa của quảng cáo có thể bỏ qua là 60.

Ví dụ max_ad_duration skip (đúng HOẶC sai)
Yêu cầu ban đầu không có tính năng làm phẳng 15 true
Yêu cầu được làm phẳng số 1: Không thể bỏ qua 15 false
Yêu cầu được làm phẳng số 2: Có thể bỏ qua 60 true

Chế độ phân tách yêu cầu giá thầu theo thời lượng video có thể bỏ qua sẽ chỉ diễn ra khi đáp ứng các điều kiện sau:

  • Yêu cầu này cho phép video.
  • Cả video có thể bỏ qua và không thể bỏ qua đều được cho phép, và hai thời lượng tối đa tương ứng có giá trị khác nhau.
  • Yêu cầu này đủ điều kiện cho Phiên đấu giá kín hoặc Phiên đấu giá mở.

Bạn có thể chọn không sử dụng kiểu làm phẳng này bằng cách liên hệ với người quản lý tài khoản hỗ trợ kỹ thuật. Khi bạn tắt chế độ này và nhà xuất bản cho phép cả quảng cáo dạng video có thể bỏ qua và không thể bỏ qua có thời lượng tối đa khác nhau dựa trên khả năng bỏ qua, thì skip sẽ được đặt thành true và maxduration sẽ được đặt thành thời lượng ngắn hơn giữa các quy tắc ràng buộc của quảng cáo có thể bỏ qua và không thể bỏ qua.

Nhóm video

Yêu cầu giá thầu cho một nhóm video có nhiều cơ hội quảng cáo sẽ được làm phẳng, sao cho mỗi yêu cầu giá thầu là cho một cơ hội quảng cáo riêng lẻ từ nhóm đó. Nhờ đó, bạn có thể đặt giá thầu cho nhiều cơ hội quảng cáo trong một nhóm quảng cáo nhất định.

Đo lường mở

Tính năng Đo lường mở cho phép bạn chỉ định các nhà cung cấp bên thứ ba cung cấp dịch vụ đo lường và xác minh độc lập cho quảng cáo được phân phát đến môi trường ứng dụng di động.

Bạn có thể xác định xem nhà xuất bản có hỗ trợ Đo lường mở trong yêu cầu giá thầu hay không bằng cách kiểm tra xem cơ hội quảng cáo có loại trừ thuộc tính OmsdkType: OMSDK 1.0 có trong Thuộc tính mẫu quảng cáo mà nhà xuất bản có thể loại trừ hay không. Bạn có thể tìm thấy thông tin này trong thuộc tính battr cho Biểu ngữ hoặc Video, tuỳ thuộc vào định dạng.

Để biết thêm thông tin về cách diễn giải các yêu cầu giá thầu có chứa tín hiệu Đo lường mở, hãy tham khảo bài viết về SDK Đo lường mở trên Trung tâm trợ giúp.

Yêu cầu giá thầu mẫu

Các phần sau đây trình bày các yêu cầu giá thầu mẫu cho nhiều loại quảng cáo.

Biểu ngữ ứng dụng

OpenRTB Protobuf

OpenRTB JSON

Quảng cáo xen kẽ trong ứng dụng

OpenRTB Protobuf

OpenRTB JSON

Video quảng cáo xen kẽ trong ứng dụng

OpenRTB Protobuf

OpenRTB JSON

Quảng cáo gốc trong ứng dụng

OpenRTB Protobuf

OpenRTB JSON

Video trên web

OpenRTB Protobuf

OpenRTB JSON

Biểu ngữ web dành cho thiết bị di động cho bên đặt giá thầu cùng sàn giao dịch

OpenRTB Protobuf

OpenRTB JSON

Quảng cáo gốc và quảng cáo dạng video nhiều định dạng

OpenRTB Protobuf

OpenRTB JSON