Iklan Native adalah iklan yang diformat agar pas dengan konten dan visual di sekitarnya desain, membuatnya lebih mungkin dilihat dan diklik oleh pengguna. Iklan Native inventaris tersedia di aplikasi seluler serta di situs desktop dan seluler. Untuk informasi selengkapnya tentang iklan native, lihat Ringkasan iklan native iklan.
Iklan native didukung untuk Authorized Buyers dan Bidding Terbuka.
Berikut alur kerja untuk iklan native:
- Panggilan untuk iklan native dilakukan ke Google. Panggilan menentukan salah satu atau kedua template iklan native di bawah, masing-masing menentukan kolom native.
- Google mengirimkan permintaan bid RTB kepada pembeli yang berisi daftar {i>field<i} yang diminta.
- Pembeli yang tertarik merespons dengan kolom yang diminta.
- Google menjalankan lelang untuk memilih bid yang menang dan mengirimkan yang disediakan pembeli kepada penayang.
- Penayang menyusun aset ke dalam iklan native dan menata gayanya agar sesuai dengan desain situs.
Format pesan
Google mendukung Spesifikasi OpenRTB di JSON dan Protobuf.
Untuk iklan native Protobuf OpenRTB, kolom berikut berbeda dengan spesifikasinya:
Spesifikasi JSON (PROTOCOL_OPENRTB_2_4) |
Jenis JSON | Implementasi OpenRTB (PROTOCOL_OPENRTB_PROTOBUF_2_4) |
Jenis OpenRTB |
---|---|---|---|
BidRequest.imp[].native.request |
string |
BidRequest.imp[].native.request_native |
NativeRequest |
BidResponse.seatbid[].bid[].adm |
string |
BidResponse.seatbid[].bid[].adm_native |
NativeResponse |
Kolom OpenRTB adalah pesan Protobuf, bukan string.
Jika Anda menggunakan implementasi
Protobuf OpenRTB, Anda tidak akan menerima
BidRequest.imp[].native.request
, dan harus merespons dengan
BidResponse.seatbid[].bid[].adm_native
. Respons bid dengan
BidResponse.seatbid[].bid[].adm
difilter. ID aset tidak diperlukan untuk OpenRTB
Respons bid Protobuf.
Jika Anda menggunakan SDK pembeli untuk merender iklan native,
Anda harus menyertakan gambar type
dalam declared_ad
saat Anda
kirim materi iklan untuk ditinjau.
Template iklan native
Google mendukung dua template iklan native yang paling umum untuk non-video dan iklan native video:
- Template iklan instal aplikasi - Promosikan dan mendorong penginstalan aplikasi seluler.
- Template iklan konten - Lebih umum kombinasi teks dan gambar untuk iklan web atau merek.
- Template iklan instal aplikasi video
- Template iklan konten video
Ada {i>template<i} lain, dan mungkin memiliki seperangkat persyaratan yang berbeda untuk {i>field<i}, dimensi, dan ukuran.
Template iklan instal aplikasi
Kolom wajib diisi dan direkomendasikan
Tabel di bawah menampilkan kolom berlabel Wajib atau Direkomendasikan. Aturan berikut berlaku:
- Kolom yang ditandai Wajib wajib diisi oleh bidder.
- Kolom yang ditandai Direkomendasikan tidak diwajibkan oleh bidder, dan penerbit mungkin atau tidak menampilkannya jika disediakan (misalnya, memberi rating).
- Pesan Ajakan (CTA) selalu ditandai sebagai Direkomendasikan karena ditetapkan secara default jika tidak dikirim oleh bidder, namun akan selalu ditampilkan jika terkirim.
Tabel berikut mencantumkan kolom template iklan instal aplikasi. Aplikasi seluler menggunakan kolom ini untuk membuat iklan native instal aplikasi.
Kolom | Deskripsi | Wajib atau Direkomendasikan? | Selalu ditampilkan? | Ukuran gambar yang direkomendasikan/jumlah karakter maksimal | Contoh |
---|---|---|---|---|---|
Judul | Judul aplikasi | Wajib | Ya | 25 karakter | Flood-It! |
Gambar | Screenshot dari aplikasi, atau gambar lain yang relevan | Wajib | Tidak | 1.200 x 627 piksel atau 600 x 600 piksel bergantung pada rasio aspek yang diperlukan oleh penerbit. | <Screenshot dari game Flood-It!> |
Isi | Teks utama aplikasi | Wajib | Tidak | 90 karakter | Sederhana yang menipu + menantang yang menggoda = sangat adiktif! |
Ikon aplikasi | Ikon aplikasi | Wajib | Tidak | 128x128 piksel | <Flood-it! ikon aplikasi> |
Pesan ajakan (CTA) | Tindakan pilihan pengguna | Disarankan | Ya | 15 karakter | Instal |
Rating bintang | Jumlah bintang (0 - 5) yang mewakili nilai aplikasi di app store | Disarankan | Tidak | 0 - 5 | 4,5 |
Harga | Biaya aplikasi | Disarankan | Tidak | 15 karakter | Gratis |
Catatan tentang panjang teks
Jika pembeli mengirimkan aset teks (misalnya, teks isi) lebih panjang dari jumlah karakter maksimum yang disarankan, teks mungkin terpotong dan oleh Google atau penerbit. Perhatikan bahwa pemotongan batasnya adalah setengah ukuran dalam bahasa China, Jepang, dan Korea. Misalnya, batas judul adalah 90 untuk bahasa Inggris dan 45 untuk bahasa China.
Catatan tentang ukuran gambar
Penayang diizinkan untuk:
- Pangkas gambar utama secara simetris hingga 20% dalam satu dimensi (tinggi atau (lebar).
- Menskalakan gambar tanpa mengubah rasio aspeknya.
- Gambar yang memiliki rasio aspek sangat berbeda dengan yang tersirat dengan tinggi dan lebarnya mungkin akan disaring.
Kerangka iklan konten
Tabel berikut mencantumkan kolom template iklan konten. Penerbit menggunakan kolom ini untuk membuat iklan konten native.
Kolom | Deskripsi | Wajib atau Direkomendasikan? | Selalu ditampilkan? | Ukuran gambar yang direkomendasikan/jumlah karakter maksimal * | Contoh |
---|---|---|---|---|---|
Judul | Header iklan | Wajib | Ya | 25 karakter | Tarif hipotek terendah |
Gambar | Gambar utama iklan | Wajib | Tidak | 1.200 x 627 piksel atau 600 x 600 piksel bergantung pada rasio aspek yang diperlukan oleh penerbit. | <Gambar utama iklan> |
Isi | Konten iklan | Wajib | Tidak | 90 karakter | Rumah Anda yang manis di Brooklyn - lebih murah dan lebih cepat dari yang Anda kira! |
Logo | Logo pengiklan atau gambar kecil lainnya yang relevan | Disarankan | Tidak | 128x128 piksel | <Logo NY Mortgage Inc.> |
Pesan ajakan (CTA) | Tindakan pilihan pengguna | Disarankan | Tidak | 15 karakter | Dapatkan penawaran |
Pengiklan | Teks yang menunjukkan pengiklan atau merek | Wajib | Tidak | 25 karakter | {i>NY Mortgage Inc.<i} |
Template iklan instal aplikasi video
Kolom | Deskripsi | Wajib atau Direkomendasikan? | Selalu ditampilkan? | Ukuran gambar yang direkomendasikan/jumlah karakter maksimal * | Contoh |
---|---|---|---|---|---|
Video | Respons VAST video yang berisi semua aset yang diperlukan untuk memutar 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 ketika sedang dimuat. | Wajib | Tidak | Harus cocok dengan rasio aspek video (misalnya: 1280x720 untuk video berukuran 16x9, 4x3 untuk video berukuran 640x480). | Screenshot dari game Flood-It! Atau dari video |
Isi | Teks utama aplikasi | Wajib | Tidak | 90 karakter | Sederhana yang menipu + menantang yang menggoda = sangat adiktif! |
Ikon aplikasi | Ikon aplikasi | Wajib | Tidak | 128x128 piksel | Flood sangat! ikon aplikasi |
Pesan ajakan (CTA) | Tindakan pilihan pengguna | 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, deskripsi mungkin akan dipotong dan dihilangkan dengan Google atau penerbit. Perhatikan bahwa batas pemotongan adalah setengah dari ukuran China, Jepang, dan Korea. Misalnya, batas judul adalah 90 dalam bahasa Inggris dan 45 untuk bahasa China.Ukuran gambar: Penayang diizinkan untuk:
- Memangkas gambar utama secara simetris hingga 20% dalam satu dimensi (tinggi atau lebarnya.
- Menskalakan gambar tanpa mengubah rasio aspeknya.
Contoh iklan instal aplikasi
Template iklan konten video
Kolom | Deskripsi | Wajib atau Direkomendasikan? | Selalu ditampilkan? | Ukuran gambar yang direkomendasikan/jumlah karakter maksimal * | Contoh |
---|---|---|---|---|---|
Video | Respons VAST video yang berisi semua aset yang diperlukan untuk memutar iklan video. | Wajib | Ya | - | URL ke XML VAST yang berisi Flood-It! Iklan video |
Judul | Header iklan | Wajib | Ya | 25 karakter | Tarif hipotek terendah |
Gambar | Gambar (thumbnail) yang ditampilkan di pemutar sebelum iklan video diklik atau ketika sedang dimuat. | Wajib | Tidak | Harus cocok dengan rasio aspek video (misalnya: 1280x720 untuk video berukuran 16x9, 4x3 untuk video berukuran 640x480). | Screenshot dari video |
Isi | Konten iklan | Wajib | Tidak | 90 karakter | Rumah Anda yang manis di Brooklyn - lebih murah dan lebih cepat dari yang Anda kira! |
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 | {i>NY Mortgage Inc.<i} |
Kolom meta
Kolom meta berikut digunakan oleh semua template iklan yang didukung:
Diotorisasi Buffering protokol real time pembeli | Diotorisasi OpenRTB Pembeli | Deskripsi |
---|---|---|
NativeAd.click_link_url |
Link.url |
URL yang akan dipanggil oleh browser saat pengguna mengklik iklan.
Dapat menjadi langkah pertama dari rantai pengalihan yang pada akhirnya mengarah ke
halaman landing Anda. Untuk iklan native, sebaiknya gunakan click_link_url sebagai kolom yang akan ditetapkan
tujuan akhir di mana
pengguna akan pergi. Anda harus menggunakan kolom ini jika
halaman landing dinamis. |
Ad.click_through_url |
Bid.adomain |
Harus ditetapkan jika bidder bermaksud melakukan bidding. Ini adalah kumpulan tujuan
URL untuk cuplikan, termasuk URL yang akan dibuka pengguna jika
klik pada iklan yang ditampilkan, dan URL yang terlihat di iklan yang
. Jangan sertakan panggilan perantara ke server iklan yang tidak terkait dengan
halaman landing terakhir. BidResponse yang menampilkan cuplikan atau iklan video
tetapi mendeklarasikan tidak ada Untuk iklan non-native, atribut ini tidak digunakan untuk pelacakan klik atau iklan lainnya fungsionalitasnya; hanya digunakan sebagai deklarasi URL tujuan. Untuk iklan native, jika |
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 |
Tautkan ke preferensi iklan atau halaman penolakan. Jika ada, Ikon AdChoices ditambahkan ke materi iklan native dan ditautkan ke URL ini. Ini didukung untuk iklan native namun bukan bagian dari pesan native di respons bid. |
Ad.impression_tracking_url |
NativeResponse.imptrackers |
Tayangan native harus dilacak dengan
impression_tracking_url dalam bidding real-time Authorized Buyers
proto atau Native imptrackers di OpenRTB. |
Kolom wajib diisi dan direkomendasikan
required_fields
dan recommended_fields
ditentukan oleh penayang. Kami menunjukkan bagaimana
untuk menerjemahkan isian bit ini untuk
menentukan apakah suatu {i>field<i} diperlukan atau
direkomendasikan.
Isian bit menggunakan setiap bit nilai biner
untuk menyimpan nilai benar atau salah
, setara dengan mengirim banyak sinyal boolean seperti
is_logo_required
, is_header_required
, dll. tetapi semua
dalam satu paket.
Contoh
Untuk contoh ini, kita akan menggunakan nilai required_fields
1085
.
Pertama, temukan nilai biner yang setara:
10000111101
Setelah Anda memiliki nilai biner, Anda dapat memeriksa bit untuk melihat apakah suatu {i>field<i} wajib (1) atau tidak diperlukan (0).
Tabel di bawah memetakan kolom sesuai 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 |
Pada contoh nilai biner 10000111101
, nilai 1-bit
(paling kanan) adalah 1
, menandakan nilai yang diperlukan. Menurut
tabel, 1-bit sesuai dengan HEADLINE
.
2-bit (nilai kedua dari kanan) adalah 0
yang menandakan
tidak wajib diisi. 2-bit sesuai dengan BODY
.
Berikut adalah semua kolom wajib diisi 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 |
Pesan NativeAdTemplate
Saat menerima permintaan bid yang berisi inventaris native, permintaan ini akan berisi
BidRequest.adSlot[].native_ad_template yang terisi.
Pesan NativeAdTemplate
memberikan spesifikasi untuk:
- Kolom yang wajib atau direkomendasikan.
- Dimensi untuk gambar, logo, dan ikon aplikasi.
- Spesifikasi untuk gaya penayangan iklan.
message BidRequest { //... message AdSlot { //... message NativeAdTemplate { // Defines the bits used in required_fields and recommended_fields. // There is one bit for each of the fields in BidResponse.Ad.NativeAd enum Fields { NO_FIELDS = 0x0; HEADLINE = 0x1; BODY = 0x2; CALL_TO_ACTION = 0x4; ADVERTISER = 0x8; IMAGE = 0x10; LOGO = 0x20; APP_ICON = 0x40; STAR_RATING = 0x80; PRICE = 0x100; DEPRECATED_STORE = 0x200; VIDEO = 0x400; } // Bitfield describing which fields are required by the publisher. Bid // responses with no value for these fields will be rejected. Click // and view tracking urls are always implicitly required. optional int64 required_fields = 1; // Bitfield describing which fields are recommended by the publisher. // All recommended field are supported, but not all recommended fields // are required. optional int64 recommended_fields = 2; // max_safe_length indicates the maximum number of Unicode characters that // are guaranteed to be shown without truncation. Longer strings may be // truncated and ellipsized by Ad Exchange or the publisher during // rendering. optional int32 headline_max_safe_length = 3; optional int32 body_max_safe_length = 4; optional int32 call_to_action_max_safe_length = 5; optional int32 advertiser_max_safe_length = 6; optional int32 price_max_safe_length = 15; // The width and height from which to calculate the required aspect ratio. // You can provide a larger image in the response. Images that have aspect // ratios substantially different than those implied by the height and // width may be filtered. optional int32 image_width = 7; optional int32 image_height = 8; optional int32 logo_width = 9; optional int32 logo_height = 10; optional int32 app_icon_width = 11; optional int32 app_icon_height = 12; // Globally distinct id for the specific style, HTML, and CSS with which // the native ad is rendered. optional int32 style_id = 16; // Type of style layout for each native ad template. enum LayoutType { PIXEL = 0; FLUID = 1; } optional LayoutType style_layout_type = 17 [default = PIXEL]; // If the style_layout_type is Pixel, width and height of the // entire native ad after rendering. If the style_layout_type is // Fluid, the style_height and style_width may optionally // not be populated. optional int32 style_height = 18; optional int32 style_width = 19; } repeated NativeAdTemplate native_ad_template = 51; } // NativePlacementType describes placement of native ad slot with respect to // surrounding context. enum NativePlacementType { PLACEMENT_UNKNOWN = 0; // In the feed of content - for example as an item inside the organic // feed/grid/listing/carousel. PLACEMENT_IN_FEED = 1; // In the atomic unit of the content - for example, in the article page or single // image page. PLACEMENT_ATOMIC_UNIT = 2; // Outside the core content - for example in the ads section on the right // rail, as a banner-style placement near the content, etc. PLACEMENT_OUTSIDE = 3; // Recommendation widget, most commonly presented below the article // content. PLACEMENT_RECOMMENDATION = 4; } optional NativePlacementType native_placement_type = 45; // ... }
Pesan NativeAd
Saat melakukan bidding pada inventaris native, pembeli harus mengisinya
BidResponse.ad[].native_ad
dengan kolom wajib diisi yang dideklarasikan di BidRequest.adSlot[].native_ad_template
yang sesuai.
message BidResponse { //... message Ad { //... message NativeAd { // A short title for the ad. optional string headline = 1; // A long description of the ad. optional string body = 2; // A label for the button that the user is supposed to click. optional string call_to_action = 3; // The name of the advertiser or sponsor, to be displayed in the ad // creative. optional string advertiser = 4; // Next tag to use: 4 message Image { optional string url = 1; // Image width and height are specified in pixels. You may provide a // larger image than was requested, so long as the aspect ratio is // preserved. optional int32 width = 2; optional int32 height = 3; } // A large image. optional Image image = 5; // A smaller image, for the advertiser's logo. optional Image logo = 6; // The app icon, for app download ads. optional Image app_icon = 7; // The video file. Only set this field if the video field is requested. oneof video { // The URL to fetch a video ad. The URL should return an XML response // that conforms to VAST standards. string video_url = 13; // The VAST document to be returned. string video_vast_xml = 16; } // The app rating in the app store. Must be in the range [0-5]. optional double star_rating = 8; // The URL that the browser/SDK will load when the user clicks the ad. // This can be the landing page directly, or the first step of a redirect // chain that eventually leads to it. For backward compatibility, if this // is not set, the first Ad.click_through_url is used. optional string click_link_url = 14; // The URL to use for click tracking. The SDK pings click tracking url on // a background thread. When resolving the url, HTTP 30x redirects are // followed. The SDK ignores the contents of the response; this URL // has no effect on the landing page for the user. // This field is planned to be deprecated and we are moving to the // repeated click_tracking_urls field. optional string click_tracking_url = 11; // The URLs to use for click tracking. This will be used throughout the // serving stack and will incorporate any URL in click_tracking_urls. repeated string click_tracking_urls = 15; // The price of the promoted app including the currency info. optional string price = 10; }; optional NativeAd native_ad = 18; // The set of destination URLs for the snippet. This includes the URLs that // the user will go to if they click on the displayed ad, and any URLs that // are visible in the rendered ad. Do not include intermediate calls to the // adserver that are unrelated to the final landing page. A BidResponse that // returns a snippet or video ad but declares no click_through_url will be // discarded. Only set this field if html_snippet or video_url or native_ad // are set. This data is used as a destination URL declaration, for example // for post-filtering of publisher-blocked URLs or ad categorization. // // For non-native ads, it is not used for click tracking or any // other ad functionality; it is only used as a destination URL // declaration. // // For native ads, if NativeAd.click_link_url is not set, the first // value of click_through_url is used to direct the user to the landing // page. In addition, all values are used as destination // URL declarations (similar to the non-native case). repeated string click_through_url = 4; //... // The URLs to call when the impression is rendered. The SDK pings // impression urls on a background thread and ignores the contents // of the response. repeated string impression_tracking_url = 19; // Link to ad preferences page. This is only supported for native ads. // If present, a standard AdChoices icon is added to the native ad creative and // linked to this URL. optional string ad_choices_destination_url = 21; // ... } }
Contoh permintaan bid
Permintaan bid non-video
JSON OpenRTB
Buffering protokol OpenRTB
Permintaan bid video
Contoh respons bid
Perhatikan bahwa nilai dalam respons ini tidak dimaksudkan untuk cocok dengan permintaan yang sesuai di atas. Namun, jika template dalam permintaan menyarankan wajib/opsional kolom, responsnya di sini mematuhi persyaratan tersebut.