Protected Audience (sebelumnya dikenal sebagai FLEDGE) pada penerapan Android biasanya melibatkan integrasi antara aplikasi pengiklan, aplikasi penayang, penjual, dan pembeli. Panduan ini ditujukan bagi partner yang berencana mengelola audiens kustom dan menjalankan lelang, seperti jaringan teknologi iklan yang beroperasi sebagai pembeli dan penjual. Kampanye iklan yang berbeda dapat memiliki sasaran yang berbeda, dan tidak semua fitur Protected Audience digunakan untuk semua kasus penggunaan. Panduan ini mencoba menjelaskan langkah-langkah yang diperlukan untuk mendukung kasus yang lebih khusus jika memungkinkan.
Untuk mempersiapkan deployment produksi Protected Audience dalam skala besar, partner dapat memulai pengujian dengan meniru titik integrasi bersama pihak lain. Untuk membantu Anda merencanakan integrasi, panduan ini menyediakan tampilan komprehensif tentang cara mengintegrasikan Protected Audience dengan aplikasi Android. Fitur ini mungkin mencakup fitur yang belum diterapkan pada tahap Privacy Sandbox saat ini di Pratinjau Developer Android. Dalam kasus ini, panduan linimasa disediakan.
Alur kerja integrasi Protected Audience terdiri dari 4 langkah utama yang dijalankan oleh berbagai jenis partner teknologi iklan:
- Pembeli membuat audiens kustom.
- Proses pemilihan iklan akan memilih iklan pemenang.
- Aplikasi penjual memulai pemilihan iklan.
- Layanan iklan menjalankan pemfilteran sisi beli dan kode bidding.
- Layanan iklan mengeksekusi kode keputusan sisi jual.
- Iklan pemenang dirender di aplikasi penjual.
- Laporan untuk tayangan iklan tersedia bagi pembeli dan penjual.
Diagram berikut menggambarkan langkah-langkah ini:
Terminologi
- Pengiklan: Perusahaan yang berinteraksi dengan pengguna melalui pembelian inventaris iklan.
- Penayang: Perusahaan yang menjual inventaris iklan yang tersedia bersama kontennya.
- Pembeli: Perusahaan teknologi iklan yang memfasilitasi pengiklan dalam membeli inventaris iklan.
- Penjual: Perusahaan teknologi iklan yang memfasilitasi penayang dalam menjual inventaris iklan.
- Jaringan: Perusahaan teknologi iklan yang bertindak sebagai pembeli dan penjual.
- Milik dan kelolaan sendiri: Perusahaan yang bertindak sebagai penayang, penjual, dan pembeli.
- Partner integrasi: Perusahaan apa pun yang perlu Anda ajak bekerja sama agar berhasil berintegrasi dengan Protected Audience.
Prasyarat, interaksi partner integrasi, dan penyiapan
Bagian ini menguraikan serangkaian aktivitas awal untuk membantu Anda memahami cara kerja Protected Audience, cara memulai integrasi Protected Audience, dan cara berinteraksi dengan partner integrasi Anda dalam penerapan Protected Audience. Aktivitas ini dapat berlangsung secara paralel.
![Diagram yang menunjukkan panduan peluncuran fitur Protected Audience.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/android/fledge-rollout-plan.png?authuser=7&hl=id)
Memahami Protected Audience
Langkah pertama adalah memahami API dan layanan Protected Audience.
- Mulailah dengan membaca proposal desain untuk memahami Protected Audience API dan kemampuannya.
- Baca panduan developer untuk mempelajari cara menggabungkan kode dan panggilan API yang diperlukan untuk kasus penggunaan Anda, serta layanan yang diperlukan untuk berintegrasi dengan Protected Audience.
- Mengirim masukan terkait desain dan penerapan API, layanan, dan dokumentasi Protected Audience.
- Daftar untuk menerima info terbaru agar tetap mendapatkan informasi terkini tentang fitur Privacy Sandbox terbaru.
Menyiapkan dan menguji aplikasi contoh
Setelah memahami dasar-dasar Protected Audience seperti yang diuraikan sebelumnya, Anda harus menyiapkan dan menguji aplikasi contoh.
- Jika Anda sudah siap untuk memulai integrasi, siapkan lingkungan pengembangan dengan Pratinjau Developer Privacy Sandbox terbaru.
- Siapkan endpoint server yang diperlukan. Gunakan contoh tiruan dengan solusi pengujian API pilihan Anda untuk mem-bootstrap proses ini.
- Lakukan fork dan jalankan kode di aplikasi contoh untuk memahami pengelolaan audiens kustom, alur kerja pemilihan iklan, dan pelaporan tayangan iklan.
Interaksi partner integrasi
Jadwalkan diskusi dengan partner integrasi Anda untuk membahas pengujian dan penggunaan Protected Audience di Android, seperti bentuk sinyal yang diteruskan antarpihak. Bagi pembeli, diskusi harus menyertakan strategi untuk membuat dan bergabung dengan audiens kustom yang dapat mencakup diskusi cara menentukan audiens. Berkolaborasilah dengan partner integrasi Anda untuk menentukan linimasa integrasi, mulai dari pengujian awal hingga adopsi, dan area yang menjadi tanggung jawab setiap pihak dalam desain.
Penyiapan beta (Tersedia di K4)
Daftarkan organisasi Anda dengan Privacy Sandbox di Android. Pendaftaran diwajibkan untuk memastikan developer teknologi iklan beroperasi dalam kebijakan Privacy Sandbox dan memungkinkan developer teknologi iklan menentukan identitas mereka di beberapa SDK dan domain.
Pertimbangan arsitektur
Bagi pembeli dan penjual, Protected Audience memperkenalkan kemampuan untuk menjalankan lelang iklan di perangkat. Anda dan partner integrasi harus memikirkan beberapa pertimbangan penting dalam desain:
Audiens dan iklan pemasaran ulang disimpan di perangkat
Berbeda dengan penyimpanan iklan sepenuhnya di server saat ini, informasi audiens dan iklan pemasaran ulang disimpan di perangkat. Iklan kontekstual yang tidak mengandalkan data dalam perangkat untuk penargetan akan terus tetap berada di server. Platform teknologi iklan harus diperluas agar dapat mempertimbangkan permintaan iklan yang tersebar di antara server dan perangkat.
Proses bidding dan lelang berlangsung di perangkat
Selain menjalankan lelang di server, platform teknologi iklan kini memiliki peluang untuk menetapkan harga dan menentukan peringkat permintaan iklan yang disimpan di perangkat.
Pendekatan umumnya adalah teknologi iklan menjalankan lelang untuk iklan kontekstual seperti yang dilakukan saat ini. Setelah menyelesaikan lelang, penjual dapat memilih menjalankan lelang di perangkat untuk mengevaluasi permintaan pemasaran ulang yang disimpan di perangkat. Anda harus mengingat batas yang ada untuk memastikan lelang berjalan secara menyeluruh seperti yang dirancang oleh partner integrasi yang berbeda dalam berbagai kasus penggunaan pemasaran ulang karena proses ini sekarang berjalan di perangkat.
Strategi data
Platform teknologi iklan harus mempertimbangkan jenis data yang digunakan dalam lelang. Saat ini, informasi ini dikumpulkan dari berbagai sumber, lalu dipusatkan di server. Lelang Protected Audience menawarkan beberapa jalur berbeda untuk meneruskan data tersebut. Misalnya: Sinyal real-time seperti sisa anggaran berasal dari layanan nilai kunci sebagai tanda tepercaya, sedangkan sinyal kontekstual seperti waktu dikirim dari penjual saat menjalankan lelang. Sinyal ini dijelaskan secara lebih mendalam di bagian yang relevan dalam panduan ini.
Membuat solusi Anda
Ada beberapa tahapan utama untuk menjalankan lelang dengan Protected Audience. Pembeli harus meningkatkan jumlah audiens, menyediakan data bidding, menargetkan iklan ke audiens, dan menyiapkan bidding. Penjual harus mengonfigurasi dan memicu lelang, menilai iklan kandidat, serta memilih pemenang. Beberapa tahap ini memerlukan kolaborasi antara kedua pihak untuk memastikan lelang dapat dijalankan dengan benar. Bagian berikut menjelaskan setiap tahap secara mendetail dan secara eksplisit menyebutkan pihak mana yang bertanggung jawab atas penerapan.
Pembeli: Meningkatkan jumlah audiens
Pembeli biasanya mengelola audiens kustom. API untuk mengelola audiens kustom dirancang untuk dipanggil di perangkat karena audiens kustom dikelola di perangkat.
Jika memiliki SDK sendiri di aplikasi pengiklan, Anda dapat menerapkan kode
ini secara langsung melalui joinCustomAudience()
.
Jika tidak memiliki kode SDK sendiri di perangkat, Anda dapat mempertimbangkan untuk berpartner dengan partner integrasi yang ada, yang juga merupakan penyedia SDK. Identifikasi dan bekerja sama dengan partner ini untuk mendefinisikan kontrak dan alur guna menentukan dan mengelola audiens kustom. Panduan ini menggunakan istilah "pembeli", apa pun pendekatan yang digunakan. Beberapa contoh pendekatan meliputi:
- Sebagai pembeli, minta pengiklan untuk menentukan audiens. SDK partner integrasi di perangkat dapat mengirim peristiwa aplikasi kepada pembeli. Jika kriteria yang telah ditentukan terpenuhi, pembeli akan mengirim pesan ke SDK untuk bergabung dengan audiens kustom di sisi klien atas nama pembeli.
- SDK dapat memiliki audiens secara langsung. Pengiklan bekerja sama dengan penyedia SDK untuk menentukan audiens. SDK memantau peristiwa aplikasi dan bergabung dengan audiens pada waktu yang tepat, dan memberi tahu pembeli bahwa pengguna telah bergabung dengan audiens.
Membuat prototipe kampanye pemasaran ulang: Mendesain audiens kustom
Audiens kustom adalah pengelompokan pengguna dengan minat serupa yang dapat menerima penayangan iklan yang dipersonalisasi. Pembeli dapat membantu pengiklan membuat audiens kustom di aplikasi mereka berdasarkan aktivitas pengguna.
Protected Audience membuat penampung untuk audiens kustom yang memetakan ke interaksi pengguna kustom tertentu seperti yang ditentukan oleh pengiklan. Hal ini meliputi kumpulan iklan kandidat yang dapat ditampilkan kepada audiens tersebut, serta kumpulan logika bidding dan data kustom yang dapat digunakan selama lelang untuk memfilter dan memberi harga pada iklan.
Penyiapan dan prototipe
- Gunakan API audiens kustom untuk membuat dan menyimpan audiens di perangkat yang nantinya dapat digunakan dalam lelang.
- Lihat panduan developer untuk mengetahui detail implementasi dan penggunaan API.
Pertimbangan desain
Pembeli dapat mendukung berbagai kasus penggunaan dengan mengonfigurasi audiens kustom. Pertimbangan ini meliputi menentukan logika bidding untuk jenis iklan atau kampanye yang ditargetkan untuk audiens ini, menentukan daftar iklan kandidat, dan pertimbangan serupa. Bagian ini mencakup pertimbangan desain untuk mengisi dan menggunakan beberapa kolom utama dalam audiens kustom.
URL logika bidding
Pembeli harus men-deploy endpoint yang dapat menampilkan logika bidding sebagai JavaScript karena lelang dijalankan di perangkat. Panduan developer kami menjelaskan metode yang memerlukan tanda tangan. Logika bidding memiliki akses ke sinyal tertentu terkait pengguna selama lelang seperti yang akan dijelaskan di beberapa bagian berikutnya. Penyiapan logika bidding dan sinyal pengguna dijelaskan nanti dalam artikel ini.
Sinyal bidding pengguna
Pembeli dapat menggunakan UserBiddingSignals
untuk meneruskan pengetahuan tentang pengguna yang dimiliki
oleh pengiklan atau pembeli ke lelang selanjutnya di
perangkat. Pengetahuan ini dapat mencakup informasi seperti:
- Audiens lain yang telah ditambahkan oleh pengguna.
- Analisis pihak pertama yang dimiliki pengiklan tentang pengguna.
Sinyal-sinyal ini tersedia selama lelang. Oleh karena itu, pembeli dapat melakukan operasi bidding kustom selama lelang, seperti:
- Menaikkan atau menurunkan bid berdasarkan sinyal bidding.
- Memfilter iklan tertentu dari lelang.
Data bidding tepercaya
Sebagai bagian dari penerapan Protected Audience, pembeli dapat mengakses informasi
real-time selama lelang dari layanan nilai kunci. Sebagai mekanisme
sementara, pembeli dan penjual dapat mengambil sinyal bidding dari
layanan mana pun, termasuk yang mereka operasikan sendiri. Contoh paling umum adalah
mencari anggaran yang tersisa untuk iklan. Selama pengembangan, Anda dapat membuat
layanan tiruan ini dan juga bisa mengembangkannya dengan endpoint tiruan ini. Lihat direktori
FledgeServerSpec
di repo aplikasi contoh kami di GitHub
untuk mengetahui petunjuk penyiapan.
Kolom TrustedBiddingData
terdiri dari URL dan kumpulan kunci.
Berikut adalah beberapa pertimbangan saat mendesain jenis struktur kunci yang akan digunakan:
- Pendekatan sederhananya adalah menyertakan kunci yang memetakan 1:1 ke audiens yang dibuat. Layanan nilai kunci ini kemudian dapat memuat semua informasi relevan yang terkait dengan audiens.
- Anggaran dan status iklan merupakan aspek penting yang perlu dipertimbangkan secara real time.
- Jumlah bid maksimum atau sinyal lain yang dapat digunakan untuk menentukan harga iklan dalam
lelang. Informasi ini dapat disertakan bersama iklan dalam
daftar
AdData
, tetapi menyimpan informasi ini ke dalam layanan nilai kunci akan mempermudah informasi diperbarui sesuai kebutuhan.
Daftar AdData
Saat membuat kampanye pemasaran ulang, pengiklan biasanya mempertimbangkan berbagai
jenis iklan untuk ditampilkan kepada pengguna dalam suatu audiens, seperti mengiklankan
diskon yang berbeda berdasarkan interaksi pengguna sebelumnya dengan aplikasi. Audiens
kustom menyertakan daftar AdData
yang menyimpan iklan kandidat.
Jumlah informasi yang disertakan untuk setiap iklan menjadi keputusan pembeli. Beberapa hal yang perlu dipertimbangkan:
- Daftar
AdData
dapat diperbarui dengan 2 cara:- Saat memiliki aktivitas yang terlihat di latar depan, aplikasi dapat memulai daftar saat menggabungkan pengguna dengan audiens kustom.
- Selama update harian, pengambilan dimulai di latar belakang. Perangkat
mengirimkan permintaan ke
daily_update_url
yang disertakan dalam panggilanjoinCustomAudience
dan mengharapkan respons seperti daftarAdData
yang diperbarui.
- Informasi tambahan tentang iklan dapat diminta pada saat
lelang. Sebelum lelang, perangkat akan mengirimkan permintaan ke layanan nilai kunci
pembeli yang disediakan di kolom
trustedBiddingData
darijoinCustomAudience
. Layanan nilai kunci adalah layanan baru yang menjadi bagian dari implementasi Protected Audience oleh pembeli. Detail selengkapnya tentang layanan ini akan dijelaskan nanti dalam dokumen ini. - Penyertaan ID materi iklan untuk iklan dapat membantu Anda mengambil tindakan tertentu
pada materi iklan tertentu. Misalnya, pengiklan dapat menjeda materi iklan tertentu
dan Anda ingin menarik ID materi iklan tersebut dari layanan nilai kunci real-time
lalu mencocokkannya dengan iklan dalam daftar
AdData
.
AdData
harus menyertakan render_url
. URL render iklan pemasaran ulang pemenang
digunakan untuk merender iklan. Beberapa pertimbangan mencakup:
- URL render memiliki nilai minimum k-anonimitas. Jadi, hindari menyertakan parameter yang sempit. Informasi lengkap nilai minimum k-anonymity ini akan dipublikasikan pada masa mendatang.
- URL ini harus memuat semua informasi yang diperlukan untuk merender iklan. Misalnya, jika Anda ingin menampilkan produk tertentu, sematkan ID produk sebagai parameter di URL.
Saat membuat prototipe, satu-satunya kolom yang wajib diisi adalah renderUri
, yang mengarah ke
aset rendering iklan. Kolom metadata di AdData
dapat diabaikan
saat Anda membuat solusi. Saat memindahkan solusi ke produksi,
Anda harus mempertimbangkan metadata yang relevan karena dapat digunakan selama
pembuatan bid untuk menyesuaikan harga bid.
Waktu aktivasi dan waktu masa berakhir
Anda dapat menggunakan kolom waktu aktivasi dan waktu masa berakhir untuk mendukung kasus penggunaan jika audiens kustom hanya memenuhi syarat untuk lelang dalam waktu yang ditentukan sebelumnya. Perhatikan bahwa ada batasan tertentu untuk durasi penundaan waktu aktivasi dan delta antara waktu aktivasi dan waktu masa berakhir. Contoh kasus penggunaan mencakup:
- Pengguna lama (misalnya pengguna yang belum berinteraksi dengan aplikasi pengiklan
dalam 7 hari terakhir)
- Setiap kali pengguna membuka aplikasi, pembeli dapat memanggil
joinCustomAudience
dan mengonfigurasiactivation_time
agar stempel waktu selanjutnya menjadi 7 hari. - Audiens memenuhi syarat untuk melakukan bidding jika telah melewati 7 hari sejak pengguna terakhir kali membuka aplikasi.
- Setiap kali pengguna membuka aplikasi, pembeli dapat memanggil
- Audiens musiman (audiens yang hanya berlaku selama jangka waktu
tertentu dalam waktu dekat)
- Pembeli dapat mulai menentukan audiens kustom terlebih dahulu yang seharusnya hanya memenuhi syarat bidding selama waktu yang telah ditentukan dalam waktu dekat.
- Misalnya, jika pengiklan menyelenggarakan kampanye akhir musim panas di Amerika Serikat
pada tahun 2022, pembeli dapat memanggil
joinCustomAudience
dan mengonfigurasiactivation_time
menjadi Sabtu, 20 Agustus 2022. Jika kampanye hanya berjalan selama satu minggu, pembeli dapat menetapkan tanggal habis masa berlaku ke tanggal 27 Agustus 2022, setelah itu audiens kustom akan difilter oleh platform selama pemilihan iklan dan sampah memori akan dibersihkan.
Pembeli dan penjual: Pemilihan iklan
Pemilihan iklan memerlukan kolaborasi antara pembeli dan penjual. Bentuk kolaborasi ini dapat dilihat sebagai proses empat langkah:
- Penjual menentukan strategi mediasi.
- Penjual mengonfigurasi lelang dan memulai pemilihan iklan.
- Pembeli diundang untuk berpartisipasi dalam lelang melalui konfigurasi yang ditentukan penjual. Logika bidding pembeli dijalankan untuk memilih iklan dan bid kandidat.
- Logika keputusan penjual dijalankan untuk menilai kandidat dan memilih iklan pemenang.
Untuk memudahkan pengembangan, respons layanan untuk pembeli dan
penjual, seperti logika bidding dan penskoran, dapat ditiru sehingga memungkinkan Anda berfokus pada
pengembangan hal-hal yang relevan dengan kasus penggunaan Anda. Lihat
direktori FledgeServerSpec
di GitHub untuk mendapatkan petunjuk
cara menyiapkan endpoint tiruan, atau panduan developer untuk mendapatkan petunjuk cara
mengesampingkan kebutuhan pengambilan JavaScript jarak jauh.
Penjual: Menentukan strategi mediasi
Protected Audience bertujuan untuk mendukung mediasi waterfall. Area ini sedang dalam pengembangan, dan informasi selengkapnya akan diberikan jika sudah tersedia. Untuk saat ini, lihat proposal desain untuk mediasi waterfall di Protected Audience.
Penjual: Mengonfigurasi lelang
Penjual bertanggung jawab mengonfigurasi lelang dan memberikan informasi untuk proses pemilihan iklan. Penjual dapat memilih untuk menyediakan informasi hanya bagi setiap pihak atau beberapa pihak yang dipilih. Informasi yang diberikan dapat mencakup informasi yang Anda miliki atau informasi yang Anda sertakan atas nama pembeli.
Penyiapan dan prototipe
- Penjual dapat mengonfigurasi dan memulai lelang dengan menyiapkan
objek
AdSelectionConfig
dan menggunakanAdSelection
API. Picu lelang dengan memanggilselectAds()
. - Lihat panduan developer untuk mengetahui detail implementasi dan penggunaan API.
Pertimbangan desain
Bagian ini berisi pertimbangan desain untuk mengisi dan menggunakan kolom utama dalam konfigurasi pemilihan iklan.
- Lingkungan eksekusi pribadi hanya menyertakan iklan audiens kustom di perangkat sehingga penerbitan permintaan iklan kontekstual sebelumnya memungkinkan Anda mempertimbangkan permintaan tambahan.
Sebelum memulai alur kerja pemilihan iklan, jalankan permintaan iklan untuk mengumpulkan informasi dari pembeli. Kemudian, gunakan informasi ini untuk mengonfigurasi pilihan iklan.
Ada banyak pembeli yang dapat membuat audiens kustom di perangkat sehingga penjual harus menggunakan kolom pembeli audiens kustom untuk menunjukkan pembeli tertentu agar disertakan dalam proses. Ada banyak cara untuk membuat daftar ini. Contohnya antara lain:
- Daftar statis pembeli yang selalu ingin disertakan penjual dalam proses ini.
- Daftar pembeli yang menunjukkan keinginan untuk berpartisipasi dalam respons iklan mereka. Opsi ini bermanfaat jika penjual menggunakan ad exchange dan mungkin tidak mengetahui semua pengguna sepenuhnya.
Penjual dapat meneruskan informasi ke dalam proses dengan beberapa cara:
- Kolom sinyal pemilihan iklan tersedia untuk semua pembeli dan penjual yang berpartisipasi dalam lelang di runtime pribadi. Gunakan laporan ini untuk memberikan informasi peluang iklan seperti ukuran iklan dan format iklan.
- Kolom sinyal per pembeli diteruskan ke pembeli tertentu untuk digunakan dalam proses bidding. Informasi ini diberikan oleh pembeli, dan Anda sebagai penjual harus mempertimbangkan cara mendapatkan informasi ini di perangkat agar dapat digunakan selama pemilihan iklan.
- Kolom sinyal penjual adalah cara terakhir bagi penjual untuk meneruskan informasi ke dalam proses. Anda sebagai penjual menggunakan sinyal ini saat menilai iklan dan memfilter iklan, seperti mengaktifkan pemeriksaan keamanan merek.
Pembeli: Bidding untuk slot iklan
Penyiapan dan prototipe
- Pembeli dapat menambahkan logika bidding ke fungsi JavaScript
generateBid()
yang ditayangkan dari parameterbiddingLogicUrl
yang ditetapkan saat mem-buildCustomAudience
. Anda dapat menyiapkan layanan tiruan menggunakan spesifikasi yang diberikan, atau menerapkan endpoint ini di server nyata. - Lihat panduan developer untuk mengetahui detail implementasi dan penggunaan API.
Pertimbangan desain
- Logika bidding dijalankan di perangkat, dan beberapa sinyal yang digunakan dalam lelang dikueri secara real time. Lihat daftar pembatasan untuk mengetahui batasan.
- Untuk beberapa kasus penggunaan iklan, Anda dianjurkan bekerja sama dengan penjual untuk memastikan bahwa Anda memiliki beberapa kandidat iklan dan bid mereka untuk dipertimbangkan di perangkat.
Logika bidding desain
Logika bidding pembeli harus diterapkan melalui JavaScript dan dijalankan
di perangkat. Panduan developer ini berisi informasi tanda tangan yang diperlukan
dan detail berbagai parameter yang diteruskan selama lelang. Logika
bidding Anda di perangkat memiliki akses ke informasi tambahan yang diteruskan sebagai parameter ke fungsi generateBid()
Anda.
Menyediakan data bidding
Sinyal bidding real-time dengan layanan nilai kunci
Sebagai pembeli, Anda dapat mengambil sinyal real-time selama lelang dari layanan
nilai kunci yang Anda miliki. Anda dapat menemukan implementasi awal layanan ini di
repositori Privacy Sandbox publik, atau membuat layanan
Anda sendiri. URL untuk layanan ini ditentukan sebagai trustedBiddingUrl
dalam
audiens kustom, dan platform akan mencoba mengambil data serta menyediakannya
untuk fungsi generateBid
dengan trusted_bidding_signals
parameter
. Anda harus membuat struktur kunci versi Anda sendiri.
Sinyal kontekstual dan pengguna
Fungsi generateBid
Anda memiliki akses ke sinyal pengguna tambahan saat menjalankan
lelang di perangkat. Sinyal ini akan diteruskan dengan kolom contextual_signals
dan per_buyer_signals
. Kolom ini berisi semua objek JSON dengan format
yang harus ditentukan oleh pembeli dan penjual.
Kolom contextual_signals
menyertakan informasi pengguna yang mungkin
relevan. Objek yang menyimpan sinyal ini dibuat oleh Protected Audience
sendiri dan diteruskan ke logika bidding Anda. Saat ini objek tersebut diteruskan sebagai objek kosong. Jika Anda yakin bahwa sinyal kontekstual tentang pengguna mungkin
relevan dengan kasus penggunaan Anda, berikan masukan untuk dipertimbangkan.
Kolom per_buyer_signals
disediakan untuk logika bidding Anda. Penjual
menetapkan nilai ini saat membuat konfigurasi lelang. Pembeli dan penjual
harus bekerja sama untuk memastikan data ini berada di perangkat dan diteruskan ke logika
bidding Anda. Beberapa contoh penggunaan untuk kolom ini meliputi:
- Pemfilteran untuk keamanan merek. Penjual dapat memberi tahu pembeli beberapa informasi klasifikasi tentang aplikasi yang meminta iklan, dan pembeli dapat menggunakan informasi ini untuk memfilter iklan tertentu.
- Mengirimkan sematan untuk model ML yang mempertimbangkan informasi kontekstual.
Penjual: Memberi skor dan memilih iklan pemenang
Penyiapan dan prototipe
- Penjual dapat menambahkan logika penskoran ke fungsi JavaScript
scoreAd()
yang disalurkan dari parameterscoringLogicUrl
yang ditetapkan saat mem-buildAdSelectionConfig
. Anda dapat menyiapkan layanan tiruan menggunakan spesifikasi yang diberikan, atau menerapkan endpoint ini di server nyata. - Lihat panduan developer untuk mengetahui detail implementasi dan penggunaan API.
Logika penskoran desain
Penjual menerapkan logika penskoran dalam JavaScript yang dijalankan di perangkat.
Panduan developer ini berisi informasi tanda tangan yang diperlukan dan detail
berbagai parameter yang diteruskan selama lelang. Selain itu, logika
penskoran di perangkat memiliki akses ke informasi tambahan yang diteruskan sebagai
parameter ke fungsi scoreAd
Anda.
Menyediakan data penskoran
Sinyal penilaian real-time dengan layanan nilai kunci
Sebagai penjual, Anda dapat mengambil sinyal real-time selama lelang dari layanan
nilai kunci yang Anda miliki. Anda dapat menemukan implementasi awal layanan ini di
repositori Privacy Sandbox publik. URL untuk layanan ini ditetapkan sebagai trustedScoringUri
dalam konfigurasi lelang, dan platform mencoba mengambil data serta menyediakannya untuk fungsi scoreAd
Anda melalui trusted_scoring_signals
. Anda harus membuat
struktur kunci versi Anda sendiri.
Sinyal kontekstual dan pengguna
Fungsi scoreAd
Anda memiliki akses ke sinyal pengguna tambahan saat menjalankan
lelang di perangkat. Sinyal ini diteruskan ke fungsi penilaian Anda melalui
kolom contextual_signal
. Kolom ini menyimpan objek JSON dengan format yang telah
ditentukan oleh pembeli dan penjual.
Kolom contextual_signal
menyertakan informasi kontekstual yang mungkin
relevan dengan pengguna. Objek yang menyimpan sinyal ini dibuat oleh
Protected Audience sendiri dan diteruskan ke logika penskoran Anda. Objek tersebut
diteruskan sebagai objek kosong. Jika Anda yakin bahwa sinyal tentang pengguna mungkin
relevan dengan kasus penggunaan Anda, berikan masukan untuk dipertimbangkan.
Penjual: Merender iklan
Penjual harus merender iklan pemenang. Lihat proposal desain untuk mengetahui detail tambahan terkait cara iklan pemenang dirender. Area ini masih dalam desain.
Melaporkan hasil tayangan
Penyiapan dan prototipe
- Pembeli dan penjual dapat menambahkan logika pelaporan ke fungsi JavaScript
reportWin()
yang ditayangkan dari parameterbiddingLogicUrl
atauscoringLogicUrl
. Anda dapat menyiapkan layanan tiruan menggunakan spesifikasi yang diberikan, atau menerapkan endpoint ini di server nyata. - Lihat panduan developer untuk mengetahui detail implementasi dan penggunaan API.
Pertimbangan desain
Pembeli dan penjual harus menerapkan fungsi reportWin
dalam kode JavaScript
yang ditampilkan dari endpoint yang telah dikonfigurasi. Metode ini memungkinkan Anda mengirim
data kembali ke server.
Privacy Sandbox juga menyediakan Attribution Reporting API untuk mengelola laporan tingkat dan gabungan peristiwa. Baca panduan integrasi untuk mengetahui detail selengkapnya.
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
- Panduan developer Protected Audience API di Android
- Mendukung penargetan audiens kustom dengan Protected Audience API
- Pembatasan frekuensi Protected Audience