Transparansi bid dengan objek SupplyChain

Dengan objek SupplyChain, pembeli dan perantara dapat mengetahui semua pihak yang menjual atau menjual kembali inventaris iklan. Objek ini dapat digunakan dengan ads.txt/app-ads.txt dan sellers.json untuk memberikan transparansi terkait ekosistem iklan.

1. Penayang mengirimkan permintaan bid.
2. Pembeli menerima permintaan bid dan data dari objek SupplyChain.
3. Pembeli mencari identitas semua perantara yang menjual kembali inventaris.
4. Pembeli meng-crawl dan memverifikasi vendor yang diizinkan untuk menjual inventaris.

Google akan secara otomatis membuat objek ini dalam permintaan OpenRTB atau protokol Google RTB, jika berlaku.

Cara kerja objek SupplyChain

Objek SupplyChain, atau disebut juga schain, merupakan bagian dari permintaan bid OpenRTB dan terdiri dari beberapa "node". Setiap node dalam objek schain mewakili entitas tertentu yang berpartisipasi dalam permintaan bid, dengan cakupan semua entitas yang terlibat dalam arus pembayaran langsung untuk inventaris.

// Contoh object
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // seller_id yang sama untuk penayang di sellers.json
         "hp":1
    }],
    "ver":"1.0"
}

Baca dokumentasi developer OpenRTB dan dokumentasi IAB untuk informasi selengkapnya.

Objek SupplyChain akan terlihat berbeda bergantung pada cara Anda bekerja sama dengan pembeli.

Penayang yang melakukan penjualan langsung dengan Google

Untuk penayang yang menjual inventaris secara langsung melalui Ad Manager, AdMob, atau AdSense, objek schain hanya berisi satu node untuk "google.com" dengan seller_id yang dapat ditemukan di sellers.json.

Penayang yang menggunakan Bidding Terbuka

Penayang yang menggunakan Bidding Terbuka untuk bekerja sama dengan bursa pihak ketiga memiliki dua node dalam objek schain: satu node untuk google.com dengan seller_id yang dapat ditemukan di sellers.json, dan satu node untuk partner hasil bursa.

Sama halnya seperti Google yang membuat node untuk google.com sebelum mengirimkan permintaan bid, bursa pihak ketiga juga bertanggung jawab untuk menambahkan node sebelum mengirimkan permintaan.

Semua perantara non-pembayaran

Perantara yang tidak menangani pembayaran tidak disertakan dalam objek SupplyChain. Hal ini mencakup bidding header sisi klien, bidding header non-pembayaran, pembagian inventaris, dan mediasi lainnya.

Penayang yang menggunakan perantara pembayaran sebelum permintaan ^(Beta) 

Fitur ini masih dalam versi Beta
Fitur dalam versi Beta mungkin tidak tersedia di jaringan Anda. Lihat catatan rilis untuk mengetahui kapan fitur ini tersedia secara umum.

Penayang yang memanfaatkan perantara pembayaran di upstream permintaan ke Google Ad Manager diwajibkan untuk meneruskan objek SupplyChain sesuai dengan panduan IAB. Objek SupplyChain hanya boleh berisi perantara yang terlibat langsung dalam alur pembayaran untuk inventaris. Perantara tersebut dapat mencakup teknologi server iklan pihak ketiga yang digunakan oleh penayang. Objek SupplyChain dapat dikirim dalam permintaan iklan menggunakan parameter schain.

Pelajari parameter schain lebih lanjut

Deskripsi

Parameter supply chain (schain) menerima nilai variabel yang harus berupa objek SupplyChain yang diserialisasi. Jika parameter ini disertakan, Google akan menambahkan node ke objek schain yang diterima sebelum mengirimkannya kepada pembeli.

Lihat dokumentasi IAB lengkap untuk mengomunikasikan informasi SupplyChain melalui tag (bukan OpenRTB).

Lihat persyaratan agar schain diuraikan dengan benar

Berdasarkan dokumentasi IAB, berikut persyaratan serialisasi untuk objek SupplyChain:

• Properti {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject dan SupplyChainNode dibatasi koma sehingga kolom opsional dapat dihilangkan dan pemisah komanya dapat dikecualikan secara opsional.
• Setiap elemen SupplyChainNode dipisahkan oleh "!".
• Jika nilai properti apa pun berisi karakter yang memerlukan encoding URL (misalnya "," atau "!"), nilai tersebut harus berupa URL yang dienkode sebelum diserialisasi.

Urutan serialisasi

Properti SupplyChainObject diserialisasi dalam urutan berikut:

ver,complete

Properti SupplyChainNode diserialisasi dalam urutan beirkut:

asi,sid,hp,rid,name,domain,ext

Catatan: Isi ext bersifat khusus untuk pertukaran. Google Ad Manager tidak mengurai properti ini.

Contoh cara melakukan serialisasi objek SupplyChain

Berikut adalah dua contoh cara melakukan serialisasi objek SupplyChain di atas:

Serialisasi dengan koma untuk kolom opsional kosong

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Serialisasi tanpa koma untuk kolom opsional kosong

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Pelajari lebih lanjut objek SupplyChain.

Contoh penggunaan

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Berikut serialisasi dengan karakter escape jika nilai untuk asi adalah exchange,1:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Persyaratan dan rekomendasi

Parameter ini memang tidak diperlukan untuk menayangkan iklan ke jenis transaksi atau penerapan tertentu, tetapi parameter ini diperlukan untuk penayang yang memanfaatkan perantara pembayaran di upstream permintaan ke Google Ad Manager. Hal ini termasuk penayang yang menggunakan teknologi server iklan pihak ketiga.

 

Catatan: Penambahan node tambahan apa pun ke objek SupplyChain juga harus ditampilkan di file ads.txt/app-ads.txt penayang. Jika tidak, pembeli mungkin menganggap traffic tersebut tidak sah.

Penayang Pengelolaan Banyak Pelanggan

Pengelolaan Banyak Pelanggan (MCM) memungkinkan penayang induk memonetisasi inventaris partner penayang satu per satu dengan jenis delegasi Kelola Akun, atau dalam skala besar dengan jenis delegasi Kelola Inventaris.

Untuk penayang induk dan partner penayang yang menggunakan Kelola Inventaris, sekarang ada satu Objek SupplyChain yang dibuat dengan satu node untuk ID penjual penayang induk, satu node untuk partner penayang, dan objek schain ditandai selesai.

Untuk penayang induk dan partner penayang yang menggunakan Kelola Akun, objek schain akan memiliki satu node dengan ID penjual partner penayang, dan rantai tersebut akan ditandai sebagai lengkap. Untuk penayang yang menggunakan Kelola Akun, monetisasi akan berlangsung di akun partner penayang. Partner penayang diperlakukan sebagai penayang akhir. Informasi penayang induk tidak disertakan dalam objek schain.