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
, merupakan bagian dari permintaan bid OpenRTB dan terdiri dari beberapa "node". Setiap node dalam objek schain
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 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
.
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}. SupplyChainObject
danSupplyChainNode
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
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 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
.