Halaman ini diterjemahkan oleh Cloud Translation API.

Bangun Responsnya

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

Buat pesan BidResponse

Authorized Buyers mengirimkan BidRequest sebagai isi pesan dari POST HTTP. Respons yang dikirimkan aplikasi Anda harus memiliki header Content-Type ditetapkan ke application/octet-stream dan isi pesan yang terdiri dari buffering protokol serial. Protokol buffer adalah pesan BidResponse seperti yang ditentukan dalam realtime-bidding.proto. Aplikasi Anda harus mengembalikan file parsable BidResponse sebagai respons terhadap setiap BidRequest. Waktu tunggu dan respons yang tidak dapat diuraikan dianggap sebagai error dan throttle Google bidder kembali dengan tingkat error yang tinggi.

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

ID Materi Iklan

BidResponse Anda menentukan materi iklan melalui Kolom buyer_creative_id (batas 64 byte). Bahkan materi iklan yang mirip harus memiliki nilai unik untuk buyer_creative_id jika berbeda 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 ke dua iklan yang:

Terlihat atau berperilaku lain.
Merender ke gambar yang berbeda.
Render dengan cara yang berbeda (misalnya, satu iklan terdiri dari gambar, sementara yang lain berisi Flash).

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

Atribut iklan

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

7 Tagging: IsTagged
Di dalamnya, iklan berisi piksel atau suar web yang bertujuan untuk membuat daftar ID cookie untuk pemasaran ulang berikutnya.
8 Remarketing: IsRemarketing
Iklan menargetkan konsumen berdasarkan ID cookie atau ID Perangkat mereka 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 daftar ID cookie atau ID Perangkat mewakili sekumpulan konsumen yang menjadi pembeli didefinisikan sebagai grup minat yang sama.
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. Lihat Creatives API untuk penjelasan tentang cara mendapatkan {i>feedback<i} mengenai properti yang terdeteksi pada materi iklan.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
Iklan memerlukan dukungan Flash untuk dirender.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
Iklan tidak memerlukan Flash untuk dirender.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
Iklan dapat ditampilkan di halaman SSL. Perhatikan bahwa Authorized Buyers memperlakukan materi iklan dengan nilai yang dinyatakan berbeda dari atribut ini sebagai berbeda (nilai tersebut akan ditinjau secara terpisah dan memiliki status persetujuan yang berbeda). Oleh karena itu, jika Anda menawar dengan SSL dan materi iklan yang sama versi non-SSL, 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 serupa dengan Authorized Buyers yang berpartisipasi dalam bidding real-time. Pelanggan Bidding Terbuka dapat menentukan tambahan, dan beberapa {i>field<i} yang ada mungkin memiliki penggunaan alternatif. Ini meliputi 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 mengajukan bid dan dilaporkan kepada penayang. Catatan: Kolom ini saat ini hanya dikirim ke beta tertutup peserta.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Jenis transaksi yang dilaporkan kepada penayang, yang memengaruhi cara transaksi yang diperlakukan dalam lelang. Catatan: Kolom ini saat ini hanya dikirim ke beta tertutup peserta.
`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 sebagai Bidder Terbuka adalah perantara. Data ini diperoleh dari pembeli pihak ketiga dan harus diteruskan ke Google tanpa diubah dalam bid yang dihasilkan.

Rekomendasi

Mengaktifkan koneksi HTTPS persisten (juga dikenal sebagai "keep-alive" atau "penggunaan ulang koneksi") di server Anda. Atur waktu tunggu menjadi 10 detik pada minimum—nilai yang lebih tinggi akan bermanfaat dalam banyak kasus. Google memverifikasi ini selama tes latensi awal aplikasi, karena Authorized Buyers mengirimkan permintaan dengan kecepatan tinggi dan perlu menghindari {i>overhead<i} latensi ketika membuat koneksi TCP terpisah untuk masing-masing permintaan.
Sertakan URL pelacakan tayangan opsional untuk melacak kapan tayangan iklan dirender, dan bukan saat bidder menang. Karena penurunan yang terjadi antara kemenangan dan rendering, ini menghasilkan pelacakan yang lebih akurat statistik.

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

Contoh respons bid

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

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

JSON OpenRTB

Berikan contohnya

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Buffering protokol OpenRTB

Berikan contohnya

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

Penting: Pesan Protobuf yang digambarkan dalam contoh ditampilkan di sini sebagai teks yang dapat dibaca manusia. Namun, itu bukan cara pesan dikirim melalui kabel. Saat menggunakan Protobuf Google atau OpenRTB hanya pesan BidResponse yang diserialisasi yang akan diterima.

Anda dapat membuat dan menserialisasi 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 menang. Bid Anda harus menyertakan salah satu format iklan yang didukung (AMP, video, native). Di sini misalnya, kita menentukan materi iklan menggunakan kolom html_snippet.

Atau, Anda dapat menentukan materi iklan menggunakan salah satu dari 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 menggunakan cuplikan HTML di kolom html_snippet dari BidResponse. Tujuan cuplikan dimasukkan dalam iFrame yang disisipkan pada halaman web, sehingga iklan yang diambil dan dirender saat halaman dimuat. Anda harus membuat HTML agar iklan (banner atau interstisial) dirender dengan benar di dalam iFrame, dan dengan ukuran yang sesuai untuk slot iklan yang Anda ajukan bid-nya.

Selain itu, ukuran iklan yang dinyatakan dalam respons bid harus sama persis dengan satu kombinasi ukuran dalam permintaan bid ketika:

Iklan adalah banner biasa (bukan video, native, atau interstisial).
Bidder telah menyatakan ukuran dalam respons bid. Deklarasi ukuran adalah jika terdapat lebih dari satu ukuran dalam permintaan.
Ada pengecualian untuk iklan interstisial. Untuk interstisial lebar minimal harus 50% dari lebar layar dan tinggi minimal 40% dari lebar layar tinggi layar.

Kolom html_snippet mendukung semua kode HTML valid yang dirender dengan benar, namun perhatikan batasan dalam menentukan buyer_creative_id di bagian Buat pesan BidResponse. paket Premium AI digunakan untuk ini adalah memasukkan informasi tambahan ke dalam argumen URL yang diambil dari server sebagai bagian dari perenderan iklan. Hal ini memungkinkan Anda meneruskan data arbitrer tentang tayangan iklan kembali ke server Anda sendiri.

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

Tentukan makro

Cuplikan HTML yang menentukan materi iklan dapat menyertakan satu atau beberapa materi iklan khusus konstruksi yang disebut makro. Pada waktu penayangan iklan, nilai diganti dengan makro. Misalnya, aplikasi bidding klien Anda dapat menggunakan WINNING_PRICE untuk menentukan jumlah yang dibayarkan untuk iklan, jika memenangkan lelang. Untuk menguraikan makro ini, Anda perlu menerapkan aplikasi yang membongkar enkripsi konfirmasi harga. Lihat Harga Pendekripsi Konfirmasi untuk mengetahui informasi selengkapnya.

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

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

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

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

Makro	Deskripsi
`ADVERTISING_IDENTIFIER`	Memungkinkan pembeli menerima IDFA iOS atau ID Iklan Android pada rendering tayangan. Lihat Mendekripsi ID Pengiklan untuk mengetahui detailnya.
`CACHEBUSTER`	Representasi string dari bilangan bulat empat byte acak yang tidak ditandatangani.
`CLICK_URL_UNESC`	URL klik yang tidak di-escape untuk iklan. Dalam cuplikan tersebut, versi escape dari URL klik pihak ketiga harus langsung mengikuti makro. Misalnya, jika URL klik pihak ketiga `http://my.adserver.com/some/path/handleclick?click=clk`, kode berikut dapat digunakan dengan versi escape tunggal dari instance URL klik pihak setelah pemanggilan makro: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Pada saat penayangan iklan, ekstensi ini akan diperluas menjadi: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Pertama-tama, URL akan mendaftarkan klik dengan Google, lalu mengalihkan ke URL klik pihak ketiga.
`CLICK_URL_ESC`	URL klik yang di-escape untuk iklan. Gunakan ini sebagai ganti `CLICK_URL_UNESC` jika Anda harus meneruskan nilai terlebih dahulu server lain yang kemudian akan mengembalikan pengalihan. Misalnya, kode berikut dapat digunakan dalam cuplikan HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Pada saat penayangan iklan, ekstensi ini akan 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 ke `my.adserver.com` yang kemudian bertanggung jawab untuk melakukan pengalihan ke URL yang diteruskan Parameter `google_click_url`. Hal ini mengasumsikan bahwa `my.adserver.com` melakukan escape dari `google_click_url` . Anda dapat menambahkan URL yang di-escape ganda setelah `%%CLICK_URL_ESC%%`. Setelah {i>unescaping<i} dilakukan dengan `my.adserver.com`, yang meninggalkan versi URL dengan escape tunggal ditambahkan ke `google_click_url`. Jika `google_click_url` diambil, unescape sekali lagi akan terjadi, lalu pengalihan.
`CLICK_URL_ESC_ESC`	URL dengan konversi karakter ganda untuk iklan. Gunakan ini sebagai ganti `CLICK_URL_UNESC` jika Anda harus meneruskan nilai terlebih dahulu server lain yang kemudian akan mengembalikan 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 saat penayangan iklan, ekstensi ini akan 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`	Diluaskan ke `http:` jika permintaan bid tidak memerlukan SSL atau untuk `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. Diganti dengan makro SITE yang menyediakan fungsi yang identik.
`TZ_OFFSET`	Offset zona waktu.
`VERIFICATION`	Nilai yang berbeda untuk produksi dan waktu materi iklan dipindai dalam verifikasi {i>pipelines<i} yang sama. Formatnya adalah: `%%?VERIFICATION:true-val:false-val%%` dengan nilai kecuali makro dapat digunakan untuk `true-val` dan `false-val`, termasuk string kosong. Untuk Bidding Terbuka, sebaiknya bursa menggunakan makro ini; setelah mereka melakukannya, platform sisi permintaan tidak perlu melakukan perubahan. Misalnya, jika materi iklan menyertakan `%%?VERIFICATION:-1:5000%%` maka penggantian teksnya akan menjadi `5000` saat ditayangkan dan `-1` di pipeline verifikasi. Hal ini untuk membantu membedakan antara dua set ping tersebut.
`WINNING_PRICE`	Biaya tayangan yang dienkode (yaitu, CPI, bukan CPM) dalam mikro mata uang akun. Misalnya, CPM pemenang sebesar $5 USD sesuai dengan 5.000.000 CPM mikro, atau 5.000 mikro CPI. Fungsi yang didekode nilai `WINNING_PRICE` dalam kasus ini adalah 5.000. Harga yang menang ditentukan dalam CPI.
`WINNING_PRICE_ESC`	`WINNING_PRICE` dengan URL yang di-escape.

Escape URL dalam makro menggunakan skema berikut:

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

Pembatasan penayang

Penayang menggunakan BidRequest untuk tidak menerapkan pembatasan pada iklan mereka izinkan. Anda harus menerapkan pembatasan 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 mengembalikan iklan dengan fitur yang tidak diizinkan. Untuk diizinkan seperti jenis vendor, mengembalikan iklan hanya jika jenis vendornya ada di Daftar allowed_vendor_type di BidRequest. Lihat komentar untuk kolom ini dalam buffering protokol BidRequest definisinya untuk informasi lebih lanjut.

Jika cuplikan HTML ditampilkan di BidResponse, berarti yang diperlukan untuk menetapkan attribute, category, dan kolom click_through_url di BidResponse. Jika iklan memiliki beberapa nilai yang berlaku untuk kolom ini, Anda harus menyertakan setiap nilai. Lihat komentar untuk bidang ini dalam Definisi buffering protokol BidResponse untuk detail selengkapnya. Respons yang belum menetapkan kolom ini akan dihapus.

Kemungkinan nilai BidRequest.excluded_attribute adalah (lihat publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
Iklan tidak diizinkan jika berisi piksel atau suar web untuk membuat daftar ID cookie untuk pemasaran ulang berikutnya.
8 CookieTargeting: IsCookieTargeted
Iklan tidak diizinkan jika menargetkan konsumen berdasarkan ID cookie yang diwakili oleh daftar ID cookie 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 yang diwakili oleh daftar ID cookie sekumpulan konsumen yang ditetapkan pembeli sebagai grup minat yang sama.
21 CreativeType: Html
Iklan tidak diizinkan menggunakan html_snippet atau snippet_template di BidResponse.Ad.
22 CreativeType: VastVideo
Iklan tidak diizinkan menggunakan kolom video_url di BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
Iklan tidak diizinkan memerlukan dukungan VPAID untuk dirender.
32 MraidType: MRAID
Iklan tidak diizinkan mewajibkan API MRAID untuk dirender.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
Iklan tidak diizinkan memerlukan dukungan Flash untuk dirender.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
Iklan tidak diizinkan mewajibkan fitur HTML5 untuk dirender.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Iklan tidak boleh membuat permintaan non-SSL.

Oleh karena itu, jika kolom excluded_attribute berisi nilai 7, maka Anda tidak boleh menampilkan iklan yang menggunakan piksel atau suar web untuk membuat daftar. Perhatikan bahwa jika iklan melakukan ini, iklan harus menetapkan nilai 7 di kolom atribut BidResponse. Demikian pula, jika kolom excluded_attribute berisi nilai 48, maka Anda hanya boleh menampilkan iklan yang dapat ditampilkan di halaman SSL (dan karenanya mendeklarasikan atribut 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Juga kolom excluded_sensitive_category di BidRequest menggunakan kode dari File ad-sensitive-categories.txt tersedia di halaman data referensi. Berikut diperpanjang deskripsi beberapa kode ini:

3 Politics
Mencakup politik atau isu sosial kontroversial; tidak mencakup iklan untuk organisasi berita yang secara umum tidak terkait dengan pandangan yang mendukung pihak tertentu dalam suatu masalah.
4 Dating
Mencakup layanan biro jodoh dan komunitas kencan online.
5 Religion
Mencakup iklan keagamaan dan iklan yang mendukung atau menentang pandangan keagamaan; tidak mencakup astrologi atau kerohanian non-agamis.
7 Video Games (Casual & Online)
Mencakup video game, game online, dan game yang dapat didownload; tidak termasuk konsol video game.
8 Ringtones & Downloadables
Add-on seluler mencakup nada dering, dan barang yang dapat didownload seperti screensaver dan wallpaper pada PC dekstop dan tata letak profil serta grafik untuk jejaring sosial.
10 Get Rich Quick
Skema yang menjanjikan penghasilan dengan cepat.
18 Weight Loss
Mencakup penurun berat badan, diet, serta produk dan program terkait; tidak mencakup iklan makanan sehat atau kebugaran yang umum.
19 Cosmetic Procedures & Body Modification
Mencakup pengencangan kulit, sedot lemak, laser, pencabutan dan pemulihan rambut, tato, dan pengubahan bentuk tubuh.
23 Drugs & Supplements:
Mencakup farmasi, vitamin, suplemen, dan retailer terkait; tidak termasuk sumber daya yang menyediakan informasi mengenai obat-obatan.
24 Sexual & Reproductive Health
Mencakup iklan fungsi seksual dan kesuburan; tidak termasuk sumber daya 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 menunjukkan bagian tubuh manusia yang tersingkap, mulai dari tulang dada sampai pertengahan paha; atau tubuh tertutup pakaian dalam, pakaian renang, lingerie, atau pakaian tembus pandang lainnya atau item non-pakaian seperti handuk atau seprai.
37 Sensationalism
Iklan yang bertujuan untuk mendorong pengguna mengklik iklan tersebut dengan cara yang menimbulkan rasa ingin tahu, sering kali menggunakan pesan teaser dengan bahasa atau gambar yang berlebihan. Mencakup iklan yang berfokus pada subjek sensasional (seperti penangkapan, kematian, atau perceraian selebritas) atau bertujuan untuk nilai kejutan.

Pengukuran Terbuka

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

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

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

JSON OpenRTB

Berikan contohnya

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Buffering protokol OpenRTB

Berikan contohnya

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

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

JSON OpenRTB

Berikan contohnya

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Buffering protokol OpenRTB

Berikan contohnya

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

Video interstisial aplikasi

Google

Berikan contohnya

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

Buffering protokol 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: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

JSON OpenRTB

Berikan contohnya

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

Buffering protokol OpenRTB

Berikan contohnya

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

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

Buffering protokol OpenRTB

Berikan contohnya

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

Bangun Responsnya

Buat pesan BidResponse

ID Materi Iklan

Atribut iklan

Kolom Bidding Terbuka

Rekomendasi

Contoh respons bid

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Buffering protokol OpenRTB

Berikan contohnya

Tentukan materi iklan

Tentukan makro

Pembatasan penayang

Pengukuran Terbuka

Contoh respons bid

Banner aplikasi

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Buffering protokol OpenRTB

Berikan contohnya

Interstisial Aplikasi

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Buffering protokol OpenRTB

Berikan contohnya

Video interstisial aplikasi

Google

Berikan contohnya

Buffering protokol OpenRTB

Berikan contohnya

Native aplikasi

Google

Berikan contohnya

JSON OpenRTB

Berikan contohnya

Buffering protokol OpenRTB

Berikan contohnya

Video web

Google

Berikan contohnya

Banner web seluler untuk bidder bursa

Buffering protokol OpenRTB

Berikan contohnya