Xử lý yêu cầu

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

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

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

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

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

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

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

Mã thanh toán

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

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

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

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

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

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

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

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

// Bid request
{
  // Indicates the blocked categories using IAB Content 1.0 Taxonomy.
  "bcat": [
    "IAB9-9",  // Cigars
    "IAB8-18"  // Wine
  ]
  "imp": {
    ...
  }
}

Hệ thống phân loại danh mục quảng cáo của Google

// Bid request
{
  // Indicates the blocked categories using Google Ad Category Taxonomy.
  "bcat": [
    "10138",  // Cigar and tobacco collecting
    "10080",  // Tobacco
    "11649",  // Wine
    "10674",  // Wine collecting
    "13008"   // Wine clubs
  ]
  "imp": {
    ...
  }
}

Lưu ý quan trọng: Để xác định những danh mục được phát hiện cho mẫu quảng cáo của bạn, hãy sử dụng tài nguyên creatives trong Real-time Bidding API. Để biết thông tin chi tiết về các danh mục được phát hiện, hãy xem Tài nguyên REST: bidders.creatives.

Tệp từ điển

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

Macro URL của đơn vị đặt giá thầu

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

Macro	Mô tả
`%%GOOGLE_USER_ID%%`	Được thay thế bằng Mã nhận dạng người dùng của Google có trong `BidRequest.user.id`. Ví dụ: URL của bên đặt giá thầu `http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%%` sẽ được thay thế bằng một URL như `http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl` tại thời điểm yêu cầu. Nếu không xác định được User-ID của Google, thì chuỗi trống sẽ được thay thế, với kết quả tương tự như http://google.bidder.com/path?gid=
`%%HAS_MOBILE%%`	Được thay thế bằng `1` để cho biết yêu cầu đặt giá thầu đến từ thiết bị di động hoặc `0` trong trường hợp khác. Điều này dựa trên giá trị của `BidRequest.device.devicetype`, trong đó thiết bị di động được biểu thị bằng `HIGHEND_PHONE` (`4`) hoặc `Tablet` (`5`).
`%%HAS_VIDEO%%`	Được thay thế bằng `1` để cho biết rằng yêu cầu đặt giá thầu có chứa khoảng không quảng cáo trong video hoặc `0` nếu không. Điều này dựa trên việc `BidRequest.imp.video` có được điền sẵn trong yêu cầu giá thầu hay không.
`%%HOSTED_MATCH_DATA%%`	Được thay thế bằng một giá trị dựa trên `BidRequest.user.buyeruid`.
`%%MOBILE_IS_APP%%`	Được thay thế bằng `1` để cho biết rằng yêu cầu giá thầu là dành cho khoảng không quảng cáo trong ứng dụng di động, hoặc `0` nếu không. Điều này dựa trên việc `BidRequest.app` có được điền sẵn hay không.

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

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

mbappgewtimrzgyytanjyg4888888.com

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

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

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

GEWTIMRZGYYTANJYG4======

kết quả:

1-429610587

Chuỗi 429610587 là mã ứng dụng cho ứng dụng iOS iFunny.

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

mbappgewtgmjug4ytmmrtgm888888.com

Giải mã giá trị này:

GEWTGMJUG4YTMMRTGM======

kết quả:

1-314716233

Kết quả 314716233 là mã ứng dụng cho ứng dụng iOS TextNow.

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

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

mbappMFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q888.com

Giải mã giá trị này:

MFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q===

kết quả:

air.com.hypah.io.slither

Kết quả này tương đương với ứng dụng Android slither.io.

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

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

OpenRTB Thông tin chi tiết

OpenRTB	Thông tin chi tiết
`BidRequest.imp.ext.dfp_ad_unit_code`	Chứa mã mạng Ad Manager của nhà xuất bản, theo sau là hệ thống phân cấp đơn vị quảng cáo, được phân tách bằng dấu gạch chéo lên. Ví dụ: thông tin này sẽ xuất hiện với định dạng tương tự như: `/1234/cruises/mars`.
`BidRequest.user.data.segment`	Các cặp khoá-giá trị lặp lại được gửi từ nhà xuất bản đến bên đặt giá thầu trao đổi. Bạn có thể xác định rằng các giá trị là cặp khoá-giá trị do nhà xuất bản gửi khi `BidRequest.user.data.name` được đặt thành `“Publisher Passed”`. Lưu ý: Trường này hiện chỉ được gửi cho những người tham gia giai đoạn thử nghiệm khép kín.

BidRequest.imp.ext.dfp_ad_unit_code

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

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

BidRequest.user.data.segment

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

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

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

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

Để hiểu BidRequest và tạo BidResponse, bạn cần lưu ý đến 2 khả năng khai báo nhà cung cấp công nghệ:

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

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

Các ví dụ sau đây 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

Yêu cầu được chuyển đổi tuần tự

id: "nz1Q895H43SP4ImxSmQa6b"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    wmax: 339
    hmax: 53
    wmin: 227
    hmin: 40
    format {
      w: 320
      h: 50
    }
    format {
      w: 300
      h: 50
    }
    [com.google.doubleclick.banner_ext] {
      flexslot {
        wmin: 227
        wmax: 339
        hmin: 40
        hmax: 53
      }
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "23.4.0"
  tagid: "1493802015"
  bidfloor: 73.7217929849032
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0008632762474007905
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 1.0
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 86548870602
    billing_id: 64050817605
    publisher_settings_list_id: 1919771331799042254
    publisher_settings_list_id: 8607682056454820141
    allowed_vendor_type: 0
    allowed_vendor_type: 9723
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 33
    allowed_restricted_category: 32
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  ver: "1.2.15"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-2021944733829074"
    [com.google.doubleclick.publisher] {
      country: "SG"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.9"
    livestream: false
    language: "sv"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "SWE"
    region: "SE-O"
    city: "Stenungsund"
    zip: "472 31"
    type: IP
    utcoffset: 120
    accuracy: 2913
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1012566
    }
  }
  make: "Samsung"
  model: "SM-A546B"
  os: "android"
  osv: "15"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  ifa: "bc49e134-7f3b-4282-928e-5ffa35e1047f"
  w: 339
  h: 735
  pxratio: 3.188
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "15"
    }
    mobile: true
    bitness: "64"
    model: "SM-A546B"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    metereddata: false
    chargelevel: 0.97
    charging: false
    diskspace: 12800
    audioout: AUDIO_SILENT
  }
}
user {
  id: "1E085g86030JZxtR8SO7g147Ygt"
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 2415
      consented_providers: 723
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    session {
      duration: 1080
      depth: 610
      requestssinceappopen: 1871
      priorclicks: 0
    }
    idage: 10368000
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "JPY"
cur: "GBP"
bcat: "5"
bcat: "31"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v251815999.243220000.1"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zGnD1h-SFMwW30WOg7X29LI78CmEi6lwfZBDI4RXQ8h6ufYC9L0y2Y448cm0445Obh37"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "nz1Q895H43SP4ImxSmQa6b",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 320,
        "h": 50,
        "pos": 1,
        "api": [
          3,
          5
        ],
        "wmax": 339,
        "hmax": 53,
        "wmin": 227,
        "hmin": 40,
        "format": [
          {
            "w": 320,
            "h": 50
          },
          {
            "w": 300,
            "h": 50
          }
        ],
        "ext": {
          "flexslot": {
            "wmin": 227,
            "wmax": 339,
            "hmin": 40,
            "hmax": 53
          }
        }
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "23.4.0",
      "tagid": "1493802015",
      "bidfloor": 73.7217929849032,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0008632762474007905,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 1.0,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "86548870602",
          "64050817605"
        ],
        "publisher_settings_list_id": [
          "1919771331799042254",
          "8607682056454820141"
        ],
        "allowed_vendor_type": [
          0,
          9723
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          33,
          32
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "1.2.15",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-2021944733829074",
      "ext": {
        "country": "SG"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.9",
      "livestream": 0,
      "language": "sv"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "SWE",
      "region": "SE-O",
      "city": "Stenungsund",
      "zip": "472 31",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 2913,
      "ext": {
        "geo_criteria_id": 1012566
      }
    },
    "make": "Samsung",
    "model": "SM-A546B",
    "os": "android",
    "osv": "15",
    "connectiontype": 2,
    "devicetype": 4,
    "ifa": "bc49e134-7f3b-4282-928e-5ffa35e1047f",
    "w": 339,
    "h": 735,
    "pxratio": 3.188,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "15"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "SM-A546B",
      "source": 3
    },
    "ext": {
      "metereddata": 0,
      "chargelevel": 0.97,
      "charging": 0,
      "diskspace": 12800,
      "audioout": 3
    }
  },
  "user": {
    "id": "1E085g86030JZxtR8SO7g147Ygt",
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "2415",
          "723"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "session": {
        "duration": 1080,
        "depth": 610,
        "requestssinceappopen": 1871,
        "priorclicks": 0
      },
      "idage": 10368000
    }
  },
  "at": 1,
  "tmax": 1000,
  "cur": [
    "JPY",
    "GBP"
  ],
  "bcat": [
    "5",
    "31"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v251815999.243220000.1"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zGnD1h-SFMwW30WOg7X29LI78CmEi6lwfZBDI4RXQ8h6ufYC9L0y2Y448cm0445Obh37",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

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

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

Authorized Buyers cũng như các đối tác trao đổi và mạng sử dụng tính năng Đặt giá thầu mở đều có thể nhận được thông tin phản hồi theo thời gian thực.

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

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

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

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

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

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

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

  // Deprecated. This field will be removed in February 2026.
  // The minimum bid value necessary to have won the server-side component of
  // the overall auction given that there was also an interest group bidding
  // component to the overall auction which ran using the Protected Audience
  // API. The value is expressed in CPM of the buyer account currency. The
  // minimum bid to win for the overall auction, including bids from the
  // server-side and the on-device interest group components, is populated in
  // the minimum_bid_to_win field of the same BidFeedback object.
  optional double sscminbidtowin = 14 [deprecated = true];

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

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

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

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

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

  // Possible types of bid response feedback objects.
  enum FeedbackType {
    FEEDBACK_TYPE_UNSPECIFIED = 0;

    // Feedback for a bid that was submitted on a bid response.
    BID_FEEDBACK = 1;

    // Feedback for an interest group buyer submitted on a bid response to
    // particpate in an interest group bidding component of the auction run
    // using the Protected Audience API.
    INTEREST_GROUP_BUYER_FEEDBACK = 2;
  }

  // Deprecated. This field will be removed in February 2026.
  // The type of the BidFeedback message. Google will send separate
  // BidFeedback objects for:
  // a) Each bid submitted on a bid response
  // b) Each buyer submitted on a bid response to particpate in an interest
  // group bidding component of the auction run using the Protected Audience
  // API.
  optional FeedbackType feedbacktype = 15 [deprecated = true];

  // Deprecated. This field will be removed in February 2026.
  // Origin of an interest group buyer that was included in the bid response.
  // This field is populated only for feedback where a bidder opted in an
  // interest group buyer to participate in the interest group bidding
  // component of the overall auction run using the Protected Audience API.
  // To learn more about origins, see https://www.rfc-editor.org/rfc/rfc6454.
  // To learn more about interest group bidding and the Protected Audience
  // API, see
  // https://developers.google.com/authorized-buyers/rtb/fledge-origin-trial.
  optional string buyerorigin = 16 [deprecated = true];

  // Deprecated. This field will be removed in February 2026.
  // The status code for the submitted interest group buyer. This field is
  // only populated in the feedback for an interest group buyer that a bidder
  // requested to enter into the interest group auction through the bid
  // response. Individual creative status codes of bids submitted by the buyer
  // in the on-device interest group auction are not available. See
  // https://storage.googleapis.com/adx-rtb-dictionaries/interest-group-buyer-status-codes.txt
  // for a list of interest group buyer status codes.
  optional int32 igbuyerstatus = 17 [deprecated = true];
}

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

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

Kết quả đấu giá	Phản hồi theo thời gian thực
Người mua không gửi giá thầu.	Miễn phí.
Người mua đã gửi một giá thầu bị lọc ra trước khi tham gia phiên đấu giá.	Mã trạng thái quảng cáo (creative-status-codes.txt).
Người mua đã gửi giá thầu nhưng thua trong phiên đấu giá.	Mã trạng thái mẫu quảng cáo `79` (bị trả giá cao hơn trong phiên đấu giá).
Người mua đã gửi một giá thầu giành chiến thắng trong phiên đấu giá.	Giá thanh toán và mã trạng thái mẫu quảng cáo `1`. Đối với một lượt hiển thị ứng dụng và mã trạng thái mẫu quảng cáo là `83`, nhà xuất bản ứng dụng có thể đã sử dụng một chuỗi dàn xếp dạng thác nước và do đó, giá thầu chiến thắng sẽ cạnh tranh với nhu cầu khác trong chuỗi thác nước passback của nhà xuất bản. Tìm hiểu cách sử dụng `sampled_mediation_cpm_ahead_of_auction_winner` khi đặt giá thầu.

Mẫu

Sau đây là ví dụ về ý kiến phản hồi theo thời gian thực như trong các giao thức được hỗ trợ:

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "19pl46RcGu32W09d2H1q80"
imp {
  id: "1"
  banner {
    w: 200
    h: 200
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 200
      h: 200
    }
    format {
      w: 300
      h: 250
    }
  }
  video {
    mimes: "video/mp4"
    linearity: LINEAR
    maxduration: 60
    w: 300
    h: 250
    startdelay: 0
    playbackmethod: ENTER_SOUND_OFF
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: true
    placement: IN_FEED_PLACEMENT
    playbackend: LEAVING_OR_USER
    plcmt: PLCMT_NO_CONTENT_STANDALONE
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_NO_CONTENT_STANDALONE
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "23.3.0"
  tagid: "4530488526"
  bidfloor: 27.72425931505949
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.008391381241381168
    vendor: "EXCHANGE"
  }
  metric {
    type: "video_completion_rate"
    value: 0.009718560613691807
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 85893299877
    billing_id: 60049223504
    publisher_settings_list_id: 9909889017109496788
    publisher_settings_list_id: 2943173989636397861
    allowed_vendor_type: 0
    allowed_vendor_type: 39523
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  ver: "2.7.40.26"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-8704859943243339"
    [com.google.doubleclick.publisher] {
      country: "SG"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.5"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "IND"
    city: "Hyderabad"
    type: IP
    utcoffset: 330
    accuracy: 19212
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1007740
    }
  }
  make: "Realme"
  model: "RMX3241"
  os: "android"
  osv: "13"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  ifa: "fb42f237-08ec-4d91-ab96-1e1c83cc2af1"
  w: 360
  h: 716
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "13"
    }
    mobile: true
    bitness: "64"
    model: "RMX3241"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    metereddata: false
    chargelevel: 0.23
    charging: false
    diskspace: 15700
    audioout: AUDIO_SILENT
  }
}
user {
  id: "Q735u4sSGK5Y0N819k25O0Vv6I7"
  [com.google.doubleclick.user] {
    session {
      duration: 2
      depth: 11
      requestssinceappopen: 11
      priorclicks: 0
    }
    idage: 25920000
  }
}
at: FIRST_PRICE
tmax: 2000
cur: "INR"
cur: "JPY"
bcat: "32"
bcat: "33"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v251815999.242402000.1"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  bid_feedback {
    request_id: "3265hT3M9Uq7370Ou263Zp"
    creative_status_code: 80
    event_notification_token {
      payload: "token"
    }
    buyer_creative_id: "test_creative_id_122439"
    minimum_bid_to_win: 5.93
    feedbacktype: BID_FEEDBACK
  }
  bid_feedback {
    request_id: "9024plcR9E3N4T0vb0y13c"
    creative_status_code: 80
    event_notification_token {
      payload: "token"
    }
    buyer_creative_id: "test_creative_id_122439"
    minimum_bid_to_win: 175.0
    feedbacktype: BID_FEEDBACK
  }
  google_query_id: "ANy-z44alu-814Bakx696mrux1VsUu39Ob428vb0B2H4HD8ADAlLE6mkm17zq511d81N0Gf0"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "19pl46RcGu32W09d2H1q80",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 200,
        "h": 200,
        "pos": 1,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 200,
            "h": 200
          },
          {
            "w": 300,
            "h": 250
          }
        ]
      },
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "linearity": 1,
        "maxduration": 60,
        "w": 300,
        "h": 250,
        "startdelay": 0,
        "playbackmethod": [
          6
        ],
        "pos": 1,
        "api": [
          3,
          5
        ],
        "protocols": [
          2,
          3
        ],
        "skip": 1,
        "placement": 4,
        "playbackend": 2,
        "plcmt": 4,
        "ext": {
          "inferredplcmt": 4
        }
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "23.3.0",
      "tagid": "4530488526",
      "bidfloor": 27.72425931505949,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.008391381241381168,
          "vendor": "EXCHANGE"
        },
        {
          "type": "video_completion_rate",
          "value": 0.009718560613691807,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "85893299877",
          "60049223504"
        ],
        "publisher_settings_list_id": [
          "9909889017109496788",
          "2943173989636397861"
        ],
        "allowed_vendor_type": [
          0,
          39523
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "2.7.40.26",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-8704859943243339",
      "ext": {
        "country": "SG"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.5",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "IND",
      "city": "Hyderabad",
      "type": 2,
      "utcoffset": 330,
      "accuracy": 19212,
      "ext": {
        "geo_criteria_id": 1007740
      }
    },
    "make": "Realme",
    "model": "RMX3241",
    "os": "android",
    "osv": "13",
    "connectiontype": 2,
    "devicetype": 4,
    "ifa": "fb42f237-08ec-4d91-ab96-1e1c83cc2af1",
    "w": 360,
    "h": 716,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "13"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "RMX3241",
      "source": 3
    },
    "ext": {
      "metereddata": 0,
      "chargelevel": 0.23,
      "charging": 0,
      "diskspace": 15700,
      "audioout": 3
    }
  },
  "user": {
    "id": "Q735u4sSGK5Y0N819k25O0Vv6I7",
    "ext": {
      "session": {
        "duration": 2,
        "depth": 11,
        "requestssinceappopen": 11,
        "priorclicks": 0
      },
      "idage": 25920000
    }
  },
  "at": 1,
  "tmax": 2000,
  "cur": [
    "INR",
    "JPY"
  ],
  "bcat": [
    "32",
    "33"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v251815999.242402000.1"
    }
  },
  "cattax": 500,
  "ext": {
    "bid_feedback": [
      {
        "request_id": "3265hT3M9Uq7370Ou263Zp",
        "creative_status_code": 80,
        "event_notification_token": {
          "payload": "token"
        },
        "buyer_creative_id": "test_creative_id_122439",
        "minimum_bid_to_win": 5.93,
        "feedbacktype": 1
      },
      {
        "request_id": "9024plcR9E3N4T0vb0y13c",
        "creative_status_code": 80,
        "event_notification_token": {
          "payload": "token"
        },
        "buyer_creative_id": "test_creative_id_122439",
        "minimum_bid_to_win": 175.0,
        "feedbacktype": 1
      }
    ],
    "google_query_id": "ANy-z44alu-814Bakx696mrux1VsUu39Ob428vb0B2H4HD8ADAlLE6mkm17zq511d81N0Gf0",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

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

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

Cách hoạt động

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

Sau đây là các CPM trong chuỗi dàn xếp theo thứ tự giảm dần:
\[C_1, C_2, …, C_n\]
Sau đây là tỷ lệ đáp ứng tương ứng cho các CPM trong chuỗi dàn xếp:
\[f_1, f_2, …, f_n\]
Sau đây là một hàm dùng để xác định CPM dự kiến và xác suất của CPM đó từ phần tử chuỗi dàn xếp $i$, dựa trên tỷ lệ lấp đầy đã cho:
$X_i = \{C_i$ với xác suất $f_i$; $0$ với xác suất $1 - f_i\}$
Chuỗi dàn xếp chiến thắng cuối cùng sẽ là:
\[\{C_1, C_2, …, C_K, W\}\]
trong đó $W$ là giá thầu giành chiến thắng và $C_K > W >= C_{K+1}$
Giá dự trữ hoặc giá sàn được biểu thị là $F$.
Giá thầu cao thứ hai được biểu thị là $R$.

Cách tính cho người chiến thắng trong phiên đấu giá

Trường	Cách tính
`minimum_bid_to_win`	$max\{F, R, X_{K+1}, …, X_n\}$
`sampled_mediation_cpm_ahead_ of_auction_winner`	$\{C_i$ với xác suất $\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}$ Đối với $1 <= i <= K$.

Cách tính toán cho người thua cuộc trong phiên đấu giá

Trường	Cách tính
`minimum_bid_to_win`	$max\{F, W\}$
`sampled_mediation_cpm_ahead_ of_auction_winner`	$max\{X_1, …, X_K\}$

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

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

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

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

Phiên đấu giá RTB	CPM
Người chiến thắng trong phiên đấu giá (W)	1 đô la
Á quân trong phiên đấu giá (R)	0,05 USD
Giá đặt trước / Giá sàn (F)	$0

Giá thầu thắng phiên đấu giá

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

`minimum_bid_to_win`	Xác suất
$max(F, R, C_3) = $0.50$	$f_3 = 80\%$
$max(F, R, C_4) = $0.10$	$(1-f_3) \cdot f_4 = 17\%$
$max(F, R, 0) = $0.05$	$(1-f_3) \cdot (1-f_4) = 3\%$

`sampled_mediation_cpm_ ahead_of_auction_winner`	Xác suất
$C_1 = $3.00$	$f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%$
$C_2 = $2.00$	$((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%$

Lưu ý: Nếu người thắng cuộc trong phiên đấu giá phân phát quảng cáo và nhận được thông báo thanh toán (ví dụ: thông qua một điểm cuối được chỉ định trong BidResponse.seatbid[].bid[].burl), thì người thắng cuộc trong phiên đấu giá có thể suy luận rằng không có CPM dàn xếp nào trong số các CPM được lấy mẫu được điền và có thể đưa tần suất xảy ra trường hợp này vào mô hình của họ.

Giá thầu thua trong phiên đấu giá

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

`minimum_bid_to_win`	Xác suất
$max(F, W) = $1.00$	$100\%$

`sampled_mediation_cpm_ ahead_of_auction_winner`	Xác suất
$C_1 = $3.00$	$f_1 = 5\%$
$C_2 = $2.00$	$(1-f_1) \cdot f_2 =~ 42.8\%$
$0$	$(1-f_1) \cdot (1-f_2) =~ 52.2\%$

Lưu ý: Giá trị sampled_mediation_cpm_ahead_of_auction_winner bằng 0 cho biết phiên đấu giá đặt giá thầu theo thời gian thực đã giành chiến thắng. Trong ví dụ trên, dự kiến người chiến thắng trong phiên đấu giá sẽ không bị mạng dàn xếp cạnh tranh trả giá cao hơn 52,2% thời gian.

phân tách giá thầu

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

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

Định dạng quảng cáo

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

Những yêu cầu giá thầu chứa các định dạng sau sẽ được phân tách thành các yêu cầu giá thầu riêng biệt:

Biểu ngữ
Video
Âm thanh
Mã gốc

Ví dụ về việc đơn giản hoá định dạng quảng cáo

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

Làm phẳng trước

Ví dụ minh họa

{
  "id": "V5ar1wXqKP58nbsyJ6549D",
  "imp": [
    {
      "id": "1",
      "video": {
        "linearity": 1,
        "w": 300,
        "h": 250,
        "pos": 1,
        "skip": 1,
        "playbackmethod": [
          6
        ],
        "placement": 3,
        "mimes": [
          "video/mp4"
        ],
        "protocols": [
          2,
          3
        ]
      },
      "banner": {
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ],
        "w": 300,
        "h": 250,
        "pos": 1
      },
      "ext": {
        "billing_id": [
          47039494050,
          52030317241
        ]
      }
    }
  ],
  "ext": {
    "google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
  }
}

Sau khi hợp nhất

Ví dụ minh họa

Yêu cầu 1

{
  "id": "B3xr1yZqRL48nbsyJ6367N",
  "imp": [
    {
      "id": "1",
      "video": {
        "linearity": 1,
        "w": 300,
        "h": 250,
        "pos": 1,
        "skip": 1,
        "playbackmethod": [
          6
        ],
        "placement": 3,
        "mimes": [
          "video/mp4"
        ],
        "protocols": [
          2,
          3
        ]
      }
      "ext": {
        "billing_id": [
          47039494050
        ]
      }
  ],
  "ext": {
    "google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
  }
}

Yêu cầu 2

{
  "id": "M1dY8qHyNK74bMsjF393Gf",
  "imp": [
    {
      "id": "1",
      "banner": {
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ],
        "w": 300,
        "h": 250,
        "pos": 1
      },
      "ext": {
        "billing_id": [
          52030317241
        ]
      }
    }
  ],
  "ext": {
    "google_query_id": "ANy-zdp266-244itJsom3dmXb7SvW1IPg6478g639g0867v1126w630F3M7lAp640H666744"
  }
}

Ưu đãi

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

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

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

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

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

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

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

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

Nhóm video

Các yêu cầu giá thầu cho một nhóm video có nhiều cơ hội quảng cáo sẽ được phân tách, sao cho mỗi yêu cầu giá thầu là cho một cơ hội quảng cáo riêng lẻ trong nhóm đó. Điều này cho phép bạn đặt giá thầu cho nhiều cơ hội quảng cáo cho một nhóm quảng cáo nhất định.

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

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

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

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

Các phần sau đây cho thấy yêu cầu đặt giá thầu mẫu cho các loại quảng cáo khác nhau.

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "9NaI48SmPW7Zf3MAHR43DY"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    wmax: 390
    hmax: 61
    wmin: 261
    hmin: 46
    format {
      w: 320
      h: 50
    }
    [com.google.doubleclick.banner_ext] {
      flexslot {
        wmin: 261
        wmax: 390
        hmin: 46
        hmax: 61
      }
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "11.10.0"
  tagid: "9396839755"
  bidfloor: 1.0
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0016558143543079495
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.96
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 82364411103
    publisher_settings_list_id: 2581479915860139166
    publisher_settings_list_id: 1866597146354523937
    allowed_vendor_type: 0
    allowed_vendor_type: 4648
    ampad: AMP_AD_NOT_ALLOWED
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "cF58w81X"
      versions: "2.0"
      versions: "2.1"
      fidelities: STOREKIT_RENDERED_ADS
      fidelities: VIEW_THROUGH_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    billable_event_rate_bid_adjustment {
      bid_adjustment: 1.033434
      creative_type: HTML_SNIPPET
    }
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  ver: "5.6.0"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-6156239328255091"
    [com.google.doubleclick.publisher] {
      country: "JP"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "ja"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "JPN"
    region: "JP-27"
    city: "Osaka"
    type: IP
    utcoffset: 540
    accuracy: 8429
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1009540
    }
  }
  ipv6: "240a:61:20a7::"
  carrier: "70000"
  language: "ja"
  make: "Apple"
  model: "iPhone13,2"
  os: "iOS"
  osv: "18.6.2"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  hwv: "iPhone13,2"
  w: 390
  h: 844
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "18"
      version: "6"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
    audioout: AUDIO_SILENT
  }
}
user {
  [com.google.doubleclick.user] {
    session {
      duration: 270
      depth: 12
      requestssinceappopen: 12
      priorclicks: 0
    }
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
cur: "JPY"
bcat: "3"
bcat: "4"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v11.10.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z7N096-BC94m1ooKoCOsHY5Aqf505y9370zhIav4249vkZ12R2ZiijB1x8I8XL5J1i25"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 320,
        "h": 50,
        "pos": 1,
        "api": [
          3,
          5
        ],
        "wmax": 390,
        "hmax": 61,
        "wmin": 261,
        "hmin": 46,
        "format": [
          {
            "w": 320,
            "h": 50
          }
        ],
        "ext": {
          "flexslot": {
            "wmin": 261,
            "wmax": 390,
            "hmin": 46,
            "hmax": 61
          }
        }
      },
      "displaymanager": "GoogleMobileAds-iOS",
      "displaymanagerver": "11.10.0",
      "tagid": "9396839755",
      "bidfloor": 1.0,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0016558143543079495,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.96,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "82364411103"
        ],
        "publisher_settings_list_id": [
          "2581479915860139166",
          "1866597146354523937"
        ],
        "allowed_vendor_type": [
          0,
          4648
        ],
        "ampad": 2,
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            1,
            0
          ]
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "billable_event_rate_bid_adjustment": [
          {
            "bid_adjustment": 1.033434,
            "creative_type": 1
          }
        ],
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "JPN",
      "region": "JP-27",
      "city": "Osaka",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 8429,
      "ext": {
        "geo_criteria_id": 1009540
      }
    },
    "ipv6": "240a:61:20a7::",
    "carrier": "70000",
    "language": "ja",
    "make": "Apple",
    "model": "iPhone13,2",
    "os": "iOS",
    "osv": "18.6.2",
    "connectiontype": 2,
    "devicetype": 4,
    "hwv": "iPhone13,2",
    "w": 390,
    "h": 844,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "18",
          "6"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "atts": 2,
      "audioout": 3
    }
  },
  "user": {
    "ext": {
      "session": {
        "duration": 270,
        "depth": 12,
        "requestssinceappopen": 12,
        "priorclicks": 0
      }
    }
  },
  "at": 1,
  "tmax": 1000,
  "cur": [
    "USD",
    "JPY"
  ],
  "bcat": [
    "3",
    "4"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v11.10.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-z7N096-BC94m1ooKoCOsHY5Aqf505y9370zhIav4249vkZ12R2ZiijB1x8I8XL5J1i25",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "D3x8RPLO96R6T137tQ6168"
imp {
  id: "1"
  banner {
    w: 360
    h: 715
    pos: AD_POSITION_FULLSCREEN
    api: MRAID_1
    api: MRAID_2
    format {
      w: 360
      h: 715
    }
    format {
      w: 320
      h: 568
    }
  }
  displaymanager: "GoogleMobileAds-Android"
  displaymanagerver: "22.3.0"
  instl: true
  tagid: "5771994185"
  bidfloor: 2764.414643547123
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.03971313312649727
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.91
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 68640308112
    billing_id: 56606437068
    publisher_settings_list_id: 1984414516100776281
    publisher_settings_list_id: 5846951473307279661
    allowed_vendor_type: 0
    allowed_vendor_type: 57823
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-7405557148270612"
    [com.google.doubleclick.publisher] {
      country: "HK"
    }
  }
  content {
    url: "https://www.google.com"
    userrating: "4.7"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GBR"
    region: "GB-ENG"
    zip: "RH20"
    type: IP
    utcoffset: 60
    accuracy: 2312
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9191103
    }
  }
  ipv6: "2a02:c7c:7c25::"
  make: "Huawei"
  model: "LYA-L09"
  os: "android"
  osv: "10"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  ifa: "0f0f33d1-fa18-4a2c-bc47-79ef855b5c16"
  w: 360
  h: 715
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "537"
      version: "36"
    }
    platform {
      brand: "Android"
      version: "10"
    }
    mobile: true
    model: "LYA-L09"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    metereddata: false
    chargelevel: 0.93
    charging: false
    diskspace: 2100
    audioout: AUDIO_SILENT
  }
}
user {
  id: "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1205
      consented_providers: 415
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    session {
      duration: 6
      depth: 12
      requestssinceappopen: 12
      priorclicks: 0
    }
    idage: 44064000
  }
}
at: FIRST_PRICE
tmax: 1500
cur: "EUR"
cur: "JPY"
bcat: "32"
bcat: "33"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v251815999.232400000.1"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zc395b-x973i1113tK7P9K633CKoo3Pl45uz8D40mz3v48s9Zp604a8FsGL3893PT15M"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 360,
        "h": 715,
        "pos": 7,
        "api": [
          3,
          5
        ],
        "format": [
          {
            "w": 360,
            "h": 715
          },
          {
            "w": 320,
            "h": 568
          }
        ]
      },
      "displaymanager": "GoogleMobileAds-Android",
      "displaymanagerver": "22.3.0",
      "instl": 1,
      "tagid": "5771994185",
      "bidfloor": 2764.414643547123,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.03971313312649727,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.91,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "68640308112",
          "56606437068"
        ],
        "publisher_settings_list_id": [
          "1984414516100776281",
          "5846951473307279661"
        ],
        "allowed_vendor_type": [
          0,
          57823
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-7405557148270612",
      "ext": {
        "country": "HK"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.7",
      "livestream": 0,
      "language": "en"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GBR",
      "region": "GB-ENG",
      "zip": "RH20",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 2312,
      "ext": {
        "geo_criteria_id": 9191103
      }
    },
    "ipv6": "2a02:c7c:7c25::",
    "make": "Huawei",
    "model": "LYA-L09",
    "os": "android",
    "osv": "10",
    "connectiontype": 2,
    "devicetype": 4,
    "ifa": "0f0f33d1-fa18-4a2c-bc47-79ef855b5c16",
    "w": 360,
    "h": 715,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "537",
            "36"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "10"
        ]
      },
      "mobile": 1,
      "model": "LYA-L09",
      "source": 3
    },
    "ext": {
      "metereddata": 0,
      "chargelevel": 0.93,
      "charging": 0,
      "diskspace": 2100,
      "audioout": 3
    }
  },
  "user": {
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee",
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1205",
          "415"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "session": {
        "duration": 6,
        "depth": 12,
        "requestssinceappopen": 12,
        "priorclicks": 0
      },
      "idage": 44064000
    }
  },
  "at": 1,
  "tmax": 1500,
  "cur": [
    "EUR",
    "JPY"
  ],
  "bcat": [
    "32",
    "33"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v251815999.232400000.1"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zc395b-x973i1113tK7P9K633CKoo3Pl45uz8D40mz3v48s9Zp604a8FsGL3893PT15M",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "179eb03K549H7I2584e7L6"
imp {
  id: "1"
  video {
    mimes: "video/mp4"
    linearity: LINEAR
    maxduration: 30
    w: 414
    h: 816
    startdelay: 0
    playbackmethod: CLICK_TO_PLAY
    pos: AD_POSITION_FULLSCREEN
    companionad {
      w: 414
      h: 816
      mimes: "text/css"
      mimes: "image/jpeg"
      format {
        w: 414
        h: 816
      }
      vcm: true
    }
    api: MRAID_1
    api: MRAID_2
    companiontype: STATIC
    companiontype: HTML
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: false
    placement: FLOATING_PLACEMENT
    playbackend: COMPLETION_OR_USER
    maxseq: 2
    poddur: 30
    plcmt: PLCMT_INTERSTITIAL
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_INTERSTITIAL
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "12.7.0"
  instl: true
  tagid: "7757209244"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.048289403319358826
    vendor: "EXCHANGE"
  }
  metric {
    type: "video_completion_rate"
    value: 0.1191580668091774
    vendor: "EXCHANGE"
  }
  rwdd: true
  [com.google.doubleclick.imp] {
    billing_id: 55383762512
    publisher_settings_list_id: 1847492880042777742
    publisher_settings_list_id: 3770000868027227103
    allowed_vendor_type: 0
    allowed_vendor_type: 237
    is_rewarded_inventory: true
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "306el65O"
      versions: "2.0"
      versions: "2.1"
      fidelities: VIEW_THROUGH_ADS
      fidelities: STOREKIT_RENDERED_ADS
      skoverlay: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  ver: "6.5.1"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-9126361500211130"
    [com.google.doubleclick.publisher] {
      country: "GB"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "fr"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-V"
    zip: "01700"
    type: IP
    utcoffset: 120
    accuracy: 3878
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9054913
    }
  }
  ipv6: "2a01:cb14:11e4::"
  language: "fr"
  make: "Apple"
  model: "iPhone12,1"
  os: "iOS"
  osv: "18.5"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  hwv: "iPhone12,1"
  w: 414
  h: 896
  pxratio: 2.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "18"
      version: "5"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
    audioout: AUDIO_SPEAKER
  }
}
user {
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1097
      consented_providers: 2963
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    session {
      duration: 7
      depth: 23
      requestssinceappopen: 23
      priorclicks: 0
    }
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "3"
bcat: "4"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
bapp: "529996768"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v12.7.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-ziHO5m-b7Qkgq8Om9TTzELn4d14HK6161373y5520g237O0317F2535zt405Mw054Ts5"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "179eb03K549H7I2584e7L6",
  "imp": [
    {
      "id": "1",
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "linearity": 1,
        "maxduration": 30,
        "w": 414,
        "h": 816,
        "startdelay": 0,
        "playbackmethod": [
          3
        ],
        "pos": 7,
        "companionad": [
          {
            "w": 414,
            "h": 816,
            "mimes": [
              "text/css",
              "image/jpeg"
            ],
            "format": [
              {
                "w": 414,
                "h": 816
              }
            ],
            "vcm": 1
          }
        ],
        "api": [
          3,
          5
        ],
        "companiontype": [
          1,
          2
        ],
        "protocols": [
          2,
          3
        ],
        "skip": 0,
        "placement": 5,
        "playbackend": 1,
        "maxseq": 2,
        "poddur": 30,
        "plcmt": 3,
        "ext": {
          "inferredplcmt": 3
        }
      },
      "displaymanager": "GoogleMobileAds-iOS",
      "displaymanagerver": "12.7.0",
      "instl": 1,
      "tagid": "7757209244",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.048289403319358826,
          "vendor": "EXCHANGE"
        },
        {
          "type": "video_completion_rate",
          "value": 0.1191580668091774,
          "vendor": "EXCHANGE"
        }
      ],
      "rwdd": 1,
      "ext": {
        "billing_id": [
          "55383762512"
        ],
        "publisher_settings_list_id": [
          "1847492880042777742",
          "3770000868027227103"
        ],
        "allowed_vendor_type": [
          0,
          237
        ],
        "is_rewarded_inventory": 1,
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "306el65O"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            0,
            1
          ],
          "skoverlay": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "6.5.1",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-9126361500211130",
      "ext": {
        "country": "GB"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "fr"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-V",
      "zip": "01700",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 3878,
      "ext": {
        "geo_criteria_id": 9054913
      }
    },
    "ipv6": "2a01:cb14:11e4::",
    "language": "fr",
    "make": "Apple",
    "model": "iPhone12,1",
    "os": "iOS",
    "osv": "18.5",
    "connectiontype": 2,
    "devicetype": 4,
    "hwv": "iPhone12,1",
    "w": 414,
    "h": 896,
    "pxratio": 2.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "18",
          "5"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "atts": 2,
      "audioout": 1
    }
  },
  "user": {
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1097",
          "2963"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "session": {
        "duration": 7,
        "depth": 23,
        "requestssinceappopen": 23,
        "priorclicks": 0
      }
    }
  },
  "at": 1,
  "tmax": 1000,
  "cur": [
    "USD"
  ],
  "bcat": [
    "3",
    "4"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "bapp": [
    "529996768"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v12.7.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-ziHO5m-b7Qkgq8Om9TTzELn4d14HK6161373y5520g237O0317F2535zt405Mw054Ts5",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "HYuQMewy7o4U9Jk0AYt543"
imp {
  id: "1"
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "12.6.0"
  tagid: "4283347586"
  bidfloor: 1841.9824245803225
  bidfloorcur: "JPY"
  secure: true
  native {
    ver: "1.2"
    api: MRAID_1
    api: MRAID_2
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 5
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 6
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      eventtrackers {
        event: OMID
        methods: JS
      }
      privacy: true
    }
  }
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0035704318434000015
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.42
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 73917825312
    billing_id: 58558932335
    publisher_settings_list_id: 3148904898759409470
    publisher_settings_list_id: 7478572817009281694
    allowed_vendor_type: 0
    allowed_vendor_type: 237
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "Q7B2W332"
      skadnetids: "10wC1989"
      versions: "2.0"
      versions: "2.1"
      fidelities: STOREKIT_RENDERED_ADS
      fidelities: VIEW_THROUGH_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
    jsver: "test-sdk_123456789"
  }
}
app {
  name: "Test App"
  ver: "4.18.1"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-7029824543087220"
    [com.google.doubleclick.publisher] {
      country: "JP"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "ja"
  }
  storeurl: "https://www.google.com"
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "JPN"
    region: "JP-08"
    city: "Tsukuba"
    zip: "305-0861"
    type: IP
    utcoffset: 540
    accuracy: 1562
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9168296
    }
  }
  language: "ja"
  make: "Apple"
  model: "iPhone14,5"
  os: "iOS"
  osv: "18.6.2"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  hwv: "iPhone14,5"
  w: 390
  h: 844
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "18"
      version: "6"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
    audioout: AUDIO_SPEAKER
  }
}
user {
  data {
    id: "39"
    segment {
      id: "OMITTED"
    }
    segment {
      id: "OMITTED"
    }
    [com.google.doubleclick.data] {
      segtax: 4
    }
  }
  [com.google.doubleclick.user] {
    session {
      duration: 10
      depth: 83
      requestssinceappopen: 83
      priorclicks: 0
    }
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "AUD"
cur: "BRL"
bcat: "4"
bcat: "32"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v12.6.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zeA4SO-5uTX8H7U5d0HkU9zRSoPKZuff5VUk04Fq0b341boSb3KUK81w20lbVye7O113"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "HYuQMewy7o4U9Jk0AYt543",
  "imp": [
    {
      "id": "1",
      "displaymanager": "GoogleMobileAds-iOS",
      "displaymanagerver": "12.6.0",
      "tagid": "4283347586",
      "bidfloor": 1841.9824245803225,
      "bidfloorcur": "JPY",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "api": [
          3,
          5
        ],
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":5,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":6,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]},{\"event\":555,\"methods\":[2]}],\"privacy\":1}"
      },
      "exp": 3600,
      "clickbrowser": 1,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0035704318434000015,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.42,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "73917825312",
          "58558932335"
        ],
        "publisher_settings_list_id": [
          "3148904898759409470",
          "7478572817009281694"
        ],
        "allowed_vendor_type": [
          0,
          237
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "Q7B2W332",
            "10wC1989"
          ],
          "versions": [
            "2.0",
            "2.1"
          ],
          "fidelities": [
            1,
            0
          ]
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0,
        "jsver": "test-sdk_123456789"
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "4.18.1",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-7029824543087220",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "JPN",
      "region": "JP-08",
      "city": "Tsukuba",
      "zip": "305-0861",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 1562,
      "ext": {
        "geo_criteria_id": 9168296
      }
    },
    "language": "ja",
    "make": "Apple",
    "model": "iPhone14,5",
    "os": "iOS",
    "osv": "18.6.2",
    "connectiontype": 2,
    "devicetype": 4,
    "hwv": "iPhone14,5",
    "w": 390,
    "h": 844,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "18",
          "6"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    },
    "ext": {
      "atts": 2,
      "audioout": 1
    }
  },
  "user": {
    "data": [
      {
        "id": "39",
        "segment": [
          {
            "id": "OMITTED"
          },
          {
            "id": "OMITTED"
          }
        ],
        "ext": {
          "segtax": 4
        }
      }
    ],
    "ext": {
      "session": {
        "duration": 10,
        "depth": 83,
        "requestssinceappopen": 83,
        "priorclicks": 0
      }
    }
  },
  "at": 1,
  "tmax": 1000,
  "cur": [
    "AUD",
    "BRL"
  ],
  "bcat": [
    "4",
    "32"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-i-v12.6.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zeA4SO-5uTX8H7U5d0HkU9zRSoPKZuff5VUk04Fq0b341boSb3KUK81w20lbVye7O113",
    "fcap_scope": 4,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Video trên web

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "9B5K1zj5T61jRM80t25s13"
imp {
  id: "1"
  video {
    mimes: "application/javascript"
    mimes: "video/mp4"
    linearity: LINEAR
    maxduration: 60
    w: 306
    h: 156
    startdelay: 0
    playbackmethod: ENTER_SOUND_OFF
    pos: ABOVE_THE_FOLD
    companionad {
      w: 0
      h: 0
      mimes: "image/png"
      mimes: "image/gif"
      format {
        w: 0
        h: 0
      }
    }
    api: VPAID_1
    api: VPAID_2
    companiontype: STATIC
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: true
    placement: IN_STREAM_PLACEMENT
    durfloors {
      maxdur: 121
      bidfloor: 628.6151504524262
    }
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_ACCOMPANYING_CONTENT
      embeddedoffsite: true
    }
  }
  displaymanager: "GOOGLE"
  tagid: "1064104152"
  bidfloor: 628.6151504524262
  bidfloorcur: "JPY"
  pmp {
    deals {
      id: "45957820"
      bidfloor: 628.615151
      bidfloorcur: "JPY"
      [com.google.doubleclick.deal] {
        deal_type: AUCTION_PACKAGE
        billing_id: 34409190968
        billing_id: 31520375265
      }
    }
  }
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.061625368893146515
    vendor: "EXCHANGE"
  }
  metric {
    type: "video_completion_rate"
    value: 0.6049572825431824
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 63495119434
    billing_id: 33073577463
    publisher_settings_list_id: 2610320062869254712
    publisher_settings_list_id: 3579681458579529403
    allowed_vendor_type: 0
    ampad: AMP_AD_NOT_ALLOWED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "IL"
    }
  }
  content {
    livestream: false
    language: "en"
  }
  mobile: true
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    ntype: NAVIGATION_TYPE_UNKNOWN
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "OH"
    metro: "558"
    city: "Lima"
    zip: "45806"
    type: IP
    utcoffset: -240
    accuracy: 6877
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9015962
    }
  }
  make: "Samsung"
  model: "sm-s921u"
  os: "android"
  osv: "15"
  devicetype: HIGHEND_PHONE
  w: 1080
  h: 2340
  sua {
    browsers {
      brand: "Chromium"
      version: "140"
      version: "0"
    }
    browsers {
      brand: "Not=A?Brand"
      version: "24"
      version: "0"
    }
    platform {
      brand: "Android"
      version: "15"
      version: "0"
    }
    mobile: true
    model: "SM-S921U"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  id: "2P499L961q5433F3W7910N24dm6"
  buyeruid: "d1f6LSo115M9T6r3wjcX397Iu6231g73"
  customdata: "98f88k2F7Q9e99vqQIs7eH5OEch4603AQ1e4zo9vP0259ZWI"
  [com.google.doubleclick.user] {
    idage: 432000
  }
}
at: FIRST_PRICE
tmax: 350
cur: "TRY"
cur: "JPY"
bcat: "32"
bcat: "33"
source {
  schain {
    complete: false
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google1"
    omidpv: "h.3.719.1"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  bid_feedback {
    request_id: "iC415EO28u2s07s8qn220h"
    creative_status_code: 80
    event_notification_token {
      payload: "token"
    }
    buyer_creative_id: "test_creative_id_459586"
    minimum_bid_to_win: 0.69
    feedbacktype: BID_FEEDBACK
  }
  google_query_id: "ANy-zk4xW4-6F6LW16t4c1LRx767c3V2OC7z3d7Z9TROv5359i3VMG9aT5b136WKCued3457"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "9B5K1zj5T61jRM80t25s13",
  "imp": [
    {
      "id": "1",
      "video": {
        "mimes": [
          "application/javascript",
          "video/mp4"
        ],
        "linearity": 1,
        "maxduration": 60,
        "w": 306,
        "h": 156,
        "startdelay": 0,
        "playbackmethod": [
          6
        ],
        "pos": 1,
        "companionad": [
          {
            "w": 0,
            "h": 0,
            "mimes": [
              "image/png",
              "image/gif"
            ],
            "format": [
              {
                "w": 0,
                "h": 0
              }
            ]
          }
        ],
        "api": [
          1,
          2
        ],
        "companiontype": [
          1
        ],
        "protocols": [
          2,
          3
        ],
        "skip": 1,
        "placement": 1,
        "durfloors": [
          {
            "maxdur": 121,
            "bidfloor": 628.6151504524262
          }
        ],
        "ext": {
          "inferredplcmt": 2,
          "embeddedoffsite": 1
        }
      },
      "displaymanager": "GOOGLE",
      "tagid": "1064104152",
      "bidfloor": 628.6151504524262,
      "bidfloorcur": "JPY",
      "pmp": {
        "deals": [
          {
            "id": "45957820",
            "bidfloor": 628.615151,
            "bidfloorcur": "JPY",
            "ext": {
              "deal_type": 4,
              "billing_id": [
                "34409190968",
                "31520375265"
              ]
            }
          }
        ]
      },
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.061625368893146515,
          "vendor": "EXCHANGE"
        },
        {
          "type": "video_completion_rate",
          "value": 0.6049572825431824,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "63495119434",
          "33073577463"
        ],
        "publisher_settings_list_id": [
          "2610320062869254712",
          "3579681458579529403"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "IL"
      }
    },
    "content": {
      "livestream": 0,
      "language": "en"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "ntype": 0
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "USA",
      "region": "OH",
      "metro": "558",
      "city": "Lima",
      "zip": "45806",
      "type": 2,
      "utcoffset": -240,
      "accuracy": 6877,
      "ext": {
        "geo_criteria_id": 9015962
      }
    },
    "make": "Samsung",
    "model": "sm-s921u",
    "os": "android",
    "osv": "15",
    "devicetype": 4,
    "w": 1080,
    "h": 2340,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "140",
            "0"
          ]
        },
        {
          "brand": "Not=A?Brand",
          "version": [
            "24",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 1,
      "model": "SM-S921U",
      "source": 2
    }
  },
  "user": {
    "id": "2P499L961q5433F3W7910N24dm6",
    "buyeruid": "d1f6LSo115M9T6r3wjcX397Iu6231g73",
    "customdata": "98f88k2F7Q9e99vqQIs7eH5OEch4603AQ1e4zo9vP0259ZWI",
    "ext": {
      "idage": 432000
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "TRY",
    "JPY"
  ],
  "bcat": [
    "32",
    "33"
  ],
  "source": {
    "schain": {
      "complete": 0,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        },
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "omidpn": "Google1",
      "omidpv": "h.3.719.1"
    }
  },
  "cattax": 500,
  "ext": {
    "bid_feedback": [
      {
        "request_id": "iC415EO28u2s07s8qn220h",
        "creative_status_code": 80,
        "event_notification_token": {
          "payload": "token"
        },
        "buyer_creative_id": "test_creative_id_459586",
        "minimum_bid_to_win": 0.69,
        "feedbacktype": 1
      }
    ],
    "google_query_id": "ANy-zk4xW4-6F6LW16t4c1LRx767c3V2OC7z3d7Z9TROv5359i3VMG9aT5b136WKCued3457",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "7JU6159A685P1Yq6AZYs9c"
imp {
  id: "1"
  banner {
    w: 300
    h: 50
    pos: SIDEBAR
    format {
      w: 300
      h: 50
    }
    format {
      w: 320
      h: 100
    }
  }
  displaymanager: "GOOGLE"
  tagid: "5569141195"
  bidfloor: 0.11
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.00012157167657278478
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.54
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 29290087654
    publisher_settings_list_id: 1176624544028271271
    publisher_settings_list_id: 7690166540312314658
    allowed_vendor_type: 0
    dfp_ad_unit_code: "/4270097/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    allowed_restricted_category: 32
    allowed_restricted_category: 33
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    livestream: false
    language: "en"
  }
  mobile: true
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    uact {
      wasact: true
      isact: true
    }
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "CA"
    metro: "803"
    city: "Los Angeles"
    type: IP
    utcoffset: -420
    accuracy: 20337
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1013962
    }
  }
  ipv6: "2a04:4e41:2959::"
  make: "Apple"
  model: "iphone"
  os: "iOS"
  osv: "18.6.2"
  devicetype: HIGHEND_PHONE
  w: 393
  h: 852
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "18"
      version: "6"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
}
user {
  [com.google.doubleclick.user] {
    eids {
      source: "OMITTED_SOURCE"
      uids {
        id: "OMITTED_ID"
      }
    }
    eids {
      source: "OMITTED_SOURCE"
      uids {
        id: "OMITTED_ID"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
bcat: "IAB14-1"
bcat: "IAB17-11"
regs {
  gpp: "OMITTED"
  gpp_sid: USCA
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: IAB_CONTENT_1_0
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z49Z28-30csCH3Q6L2592cP4mj84zr6ZQJ982HPa49dwsj1WphMK1goO8M62j84bh1PB"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "7JU6159A685P1Yq6AZYs9c",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 50,
        "pos": 6,
        "format": [
          {
            "w": 300,
            "h": 50
          },
          {
            "w": 320,
            "h": 100
          }
        ]
      },
      "displaymanager": "GOOGLE",
      "tagid": "5569141195",
      "bidfloor": 0.11,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.00012157167657278478,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.54,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "29290087654"
        ],
        "publisher_settings_list_id": [
          "1176624544028271271",
          "7690166540312314658"
        ],
        "allowed_vendor_type": [
          0
        ],
        "dfp_ad_unit_code": "/4270097/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          },
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "allowed_restricted_category": [
          32,
          33
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "US"
      }
    },
    "content": {
      "livestream": 0,
      "language": "en"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "uact": {
        "wasact": 1,
        "isact": 1
      },
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "USA",
      "region": "CA",
      "metro": "803",
      "city": "Los Angeles",
      "type": 2,
      "utcoffset": -420,
      "accuracy": 20337,
      "ext": {
        "geo_criteria_id": 1013962
      }
    },
    "ipv6": "2a04:4e41:2959::",
    "make": "Apple",
    "model": "iphone",
    "os": "iOS",
    "osv": "18.6.2",
    "devicetype": 4,
    "w": 393,
    "h": 852,
    "pxratio": 3.0,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "AppleWebKit",
          "version": [
            "605",
            "1"
          ]
        }
      ],
      "platform": {
        "brand": "iPhone",
        "version": [
          "18",
          "6"
        ]
      },
      "mobile": 1,
      "bitness": "64",
      "model": "iPhone",
      "source": 3
    }
  },
  "user": {
    "ext": {
      "eids": [
        {
          "source": "OMITTED_SOURCE",
          "uids": [
            {
              "id": "OMITTED_ID"
            }
          ]
        },
        {
          "source": "OMITTED_SOURCE",
          "uids": [
            {
              "id": "OMITTED_ID"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB14-1",
    "IAB17-11"
  ],
  "regs": {
    "gpp": "OMITTED",
    "gpp_sid": [
      8
    ]
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        },
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 1,
  "ext": {
    "google_query_id": "ANy-z49Z28-30csCH3Q6L2592cP4mj84zr6ZQJ982HPa49dwsj1WphMK1goO8M62j84bh1PB",
    "fcap_scope": 1
  }
}

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

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "rKxPN2rc298433R68335M1"
imp {
  id: "1"
  banner {
    w: 320
    h: 480
    pos: SIDEBAR
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    wmax: 384
    hmax: 480
    wmin: 300
    hmin: 50
    format {
      w: 320
      h: 480
    }
    format {
      w: 320
      h: 50
    }
    [com.google.doubleclick.banner_ext] {
      flexslot {
        wmin: 300
        wmax: 384
        hmin: 50
        hmax: 480
      }
    }
  }
  video {
    mimes: "video/mp4"
    linearity: LINEAR
    w: 320
    h: 480
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    playbackmethod: ENTER_SOUND_OFF
    pos: BELOW_THE_FOLD
    protocols: VAST_2_0
    protocols: VAST_3_0
    skip: true
    placement: IN_ARTICLE_PLACEMENT
    playbackend: LEAVING_OR_USER
    plcmt: PLCMT_NO_CONTENT_STANDALONE
    [com.google.doubleclick.video] {
      inferredplcmt: PLCMT_NO_CONTENT_STANDALONE
    }
  }
  displaymanager: "GOOGLE"
  tagid: "9536033828"
  bidfloor: 241.70793093803206
  bidfloorcur: "JPY"
  pmp {
    deals {
      id: "52277873"
      bidfloor: 1397.489002
      bidfloorcur: "JPY"
      at: FIXED_PRICE
      [com.google.doubleclick.deal] {
        deal_type: PREFERRED_DEAL
        publisher_blocks_overridden: true
        creative_constraints {
          mtypes: CREATIVE_MARKUP_BANNER
        }
        billing_id: 75764464008
        billing_id: 72269403729
      }
    }
    deals {
      id: "75438087"
      bidfloor: 399.282572
      bidfloorcur: "JPY"
      at: FIXED_PRICE
      [com.google.doubleclick.deal] {
        deal_type: PREFERRED_DEAL
        publisher_blocks_overridden: true
        creative_constraints {
          mtypes: CREATIVE_MARKUP_BANNER
        }
        billing_id: 54698438246
        billing_id: 73896418461
      }
    }
  }
  secure: true
  native {
    ver: "1.2"
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 5
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 6
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      plcmttype: IN_FEED
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        pos: BELOW_THE_FOLD
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0041323439218103886
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.34
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 73015827208
    billing_id: 49611563199
    publisher_settings_list_id: 8800547900990823335
    publisher_settings_list_id: 7288715008664845891
    allowed_vendor_type: 0
    ampad: AMP_AD_ALLOWED_AND_EARLY_RENDERED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 32
    allowed_restricted_category: 33
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "GB"
    }
  }
  content {
    livestream: false
    language: "en"
  }
  mobile: true
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML_AMP
    page_visibility: VISIBILITY_STATE_HIDDEN
    ntype: NAVIGATION_TYPE_UNKNOWN
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GBR"
    region: "GB-ENG"
    city: "London"
    zip: "SE1"
    type: IP
    utcoffset: 60
    accuracy: 1437
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9045888
    }
  }
  ipv6: "2a00:23ee:2870::"
  carrier: "70062"
  make: "Samsung"
  model: "sm-a326b"
  os: "android"
  osv: "12"
  devicetype: HIGHEND_PHONE
  w: 385
  h: 854
  pxratio: 1.875
  sua {
    browsers {
      brand: "Chromium"
      version: "136"
    }
    browsers {
      brand: "Google Chrome"
      version: "136"
    }
    platform {
      brand: "Android"
      version: "12"
      version: "0"
    }
    mobile: true
    model: "SM-A326B"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  id: "91b09w734L84717xiK05zAZf5n0"
  buyeruid: "8vo3pY3AoGtGr33C3l7675sM26SB7NB8"
  customdata: "868uz0uj2AjUDOD604yq2d8KwN8dhQyH2Qlulc9m2oF4f866"
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1725
      consented_providers: 2922
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    idage: 20736000
  }
}
at: FIRST_PRICE
tmax: 350
cur: "GBP"
cur: "TRY"
bcat: "5"
bcat: "8"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zAo260-k5UV8JFUsGCH92VU2O823b532U1q8Gzs72ny20W3Tnhi3rod972Z990D7324m"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "rKxPN2rc298433R68335M1",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 320,
        "h": 480,
        "pos": 6,
        "battr": [
          6,
          7
        ],
        "wmax": 384,
        "hmax": 480,
        "wmin": 300,
        "hmin": 50,
        "format": [
          {
            "w": 320,
            "h": 480
          },
          {
            "w": 320,
            "h": 50
          }
        ],
        "ext": {
          "flexslot": {
            "wmin": 300,
            "wmax": 384,
            "hmin": 50,
            "hmax": 480
          }
        }
      },
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "linearity": 1,
        "w": 320,
        "h": 480,
        "battr": [
          6,
          7
        ],
        "playbackmethod": [
          6
        ],
        "pos": 3,
        "protocols": [
          2,
          3
        ],
        "skip": 1,
        "placement": 3,
        "playbackend": 2,
        "plcmt": 4,
        "ext": {
          "inferredplcmt": 4
        }
      },
      "displaymanager": "GOOGLE",
      "tagid": "9536033828",
      "bidfloor": 241.70793093803206,
      "bidfloorcur": "JPY",
      "pmp": {
        "deals": [
          {
            "id": "52277873",
            "bidfloor": 1397.489002,
            "bidfloorcur": "JPY",
            "at": 3,
            "ext": {
              "deal_type": 1,
              "publisher_blocks_overridden": 1,
              "creative_constraints": {
                "mtypes": [
                  1
                ]
              },
              "billing_id": [
                "75764464008",
                "72269403729"
              ]
            }
          },
          {
            "id": "75438087",
            "bidfloor": 399.282572,
            "bidfloorcur": "JPY",
            "at": 3,
            "ext": {
              "deal_type": 1,
              "publisher_blocks_overridden": 1,
              "creative_constraints": {
                "mtypes": [
                  1
                ]
              },
              "billing_id": [
                "54698438246",
                "73896418461"
              ]
            }
          }
        ]
      },
      "secure": 1,
      "native": {
        "ver": "1.2",
        "battr": [
          6,
          7
        ],
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":5,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":6,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"plcmttype\":1,\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"pos\":3}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0041323439218103886,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.34,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "73015827208",
          "49611563199"
        ],
        "publisher_settings_list_id": [
          "8800547900990823335",
          "7288715008664845891"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 4,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          32,
          33
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "GB"
      }
    },
    "content": {
      "livestream": 0,
      "language": "en"
    },
    "mobile": 1,
    "ext": {
      "amp": 1,
      "page_visibility": 2,
      "ntype": 0
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GBR",
      "region": "GB-ENG",
      "city": "London",
      "zip": "SE1",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 1437,
      "ext": {
        "geo_criteria_id": 9045888
      }
    },
    "ipv6": "2a00:23ee:2870::",
    "carrier": "70062",
    "make": "Samsung",
    "model": "sm-a326b",
    "os": "android",
    "osv": "12",
    "devicetype": 4,
    "w": 385,
    "h": 854,
    "pxratio": 1.875,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "136"
          ]
        },
        {
          "brand": "Google Chrome",
          "version": [
            "136"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "12",
          "0"
        ]
      },
      "mobile": 1,
      "model": "SM-A326B",
      "source": 2
    }
  },
  "user": {
    "id": "91b09w734L84717xiK05zAZf5n0",
    "buyeruid": "8vo3pY3AoGtGr33C3l7675sM26SB7NB8",
    "customdata": "868uz0uj2AjUDOD604yq2d8KwN8dhQyH2Qlulc9m2oF4f866",
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1725",
          "2922"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "idage": 20736000
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "GBP",
    "TRY"
  ],
  "bcat": [
    "5",
    "8"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zAo260-k5UV8JFUsGCH92VU2O823b532U1q8Gzs72ny20W3Tnhi3rod972Z990D7324m",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

`minimum_bid_to_win`	Xác suất
\(max(F, R, C_3) = $0.50\)	\(f_3 = 80\%\)
\(max(F, R, C_4) = $0.10\)	\((1-f_3) \cdot f_4 = 17\%\)
\(max(F, R, 0) = $0.05\)	\((1-f_3) \cdot (1-f_4) = 3\%\)

`sampled_mediation_cpm_ ahead_of_auction_winner`	Xác suất
\(C_1 = $3.00\)	\(f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%\)
\(C_2 = $2.00\)	\(((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%\)

`sampled_mediation_cpm_ ahead_of_auction_winner`	Xác suất
\(C_1 = $3.00\)	\(f_1 = 5\%\)
\(C_2 = $2.00\)	\((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\)	\((1-f_1) \cdot (1-f_2) =~ 52.2\%\)

Trường	Cách tính
`minimum_bid_to_win`	\(max\{F, R, X_{K+1}, …, X_n\}\)
`sampled_mediation_cpm_ahead_ of_auction_winner`	\(\{C_i\) với xác suất \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\) Đối với \(1 <= i <= K\).

Trường	Cách tính
`minimum_bid_to_win`	\(max\{F, W\}\)
`sampled_mediation_cpm_ahead_ of_auction_winner`	\(max\{X_1, …, X_K\}\)

Xử lý yêu cầu Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Mã thanh toán

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

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

Hệ thống phân loại danh mục quảng cáo của Google

Tệp từ điển

Macro URL của đơn vị đặt giá thầu

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

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

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

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

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

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

Mẫu

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

Cách hoạt động

Cách tính cho người chiến thắng trong phiên đấu giá

Cách tính toán cho người thua cuộc trong phiên đấu giá

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

Giá thầu thắng phiên đấu giá

Giá thầu thua trong phiên đấu giá

phân tách giá thầu

Định dạng quảng cáo

Ví dụ về việc đơn giản hoá định dạng quảng cáo

Làm phẳng trước

Ví dụ minh họa

Sau khi hợp nhất

Ví dụ minh họa

Yêu cầu 1

Yêu cầu 2

Ưu đãi

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

Nhóm video

Đo lường mở

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

Biểu ngữ ứng dụng

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

Video trên web

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

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

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

Xử lý yêu cầu