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

Sau khi xử lý yêu cầu giá thầu của 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 lập trình ứng dụng của bạn để tạo bản dựng nội dung phản hồi.

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

Authorized Buyers gửi BidRequest dưới dạng nội dung thư của POST HTTP. Nếu điểm cuối đặt giá thầu được định cấu hình để sử dụng định dạng Protobuf, thì ứng dụng của bạn phải gửi một phản hồ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 chuyển đổi tuần tự. Vùng đệm giao thức là một thông báo BidResponse như được xác định trong openrtb.proto. Ứng dụng của bạn phải trả về một trình phân tích cú pháp BidResponse để phản hồi mỗi BidRequest. Số lần bị tạm ngừng và những phản hồi không thể phân tích cú pháp sẽ bị coi là lỗi và Google sẽ chặn 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 Chỉ có BidResponse.ext.processing_time_ms và để lại tất cả các trường khác trống. Bạn có thể lấy openrtb.proto từ trang dữ liệu tham chiếu.

Mã mẫu quảng cáo

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

• Có vẻ ngoài hoặc hành vi khác.
• Hiển thị sang các hình ảnh khác.
• Kết xuất theo nhiều phương thức (ví dụ: một quảng cáo bao gồm hình ảnh, còn quảng cáo còn lại là video).

Khi thiết kế ứng dụng, bạn nên quyết định theo 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 dự định để gửi.

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

Bạn nên khai báo các thuộc tính mẫu quảng cáo để mô tả các đặc điểm và tiêu chí nhắm mục tiêu của quảng cáo bằng cách kết hợp BidResponse.seatbid.bid.apis và BidResponse.seatbid.bid.attr hoặc tiện ích BidResponse.seatbid.bid.ext.attribute. Nội dung sau đây mô tả 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
  Điều này được thể hiện bằng cách đặt BidResponse.seatbid.bid.attr thành USER_INTERACTIVE hoặc 13 đối với JSON .

Xem Tài nguyên về mẫu quảng cáo để được giải thích về cách nhậ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ủa mình.

Các trường trong tính năng Đặt giá thầu mở

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

Đề xuất

• Bật kết nối HTTPS ổn định (còn gọi là "keep-alive" 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 – các giá trị cao hơn sẽ có lợi trong nhiều trường hợp. Google xác minh điều này trong quá trình 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 hao tổn độ trễ khi thiết lập kết nối TCP riêng cho từng yêu cầu.

• Bao gồm URL theo dõi lượt hiển thị tuỳ chọn để theo dõi khi lượt hiển thị hiển thị thay vì khi bên đặt giá thầu thắng. Do sự sụt giảm giữa số lần chiến thắng và số lần kết xuất, điều này sẽ mang lại số liệu thống kê theo dõi chính xác hơn.

• Đảm bảo mã của 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, vì điều này có thể khiến giá thầu của bạn không thành công và gặp lỗi.
• Thêm BidResponse.seatbid.bid.w và BidResponse.seatbid.bid.h vào BidResponse. BidResponse đến một yêu cầu bao gồm nhiều kích thước quảng cáo phải bao gồm các trường này, nếu không sẽ bị loại khỏi phiên đấu giá.
• Giới hạn kích thước câu trả lời dưới 8K. Phản hồi quá nhiều có thể tăng độ trễ mạng và gây ra thời gian chờ.
• Làm theo hướng dẫn 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 Protobuf mà con người có thể đọc được và Yêu cầu JSON.

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    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: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [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"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "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": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

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: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

Lưu ý 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 mà con người có thể đọc được. Tuy nhiên, đó không phải là cách gửi thông báo qua mạng. Khi sử dụng Google hoặc OpenRTB Protobuf thì chỉ thông báo phản hồi giá thầu được chuyển đổi tuần tự 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 mã C++ sau đây:

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

Giá thầu phản hồi 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 những định dạng quảng cáo được hỗ trợ (AMP, video, gốc). Trong phần này ví dụ: chúng tôi chỉ định mẫu quảng cáo bằ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.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 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 đưa vào một iFrame được chèn vào trang web, nhờ đó 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 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 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à một 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 phản hồi giá thầu. Bạn bắt buộc 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.
• Một trường hợp ngoại lệ là quảng cáo xen kẽ. Đố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 ít nhất 40% của màn hình 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 bất kỳ mã HTML hợp lệ nào hiển thị đúng cách, nhưng hãy lưu ý các quy định hạn chế về việc chỉ định trường crid trong phần Tạo thông báo BidResponse. Một cách sử dụng cho trường hợp 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 chuyển dữ liệu tuỳ ý về lượt hiển thị về lại máy chủ của riêng bạn.

Hầu hết các chính sách cho đoạn mã HTML được trả về trong giá thầu phản hồi đều giống với cho quảng cáo của bên thứ ba. Xem Authorized Buyers Nguyên tắc chương trình, Yêu cầu đối với bên thứ ba việc phân phát quảng cáo và Khai báo URL của trang đích khi nhấp 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 nhúng vào một số trường phản hồi giá thầu chứa các URL được thay thế bằng một giá trị có liên quan 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 bao gồm 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ể bao gồm macro trong các trường sau:

• BidResponse.seatbid.bid.adm

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

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

• BidResponse.seatbid.bid.adm_native.imptrackers

• BidResponse.seatbid.bid.ext.amp_ad_url

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

• BidResponse.seatbid.bid.burl

• BidResponse.seatbid.bid.ext.impression_tracking_url

  Sử dụng thuộc tính này thay vì BidResponse.seatbid.bid.burl nếu bạn yêu cầu nhiều URL thanh toán.

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

Macro Google RTB

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

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

<a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a>

<a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a>

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a>

<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>

Google yêu cầu bạn sử dụng CLICK_URL_UNESC hoặc Macro CLICK_URL_ESC trong mẫu quảng cáo của bên thứ ba phân phát quảng cáo. 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 (+).
• 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 đượ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 hạn chế và mà nhà xuất bản đặt cho 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 phát hiện cho các quảng cáo mà bạn đã gửi bằng cách sử dụng API Đặt giá thầu theo thời gian thực Trường detectedCategories.
• BidRequest.imp.ext.allowed_vendor_type
• BidRequest.imp.secure
  • Trong 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 bằng quảng cáo có chứa tính năng bị hạn chế. Cho các tính năng được phép chẳng hạn như loại nhà cung cấp, chỉ trả về một quảng cáo nếu loại nhà cung cấp nằm trong Danh sách allowed_vendor_type trong BidRequest. Chỉ quảng cáo định dạng được chỉ định trong yêu cầu giá thầu bằng cách điền vào các trường, chẳng hạn như BidRequest.imp.banner phải được bao gồm trong giá thầu của bạn. Hãy xem các nhận xét về các trường này trong định nghĩa vùng đệ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 bắt buộc phải đặt chính xác BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat và có một trong hai BidResponse.seatbid.bid.adomain hoặc BidResponse.seatbid.bid.adm_native.link.url trường 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 các 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 phản hồi không có các trường này sẽ bị loại bỏ.

Đo lường mở

Đ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.

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 tính năng Đo lường mở trong giá thầu phản hồi có chứa các định dạng khác, hãy tham khảo SDK đo lường mở bài viết 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 giá thầu phản hồi mẫu cho các loại quảng cáo khác nhau.

Biểu ngữ ứng dụng

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    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: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "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": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

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: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

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

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    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"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "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": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

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: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

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

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"

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

Ứng dụng gốc

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    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"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

Video trên web

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

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    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: "46483683815"
    crid: "test_creative_id_527097"
    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"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}