Xây dựng câu trả lời

Sau khi xử lý yêu cầu giá thầu từ Google, ứng dụng của bạn phải tạo và gửi một phản hồi. Hướng dẫn này giải thích cách viết mã ứng dụng để tạo phản hồi.

Tạo thông báo BidResponse

Để gửi giá thầu, ứng dụng đặt giá thầu của bạn phải phản hồi yêu cầu đặt giá thầu bằng một BidResponse chứa Bid theo định dạng mà bạn đã định cấu hình. Nếu bạn đang sử dụng định dạng JSON, thì phản hồi của bạn phải đặt tiêu đề Content-Type thành application/json; charset=utf-8 và đưa JSON BidResponse vào nội dung. Nếu đang sử dụng định dạng Protobuf, ứng dụng của bạn phải đặt tiêu đề Content-Type thành application/octet-stream và thêm BidResponse được chuyển đổi tuần tự vào nội dung.

Để tạo và chuyển đổi một BidResponse cho định dạng Protobuf, bạn phải tạo và sử dụng các thư viện Protobuf dựa trên openrtb.proto và openrtb-adx.proto. Các thư viện này lần lượt triển khai các trường BidResponse OpenRTB tiêu chuẩn và các tiện ích của Google trong Protobuf. Bạn có thể tìm thấy các thông tin này trong phần Protos & Reference Data (Dữ liệu tham chiếu và giao thức).

Nếu không muốn đặt giá thầu cho một lượt hiển thị, bạn phải trả về một phản hồi HTTP 204 trống. Ứng dụng của bạn phải trả về một phản hồi cho mọi BidRequest. Hết thời gian chờ và các phản hồi không phân tích cú pháp được coi là lỗi và Google sẽ điều tiết những bên đặt giá thầu có tỷ lệ lỗi cao.

Mã mẫu quảng cáo

BidResponse của bạn chỉ định một mẫu quảng cáo thông qua trường BidResponse.seatbid.bid.crid (giới hạn 128 byte). Ngay cả những mẫu quảng cáo tương tự cũng phải có giá trị riêng biệt cho trường này nếu chúng khác nhau về bất kỳ đặc điểm đáng chú ý nào, bao gồm nhưng không giới hạn ở: kích thước, URL đã khai báo, thuộc tính mẫu quảng cáo và loại nhà cung cấp. Nói cách khác, bạn phải chỉ định mã nhận dạng mẫu quảng cáo khác nhau cho hai quảng cáo bất kỳ có:

• Có vẻ ngoài hoặc hành vi khác biệt.
• Kết xuất thành nhiều hình ảnh.
• Hiển thị bằng nhiều cách (ví dụ: một quảng cáo bao gồm hình ảnh, trong khi quảng cáo kia là video).

Khi thiết kế ứng dụng, bạn nên quyết định một cách có hệ thống để tạo giá trị nhận dạng phù hợp với các loại mẫu quảng cáo mà bạn dự định gửi.

Thuộc tính quảng cáo

Google đề xuất bạn khai báo các thuộc tính mẫu quảng cáo để mô tả đặc điểm của quảng cáo và mục tiêu nhắm đến bằng cách sử dụng kết hợp BidResponse.seatbid.bid.apis và BidResponse.seatbid.bid.attr hoặc tiện ích BidResponse.seatbid.bid.ext.attribute. Sau đây là cách bạn có thể khai báo các thuộc tính:

• VPAID
  Đặt BidResponse.seatbid.bid.apis thành VPAID_1 hoặc VPAID_2. Đối với định dạng JSON, bạn có thể đặt giá trị này thành 1 hoặc 2 tương ứng.
• MRAID
  Đặt BidResponse.seatbid.bid.apis thành MRAID_1 hoặc 3 cho định dạng JSON.
• SIZELESS
  Đặt BidResponse.seatbid.bid.attr thành RESPONSIVE hoặc 18 cho định dạng JSON.
• PLAYABLE
  Bạn có thể chỉ định điều này bằng cách đặt BidResponse.seatbid.bid.attr thành USER_INTERACTIVE hoặc 13 cho định dạng JSON.

Lưu ý: Nếu đang sử dụng tiện ích BidResponse.seatbid.bid.ext.attribute, bạn có thể sử dụng các giá trị trong buyer-declarable-creative-attributes.txt để khai báo các thuộc tính này.

Hãy xem Tài nguyên mẫu quảng cáo để biết thông tin giải thích về cách nhận ý kiến phản hồi liên quan đến các thuộc tính được phát hiện của mẫu quảng cáo.

Các trường Đặt giá thầu mở

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

Trường	Thông tin chi tiết
BidResponse.imp.pmp.deals.id	Mã thoả thuận trong không gian tên của sàn giao dịch được liên kết với giá thầu này và được báo cáo cho nhà xuất bản. Lưu ý: Trường này chỉ được gửi cho những người tham gia thử nghiệm khép kín.
BidResponse.seatbid.bid.ext.exchange_deal_type	Loại giao dịch được báo cáo cho nhà xuất bản, ảnh hưởng đến cách giao dịch được xử lý trong phiên đấu giá. Lưu ý: Trường này chỉ được gửi cho những người tham gia thử nghiệm khép kín.
BidResponse.seatbid.bid.ext.third_party_buyer_token	Mã thông báo dùng để xác định thông tin người mua bên thứ ba cuối cùng nếu sàn giao dịch là một Người đặt giá thầu mở đóng vai trò trung gian. Thông tin này được lấy từ người mua bên thứ ba và phải được truyền đến Google mà không thay đổi trong phản hồi giá thầu.

Đề xuất

• Bật các kết nối HTTPS liên tục (còn gọi là "keep-alive" hoặc "connection reuse") trên máy chủ của bạn. Đặt thời gian chờ tối thiểu là 10 giây – trong nhiều trường hợp, giá trị cao hơn sẽ có lợi. Google xác minh điều này trong các kiểm thử độ trễ ban đầu của ứng dụng, vì Authorized Buyers gửi yêu cầu với tốc độ cao và cần tránh độ trễ khi thiết lập một kết nối TCP riêng cho mỗi yêu cầu.

• Thêm URL theo dõi lượt hiển thị (không bắt buộc) để theo dõi thời điểm lượt hiển thị hiển thị thay vì thời điểm giá thầu giành chiến thắng. Do sự sụt giảm giữa số lượt thắng và số lượt hiển thị, điều này mang lại số liệu thống kê theo dõi chính xác hơn.

  Lưu ý: Khi sử dụng OpenRTB, trường chuẩn cho thông tin này là BidResponse.seatbid.bid.burl.
• Giữ cho mã đặt giá thầu của bạn không phụ thuộc vào các trường không dùng nữa. Điều này có thể khiến giá thầu của bạn không thành công do lỗi.
• Thêm BidResponse.seatbid.bid.w và BidResponse.seatbid.bid.h vào BidResponse. BidResponse cho một yêu cầu bao gồm nhiều kích thước quảng cáo phải có các trường này, nếu không yêu cầu đó sẽ bị loại khỏi phiên đấu giá.
• Giới hạn kích thước phản hồi ở mức dưới 8K. Các phản hồi có kích thước rất lớn có thể làm tăng độ trễ mạng và gây ra tình trạng hết thời gian chờ.
• Làm theo các nguyên tắc về giá thầu trên khoảng không quảng cáo iOS yêu cầu mô hình phân bổ SKAdNetwork.

Ví dụ về phản hồi giá thầu

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

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "1lY5z94y6Bz404R9H0ZN38"
seatbid {
  bid {
    id: "n1KLe2Q26Xyu431W1PU"
    impid: "1"
    price: 1.0575798749923706
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    crid: "test_creative_id_666097"
    dealid: "0"
    w: 339
    h: 53
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 86548870602
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 7
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "1lY5z94y6Bz404R9H0ZN38",
  "seatbid": [
    {
      "bid": [
        {
          "id": "n1KLe2Q26Xyu431W1PU",
          "impid": "1",
          "price": 1.0575798749923706,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "crid": "test_creative_id_666097",
          "dealid": "0",
          "w": 339,
          "h": 53,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "86548870602",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 7
  }
}

Quan trọng: Các thông báo Protobuf được mô tả trong các mẫu được trình bày ở đây dưới dạng văn bản dễ đọc. Tuy nhiên, đó không phải là cách các thông báo được gửi qua mạng. Khi sử dụng định dạng OpenRTB Protobuf, hệ thống sẽ chỉ chấp nhận các thông báo BidResponse được chuyển đổi tuần tự.

Bạn có thể tạo và chuyển đổi một thông báo BidResponse thành chuỗi bằng cách sử dụng mã C++ sau:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Chỉ định mẫu quảng cáo

Phản hồi giá thầu của bạn chỉ định mẫu quảng cáo sẽ phân phát nếu giá thầu của bạn thắng. Giá thầu của bạn phải bao gồm một trong các định dạng quảng cáo được hỗ trợ (AMP, video, quảng cáo gốc). Trong ví dụ này, chúng ta chỉ định mẫu quảng cáo bằng cách sử dụng trường html_snippet.

Ngoài ra, bạn có thể chỉ định mẫu quảng cáo bằng cách sử dụng một trong các trường sau, dựa trên định dạng quảng cáo:

• Quảng cáo do SDK hiển thị
  • BidResponse.seatbid.bid.ext.sdk_rendered_ad
• AMP
  • BidResponse.seatbid.bid.amp_ad_url
• Video
  • BidResponse.seatbid.bid.adm
• Quảng cáo gốc
  • BidResponse.seatbid.bid.adm_native

Chỉ định một quảng cáo được lưu trữ trên(các) máy chủ của riêng bạn bằng cách sử dụng một đoạn mã HTML trong trường BidResponse.seatbid.bid.adm. Đoạn mã được đặt trong một iFrame được chèn vào trang web, dẫn đến việc quảng cáo được truy xuất và hiển thị khi trang được tải. Bạn phải tạo đoạn mã HTML sao cho quảng cáo (biểu ngữ hoặc quảng cáo xen kẽ) hiển thị chính xác bên trong một iFrame và có kích thước phù hợp với vị trí quảng cáo mà bạn đang đặt giá thầu.

Ngoài ra, kích thước quảng cáo được khai báo trong giá thầu phản hồi phải khớp chính xác với một trong các tổ hợp kích thước trong yêu cầu giá thầu khi:

• Quảng cáo là biểu ngữ thông thường (không phải quảng cáo dạng video, quảng cáo gốc hoặc quảng cáo xen kẽ).
• Bên đặt giá thầu đã khai báo kích thước trong giá thầu phản hồi. Bạn phải khai báo kích thước bất cứ khi nào có nhiều kích thước trong yêu cầu.
• Quảng cáo xen kẽ là một trường hợp ngoại lệ. Đối với quảng cáo xen kẽ, chiều rộng phải bằng ít nhất 50% chiều rộng màn hình và chiều cao bằng ít nhất 40% chiều cao màn hình.

Bạn có thể chỉ định mẫu quảng cáo đoạn mã HTML bằng cách sử dụng mã HTML hợp lệ bất kỳ để hiển thị đúng cách, nhưng hãy lưu ý các quy tắc hạn chế khi chỉ định trường crid trong phần Tạo thông báo BidResponse. Một trường hợp sử dụng cho việc này là đưa thêm thông tin vào các đối số của URL được tìm nạp từ máy chủ của bạn trong quá trình hiển thị quảng cáo. Thao tác này cho phép bạn truyền dữ liệu tuỳ ý về lượt hiển thị trở lại máy chủ của riêng mình.

Hầu hết các chính sách đối với đoạn mã HTML được trả về trong phản hồi giá thầu đều giống như đối với quảng cáo của bên thứ ba. Hãy xem Nguyên tắc của chương trình Authorized Buyers, Yêu cầu đối với hoạt động phân phát quảng cáo của bên thứ ba và Khai báo URL chuyển qua trong quảng cáo để biết thêm thông tin.

Chỉ định macro

Macro là văn bản được định dạng, được nhúng vào một số trường phản hồi giá thầu có chứa URL. Các URL này sẽ được thay thế bằng một giá trị phù hợp tại thời điểm phân phát quảng cáo. Ví dụ: nếu giá thầu chiến thắng của bạn có chứa macro AUCTION_PRICE trong mẫu quảng cáo đoạn mã HTML đi kèm với giá thầu, thì macro đó sẽ được thay thế bằng một giá trị mà bạn có thể giải mã để xác định số tiền bạn đã trả cho lượt hiển thị trong phiên đấu giá.

Bạn có thể thêm macro vào các trường sau:

• BidResponse.seatbid.bid.adm

  Macro được hỗ trợ cho các định dạng đoạn mã HTML, gốc, URL video và XML VAST của video.

• BidResponse.seatbid.bid.adm_native.eventtrackers.url

• BidResponse.seatbid.bid.adm_native.imptrackers

• BidResponse.seatbid.bid.ext.amp_ad_url

  Chỉ macro WINNING_PRICE và WINNING_PRICE_ESC dành riêng cho Google được hỗ trợ cho mẫu quảng cáo AMP.

• BidResponse.seatbid.bid.burl

• BidResponse.seatbid.bid.ext.impression_tracking_url

  Hãy sử dụng phương thức này thay vì BidResponse.seatbid.bid.burl nếu bạn cần nhiều URL thanh toán.

Ví dụ: bạn có thể thêm một macro vào một đoạn mã HTML bằng cách nhúng ${MACRO} vào URL dùng để tìm nạp mẫu quảng cáo, trong đó MACRO là một trong các macro được hỗ trợ như mô tả trong quy cách OpenRTB.

Macro của Google

Google hỗ trợ các macro bổ sung ngoài những macro có trong quy cách OpenRTB. Các macro này được định dạng khác và sẽ xuất hiện dưới dạng %%MACRO%% nếu được nhúng trong một URL. Bảng sau đây mô tả các macro này:

Macro	Nội dung mô tả
ADVERTISING_IDENTIFIER	Cho phép người mua nhận IDFA trên iOS hoặc Mã nhận dạng cho quảng cáo của Android khi hiển thị lượt hiển thị. Hãy xem phần Giải mã giá trị nhận dạng nhà quảng cáo để biết thông tin chi tiết.
CACHEBUSTER	Giá trị biểu thị chuỗi của một số nguyên ngẫu nhiên, không dấu, có kích thước 4 byte.
CLICK_URL_UNESC	URL nhấp chuột không thoát cho quảng cáo. Trong đoạn mã, phiên bản thoát của URL lượt nhấp của bên thứ ba phải đi ngay sau macro. Ví dụ: nếu URL nhấp chuột của bên thứ ba là http://my.adserver.com/some/path/handleclick?click=clk, thì bạn có thể sử dụng mã sau với phiên bản thoát đơn của URL nhấp chuột của bên thứ ba sau lệnh gọi macro: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Tại thời điểm phân phát quảng cáo, quảng cáo này sẽ mở rộng thành: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Trước tiên, URL này sẽ đăng ký lượt nhấp với Google, sau đó chuyển hướng đến URL nhấp qua của bên thứ ba.
CLICK_URL_ESC	URL nhấp chuột được thoát cho quảng cáo. Hãy sử dụng giá trị này thay vì CLICK_URL_UNESC nếu trước tiên bạn cần truyền giá trị thông qua một máy chủ khác, sau đó máy chủ này sẽ trả về một lệnh chuyển hướng. Ví dụ: bạn có thể sử dụng mã sau trong một đoạn mã HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Tại thời điểm phân phát quảng cáo, quảng cáo này sẽ mở rộng thành: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Thao tác này sẽ đăng ký lượt nhấp bằng my.adserver.com. Sau đó, my.adserver.com sẽ chịu trách nhiệm chuyển hướng đến URL được truyền trong tham số google_click_url. Điều này giả định rằng my.adserver.com sẽ bỏ thoát tham số google_click_url. Bạn có thể thêm một URL được thoát hai lần sau %%CLICK_URL_ESC%%. Sau khi my.adserver.com hoàn tất việc huỷ thoát, hệ thống sẽ để lại một phiên bản được thoát đơn của URL được thêm vào google_click_url. Khi google_click_url được tìm nạp, nó sẽ huỷ thoát thêm một lần nữa rồi chuyển hướng.
CLICK_URL_ESC_ESC	URL được thoát hai lần cho quảng cáo. Hãy sử dụng giá trị này thay vì CLICK_URL_UNESC nếu trước tiên bạn cần truyền giá trị thông qua một máy chủ khác, sau đó máy chủ này sẽ trả về một lệnh chuyển hướng. Ví dụ: bạn có thể sử dụng mã sau trong một đoạn mã HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> Tại thời điểm phân phát quảng cáo, quảng cáo này sẽ mở rộng thành: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
SCHEME	Mở rộng thành http: nếu yêu cầu đặt giá thầu không yêu cầu SSL hoặc thành https: nếu yêu cầu đặt giá thầu yêu cầu SSL.
SITE	Miền được thoát URL của URL nội dung hoặc mã nhận dạng ẩn danh cho khoảng không quảng cáo ẩn danh.
SITE_URL	Không dùng nữa. Được thay thế bằng macro SITE có chức năng tương tự.
TZ_OFFSET	Chênh lệch múi giờ.
VERIFICATION	Các giá trị khác nhau cho sản phẩm và khi mẫu quảng cáo được quét trong quy trình xác minh. Định dạng là: %%?VERIFICATION:true-val:false-val%%, trong đó bạn có thể dùng mọi giá trị (ngoại trừ macro) cho true-val và false-val, kể cả chuỗi trống. Đối với tính năng Đặt giá thầu mở, các nền tảng trao đổi nên sử dụng macro này; sau khi sử dụng, các nền tảng phía nhu cầu không cần thực hiện thay đổi. Ví dụ: nếu một mẫu quảng cáo có chứa %%?VERIFICATION:-1:5000%% thì văn bản thay thế sẽ là 5000 khi phân phát và -1 trong quy trình xác minh. Điều này giúp phân biệt giữa hai nhóm ping này.
WINNING_PRICE	Chi phí được mã hoá cho lượt hiển thị (tức là CPI chứ không phải CPM) tính bằng đơn vị vi mô của đơn vị tiền tệ của tài khoản. Ví dụ: CPM chiến thắng là 5 USD tương ứng với 5.000.000 micros CPM hoặc 5.000 micros CPI. Giá trị đã giải mã của WINNING_PRICE trong trường hợp này sẽ là 5.000. Giá giành chiến thắng được chỉ định trong CPI. Để phân tích cú pháp macro này, bạn cần triển khai một ứng dụng giải mã thông tin xác nhận giá. Hãy tham khảo trang Giải mã thông tin xác nhận giá để biết thêm thông tin.
WINNING_PRICE_ESC	WINNING_PRICE được thoát URL.

Google yêu cầu bạn sử dụng macro CLICK_URL_UNESC hoặc CLICK_URL_ESC trong mẫu quảng cáo của quảng cáo do bên thứ ba phân phát. Google sử dụng macro CLICK_URL để theo dõi lượt nhấp.

Việc thoát URL trong macro sử dụng lược đồ sau:

• Ký tự dấu cách được thay thế bằng dấu cộng (+).
• Các ký tự chữ và số (0-9, a-z, A-Z) và các ký tự trong tập hợp !()*,-./:_~ vẫn không thay đổi.
• Tất cả các ký tự khác sẽ được thay thế bằng %XX, trong đó XX là số thập lục phân biểu thị ký tự.

Các quy định hạn chế và yêu cầu đối với nhà xuất bản

Yêu cầu giá thầu bao gồm thông tin về các loại quy định hạn chế và yêu cầu mà nhà xuất bản đặt ra đối với mẫu quảng cáo trong phiên đấu giá.

• BidRequest.bcat
  • Bạn có thể so sánh các danh mục bị chặn do trường này chỉ định với các danh mục được phát hiện cho mẫu quảng cáo mà bạn đã gửi bằng cách sử dụng trường detectedCategories của API Đặt giá thầu theo thời gian thực.
• BidRequest.imp.ext.allowed_vendor_type
• BidRequest.imp.secure
  • Trên thực tế, giá trị này sẽ luôn được đặt thành true vì Google yêu cầu tất cả mẫu quảng cáo đều phải hỗ trợ SSL.
• BidRequest.imp.{audio/banner/native/video}
• BidRequest.imp.{audio/banner/native/video}.api
• BidRequest.imp.{audio/banner/native/video}.battr
• BidRequest.imp.{audio/banner/video}.mimes

Không bao giờ đặt giá thầu với quảng cáo có chứa một tính năng bị hạn chế. Đối với các tính năng được phép như loại nhà cung cấp, chỉ trả về quảng cáo nếu loại nhà cung cấp của quảng cáo đó nằm trong danh sách allowed_vendor_type trong BidRequest. Bạn chỉ nên đưa những định dạng quảng cáo được chỉ định trong yêu cầu giá thầu bằng cách điền sẵn các trường như BidRequest.imp.banner vào giá thầu của mình. Hãy xem phần nhận xét về các trường này trong định nghĩa bộ đệm giao thức BidRequest để biết thêm thông tin chi tiết.

Nếu một quảng cáo được trả về trong BidResponse, bạn phải đặt chính xác các trường BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat và BidResponse.seatbid.bid.adomain hoặc BidResponse.seatbid.bid.adm_native.link.url trong BidResponse. Nếu một quảng cáo có nhiều giá trị áp dụng cho các trường này, thì bạn phải thêm mọi giá trị. Hãy xem phần nhận xét cho các trường này trong định nghĩa vùng đệm giao thức BidResponse để biết thêm thông tin chi tiết. Những câu trả lời không có các trường này sẽ bị loại bỏ.

Đo lường mở

Chức năng Đo lường mở cho phép bạn chỉ định những 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 các môi trường ứng dụng di động.

Các định dạng quảng cáo được hỗ trợ bao gồm quảng cáo dạng video, quảng cáo biểu ngữ và quảng cáo xen kẽ. Để biết thêm thông tin về cách sử dụng Open Measurement trong một phản hồi giá thầu có chứa các định dạng này, hãy tham khảo bài viết SDK Open Measurement trên Trung tâm trợ giúp.

Phản hồi giá thầu mẫu

Các phần sau đây cho thấy các phản hồi về giá thầu mẫu cho nhiều loại quảng cáo.

Lưu ý: Các mẫu Protobuf bao gồm đường liên kết tải xuống đến các phản hồi giá thầu được chuyển đổi tuần tự tương tự. Chúng không được đảm bảo là giống hệt nhau.

Biểu ngữ ứng dụng

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "4308k26S0C36XQ2z1dIo99"
seatbid {
  bid {
    id: "y2OcJw5j213rO95Gz78"
    impid: "1"
    price: 18.360865389304116
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    crid: "test_creative_id_391487"
    dealid: "1"
    w: 390
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      ad_choices_destination_url: "https://test.com/preferences"
      billing_id: 82364411103
      skadn {
        version: "4.0"
        network: "cF58w81X"
        itunesitem: "788729094"
        sourceapp: "1422994973"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "017e597c-3c7d-4a44-afeb-41cd9a17066f"
          timestamp: "1757235407882"
          signature: "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "017e597c-3c7d-4a44-afeb-41cd9a17066f"
          timestamp: "1757235407882"
          signature: "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
        }
        sourceidentifier: "5507"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
      clickurl: "example.com"
    }
  }
  seat: "2542:1534:245840"
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 3
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "4308k26S0C36XQ2z1dIo99",
  "seatbid": [
    {
      "bid": [
        {
          "id": "y2OcJw5j213rO95Gz78",
          "impid": "1",
          "price": 18.360865389304116,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "crid": "test_creative_id_391487",
          "dealid": "1",
          "w": 390,
          "h": 60,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "billing_id": "82364411103",
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com",
              "example.com"
            ]
          }
        }
      ],
      "seat": "2542:1534:245840"
    }
  ],
  "ext": {
    "processing_time_ms": 3
  }
}

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

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "U0t6Une80802A28Mi98o1t"
seatbid {
  bid {
    id: "300z78I726nCP7u4sFp"
    impid: "1"
    price: 149.83914184570312
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    crid: "test_creative_id_732353"
    dealid: "0"
    w: 360
    h: 715
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 68640308112
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 10
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "U0t6Une80802A28Mi98o1t",
  "seatbid": [
    {
      "bid": [
        {
          "id": "300z78I726nCP7u4sFp",
          "impid": "1",
          "price": 149.83914184570312,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "crid": "test_creative_id_732353",
          "dealid": "0",
          "w": 360,
          "h": 715,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "68640308112",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 10
  }
}

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

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "n40G42d551UX18627ao8lt",
  "seatbid": [
    {
      "bid": [
        {
          "id": "17u6BnD62h88r5q7066",
          "impid": "1",
          "price": 0.797848,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_987914",
          "w": 320,
          "h": 480,
          "cattax": 500,
          "ext": {
            "attribute": [
              47,
              50
            ],
            "billing_id": "55383762512",
            "skadn": {
              "version": "4.0",
              "network": "306el65O",
              "itunesitem": "832461214",
              "sourceapp": "977150768",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0054e0b9-0b53-4426-99dd-a1eefeb45565",
                  "timestamp": "1757329316673",
                  "signature": "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
                },
                {
                  "fidelity": 1,
                  "nonce": "0054e0b9-0b53-4426-99dd-a1eefeb45565",
                  "timestamp": "1757329316673",
                  "signature": "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
                }
              ],
              "sourceidentifier": "8396"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "ext": {
    "processing_time_ms": 20
  }
}

Ứng dụng gốc

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "550102L8So5v6gi4C00T36"
seatbid {
  bid {
    id: "U796oSA426V3U666ue8"
    impid: "1"
    price: 1.057860016822815
    crid: "test_creative_id_395811"
    dealid: "0"
    adm_native {
      ver: "1.2"
      assets {
        id: 6
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 200
          h: 200
          type: LOGO
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/image?id=123456"
          w: 800
          h: 800
          type: MAIN
        }
      }
      assets {
        id: 4
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      link {
        url: "https://www.google.com"
      }
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      ad_choices_destination_url: "https://test.com/preferences"
      event_notification_token {
        payload: "token"
      }
      billing_id: 73917825312
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 17
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "550102L8So5v6gi4C00T36",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U796oSA426V3U666ue8",
          "impid": "1",
          "price": 1.057860016822815,
          "crid": "test_creative_id_395811",
          "dealid": "0",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "73917825312",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":6,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":200,\"h\":200,\"type\":2}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":800,\"h\":800,\"type\":3}},{\"id\":4,\"data\":{\"value\":\"Galactic Luxury Cruises\",\"type\":1}},{\"id\":3,\"data\":{\"value\":\"Book today\",\"type\":12}},{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\",\"type\":2}}],\"link\":{\"url\":\"https://www.google.com\"}}"
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 17
  }
}

Video trên web

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "04XK8XoQI227314y42h0LL"
seatbid {
  bid {
    id: "R9TtHE88cGu48FA4DuG"
    impid: "1"
    price: 1.0523000955581665
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    crid: "test_creative_id_400281"
    dealid: "45957820"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 63495119434
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 11
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "04XK8XoQI227314y42h0LL",
  "seatbid": [
    {
      "bid": [
        {
          "id": "R9TtHE88cGu48FA4DuG",
          "impid": "1",
          "price": 1.0523000955581665,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "crid": "test_creative_id_400281",
          "dealid": "45957820",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "63495119434",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 11
  }
}

Biểu ngữ trên web di động cho đơn vị đặt giá thầu trao đổi

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "1qCcL0350ZX64rx8WQm7N1"
seatbid {
  bid {
    id: "9I6TCG083egHnxY1490"
    impid: "1"
    price: 0.34
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_607960"
    w: 320
    h: 100
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 29290087654
      third_party_buyer_token: "0W4u1J2Ya9GqKfzo925xPxN527l74y91z6P9h9b4s0Dg2t1q84O4S652wcHe63576VvK8aG6K7387yQujd13kdb99q75447qr6k332G4l3Mzhq75f155894Jg0U1vB18t73C24B4D1cd"
    }
  }
  bid {
    id: "1xHeg1ANn9RbY9n4rG2"
    impid: "1"
    price: 0.2
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_607960"
    w: 300
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      third_party_buyer_token: "ha1g9MaJIJ8R0110bkX95Jb0ksv78l4139zr4t98A19DDO6NCpX84TQp84a6H470M7mop5KzVHRyrJtn1zw78N1559WRm7554X7R21jnI0E1X7c10Xj98c08iH85742t76Y26H67cW78"
    }
  }
  seat: "3581:7507:419542"
}
seatbid {
  bid {
    id: "x0ch5K0vq3iY6M7ZT84"
    impid: "1"
    price: 0.11
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_607960"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
    }
  }
  seat: "3581:7507:419542"
}
bidid: "EFa8lD5s-3w28kZzd-4221-aZkE1F6r5810"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 250
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "1qCcL0350ZX64rx8WQm7N1",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9I6TCG083egHnxY1490",
          "impid": "1",
          "price": 0.34,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_607960",
          "w": 320,
          "h": 100,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "29290087654",
            "third_party_buyer_token": "0W4u1J2Ya9GqKfzo925xPxN527l74y91z6P9h9b4s0Dg2t1q84O4S652wcHe63576VvK8aG6K7387yQujd13kdb99q75447qr6k332G4l3Mzhq75f155894Jg0U1vB18t73C24B4D1cd"
          }
        },
        {
          "id": "1xHeg1ANn9RbY9n4rG2",
          "impid": "1",
          "price": 0.2,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_607960",
          "w": 300,
          "h": 50,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "third_party_buyer_token": "ha1g9MaJIJ8R0110bkX95Jb0ksv78l4139zr4t98A19DDO6NCpX84TQp84a6H470M7mop5KzVHRyrJtn1zw78N1559WRm7554X7R21jnI0E1X7c10Xj98c08iH85742t76Y26H67cW78"
          }
        }
      ],
      "seat": "3581:7507:419542"
    },
    {
      "bid": [
        {
          "id": "x0ch5K0vq3iY6M7ZT84",
          "impid": "1",
          "price": 0.11,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_607960",
          "w": 320,
          "h": 50,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3581:7507:419542"
    }
  ],
  "bidid": "EFa8lD5s-3w28kZzd-4221-aZkE1F6r5810",
  "ext": {
    "processing_time_ms": 250
  }
}