Halaman ini diterjemahkan oleh Cloud Translation API.

Bangun Responsnya

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

Buat pesan BidResponse

Authorized Buyers mengirimkan BidRequest sebagai isi pesan POST HTTP. Respons yang dikirim aplikasi Anda harus memiliki header Content-Type yang ditetapkan ke application/octet-stream dan isi pesan yang terdiri dari buffering protokol serial. Buffering protokol adalah pesan BidResponse seperti yang didefinisikan dalam realtime-bidding.proto. Aplikasi Anda harus menampilkan BidResponse yang dapat diuraikan sebagai respons terhadap setiap BidRequest. Waktu tunggu dan respons yang tidak dapat diuraikan dianggap error dan Google akan memperlambat bidder dengan tingkat error yang tinggi.

Jika tidak ingin mengajukan bid pada tayangan, Anda dapat menetapkan kolom processing_time_ms saja, dan membiarkan semua kolom lainnya kosong. Anda bisa mendapatkan realtime-bidding.proto dari halaman data referensi.

ID Materi Iklan

BidResponse Anda menentukan materi iklan melalui kolom buyer_creative_id (batas 64 byte). Bahkan materi iklan serupa harus memiliki nilai unik untuk buyer_creative_id jika materi iklan tersebut berbeda dalam semua karakteristik penting, termasuk, tetapi tidak terbatas pada: ukuran, URL yang dideklarasikan, 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.
Merender dengan cara yang berbeda (misalnya, satu iklan terdiri dari gambar, sedangkan iklan lainnya berisi Flash).

Saat mendesain aplikasi, Anda harus memutuskan cara sistematis untuk menghasilkan ID yang sesuai untuk jenis materi iklan yang ingin Anda kirim.

Atribut iklan

Anda harus mendeklarasikan atribut materi iklan yang mendeskripsikan sepenuhnya karakteristik iklan dan penargetannya di BidResponse.Ad.attribute. Atribut yang harus dideklarasikan adalah (lihat juga daftar lengkap atribut yang didukung di buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
Iklan berisi piksel atau suar web yang bertujuan membuat daftar ID cookie untuk pemasaran ulang berikutnya.
8 Remarketing: IsRemarketing
Iklan menargetkan konsumen berdasarkan ID cookie atau ID Perangkat mereka dengan daftar ID cookie atau ID Perangkat mewakili sekumpulan konsumen yang sebelumnya berinteraksi dengan situs yang dimiliki atau diwakili oleh pembeli.
9 UserInterestTargeting: IsUserInterestTargeted
Iklan menargetkan konsumen berdasarkan ID cookie atau ID Perangkat mereka dengan daftar ID cookie atau ID Perangkat mewakili sekumpulan konsumen yang ditetapkan pembeli sebagai grup minat umum.
30 InstreamVastVideoType: Vpaid
Iklan memerlukan dukungan VPAID untuk dirender.
32 MraidType: MRAID
Iklan memerlukan API MRAID untuk dirender.

Selain itu, atribut berikut didukung, tetapi deklarasinya tidak diperlukan, karena Authorized Buyers otomatis mendeteksinya, dan akan memblokir (atau mengizinkan) materi iklan berdasarkan nilai yang terdeteksi, bukan deklarasi Anda. Lihat Creatives API untuk penjelasan cara mendapatkan masukan terkait properti materi iklan yang terdeteksi.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
Iklan membutuhkan dukungan Flash untuk merender.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
Iklan tidak memerlukan Flash untuk dirender.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
Iklan memiliki kemampuan untuk ditampilkan pada halaman SSL. Perlu diketahui bahwa Authorized Buyers memperlakukan materi iklan dengan nilai yang dideklarasikan yang berbeda dari atribut ini sebagai berbeda (materi iklan ini akan ditinjau secara terpisah dan memiliki status persetujuan yang berbeda). Oleh karena itu, jika Anda mengajukan bid dengan versi SSL dan non-SSL dari materi iklan yang sama, Anda harus mendeklarasikan atribut ini sebagaimana mestinya, sehingga perbedaan ini tercermin dengan benar di AdX.

Kolom Bidding Terbuka

Respons bid yang dikirim oleh bidder bursa dan jaringan yang berpartisipasi dalam Bidding Terbuka serupa dengan 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 hal berikut:

OpenRTB	Authorized Buyers	Detail
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	ID transaksi dari namespace bursa yang terkait dengan bid ini dan dilaporkan kepada penayang. Catatan: Saat ini, kolom ini hanya dikirim ke peserta beta tertutup.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Jenis transaksi yang dilaporkan kepada penayang, yang memengaruhi cara transaksi diperlakukan dalam lelang. Catatan: Saat ini, kolom ini hanya dikirim ke peserta beta tertutup.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Token yang digunakan untuk mengidentifikasi informasi pembeli pihak ketiga akhir jika bursa sebagai Bidder Terbuka adalah perantara. Data 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. Setel waktu tunggu minimal ke 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 menang. Karena terjadi penurunan antara kemenangan dan rendering, ini menghasilkan statistik pelacakan yang lebih akurat.

Catatan: Jika menggunakan OpenRTB 2.5 atau versi yang lebih tinggi, kolom standar untuk ini adalah BidResponse.seatbid[].bid[].burl.
Pastikan kode bidder Anda bebas dari dependensi pada kolom yang tidak digunakan lagi, yang dapat menyebabkan bid Anda gagal dengan error.
Sertakan BidResponse.Ad.width dan BidResponse.Ad.height dalam BidResponse Anda. BidResponse untuk permintaan yang menyertakan beberapa ukuran iklan harus menyertakan nilai width dan height atau nilai tersebut akan dihapus dari lelang.
Batasi ukuran respons Anda di bawah 8K. Respons yang sangat besar dapat meningkatkan latensi jaringan dan menyebabkan waktu tunggu habis.
Ikuti panduan bidding pada inventaris iOS yang memerlukan atribusi SKAdNetwork.

Contoh respons bid

Contoh berikut menampilkan contoh permintaan Protobuf dan JSON yang dapat dibaca manusia.

Google

Berikan contohnya

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

JSON OpenRTB

Berikan contohnya

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

Protobuf OpenRTB

Berikan contohnya

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

Penting: Pesan Protobuf yang digambarkan dalam contoh direpresentasikan di sini sebagai teks yang dapat dibaca manusia. Namun, itu bukanlah cara pesan dikirim melalui kabel. Saat menggunakan format Google atau OpenRTB Protobuf, hanya pesan BidResponse serial 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 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, kami 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.Ad.sdk_rendered_ad
AMP
- BidResponse.Ad.amp_ad_url
Video
- BidResponse.Ad.video_url atau
- BidResponse.Ad.video_vast_xml
Native
- BidResponse.Ad.native_ad

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

Selain itu, ukuran iklan yang dideklarasikan dalam respons bid harus cocok persis dengan salah satu kombinasi ukuran dalam permintaan bid jika:

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

Kolom html_snippet mendukung semua kode HTML valid yang dirender dengan benar, tetapi perhatikan batasan dalam menentukan kolom buyer_creative_id di bagian Create BidResponse. Salah satu kegunaannya adalah untuk memasukkan informasi tambahan ke dalam argumen URL yang diambil dari server Anda sebagai bagian dari rendering iklan. Hal ini memungkinkan Anda meneruskan data arbitrer tentang tayangan kembali ke server Anda sendiri.

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

Menentukan makro

Cuplikan HTML yang menentukan materi iklan dapat menyertakan satu atau beberapa konstruksi khusus yang disebut makro. Pada waktu penayangan iklan, nilai akan diganti dengan makro. Misalnya, aplikasi bidding klien dapat menggunakan makro WINNING_PRICE untuk menentukan biaya yang dibayarkan untuk iklan, jika aplikasi memenangkan lelang. Untuk mengurai makro ini, Anda harus mengimplementasikan aplikasi yang mendekripsi konfirmasi harga. Lihat halaman Konfirmasi Harga Mendekripsi untuk mengetahui informasi selengkapnya.

Tentukan makro sebagai bagian dari cuplikan HTML dalam format %%MACRO%%, dengan MACRO sebagai salah satu makro yang didukung dan tercantum pada tabel di bawah.

Catatan: Untuk respons bid iklan AMP (amp_ad_url), hanya makro WINNING_PRICE dan WINNING_PRICE_ESC yang didukung.

Google mengharuskan 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.

Untuk menggunakan makro, sertakan makro tersebut dalam iklan sehingga URL akan diambil saat seseorang mengkliknya. Nilai hasil pengambilan adalah pengalihan ke URL lain yang Anda tambahkan ke CLICK_URL.

Makro	Deskripsi
`ADVERTISING_IDENTIFIER`	Memungkinkan pembeli menerima ID Iklan Android atau IDFA iOS saat rendering tayangan. Lihat Mendekripsi ID Pengiklan untuk mengetahui detailnya.
`CACHEBUSTER`	Representasi string dari bilangan bulat empat byte yang acak dan tidak ditandatangani.
`CLICK_URL_UNESC`	URL klik yang tidak di-escape 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`, kode berikut dapat digunakan dengan versi URL klik pihak ketiga yang di-escape tunggal 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 ke: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> URL akan mendaftarkan klik dengan Google terlebih dahulu, kemudian mengalihkan ke URL klik pihak ketiga.
`CLICK_URL_ESC`	URL klik yang di-escape untuk iklan. Gunakan ini, bukan `CLICK_URL_UNESC`, jika Anda harus meneruskan nilai ini 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 ke: <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`. Hal ini mengasumsikan bahwa `my.adserver.com` melakukan unescape dari parameter `google_click_url`. Anda dapat menambahkan URL dengan konversi karakter ganda setelah `%%CLICK_URL_ESC%%`. Setelah proses unescaping dilakukan oleh `my.adserver.com`, versi URL dengan escape tunggal akan ditambahkan ke `google_click_url`. Saat `google_click_url` diambil, objek tidak akan di-escape sekali lagi, lalu dialihkan.
`CLICK_URL_ESC_ESC`	URL dengan konversi karakter ganda untuk iklan. Gunakan ini, bukan `CLICK_URL_UNESC`, jika Anda harus meneruskan nilai ini 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 ke: <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 ke `http:` jika permintaan bid tidak memerlukan SSL atau ke `https:` jika permintaan bid memerlukan SSL.
`SITE`	Domain URL konten yang di-escape URL atau ID anonim untuk inventaris anonim.
`SITE_URL`	Tidak digunakan lagi. Diganti dengan makro SITE yang menyediakan fungsi identik.
`TZ_OFFSET`	Offset 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 melakukannya, platform sisi permintaan tidak perlu membuat perubahan. Misalnya, jika materi iklan akan menyertakan `%%?VERIFICATION:-1:5000%%`, penggantian teksnya adalah `5000` pada penayangan dan `-1` dalam pipeline verifikasi. Hal ini untuk membantu membedakan kedua kumpulan ping tersebut.
`WINNING_PRICE`	Biaya tayangan yang dienkode (yaitu, CPI, bukan CPM) dalam mikro mata uang akun. Misalnya, CPM pemenang sebesar $5 USD setara 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.
`WINNING_PRICE_ESC`	`WINNING_PRICE` dengan escape URL.

Konversi URL dalam makro menggunakan skema berikut:

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

Pembatasan penayang

Penayang menggunakan BidRequest untuk menerapkan pembatasan pada iklan yang akan mereka izinkan. Anda harus menerapkan batasan di kolom berikut:

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

Satu kolom menentukan fitur yang diizinkan untuk iklan dan kolom lainnya menentukan fitur yang tidak diizinkan. Jangan pernah menampilkan iklan dengan fitur yang tidak diizinkan. Untuk fitur yang diizinkan seperti jenis vendor, tampilkan iklan hanya jika jenis vendornya ada dalam daftar allowed_vendor_type di BidRequest. Lihat komentar untuk kolom ini dalam definisi buffering protokol BidRequest untuk detail selengkapnya.

Jika cuplikan HTML ditampilkan di BidResponse, Anda harus menetapkan kolom attribute, category, dan click_through_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 buffering protokol BidResponse untuk detail selengkapnya. Respons yang tidak menyetel kolom ini akan dihapus.

Nilai BidRequest.excluded_attribute yang mungkin adalah (lihat publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
Iklan tidak diizinkan jika berisi piksel atau web-beacon yang bertujuan membuat daftar ID cookie untuk pemasaran ulang berikutnya.
8 CookieTargeting: IsCookieTargeted
Iklan tidak diizinkan jika menargetkan konsumen berdasarkan ID cookie mereka dengan daftar ID cookie mewakili sekumpulan konsumen yang sebelumnya berinteraksi dengan situs yang dimiliki atau diwakili oleh pembeli.
9 UserInterestTargeting: IsUserInterestTargeted
Iklan tidak diizinkan jika menargetkan konsumen berdasarkan ID cookie dengan daftar ID cookie mewakili sekumpulan konsumen yang ditetapkan pembeli sebagai grup minat umum.
21 CreativeType: Html
Iklan tidak diizinkan untuk menggunakan kolom html_snippet atau snippet_template di BidResponse.Ad.
22 CreativeType: VastVideo
Iklan tidak diizinkan untuk menggunakan kolom video_url di BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
Iklan tidak diizinkan untuk memerlukan dukungan VPAID untuk merender.
32 MraidType: MRAID
Iklan tidak diizinkan untuk meminta API MRAID untuk dirender.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
Iklan tidak diizinkan untuk meminta dukungan Flash agar dapat dirender.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
Iklan tidak diizinkan untuk meminta fitur HTML5 agar dirender.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Iklan tidak diizinkan membuat permintaan non-SSL.

Oleh karena itu, jika kolom excluded_attribute berisi nilai 7, Anda tidak boleh menampilkan iklan yang menggunakan piksel atau web-beacon untuk membuat daftar. Perhatikan bahwa jika iklan melakukan hal ini, iklan harus menetapkan nilai 7 di kolom atribut BidResponse. Demikian pula, jika kolom excluded_attribute berisi nilai 48, Anda hanya boleh menampilkan iklan yang dapat dirender di halaman SSL (dan, sebagaimana mestinya, deklarasikan atribut 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Selain itu, kolom excluded_sensitive_category di BidRequest menggunakan kode dari file ad-sensitive-categories.txt yang tersedia di halaman data referensi. Berikut adalah deskripsi lengkap dari beberapa kode tersebut:

3 Politics
Mencakup politik atau masalah sosial kontroversial; tidak termasuk iklan untuk organisasi berita yang secara umum tidak terkait dengan pandangan yang mendukung salah satu partai dalam masalah tertentu.
4 Dating
Mencakup layanan kencan dan komunitas kencan online.
5 Religion
Mencakup iklan keagamaan dan iklan yang mendukung atau menentang pandangan keagamaan; tidak mencakup astrologi atau sekte kerohanian non-agamis.
7 Video Games (Casual & Online)
Mencakup video game, game online, dan game yang dapat didownload; tidak mencakup konsol video game.
8 Ringtones & Downloadables
Add-on seluler mencakup nada dering, dan konten digital lainnya yang dapat didownload seperti screensaver dan wallpaper untuk PC desktop dan tata letak profil serta grafik untuk jejaring sosial.
10 Get Rich Quick
Skema yang menjanjikan penghasilan yang cepat.
18 Weight Loss
Mencakup penurun berat badan, diet, dan produk serta program terkait; tidak termasuk iklan makanan sehat atau kebugaran yang umum.
19 Cosmetic Procedures & Body Modification
Mencakup pengencangan kulit, sedotan, laser, pencabutan dan pemulihan rambut, tato, dan modifikasi tubuh.
23 Drugs & Supplements:
Mencakup farmasi, vitamin, suplemen, dan retailer terkait; tidak mencakup referensi yang menyediakan informasi mengenai obat-obatan.
24 Sexual & Reproductive Health
Mencakup iklan fungsi seksual dan kesuburan; tidak termasuk referensi kehamilan normal.
35 Social Casino Games
Mencakup simulasi game perjudian (termasuk, tetapi tidak terbatas pada, poker, slot, bingo, lotre, taruhan olahraga, taruhan pada berbagai balapan, serta game kartu dan game kasino lainnya) di mana tidak ada peluang untuk memenangkan apa pun yang berharga (seperti uang atau hadiah).
36 Significant Skin Exposure
Gambar iklan yang tidak memperlihatkan bagian tubuh manusia, mulai dari tulang dada hingga pertengahan paha; atau tubuh mengenakan pakaian dalam, pakaian renang, lingerie, atau pakaian yang tembus pandang atau item non-pakaian lainnya seperti handuk atau seprai.
37 Sensationalism
Iklan yang bertujuan untuk mendorong pengguna agar mengklik iklan tersebut dengan cara yang memancing rasa ingin tahu mereka, sering kali menggunakan pesan teaser dengan bahasa atau gambar yang berlebihan. Termasuk iklan yang berpusat pada subjek sensasional (seperti penangkapan, kematian, atau perceraian selebritas) atau bertujuan untuk nilai kejutan.

Pengukuran Terbuka

Open Measurement 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 saat ini mencakup iklan video, banner, dan interstisial. Untuk 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.

Google

Berikan contohnya

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

JSON OpenRTB

Berikan contohnya

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

Protobuf OpenRTB

Berikan contohnya

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

Interstisial Aplikasi

Google

Berikan contohnya

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

JSON OpenRTB

Berikan contohnya

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

Protobuf OpenRTB

Berikan contohnya

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

Video interstisial aplikasi

Google

Berikan contohnya

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

Protobuf OpenRTB

Berikan contohnya

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

Native aplikasi

Google

Berikan contohnya

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

JSON OpenRTB

Berikan contohnya

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

Protobuf OpenRTB

Berikan contohnya

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

Video web

Google

Berikan contohnya

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

Protobuf OpenRTB

Berikan contohnya

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}

Bangun Responsnya

Buat pesan BidResponse

ID Materi Iklan

Atribut iklan

Kolom Bidding Terbuka

Rekomendasi

Contoh respons bid

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Protobuf OpenRTB

Berikan contohnya

Tentukan materi iklan

Menentukan makro

Pembatasan penayang

Pengukuran Terbuka

Contoh respons bid

Banner aplikasi

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Protobuf OpenRTB

Berikan contohnya

Interstisial Aplikasi

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Protobuf OpenRTB

Berikan contohnya

Video interstisial aplikasi

Google

Berikan contohnya

Protobuf OpenRTB

Berikan contohnya

Native aplikasi

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Protobuf OpenRTB

Berikan contohnya

Video web

Google

Berikan contohnya

Banner web seluler untuk bidder bursa

Protobuf OpenRTB

Berikan contohnya