Protected Audience: panduan integrasi

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:

  1. Pembeli membuat audiens kustom.
  2. Proses pemilihan iklan akan memilih iklan pemenang.
    1. Aplikasi penjual memulai pemilihan iklan.
    2. Layanan iklan menjalankan pemfilteran sisi beli dan kode bidding.
    3. Layanan iklan mengeksekusi kode keputusan sisi jual.
  3. Iklan pemenang dirender di aplikasi penjual.
  4. Laporan untuk tayangan iklan tersedia bagi pembeli dan penjual.

Diagram berikut menggambarkan langkah-langkah ini:

Diagram visual alur kerja pemilihan iklan.
Alur kerja pemilihan iklan dan pengelolaan audiens kustom Protected Audience.

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.
Panduan peluncuran fitur Protected Audience.

Memahami Protected Audience

Langkah pertama adalah memahami API dan layanan Protected Audience.

  1. Mulailah dengan membaca proposal desain untuk memahami Protected Audience API dan kemampuannya.
  2. 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.
  3. Mengirim masukan terkait desain dan penerapan API, layanan, dan dokumentasi Protected Audience.
  4. 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.

  1. Jika Anda sudah siap untuk memulai integrasi, siapkan lingkungan pengembangan dengan Pratinjau Developer Privacy Sandbox terbaru.
  2. Siapkan endpoint server yang diperlukan. Gunakan contoh tiruan dengan solusi pengujian API pilihan Anda untuk mem-bootstrap proses ini.
  3. 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 panggilan joinCustomAudience dan mengharapkan respons seperti daftar AdData 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 dari joinCustomAudience. 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 mengonfigurasi activation_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.
  • 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 mengonfigurasi activation_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:

  1. Penjual menentukan strategi mediasi.
  2. Penjual mengonfigurasi lelang dan memulai pemilihan iklan.
  3. Pembeli diundang untuk berpartisipasi dalam lelang melalui konfigurasi yang ditentukan penjual. Logika bidding pembeli dijalankan untuk memilih iklan dan bid kandidat.
  4. 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 menggunakan AdSelection API. Picu lelang dengan memanggil selectAds().
  • 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 parameter biddingLogicUrl yang ditetapkan saat mem-build CustomAudience. 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 parameter scoringLogicUrl yang ditetapkan saat mem-build AdSelectionConfig. 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 parameter biddingLogicUrl atau scoringLogicUrl. 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.