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.
- Penayang mengirimkan permintaan bid.
- Pembeli menerima permintaan bid dan data dari objek SupplyChain.
- Pembeli mencari identitas semua perantara yang menjual kembali inventaris.
- 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 schainschain mewakili entitas tertentu yang berpartisipasi dalam permintaan bid, dengan cakupan semua entitas yang terlibat dalam alur pembayaran langsung untuk inventaris.
sid) penayang turunan mereka melalui Ad Manager atau menggunakan API.
// 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. Perantara ini mencakup bidding header sisi klien, bidding header non-pembayaran, pembagian inventaris, dan mediasi lainnya.
Penayang yang menggunakan perantara pembayaran sebelum permintaan (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 panggilan iklan menggunakan parameter schain.
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 agarschain diuraikan dengan benar
Berdasarkan dokumentasi IAB, berikut persyaratan serialisasi untuk objek SupplyChain:
- Properti
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectdanSupplyChainNodedibatasi koma sehingga kolom opsional dapat dihilangkan dan pemisah komanya dapat dikecualikan secara opsional. - Setiap elemen
SupplyChainNodedipisahkan 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
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:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
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.
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 mengelola akun AdMob klien mereka dengan visibilitas dan kontrol yang sama seperti penayang itu sendiri.
Untuk penayang induk dan partner penayang yang menggunakan MCM AdMob, objek schain akan memiliki satu node dengan ID penjual partner penayang, satu node untuk penayang induk, dan rantai tersebut akan ditandai sebagai lengkap. Untuk MCM AdMob, monetisasi akan berlangsung di akun partner penayang. Partner penayang diperlakukan sebagai penayang akhir.