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 phản hồi. Hướng dẫn này giải thích cách mã hoá ứng dụng để tạo phản hồi.

Tạo thông báo Phản hồi giá thầu

Authorized Buyers gửi BidRequest dưới dạng nội dung thông báo của HTTP POST. Phản hồi mà ứng dụng của bạn gửi phải có tiêu đề Content-Type được đặt thành application/octet-stream và nội dung thông báo bao gồm vùng đệm giao thức được tuần tự hoá. Vùng đệm giao thức là một thông báo BidResponse như được xác định trong realtime-bidding.proto. Ứng dụng của bạn phải trả về một BidResponse có thể phân tích cú pháp để phản hồi mỗi BidRequest. Thời gian chờ và phản hồi không thể phân tích cú pháp bị coi là lỗi và Google sẽ điều tiết lại những bên đặt giá thầu có tỷ lệ lỗi cao.

Nếu không muốn đặt giá thầu cho một lượt hiển thị, bạn có thể đặt riêng trường processing_time_ms và để trống tất cả các trường khác. Bạn có thể lấy realtime-bidding.proto từ trang dữ liệu tham chiếu.

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 buyer_creative_id (giới hạn 64 byte). Ngay cả các mẫu quảng cáo tương tự phải có các giá trị duy nhất cho buyer_creative_id 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 cung cấp mã mẫu quảng cáo khác nhau cho hai quảng cáo bất kỳ:

• Nhìn hoặc hành xử khác đi.
• Kết xuất thành các hình ảnh khác nhau.
• 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 một quảng cáo khác chứa Flash).

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 loại mẫu quảng cáo mà bạn định gửi.

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

Bạn phải khai báo các thuộc tính mẫu quảng cáo mô tả đầy đủ các đặc điểm của quảng cáo và tiêu chí nhắm mục tiêu của quảng cáo đó trong BidResponse.Ad.attribute. Các thuộc tính phải được khai báo (bạn cũng có thể xem danh sách đầy đủ các thuộc tính được hỗ trợ tại buyer-declarable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Trong quảng cáo, có một pixel hoặc tín hiệu web nhằm mục đích tạo danh sách mã cookie cho hoạt động tiếp thị lại sau này.
• 8 Remarketing: IsRemarketing
  Quảng cáo nhắm mục tiêu người tiêu dùng dựa trên mã cookie hoặc Mã thiết bị, trong đó danh sách mã cookie hoặc Mã thiết bị đại diện cho một nhóm người tiêu dùng đã từng tương tác với trang web do người mua sở hữu hoặc đại diện.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Quảng cáo nhắm mục tiêu người tiêu dùng dựa trên mã cookie hoặc Mã thiết bị, trong đó danh sách mã cookie hoặc Mã thiết bị đại diện cho một tập hợp người tiêu dùng mà người mua đã xác định là một nhóm có mối quan tâm chung.
• 30 InstreamVastVideoType: Vpaid
  Quảng cáo yêu cầu hỗ trợ VPAID để hiển thị.
• 32 MraidType: MRAID
  Quảng cáo yêu cầu API MRAID để hiển thị.

Ngoài ra, các thuộc tính sau được hỗ trợ nhưng không bắt buộc phải khai báo vì Authorized Buyers tự động phát hiện các thuộc tính đó và sẽ chặn (hoặc cho phép) mẫu quảng cáo của bạn dựa trên các giá trị phát hiện được, thay vì thông tin khai báo của bạn. Hãy xem API Tệp sáng tạo để biết thông tin giải thích về cách nhận ý kiến phản hồi về các thuộc tính được phát hiện trong mẫu quảng cáo của bạn.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Quảng cáo yêu cầu hỗ trợ Flash để hiển thị.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  Quảng cáo không yêu cầu Flash để hiển thị.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  Quảng cáo có khả năng hiển thị trên trang SSL. Xin lưu ý rằng Authorized Buyers xem các mẫu quảng cáo có các giá trị được khai báo khác nhau của thuộc tính này là riêng biệt (các mẫu quảng cáo sẽ được xem xét riêng và có trạng thái phê duyệt riêng biệt). Do đó, nếu bạn đặt giá thầu bằng cả phiên bản SSL và không phải SSL của cùng một quảng cáo, thì bạn nên khai báo thuộc tính này cho phù hợp, để sự khác biệt này được phản ánh chính xác trong AdX.

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ính năng Đặt giá thầu mở gửi cũng tương tự như phản hồi của Authorized Buyers tham gia đặt giá thầu chuẩn theo thời gian thực. Khách hàng Đặt giá thầu mở có thể chỉ định một số ít trường bổ sung và một vài trường hiện có có thể có mục đích sử dụng thay thế. Các kiểu dữ liệu này bao gồm:

OpenRTB	Authorized Buyers	Thông tin chi tiết
BidResponse.imp[].pmp.deals[].id	BidResponse.ad[].adslot[].exchange_deal_id	Mã giao dịch từ không gian tên của đối tác trao đổi đượ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 ý: Hiện tại, trường này chỉ được gửi cho những người tham gia chương trình thử nghiệm beta kín.
BidResponse.seatbid[].bid[].ext.exchange_deal_type	BidResponse.ad[].adslot[].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 ý: Hiện tại, trường này chỉ được gửi cho những người tham gia chương trình thử nghiệm beta kín.
BidResponse.seatbid[].bid[].ext.third_party_buyer_token	BidResponse.ad[].adslot[].third_party_buyer_token	Mã thông báo được dùng để xác định thông tin về người mua bên thứ ba cuối nếu bên trao đổi là Bên đặt giá thầu mở là bên trung gian. Giá trị này lấy từ người mua bên thứ ba và phải được chuyển cho 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 cố định (còn gọi là "duy trì hoạt động" hoặc "sử dụng lại kết nối") 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 có lợi. Google xác minh điều này trong các lần kiểm tra độ 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 chi phí về độ trễ khi thiết lập kết nối TCP riêng cho mỗi yêu cầu.

• Bao gồ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 bên đặt giá thầu giành chiến thắng. Do sự sụt giảm giữa các lượt chiến thắng và kết xuất, nên số liệu thống kê theo dõi chính xác hơn.

  Lưu ý: Khi sử dụng OpenRTB 2.5 trở lên, trường tiêu chuẩn cho trường này là BidResponse.seatbid[].bid[].burl.
• Đảm bảo mã bên đặt giá thầu không có phần phụ thuộc trên các trường không dùng nữa. Việc này có thể khiến giá thầu của bạn không thành công do lỗi.
• Đưa BidResponse.Ad.width và BidResponse.Ad.height vào BidResponse của bạn. BidResponse cho một yêu cầu có nhiều kích thước quảng cáo phải bao gồm các giá trị width và height, nếu không, giá trị này sẽ bị loại khỏi phiên đấu giá.
• Giới hạn kích thước phản hồi của bạn ở dưới 8K. Phản hồi rất lớn có thể làm tăng độ trễ mạng và gây hết thời gian chờ.
• Tuân thủ 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 thể hiện các mẫu yêu cầu Protobuf và JSON mà con người có thể đọc được.

Google

Ví dụ minh họa

ad {
  html_snippet: "<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>"
  adslot {
    id: 1
    max_cpm_micros: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

Định dạng JSON OpenRTB

Ví dụ minh họa

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "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"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

Protobuf OpenRTB

Ví dụ minh họa

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    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"
    cid: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

Lưu ý quan trọng: Thông điệp Protobuf được mô tả trong mẫu được biểu thị ở đây dưới dạng văn bản mà con người có thể đọc được. Tuy nhiên, đó không phải là cách tin nhắn được gửi qua mạng. Khi sử dụng định dạng Google hoặc OpenRTB Protobuf, chỉ các thông báo Phản hồi giá thầu nối tiếp mới được chấp nhận.

Bạn có thể tạo và chuyển đổi tuần tự một thông báo BidResponse 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 để 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 tôi 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 của mình 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.Ad.sdk_rendered_ad
• AMP
  • BidResponse.Ad.amp_ad_url
• Video
  • BidResponse.Ad.video_url hoặc
  • BidResponse.Ad.video_vast_xml
• Quảng cáo gốc
  • BidResponse.Ad.native_ad

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 đoạn mã HTML trong trường html_snippet của BidResponse. Đ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 để 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 IFrame và ở kích thước phù hợp cho vùng 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 phản hồi giá thầu 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 biểu 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ẽ có 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 và chiều cao bằng 40% chiều cao màn hình.

Trường html_snippet hỗ trợ mọi mã HTML hợp lệ hiển thị đúng cách, nhưng hãy lưu ý các hạn chế khi chỉ định trường buyer_creative_id trong phần Tạo thông báo Phản hồi giá thầu. Một cách 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. Điều này cho phép bạn truyền dữ liệu tuỳ ý về lượt hiển thị về máy chủ của riêng bạn.

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

Chỉ định macro

Đoạn mã HTML xác định mẫu quảng cáo có thể bao gồm một hoặc nhiều cấu trúc đặc biệt được gọi là macro. Tại thời điểm phân phát quảng cáo, các giá trị được thay thế cho macro. Ví dụ: ứng dụng đặt giá thầu mà máy khách của bạn có thể sử dụng macro WINNING_PRICE để xác định số tiền đã trả cho quảng cáo, nếu ứng dụng đó thắng phiên đấu giá. Để 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 Xác nhận giá giải mã để biết thêm thông tin.

Chỉ định macro như một phần của đoạn mã HTML theo định dạng %%MACRO%%, trong đó MACRO là một trong những macro được hỗ trợ được liệt kê trong bảng dưới đây.

Lưu ý: Đối với phản hồi giá thầu quảng cáo AMP (amp_ad_url), hệ thống chỉ hỗ trợ macro WINNING_PRICE và WINNING_PRICE_ESC.

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.

Để sử dụng macro, hãy đưa macro đó vào quảng cáo để hệ thống tìm nạp URL khi có người nhấp vào URL đó. Giá trị trả về của tìm nạp là một lệnh chuyển hướng đến một URL khác mà bạn thêm vào CLICK_URL.

Lưu ý: Ngoài các macro DoubleClick này, chúng tôi cũng hỗ trợ các macro OpenRTB. Hãy xem phần Thông số kỹ thuật OpenRTB để biết thêm thông tin về macro OpenRTB.

Macro	Mô tả
ADVERTISING_IDENTIFIER	Cho phép người mua nhận IDFA của 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 bài viết Giải mã giá trị nhận dạng của nhà quảng cáo để biết thông tin chi tiết.
CACHEBUSTER	Một chuỗi đại diện của một số nguyên 4 byte ngẫu nhiên, chưa có dấu.
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 nhấp chuột bên thứ ba phải trực tiếp theo sau macro. Ví dụ: nếu URL lượt nhấp của bên thứ ba là http://my.adserver.com/some/path/handleclick?click=clk, thì bạn có thể dùng mã sau với phiên bản thoát đơn của URL lượt nhấp 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, quyền này được mở rộng để: <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 sẽ đăng ký lượt nhấp với Google, sau đó chuyển hướng đến URL lượt nhấp của bên thứ ba.
CLICK_URL_ESC	URL lượt nhấp thoát cho quảng cáo. Sử dụng phương thức này thay vì CLICK_URL_UNESC nếu trước tiên bạn cần chuyển giá trị thông qua một máy chủ khác, máy chủ này sẽ trả về lệnh chuyển hướng. Ví dụ: bạn có thể sử dụng mã sau trong đ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, quyền này được mở rộng để: <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 đó, hệ thống sẽ chịu trách nhiệm chuyển hướng đến URL được chuyển trong tham số google_click_url. Điều này giả định rằng my.adserver.com không thoát tham số google_click_url. Bạn có thể thêm một URL thoát kép sau %%CLICK_URL_ESC%%. Sau khi my.adserver.com thực hiện thao tác thoát, điều đó sẽ để lại một phiên bản thoát duy nhất của URL được thêm vào google_click_url. Khi được tìm nạp, google_click_url sẽ không thoát một lần nữa rồi chuyển hướng.
CLICK_URL_ESC_ESC	URL thoát kép cho quảng cáo. Sử dụng phương thức này thay vì CLICK_URL_UNESC nếu trước tiên bạn cần chuyển giá trị thông qua một máy chủ khác, máy chủ này sẽ trả về lệnh chuyển hướng. Ví dụ: bạn có thể sử dụng mã sau trong đ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, quyền này được mở rộng để: <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	Được mở rộng thành http: nếu yêu cầu giá thầu không yêu cầu SSL hoặc thành https: nếu yêu cầu giá thầu yêu cầu SSL.
SITE	Miền được thoát khỏi url của URL nội dung hoặc ID ẩn danh đối với khoảng không quảng cáo ẩn danh.
SITE_URL	Không dùng nữa. Được thay thế bằng macro Sites cung cấp chức năng tương tự.
TZ_OFFSET	Mức chênh lệch múi giờ.
VERIFICATION	Các giá trị khác nhau cho phiên bản chính thức và thời điểm quét mẫu quảng cáo trong quy trình xác minh. Định dạng là: %%?VERIFICATION:true-val:false-val%%, trong đó, bạn có thể dùng bất kỳ giá trị nào ngoại trừ macro cho true-val và false-val, bao gồm cả các chuỗi trống. Đối với tính năng Đặt giá thầu mở, các sàn giao dịch nên sử dụng macro này; sau khi họ làm như vậy, các nền tảng bên cầu không cần thực hiện thay đổi. Ví dụ: nếu mẫu quảng cáo sử dụng %%?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. Thao tác này giúp phân biệt giữa 2 bộ ping này.
WINNING_PRICE	Chi phí hiển thị được mã hoá (tức là CPI thay vì CPM) tính bằng phần triệu đơ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 CPM hoặc CPI 5.000 micro giây. Trong trường hợp này,giá trị đã giải mã của WINNING_PRICE sẽ là 5.000. Giá chiến thắng được chỉ định trong CPI.
WINNING_PRICE_ESC	WINNING_PRICE có ký tự thoát URL.

Tính năng 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ữ 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 được thay thế bằng %XX, trong đó XX là số thập lục phân đại diện cho ký tự đó.

Các quy định hạn chế dành cho nhà xuất bản

Nhà xuất bản sử dụng BidRequest để chuyển các giới hạn về loại quảng cáo mà họ sẽ cho phép. Bạn bắt buộc phải thực thi các quy định hạn chế trong các trường sau:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

Một trường chỉ định các tính năng được phép của quảng cáo và trường còn lại chỉ định các tính năng không được phép. Không bao giờ trả lại quảng cáo có tính năng không được phép. Đối với các tính năng được phép chẳng hạn 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 đó có trong danh sách allowed_vendor_type trong BidRequest. Xem nhận xét về các trường này trong phần định nghĩa vùng đệm giao thức BidRequest để biết thêm thông tin chi tiết.

Nếu một đoạn mã HTML được trả về trong BidResponse, thì bạn phải đặt chính xác các trường attribute, category và click_through_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 đưa vào mọi giá trị. Xem nhận xét cho các trường này trong phần định nghĩa vùng đệm giao thức BidResponse để biết thêm thông tin chi tiết. Những phản hồi không đặt các trường này sẽ bị loại bỏ.

Các giá trị có thể có của BidRequest.excluded_attribute là (xem publisher-excludable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Quảng cáo không được phép nếu chứa điểm ảnh hoặc tín hiệu web nhằm mục đích tạo danh sách mã cookie cho hoạt động tiếp thị lại sau này.
• 8 CookieTargeting: IsCookieTargeted
  Quảng cáo không được phép quảng cáo nếu các quảng cáo đó nhắm đến người tiêu dùng dựa trên mã cookie của họ, trong đó danh sách mã cookie đại diện cho một tập hợp người tiêu dùng đã từng tương tác với trang web do người mua sở hữu hoặc đại diện.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Quảng cáo không được phép quảng cáo nhắm đến người tiêu dùng dựa trên mã cookie của họ, trong đó danh sách mã cookie đại diện cho một tập hợp người tiêu dùng mà người mua đã xác định là nhóm có mối quan tâm chung.
• 21 CreativeType: Html
  Quảng cáo không được phép sử dụng trường html_snippet hoặc snippet_template trong BidResponse.Ad.
• 22 CreativeType: VastVideo
  Quảng cáo không được phép sử dụng trường video_url trong BidResponse.Ad.
• 30 InstreamVastVideoType: Vpaid
  Quảng cáo không được phép yêu cầu hỗ trợ VPAID để hiển thị.
• 32 MraidType: MRAID
  Quảng cáo không được phép yêu cầu API MRAID để hiển thị.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Quảng cáo không được phép yêu cầu hỗ trợ Flash để hiển thị.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  Quảng cáo không được phép yêu cầu các tính năng HTML5 hiển thị.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  Quảng cáo không được phép thực hiện yêu cầu không phải SSL.

Do đó, nếu trường excluded_attribute chứa giá trị 7, thì bạn không nên trả về quảng cáo sử dụng pixel hoặc tín hiệu web để tạo danh sách. Lưu ý rằng nếu một quảng cáo thực hiện việc này, thì quảng cáo phải đặt giá trị 7 trong trường thuộc tính của BidResponse. Tương tự, nếu trường excluded_attribute chứa giá trị 48, thì bạn chỉ nên trả về những quảng cáo có thể hiển thị trên trang SSL (và theo đó hãy khai báo thuộc tính 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Ngoài ra, trường excluded_sensitive_category trong BidRequest sử dụng các mã từ tệp ad-sensitive-categories.txt có trên trang dữ liệu tham chiếu. Dưới đây là nội dung mô tả mở rộng về một số mã trong số này:

• 3 Politics
  Bao gồm các vấn đề về chính trị hoặc xã hội gây tranh cãi; không bao gồm quảng cáo cho các hãng tin thường không có quan điểm ủng hộ về các vấn đề đó.
• 4 Dating
  Bao gồm các dịch vụ hẹn hò và các cộng đồng hẹn hò trực tuyến.
• 5 Religion
  Bao gồm các quảng cáo về tôn giáo và quảng cáo ủng hộ hoặc chống lại các quan niệm về tôn giáo; không bao gồm quảng cáo tử vi hoặc mang tính duy linh không thuộc giáo phái nào.
• 7 Video Games (Casual & Online)
  Bao gồm trò chơi điện tử, trò chơi trực tuyến và trò chơi có thể tải xuống; không bao gồm máy chơi trò chơi điện tử.
• 8 Ringtones & Downloadables
  Các tiện ích bổ sung cho thiết bị di động, bao gồm nhạc chuông và các ứng dụng có thể tải xuống khác, chẳng hạn như trình bảo vệ màn hình và hình nền cho máy tính, cũng như bố cục cấu hình và hình ảnh đồ hoạ cho mạng xã hội.
• 10 Get Rich Quick
  Các chiến dịch hứa hẹn thu nhập nhanh chóng.
• 18 Weight Loss
  Bao gồm việc giảm cân, ăn kiêng cũng như các sản phẩm và chương trình có liên quan; không bao gồm các quảng cáo về ăn uống lành mạnh hoặc thể hình nói chung.
• 19 Cosmetic Procedures & Body Modification
  Bao gồm nâng ngực, hút mỡ, kỹ thuật laser, cắt và nối tóc, xăm hình và chỉnh sửa cơ thể.
• 23 Drugs & Supplements:
  Bao gồm các loại dược phẩm, vitamin, thực phẩm bổ sung và các loại thuốc bán lẻ có liên quan; không bao gồm các nguồn cung cấp thông tin về thuốc.
• 24 Sexual & Reproductive Health
  Bao gồm các quảng cáo về chức năng giới tính và sinh sản; không bao gồm các nguồn về việc mang thai thông thường.
• 35 Social Casino Games
  Bao gồm các trò chơi mô phỏng cờ bạc (bao gồm nhưng không giới hạn, bài xì phé, máy đánh bạc, trò chơi cờ bạc, xổ số, cá cược thể thao, cá cược cuộc đua, cũng như các trò chơi thẻ bài và trò chơi đánh bạc khác) không mang đến cơ hội chiến thắng bất kỳ thứ gì có giá trị (chẳng hạn như tiền hoặc phần thưởng).
• 36 Significant Skin Exposure
  Hình ảnh quảng cáo có bất kỳ bộ phận nào của cơ thể người từ xương ức đến giữa đùi không được mặc quần áo; hoặc cơ thể mặc đồ lót, đồ bơi, nội y hoặc các trang phục xuyên thấu hay các vật dụng không phải quần áo như khăn hoặc ga trải giường.
• 37 Sensationalism
  Quảng cáo nhằm mục đích khuyến khích người dùng nhấp vào bằng cách thu hút sự tò mò của họ, thường là bằng cách sử dụng thông điệp kích thích với ngôn từ hoặc hình ảnh cường điệu. Bao gồm cả quảng cáo tập trung vào các chủ đề giật gân (chẳng hạn như người nổi tiếng bắt giữ, chết hoặc ly hôn) hoặc có mục đích gây sốc.

Đo lường mở

Tính 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 những quảng cáo được phân phát đến môi trường ứng dụng di động.

Các định dạng quảng cáo được hỗ trợ hiện 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 tính năng Đo lường mở trong một giá thầu phản hồi chứa các định dạng này, hãy tham khảo bài viết về SDK đo lường mở trên Trung tâm trợ giúp.

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

Các mục sau đây trình bày các phản hồi giá thầu mẫu cho các loại quảng cáo khác nhau.

Biểu ngữ ứng dụng

Google

Ví dụ minh họa

ad {
  html_snippet: "<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>"
  adslot {
    id: 1
    max_cpm_micros: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

Định dạng JSON OpenRTB

Ví dụ minh họa

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "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>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

Protobuf OpenRTB

Ví dụ minh họa

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    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"
    cid: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

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

Google

Ví dụ minh họa

ad {
  html_snippet: "<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>"
  adslot {
    id: 1
    max_cpm_micros: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

Định dạng JSON OpenRTB

Ví dụ minh họa

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "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"
          ],
          "cid": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

Protobuf OpenRTB

Ví dụ minh họa

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    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"
    cid: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

Video xen kẽ trong ứng dụng

Google

Ví dụ minh họa

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

Protobuf OpenRTB

Ví dụ minh họa

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

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

Google

Ví dụ minh họa

ad {
  adslot {
    id: 1
    max_cpm_micros: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

Định dạng JSON OpenRTB

Ví dụ minh họa

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

Protobuf OpenRTB

Ví dụ minh họa

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

Video trên web

Google

Ví dụ minh họa

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Biểu ngữ web dành cho thiết bị di động cho bên đặt giá thầu trao đổi

Protobuf OpenRTB

Ví dụ minh họa

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    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"
    cid: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}