Halaman ini diterjemahkan oleh Cloud Translation API.

Iklan Native

Iklan native adalah iklan yang diformat agar sesuai dengan konten dan desain visual di sekitarnya, sehingga membuatnya cenderung lebih sering dilihat dan diklik oleh pengguna. Inventaris iklan native tersedia di aplikasi seluler serta situs desktop dan seluler. Untuk informasi selengkapnya tentang iklan native, lihat Ringkasan iklan native.

Iklan native didukung untuk Authorized Buyers dan Bidding Terbuka.

Berikut adalah alur kerja untuk iklan native:

Panggilan untuk iklan native dilakukan ke Google. Panggilan menentukan satu atau kedua template iklan native berikut, yang masing-masing menentukan kolom native yang diinginkan.
Google mengirimkan permintaan bid RTB kepada pembeli yang berisi daftar kolom yang diminta.
Pembeli yang tertarik akan merespons dengan mengisi kolom yang diminta.
Google menjalankan lelang untuk memilih bid pemenang dan mengirimkan aset materi iklan yang disediakan pembeli kepada penayang.
Penayang menyusun aset menjadi iklan native dan menata gayanya agar sesuai dengan desain situs.

Format pesan

Google mendukung spesifikasi OpenRTB dalam JSON dan Protobuf.

Untuk iklan native Protobuf OpenRTB, kolom berikut berbeda dengan spesifikasi:

JSON	Jenis JSON	Protobuf	Jenis protobuf
`BidRequest.imp[].native.request`	`string`	`BidRequest.imp[].native.request_native`	`NativeRequest`
`BidResponse.seatbid[].bid[].adm`	`string`	`BidResponse.seatbid[].bid[].adm_native`	`NativeResponse`

Kolom Protobuf OpenRTB adalah pesan Protobuf, bukan string.

Jika Anda menggunakan implementasi Protobuf OpenRTB, endpoint Anda akan menerima permintaan bid yang berisi BidRequest.imp.native.request_native, bukan BidRequest.imp.native.request. Selain itu, endpoint Anda harus menampilkan respons bid yang mengisi BidResponse.seatbid.bid.adm_native, bukan BidResponse.seatbid.bid.adm. Jika tidak, endpoint akan difilter dari lelang.

Jika menggunakan SDK pembeli untuk merender iklan native, Anda harus menyertakan gambar type di declared_ad saat mengirimkan materi iklan untuk ditinjau.

Template iklan native

Template iklan native menjelaskan komponen iklan native, dan menentukan konten dan struktur NativeRequest OpenRTB atau NativeAdTemplate protokol Google RTB yang tidak digunakan lagi dalam permintaan bid. Google mendukung dua template iklan native yang paling umum untuk iklan native video dan non-video:

Template iklan penginstalan aplikasi - Mempromosikan dan mendorong penginstalan aplikasi seluler.
Template iklan konten - Kombinasi teks dan gambar yang lebih umum untuk iklan web atau merek.
Template iklan instal aplikasi video
Template iklan konten video

Template lain ada, dan mungkin memiliki serangkaian persyaratan yang berbeda untuk kolom, dimensi, dan ukuran.

Template iklan instal aplikasi

Kolom yang wajib diisi dan direkomendasikan

Tabel berikut menampilkan kolom berlabel Wajib atau Direkomendasikan. Aturan berikut berlaku:

Kolom yang ditandai Wajib harus diisi oleh bidder.
Kolom yang ditandai Direkomendasikan tidak diperlukan oleh bidder, dan penayang dapat atau tidak dapat menampilkannya jika disediakan (misalnya, rating bintang).
Pesan Ajakan Bertindak (CTA) selalu ditandai sebagai Direkomendasikan karena default ditetapkan jika tidak dikirim oleh bidder, tetapi akan selalu ditampilkan jika dikirim.

Tabel berikut mencantumkan kolom template iklan instal aplikasi. Aplikasi seluler menggunakan kolom ini untuk membuat iklan instal aplikasi native.

Kolom	Deskripsi	Wajib atau Direkomendasikan?	Selalu ditampilkan?	Ukuran gambar/jumlah maksimum karakter yang direkomendasikan	Contoh
Judul	Judul aplikasi	Wajib	Ya	25 karakter	Flood-It!
Gambar	Screenshot dari aplikasi, atau gambar lain yang relevan	Wajib	Tidak	1.200 piksel x 627 piksel atau 600 piksel x 600 piksel,bergantung pada rasio aspek yang diperlukan oleh penayang.	<Screenshot dari game Flood-It!>
Isi	Teks utama aplikasi	Wajib	Tidak	90 karakter	Sederhana tapi menantang = menyenangkan dan bikin ketagihan!
Ikon aplikasi	Ikon aplikasi	Wajib	Tidak	128x128 piksel	<Flood-it! app icon>
Pesan ajakan (CTA)	Tindakan pengguna yang diinginkan	Disarankan	Ya	15 karakter	Instal
Rating bintang	Jumlah bintang (0 - 5) yang mewakili rating aplikasi di app store	Disarankan	Tidak	0 - 5	4,5
Harga	Biaya aplikasi	Disarankan	Tidak	15 karakter	Gratis

Catatan tentang panjang teks

Jika pembeli mengirim aset teks (misalnya teks isi) yang lebih panjang dari jumlah maksimum karakter yang disarankan, teks tersebut dapat dipotong dan dihilangkan oleh Google atau penayang. Perhatikan bahwa batas pemotongan untuk bahasa China, Jepang, dan Korea adalah setengahnya. Misalnya, batas judul sebesar 90 untuk bahasa Inggris dan 45 untuk bahasa China.

Catatan tentang ukuran gambar

Penayang diizinkan untuk:

Pangkas gambar utama secara simetris hingga maksimum 20% dalam satu dimensi (tinggi atau lebar).
Menskalakan gambar tanpa mengubah rasio aspeknya.
Gambar yang memiliki rasio aspek yang sangat berbeda dengan yang tersirat oleh tinggi dan lebar dapat difilter.

Template iklan konten

Tabel berikut mencantumkan kolom template iklan konten. Penayang menggunakan kolom ini untuk membuat iklan konten native.

Kolom	Deskripsi	Wajib atau Direkomendasikan?	Selalu ditampilkan?	Ukuran gambar/jumlah maksimum karakter yang direkomendasikan *	Contoh
Judul	Header iklan	Wajib	Ya	25 karakter	Suku bunga hipotek terendah
Gambar	Gambar utama iklan	Wajib	Tidak	1.200 piksel x 627 piksel atau 600 piksel x 600 piksel,bergantung pada rasio aspek yang diperlukan oleh penayang.	<Gambar utama iklan>
Isi	Konten iklan	Wajib	Tidak	90 karakter	Rumah Anda di Brooklyn - lebih murah dan lebih cepat dari yang Anda bayangkan!
Logo	Logo pengiklan atau gambar kecil lainnya yang relevan	Disarankan	Tidak	128x128 piksel	<NY Mortgage Inc.'s logo>
Pesan ajakan (CTA)	Tindakan pilihan pengguna	Disarankan	Tidak	15 karakter	Dapatkan penawaran
Pengiklan	Teks yang menunjukkan pengiklan atau merek	Wajib	Tidak	25 karakter	NY Mortgage Inc.

Template iklan instal aplikasi video

Kolom	Deskripsi	Wajib atau Direkomendasikan?	Selalu ditampilkan?	Ukuran gambar/jumlah maksimum karakter yang direkomendasikan *	Contoh
Video	Respons VAST video yang berisi semua aset yang diperlukan untuk memutar ulang iklan video.	Wajib	Tidak	-	URL ke XML VAST yang berisi Flood-It! Iklan video
Judul	Judul aplikasi	Wajib	Ya	25 karakter	Flood-It!
Gambar	Gambar (thumbnail) yang ditampilkan di pemutar sebelum iklan video diklik atau saat sedang dimuat.	Wajib	Tidak	Harus cocok dengan rasio aspek video (misalnya: 1280x720 untuk video berukuran 16x9, 4x3 untuk video beresolusi 640x480).	Screenshot dari game Flood-It! Atau dari video
Isi	Teks utama aplikasi	Wajib	Tidak	90 karakter	Sederhana tapi menantang = menyenangkan dan bikin ketagihan!
Ikon aplikasi	Ikon aplikasi	Wajib	Tidak	128x128 piksel	Ikon aplikasi Flood-it!
Pesan ajakan (CTA)	Tindakan pengguna yang diinginkan	Wajib	Ya	15 karakter	Instal
Rating bintang	Jumlah bintang (0 - 5) yang mewakili rating aplikasi di app store	Disarankan	Tidak	0 - 5	4,5
Harga	Biaya aplikasi	Disarankan	Tidak	15 karakter	Gratis

Pembatasan

Video: Semua video harus dalam bentuk URL VAST atau Tag VAST. File video mentah seperti WebM, MP4, dll. tidak dapat ditentukan.
Panjang teks: Jika pembeli menentukan aset teks seperti body dalam respons, aset tersebut dapat dipotong dan dihilangkan oleh Google atau penayang. Perhatikan bahwa batas pemotongan adalah setengah ukuran dalam bahasa China, Jepang, dan Korea. Misalnya, batas judul sebesar 90 untuk bahasa Inggris dan 45 untuk bahasa China.
Ukuran gambar: Penayang diizinkan untuk:
- Pangkas gambar utama secara simetris hingga maksimum 20% dalam satu dimensi (tinggi atau lebar.
- Menskalakan gambar tanpa mengubah rasio aspeknya.

Contoh iklan instal aplikasi

Template iklan konten video

Kolom	Deskripsi	Wajib atau Direkomendasikan?	Selalu ditampilkan?	Ukuran gambar/jumlah maksimum karakter yang direkomendasikan *	Contoh
Video	Respons VAST video yang berisi semua aset yang diperlukan untuk memutar ulang iklan video.	Wajib	Ya	-	URL ke XML VAST yang berisi Flood-It! Iklan video
Judul	Header iklan	Wajib	Ya	25 karakter	Suku bunga hipotek terendah
Gambar	Gambar (thumbnail) yang ditampilkan di pemutar sebelum iklan video diklik atau saat sedang dimuat.	Wajib	Tidak	Harus cocok dengan rasio aspek video (misalnya: 1280x720 untuk video berukuran 16x9, 4x3 untuk video beresolusi 640x480).	Screenshot dari video
Isi	Konten iklan	Wajib	Tidak	90 karakter	Rumah Anda di Brooklyn - lebih murah dan lebih cepat dari yang Anda bayangkan!
Logo	Logo pengiklan atau gambar kecil lainnya yang relevan	Disarankan	Tidak	128x128 piksel	Logo NY Mortgage Inc.
Pesan ajakan (CTA)	Tindakan pilihan pengguna	Wajib	Tidak	15 karakter	Dapatkan penawaran
Pengiklan	Teks yang menunjukkan pengiklan atau merek	Wajib	Tidak	25 karakter	NY Mortgage Inc.

Kolom meta

Kolom meta berikut digunakan bersama oleh semua template iklan yang didukung:

Protokol Google RTB	Setara OpenRTB	Deskripsi
`NativeAd.click_link_url`	`Link.url`	URL yang akan dipanggil oleh browser saat pengguna mengklik iklan. Dapat menjadi langkah pertama rantai pengalihan yang pada akhirnya mengarah ke halaman landing. Untuk iklan native, sebaiknya gunakan `click_link_url` sebagai kolom untuk menetapkan tujuan tempat pengguna akan diarahkan. Kolom ini harus digunakan dalam kasus halaman landing dinamis.
`Ad.click_through_url`	`Bid.adomain`	Harus ditetapkan jika bidder ingin mengajukan bid. Ini adalah kumpulan URL tujuan untuk cuplikan, termasuk URL yang akan dituju pengguna jika mereka mengklik iklan yang ditampilkan, dan URL apa pun yang terlihat di iklan yang dirender. Jangan sertakan panggilan perantara ke server iklan yang tidak terkait dengan halaman landing akhir. BidResponse yang menampilkan cuplikan atau iklan video tetapi menyatakan tidak ada `click_through_url` akan dihapus. Hanya tetapkan kolom ini jika `html_snippet`, `video_url`, atau `native_ad` ditetapkan. Data ini digunakan sebagai deklarasi URL tujuan, misalnya untuk pemfilteran pasca-URL yang diblokir penayang atau kategorisasi iklan. Lihat `NativeAd.click_link_url` saat menggunakan iklan native. Untuk iklan non-native, URL ini tidak digunakan untuk pelacakan klik atau fungsi iklan lainnya; URL ini hanya digunakan sebagai deklarasi URL tujuan. Untuk iklan native, jika `NativeAd.click_link_url` tidak ditetapkan, nilai pertama `click_through_url` akan digunakan untuk mengarahkan pengguna ke halaman landing. Selain itu, semua nilai digunakan sebagai deklarasi URL tujuan (mirip dengan kasus non-native).
`NativeAd.click_tracking_urls`	`Link.clicktrackers`	Opsional. URL tambahan yang memungkinkan pengiklan melacak klik pengguna pada iklan.
`Ad.ad_choices_destination_url`	`BidExt.ad_choices_destination_url`	Link ke halaman preferensi iklan atau halaman pilihan tidak ikut. Jika ada, ikon AdChoices standar akan ditambahkan ke materi iklan native dan ditautkan ke URL ini. Hal ini didukung untuk iklan native, tetapi bukan bagian dari pesan native dalam respons bid.
`Ad.impression_tracking_url`	`NativeResponse.imptrackers`	Tayangan native harus dilacak dengan `impression_tracking_url` di proto bidding real-time Authorized Buyers atau imptracker Native di OpenRTB.

Kolom yang wajib diisi dan direkomendasikan untuk protokol RTB Google

required_fields dan recommended_fields ditentukan oleh penayang. Kami menunjukkan cara menerjemahkan kolom bit ini untuk menentukan apakah kolom diperlukan atau direkomendasikan.

Kolom bit menggunakan setiap bit nilai biner untuk menyimpan pernyataan benar atau salah, yang setara dengan mengirim banyak sinyal boolean seperti is_logo_required atau is_header_required, tetapi semuanya dikemas bersama.

Catatan: Di OpenRTB, kolom BidRequest.imp.native.request_native.assets.required menentukan apakah kolom tertentu diperlukan atau direkomendasikan.

Contoh

Untuk contoh ini, kita akan menggunakan nilai required_fields 1085.

Pertama, temukan nilai biner yang setara: 10000111101

Setelah memiliki nilai biner, Anda dapat memeriksa bit untuk melihat apakah kolom diperlukan (1) atau tidak diperlukan (0).

Tabel berikut memetakan kolom ke tempatnya dalam nilai biner. Baca biner dari kanan ke kiri, dengan 1-bit yang sesuai dengan tempat paling kanan dalam nilai biner.

Kolom	Penempatan nilai biner (kanan ke kiri)
`HEADLINE`	`1`
`BODY`	`2`
`CALL_TO_ACTION`	`4`
`ADVERTISER`	`8`
`IMAGE`	`16`
`LOGO`	`32`
`APP_ICON`	`64`
`STAR_RATING`	`128`
`PRICE`	`256`
`STORE`	`512`
`VIDEO`	`1024`

Melihat contoh nilai biner 10000111101, 1-bit (paling kanan) adalah 1, yang menunjukkan nilai yang diperlukan. Menurut tabel, 1-bit sesuai dengan HEADLINE.

2-bit (nilai kedua dari kanan) adalah 0 yang menunjukkan tidak diperlukan. 2-bit sesuai dengan BODY.

Berikut adalah semua kolom wajib yang ditafsirkan dalam contoh kami:

Nilai	Deskripsi	Wajib?
`1`	`VIDEO`	Ya
`0`	`STORE`	Tidak
`0`	`PRICE`	Tidak
`0`	`STAR_RATING`	Tidak
`0`	`APP_ICON`	Tidak
`1`	`LOGO`	Ya
`1`	`IMAGE`	Ya
`1`	`ADVERTISER`	Ya
`1`	`CALL_TO_ACTION`	Ya
`0`	`BODY`	Tidak
`1`	`HEADLINE`	Ya

Representasi template iklan native dalam permintaan bid

Saat menerima permintaan bid yang berisi inventaris native, permintaan tersebut akan berisi template iklan native dalam berbagai bentuk, bergantung pada protokol yang digunakan. Sebaiknya gunakan OpenRTB karena protokol Google tidak digunakan lagi.

Di OpenRTB, template iklan native dijelaskan dengan pesan NativeRequest. Dalam protokol Google RTB, template ini dijelaskan dengan NativeAdTemplate. Pesan ini memberikan detail berikut tentang inventaris iklan native:

Kolom yang wajib diisi atau direkomendasikan.
Dimensi untuk gambar, logo, dan ikon aplikasi.
Spesifikasi untuk gaya render iklan.

Catatan: Untuk kolom style_layout_type, PIXEL menunjukkan bahwa unit native memiliki ukuran tetap, sedangkan FLUID berarti unit tersebut diskalakan untuk mengisi lebar kolom yang melingkupi dan menyesuaikan tinggi untuk mempertahankan rasio aspek. Jika FLUID ditentukan, tinggi dan lebarnya mungkin muncul sebagai 1x1.

ID aset OpenRTB

OpenRTB meneruskan array aset dalam permintaan bid yang menjelaskan struktur iklan native yang harus Anda tampilkan dalam respons. Setiap aset dalam permintaan akan memiliki ID yang harus ditentukan untuk aset yang sesuai dalam respons. Untuk mengetahui contoh bagaimana ID ini sesuai antara permintaan dan respons, lihat contoh permintaan bid native dan contoh respons bid native.

Representasi iklan native dalam respons bid

Saat mengajukan bid pada inventaris native, pembeli harus mengisi kolom wajib yang diidentifikasi dalam permintaan bid. Di OpenRTB, Anda dapat melakukannya dengan BidResponse.seatbid.bid.adm_native saat menggunakan Protobuf, atau BidResponse.seatbid.bid.adm untuk JSON. Untuk protokol Google yang tidak digunakan lagi, hal ini dilakukan dengan kolom BidResponse.ad.native_ad.

Contoh permintaan bid

Catatan: Untuk memahami apa yang diperlukan atau opsional dalam respons, lihat template iklan native dalam permintaan bid. Untuk OpenRTB, nilai ini dapat ditemukan di BidRequest.imp.native. Untuk protokol Google yang tidak digunakan lagi, ini dapat ditemukan di BidRequest.adslot.native_ad_template.

Permintaan bid non-video

Protobuf OpenRTBJSON OpenRTBGoogle

Berikan contohnya

Permintaan serialisasi

id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 5
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

Berikan contohnya

{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}

Berikan contohnya

Permintaan serialisasi

id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 1200
    image_height: 627
    style_id: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Permintaan bid video

{
  id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
  ip: "\0338\355",
  google_user_id: "CAESEJ1ur2l94_8ruuu",
  cookie_version: 1,
  cookie_age_seconds: 5184000,
  hosted_match_data: "W9ABDAAAAGR67nl0",
  user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
  publisher_country: "IN",
  geo_criteria_id: 1007796,
  timezone_offset: 330,
  publisher_id: "pub-2230723027927371",
  seller_network_id: 989,
  url: "https://m.example.com",
  detected_language: [en],
  google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
  auction_type: "SECOND_PRICE",
  device: {
    device_type: "HIGHEND_PHONE",
    platform: "android",
    brand: "coolpad",
    model: "cp8298_i00",
    os_version: {
      major: 5,
      minor: 1
    },
    carrier_id: 70210,
    screen_width: 360,
    screen_height: 640,
    screen_pixel_ratio_millis: 2000
  },
  mobile: {
    is_app: false,
    is_mobile_web_optimized: true,
    DEPRECATED_platform: "android",
    DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
    DEPRECATED_brand: "coolpad",
    DEPRECATED_model: "cp8298_i00",
    DEPRECATED_os_version: {
      os_version_major: 5,
      os_version_minor: 1
    },
    DEPRECATED_screen_width: 360,
    DEPRECATED_screen_height: 640,
    DEPRECATED_carrier_id: 70210,
    DEPRECATED_device_pixel_ratio_millis: 2000
  },
  publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
  adslot: [{
    id: 1,
    ad_block_key: 2882274820,
    width:   [300,250],
    height:   [250,250],
    excluded_attribute:   [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
    allowed_vendor_type:   [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
    excluded_sensitive_category:   [36,27,19,4,23,30,10,3,31,5,8,37,18],
    excluded_product_category:   [10031,11669,13423,13525,13566,13589,13612,13740],
    excluded_creatives:   [{
      buyer_creative_id: "1234567.1234567890-ssl"
    }],
    matching_ad_data:   [{
      billing_id:     [6629616415,51386650457],
      minimum_cpm_micros: 1380000,
      direct_deal:     [{
        direct_deal_id: 410401,
        fixed_cpm_micros: 1360000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      },{
        direct_deal_id: 240644,
        fixed_cpm_micros: 1500000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      }]
    },{
      billing_id:     [1234567890],
      minimum_cpm_micros: 1380000
    }],
    publisher_settings_list_id:   [12109930661871909476,11138951146123409010],
    slot_visibility: "BELOW_THE_FOLD",
    viewability: 30,
    click_through_rate: 0.0010072842,
    iframing_state: "UNKNOWN_IFRAME_STATE",
    native_ad_template:   [{
      required_fields: 1065,
      recommended_fields: 4,
      headline_max_safe_length: 25,
      body_max_safe_length: 90,
      call_to_action_max_safe_length: 15,
      advertiser_max_safe_length: 25,
      logo_width: 100,
      logo_height: 100,
      style_id: 199892,
      style_height: 250,
      style_width: 300
    }],
    sticky_settings: {

    },
    renderer: "GOOGLE",
    is_amp_page: "DIALECT_HTML",
    amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
    allowed_ad_types:   [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
    session_depth: 1,
    internal_data: {

    }
  }],
  response_deadline_ms: 122,
  is_test: false
}

Contoh respons bid

Respons bid non-video

Protobuf OpenRTBJSON OpenRTBGoogle

Berikan contohnya

Respons serialisasi

id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      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"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"

Berikan contohnya

{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "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\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}

Berikan contohnya

Respons serialisasi

ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  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\254 225"
    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"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

Respons bid video

bid_response {
  ad {
    ...
    click_through_url: "https://www.exampleDomain.com"
    impression_tracking_url: "https://my_impression_tracking_url.com/"
    ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
    ...
    native_ad {
      headline: "Lowest mortgage rates"
      video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
      call_to_action: "Get a quote"
      advertiser: "NY Mortgage Inc."
      image {
        url: "https://www.example.net/mypromoimage.png"
        width: 1200
        height: 700
      }
      logo {
        url: "https://www.example.net/mylogo.png"
        width: 200
        height: 200
      }
      click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
      click_tracking_urls: "https://my_click_tracking_url.com/"
    }
  }
}