Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Bangun Responsnya

Setelah aplikasi Anda memproses permintaan bid dari Google, aplikasi tersebut harus membuat dan mengirim respons. Panduan ini menjelaskan cara membuat kode aplikasi Anda untuk membuat respons.

Membuat pesan BidResponse

Untuk mengirimkan bid, aplikasi bidding Anda harus merespons permintaan bid dengan BidResponse yang berisi Bid dalam format yang dikonfigurasi. Jika Anda menggunakan format JSON, respons Anda harus menyetel header Content-Type ke application/json; charset=utf-8 dan menyertakan JSON BidResponse dalam isi. Jika Anda menggunakan format Protobuf, aplikasi Anda harus menyetel header Content-Type ke application/octet-stream dan menyertakan BidResponse yang diserialisasi dalam isi.

Untuk membuat dan melakukan serialisasi BidResponse untuk format Protobuf, Anda harus membuat dan menggunakan library Protobuf berdasarkan openrtb.proto dan openrtb-adx.proto, yang masing-masing menerapkan kolom BidResponse OpenRTB standar dan ekstensi Google di Protobuf. Hal ini dapat ditemukan di Protos & Data Referensi.

Jika Anda tidak ingin mengajukan bid pada tayangan iklan, Anda harus menampilkan respons HTTP 204 kosong. Aplikasi Anda harus menampilkan respons untuk setiap BidRequest. Waktu tunggu dan respons yang tidak dapat diuraikan dianggap sebagai error dan Google akan membatasi bidder dengan rasio error yang tinggi.

ID Materi Iklan

BidResponse Anda menentukan materi iklan melalui kolom BidResponse.seatbid.bid.crid (batas 128 byte). Bahkan materi iklan yang serupa harus memiliki nilai unik untuk kolom ini jika berbeda dalam karakteristik penting apa pun, termasuk, tetapi tidak terbatas pada: ukuran, URL yang dinyatakan, atribut materi iklan, dan jenis vendor. Dengan kata lain, Anda harus memberikan ID materi iklan yang berbeda untuk dua iklan yang:

Terlihat atau berperilaku berbeda.
Merender ke gambar yang berbeda.
Dirender dengan cara yang berbeda (misalnya, satu iklan terdiri dari gambar, sedangkan iklan lainnya adalah video).

Saat mendesain aplikasi, Anda harus memutuskan cara sistematis untuk membuat ID yang sesuai dengan jenis materi iklan yang akan Anda kirimkan.

Atribut iklan

Google merekomendasikan untuk mendeklarasikan atribut materi iklan guna mendeskripsikan karakteristik iklan dan penargetannya menggunakan kombinasi BidResponse.seatbid.bid.apis dan BidResponse.seatbid.bid.attr, atau ekstensi BidResponse.seatbid.bid.ext.attribute. Berikut ini menjelaskan cara mendeklarasikan atribut:

VPAID
Tetapkan BidResponse.seatbid.bid.apis ke VPAID_1, atau VPAID_2. Untuk format JSON, ini dapat disetel ke 1 atau 2.
MRAID
Tetapkan BidResponse.seatbid.bid.apis ke MRAID_1, atau 3 untuk format JSON.
SIZELESS
Tetapkan BidResponse.seatbid.bid.attr ke RESPONSIVE, atau 18 untuk format JSON.
PLAYABLE
Hal ini ditunjukkan dengan menyetel BidResponse.seatbid.bid.attr ke USER_INTERACTIVE, atau 13 untuk format JSON.

Catatan: Jika Anda menggunakan ekstensi BidResponse.seatbid.bid.ext.attribute, Anda dapat menggunakan nilai yang ditemukan di buyer-declarable-creative-attributes.txt untuk mendeklarasikan atribut ini.

Lihat resource Materi Iklan untuk mengetahui penjelasan tentang cara mendapatkan masukan terkait properti yang terdeteksi dari materi iklan Anda.

Kolom Bidding Terbuka

Respons bid yang dikirim oleh bidder bursa dan jaringan yang berpartisipasi dalam Bidding Terbuka serupa dengan respons bid Authorized Buyers yang berpartisipasi dalam bidding real-time standar. Pelanggan Bidding Terbuka dapat menentukan sejumlah kecil kolom tambahan, dan beberapa kolom yang ada mungkin memiliki penggunaan alternatif. Hal ini mencakup:

Kolom	Detail
`BidResponse.imp.pmp.deals.id`	ID transaksi dari namespace bursa yang terkait dengan bid ini dan dilaporkan kepada penayang. Catatan: Kolom ini hanya dikirim ke peserta beta tertutup.
`BidResponse.seatbid.bid.ext.exchange_deal_type`	Jenis transaksi yang dilaporkan kepada penayang, yang memengaruhi cara transaksi ditangani dalam lelang. Catatan: Kolom ini hanya dikirim ke peserta beta tertutup.
`BidResponse.seatbid.bid.ext.third_party_buyer_token`	Token yang digunakan untuk mengidentifikasi informasi pembeli pihak ketiga akhir jika bursa sebagai Bidder Terbuka adalah perantara. ID ini diperoleh dari pembeli pihak ketiga dan harus diteruskan ke Google tanpa diubah dalam respons bid.

Rekomendasi

Aktifkan koneksi HTTPS persisten (juga dikenal sebagai "keep-alive" atau "penggunaan ulang koneksi") di server Anda. Tetapkan waktu tunggu ke minimal 10 detik—nilai yang lebih tinggi akan bermanfaat dalam banyak kasus. Google memverifikasi hal ini selama pengujian latensi awal aplikasi Anda, karena Authorized Buyers mengirim permintaan dengan kecepatan tinggi dan perlu menghindari overhead latensi saat membuat koneksi TCP terpisah untuk setiap permintaan.
Sertakan URL pelacakan tayangan opsional untuk melacak saat tayangan dirender, bukan saat bidder memenangkan lelang. Karena adanya penurunan antara kemenangan dan rendering, hal ini menghasilkan statistik pelacakan yang lebih akurat.

Catatan: Saat menggunakan OpenRTB, kolom standar untuk ini adalah BidResponse.seatbid.bid.burl.
Jaga agar kode bidder Anda bebas dari dependensi pada kolom yang tidak digunakan lagi, yang dapat menyebabkan bid Anda gagal karena error.
Sertakan BidResponse.seatbid.bid.w dan BidResponse.seatbid.bid.h dalam BidResponse Anda. A BidResponse ke permintaan yang menyertakan beberapa ukuran iklan harus menyertakan kolom ini atau akan dikeluarkan dari lelang.
Batasi ukuran respons Anda hingga di bawah 8K. Respons yang sangat besar dapat meningkatkan latensi jaringan dan menyebabkan waktu tunggu habis.
Ikuti pedoman untuk bid pada inventaris iOS yang memerlukan atribusi SKAdNetwork.

Contoh respons bid

Contoh berikut menampilkan sampel permintaan Protobuf dan JSON yang mudah dibaca.

Protobuf OpenRTB

Berikan contohnya

Respons berseri

id: "Z40x0v53721142nd3J1E07"
seatbid {
  bid {
    id: "25lvG8gXKV0GEcaQE67"
    impid: "1"
    price: 0.01176087612355106
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_656889"
    w: 395
    h: 62
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      exchange_deal_type: OPEN_AUCTION
      attribute: 21
      event_notification_token {
        payload: "token"
      }
      billing_id: 40355106859
      clickurl: "google.com"
    }
  }
  seat: "7877:1572:891547"
}
bidid: "A7j5NZRS-vA5H1033-4084-459j7H7Gn614"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 54
}

JSON OpenRTB

Berikan contohnya

{
  "id": "Z40x0v53721142nd3J1E07",
  "seatbid": [
    {
      "bid": [
        {
          "id": "25lvG8gXKV0GEcaQE67",
          "impid": "1",
          "price": 0.01176087612355106,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_656889",
          "w": 395,
          "h": 62,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "exchange_deal_type": 0,
            "attribute": [
              21
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "40355106859",
            "clickurl": [
              "google.com"
            ]
          }
        }
      ],
      "seat": "7877:1572:891547"
    }
  ],
  "bidid": "A7j5NZRS-vA5H1033-4084-459j7H7Gn614",
  "ext": {
    "processing_time_ms": 54
  }
}

Penting: Pesan Protobuf yang digambarkan dalam contoh ditampilkan di sini sebagai teks yang mudah dibaca. Namun, pesan tidak dikirim melalui kabel seperti itu. Saat menggunakan format Protobuf OpenRTB, hanya pesan BidResponse yang diserialisasi yang akan diterima.

Anda dapat membuat dan melakukan serialisasi pesan BidResponse menggunakan kode C++ berikut:

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

Tentukan materi iklan

Respons bid Anda menentukan materi iklan yang akan ditayangkan jika bid Anda menang. Bid Anda harus menyertakan salah satu format iklan yang didukung (AMP, video, native). Dalam contoh ini, kita menentukan materi iklan menggunakan kolom html_snippet.

Atau, Anda dapat menentukan materi iklan menggunakan salah satu kolom berikut, berdasarkan format iklan:

Iklan yang dirender SDK
- BidResponse.seatbid.bid.ext.sdk_rendered_ad
AMP
- BidResponse.seatbid.bid.amp_ad_url
Video
- BidResponse.seatbid.bid.adm
Native
- BidResponse.seatbid.bid.adm_native

Tentukan iklan yang dihosting di server Anda sendiri menggunakan cuplikan HTML di kolom BidResponse.seatbid.bid.adm. Cuplikan disertakan dalam iFrame yang disisipkan di halaman web, sehingga iklan diambil dan dirender saat halaman dimuat. Anda harus membuat cuplikan HTML sehingga iklan (banner atau interstisial) dirender dengan benar di dalam iFrame, dan pada ukuran yang sesuai untuk slot iklan yang Anda bid.

Selain itu, ukuran iklan yang dinyatakan dalam respons bid harus cocok dengan tepat salah satu kombinasi ukuran dalam permintaan bid saat:

Iklan adalah banner reguler (bukan video, native, atau interstisial).
Bidder telah menyatakan ukuran dalam respons bid. Pernyataan ukuran diperlukan setiap kali ada lebih dari satu ukuran dalam permintaan.
Pengecualian dibuat untuk iklan interstisial. Untuk iklan pengantara, lebar harus minimal 50% dari lebar layar dan tinggi minimal 40% dari tinggi layar.

Anda dapat menentukan materi iklan cuplikan HTML menggunakan kode HTML valid yang dirender dengan benar, tetapi perlu diingat batasan dalam menentukan kolom crid di bagian Buat pesan BidResponse. Salah satu penggunaan untuk ini adalah memasukkan informasi tambahan ke dalam argumen URL yang diambil dari server Anda sebagai bagian dari rendering iklan. Dengan begitu, Anda dapat meneruskan data arbitrer tentang tayangan kembali ke server Anda sendiri.

Sebagian besar kebijakan untuk cuplikan HTML yang ditampilkan dalam respons bid sama dengan kebijakan untuk iklan pihak ketiga. Lihat Pedoman Program Authorized Buyers, Persyaratan untuk penayangan iklan pihak ketiga, dan Mendeklarasikan URL tayang-klik dalam iklan untuk mengetahui informasi selengkapnya.

Menentukan makro

Makro adalah teks berformat yang disematkan ke dalam beberapa kolom respons bid yang berisi URL yang diganti dengan nilai yang relevan pada waktu penayangan iklan. Misalnya, jika bid yang Anda menangkan menyertakan makro AUCTION_PRICE dalam materi iklan cuplikan HTML yang disertakan dengan bid Anda, makro tersebut akan diganti dengan nilai yang dapat Anda dekripsi untuk menentukan jumlah yang Anda bayar untuk tayangan iklan dalam lelang.

Anda dapat menyertakan makro di kolom berikut:

BidResponse.seatbid.bid.adm

Makro didukung untuk cuplikan HTML, native, URL video, dan format XML VAST video.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

Hanya makro WINNING_PRICE dan WINNING_PRICE_ESC khusus Google yang didukung untuk materi iklan AMP.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

Gunakan ini, bukan BidResponse.seatbid.bid.burl jika Anda memerlukan lebih dari satu URL penagihan.

Sebagai contoh, Anda dapat menyertakan makro sebagai bagian dari cuplikan HTML dengan menyematkan ${MACRO} dalam URL yang digunakan untuk mengambil materi iklan, dengan MACRO adalah salah satu makro yang didukung yang dijelaskan dalam spesifikasi OpenRTB.

Makro Google

Google mendukung makro tambahan selain yang ada dalam spesifikasi OpenRTB. Makro ini diformat secara berbeda, dan akan muncul sebagai %%MACRO%% jika disematkan dalam URL. Tabel berikut menjelaskan makro ini:

Makro	Deskripsi
`ADVERTISING_IDENTIFIER`	Memungkinkan pembeli menerima IDFA iOS atau ID Iklan Android saat rendering tayangan iklan. Lihat Mendekripsi ID Pengiklan untuk mengetahui detailnya.
`CACHEBUSTER`	Representasi string dari bilangan bulat empat byte tanpa tanda acak.
`CLICK_URL_UNESC`	URL klik tanpa konversi karakter untuk iklan. Dalam cuplikan, versi yang di-escape dari URL klik pihak ketiga harus langsung mengikuti makro. Misalnya, jika URL klik pihak ketiga adalah `http://my.adserver.com/some/path/handleclick?click=clk`, maka kode berikut dapat digunakan dengan versi yang di-escape tunggal dari URL klik pihak ketiga setelah pemanggilan makro: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Pada waktu penayangan iklan, ini diperluas menjadi: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> URL akan mendaftarkan klik terlebih dahulu dengan Google, lalu mengalihkan ke URL klik pihak ketiga.
`CLICK_URL_ESC`	URL klik yang di-escape untuk iklan. Gunakan ini, bukan `CLICK_URL_UNESC` jika Anda perlu meneruskan nilai terlebih dahulu melalui server lain yang kemudian akan menampilkan pengalihan. Misalnya, kode berikut dapat digunakan dalam cuplikan HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Pada waktu penayangan iklan, ini diperluas menjadi: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Tindakan ini akan mendaftarkan klik dengan `my.adserver.com` yang kemudian akan bertanggung jawab untuk mengalihkan ke URL yang diteruskan dalam parameter `google_click_url`. Contoh ini mengasumsikan bahwa `my.adserver.com` membatalkan escape parameter `google_click_url`. Anda dapat menambahkan URL yang di-escape ganda setelah `%%CLICK_URL_ESC%%`. Setelah proses unescape dilakukan oleh `my.adserver.com`, akan ada satu versi URL yang di-escape dan ditambahkan ke `google_click_url`. Saat `google_click_url` diambil, `google_click_url` akan di-unescape sekali lagi lalu dialihkan.
`CLICK_URL_ESC_ESC`	URL yang di-escape dua kali untuk iklan. Gunakan ini, bukan `CLICK_URL_UNESC` jika Anda perlu meneruskan nilai terlebih dahulu melalui server lain yang kemudian akan menampilkan pengalihan. Misalnya, kode berikut dapat digunakan dalam cuplikan HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> Pada waktu penayangan iklan, ini diperluas menjadi: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	Diperluas menjadi `http:` jika permintaan bid tidak memerlukan SSL atau menjadi `https:` jika permintaan bid memerlukan SSL.
`SITE`	Domain yang di-escape URL dari URL konten atau ID anonim untuk inventaris anonim.
`SITE_URL`	Tidak digunakan lagi. Digantikan oleh makro SITUS yang menyediakan fungsi yang identik.
`TZ_OFFSET`	Selisih zona waktu.
`VERIFICATION`	Nilai yang berbeda untuk produksi dan saat materi iklan dipindai di pipeline verifikasi. Formatnya adalah: `%%?VERIFICATION:true-val:false-val%%` dengan nilai apa pun kecuali makro dapat digunakan untuk `true-val` dan `false-val`, termasuk string kosong. Untuk Bidding Terbuka, sebaiknya bursa menggunakan makro ini. Setelah bursa melakukannya, platform sisi permintaan tidak perlu melakukan perubahan. Misalnya, jika materi iklan menyertakan `%%?VERIFICATION:-1:5000%%`, penggantian teks adalah `5000` saat penayangan dan `-1` dalam pipeline verifikasi. Hal ini dilakukan untuk membantu membedakan kedua set ping ini.
`WINNING_PRICE`	Biaya tayangan iklan yang dienkode (yaitu, CPI, bukan CPM) dalam mikro mata uang akun. Misalnya, CPM yang menang sebesar $5 USD sesuai dengan 5.000.000 CPM mikro, atau 5.000 CPI mikro. Nilai `WINNING_PRICE` yang didekode dalam kasus ini adalah 5.000. Harga pemenang ditentukan dalam CPI. Untuk mengurai makro ini, Anda harus menerapkan aplikasi yang mendekripsi konfirmasi harga. Lihat halaman Mendekripsi Konfirmasi Harga untuk mengetahui informasi selengkapnya.
`WINNING_PRICE_ESC`	`WINNING_PRICE` yang di-escape URL.

Google mewajibkan Anda menggunakan makro CLICK_URL_UNESC atau CLICK_URL_ESC dalam materi iklan yang ditayangkan pihak ketiga. Google menggunakan makro CLICK_URL untuk pelacakan klik.

Konversi karakter URL dalam makro menggunakan skema berikut:

Karakter spasi diganti dengan tanda plus (+).
Karakter alfanumerik (0-9, a-z, A-Z) dan karakter dari set !()*,-./:_~ tetap tidak berubah.
Semua karakter lainnya diganti dengan %XX, dengan XX adalah angka heksadesimal yang merepresentasikan karakter.

Pembatasan dan persyaratan penayang

Permintaan bid menyertakan informasi tentang jenis batasan dan persyaratan yang diterapkan penayang pada materi iklan dalam lelang.

BidRequest.bcat
- Anda dapat membandingkan kategori yang diblokir yang ditentukan oleh kolom ini dengan kategori yang terdeteksi untuk materi iklan yang Anda kirimkan menggunakan kolom detectedCategories Real-time Bidding API.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- Pada praktiknya, ini akan selalu ditetapkan true karena Google mewajibkan dukungan SSL untuk semua materi iklan.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes

Jangan pernah mengajukan bid dengan iklan yang berisi fitur yang dibatasi. Untuk fitur yang diizinkan seperti jenis vendor, tampilkan iklan hanya jika jenis vendornya ada dalam daftar allowed_vendor_type di BidRequest. Hanya format iklan yang ditentukan dalam permintaan bid dengan mengisi kolom seperti BidRequest.imp.banner yang harus disertakan dalam bid Anda. Lihat komentar untuk kolom ini dalam definisi buffer protokol BidRequest untuk mengetahui detail selengkapnya.

Jika iklan ditampilkan di BidResponse, Anda harus menetapkan BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat, dan salah satu bidang BidResponse.seatbid.bid.adomain atau BidResponse.seatbid.bid.adm_native.link.url secara akurat di BidResponse. Jika iklan memiliki beberapa nilai yang berlaku untuk kolom ini, Anda harus menyertakan setiap nilai. Lihat komentar untuk kolom ini dalam definisi buffer protokol BidResponse untuk mengetahui detail selengkapnya. Respons yang tidak menetapkan kolom ini akan diabaikan.

Pengukuran Terbuka

Pengukuran Terbuka memungkinkan Anda menentukan vendor pihak ketiga yang menyediakan layanan pengukuran dan verifikasi independen untuk iklan yang ditayangkan ke lingkungan aplikasi seluler.

Format iklan yang didukung mencakup iklan video, banner, dan interstisial. Untuk mengetahui informasi selengkapnya tentang cara menggunakan Pengukuran Terbuka dalam respons bid yang berisi format ini, lihat artikel Pusat Bantuan Open Measurement SDK.

Contoh respons bid

Bagian berikut menunjukkan contoh respons bid untuk berbagai jenis iklan.

Protobuf OpenRTB

Berikan contohnya

Respons berseri

id: "1i4fAl37oW6u51H59WmQdF"
seatbid {
  bid {
    id: "F5660t9N52c4972XV8n"
    impid: "1"
    price: 0.037953998893499374
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_257354"
    w: 390
    h: 60
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 61131625086
      app_promotion_type: INSTALLS
    }
  }
  seat: "7091:5573:967460"
}
cur: "USD"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 35
}

JSON OpenRTB

Berikan contohnya

{
  "id": "1i4fAl37oW6u51H59WmQdF",
  "seatbid": [
    {
      "bid": [
        {
          "id": "F5660t9N52c4972XV8n",
          "impid": "1",
          "price": 0.037953998893499374,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_257354",
          "w": 390,
          "h": 60,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "billing_id": "61131625086",
            "app_promotion_type": 1
          }
        }
      ],
      "seat": "7091:5573:967460"
    }
  ],
  "cur": "USD",
  "ext": {
    "processing_time_ms": 35
  }
}

Interstisial Aplikasi

Protobuf OpenRTB

Berikan contohnya

Respons berseri

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

JSON OpenRTB

Berikan contohnya

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

Video interstisial aplikasi

Protobuf OpenRTB

Berikan contohnya

Respons berseri

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

JSON OpenRTB

Berikan contohnya

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

Native aplikasi

Protobuf OpenRTB

Berikan contohnya

Respons berseri

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

JSON OpenRTB

Berikan contohnya

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

Video web

Protobuf OpenRTB

Berikan contohnya

Respons berseri

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

JSON OpenRTB

Berikan contohnya

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

Protobuf OpenRTB

Berikan contohnya

Respons berseri

id: "C379209h9u3tvIMwToq9PW"
seatbid {
  bid {
    id: "l36729l7aMo7WO801t9"
    impid: "1"
    price: 0.2
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_465923"
    w: 320
    h: 50
    mtype: CREATIVE_MARKUP_BANNER
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 98128982291
      third_party_buyer_token: "dl5c45g43kEO9Ie04cn6b4tG674R212W3pCNE7xew665149V0R600SJQR3OClz2KeJ8aGTWi4UnZsd6UnrNW8UU4EZ6w7mD32fI4EdIqi3fq7T88936L7hpA7Uz43451508HVp0Y47Pq"
    }
  }
  seat: "1433:4310:708345"
}
seatbid {
  bid {
    id: "Uod3V6V129YHu2g8V0p"
    impid: "1"
    price: 0.15
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_465923"
    w: 320
    h: 50
    mtype: CREATIVE_MARKUP_BANNER
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
    }
  }
  bid {
    id: "63V17Ip8VwlE60G90qV"
    impid: "1"
    price: 0.09
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_465923"
    w: 320
    h: 50
    mtype: CREATIVE_MARKUP_BANNER
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
    }
  }
  seat: "1433:4310:708345"
}
bidid: "918c2X56-F1CeU3fl-289U-4mm9263RC66m"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 130
}

JSON OpenRTB

Berikan contohnya

{
  "id": "C379209h9u3tvIMwToq9PW",
  "seatbid": [
    {
      "bid": [
        {
          "id": "l36729l7aMo7WO801t9",
          "impid": "1",
          "price": 0.2,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_465923",
          "w": 320,
          "h": 50,
          "mtype": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "98128982291",
            "third_party_buyer_token": "dl5c45g43kEO9Ie04cn6b4tG674R212W3pCNE7xew665149V0R600SJQR3OClz2KeJ8aGTWi4UnZsd6UnrNW8UU4EZ6w7mD32fI4EdIqi3fq7T88936L7hpA7Uz43451508HVp0Y47Pq"
          }
        }
      ],
      "seat": "1433:4310:708345"
    },
    {
      "bid": [
        {
          "id": "Uod3V6V129YHu2g8V0p",
          "impid": "1",
          "price": 0.15,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_465923",
          "w": 320,
          "h": 50,
          "mtype": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            }
          }
        },
        {
          "id": "63V17Ip8VwlE60G90qV",
          "impid": "1",
          "price": 0.09,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_465923",
          "w": 320,
          "h": 50,
          "mtype": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "1433:4310:708345"
    }
  ],
  "bidid": "918c2X56-F1CeU3fl-289U-4mm9263RC66m",
  "ext": {
    "processing_time_ms": 130
  }
}

Bangun Responsnya Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Membuat pesan BidResponse

ID Materi Iklan

Atribut iklan

Kolom Bidding Terbuka

Rekomendasi

Contoh respons bid

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Tentukan materi iklan

Menentukan makro

Makro Google

Pembatasan dan persyaratan penayang

Pengukuran Terbuka

Contoh respons bid

Banner aplikasi

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Interstisial Aplikasi

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Video interstisial aplikasi

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Native aplikasi

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Video web

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Banner web seluler untuk bidder bursa

Protobuf OpenRTB

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Bangun Responsnya