Penginstalan aplikasi seluler baru biasanya disebabkan oleh adanya iklan instal aplikasi. Untuk memaksimalkan ROI pembelanjaan iklan, sebaiknya jangan tampilkan iklan untuk menginstal aplikasi di perangkat yang telah menginstal aplikasi yang sama. Dalam proposal ini, kami menyebut praktik ini sebagai "pemfilteran iklan instal aplikasi".
Proposal ini memperkenalkan cara Protected Audience di Android mendukung pemfilteran iklan kontekstual, khususnya pemfilteran iklan instal aplikasi, dengan cara yang menjaga privasi. Untuk berpartisipasi, aplikasi di perangkat harus secara eksplisit memilih ikut serta dalam pemfilteran iklan instal aplikasi. Selama pemilihan iklan, kandidat iklan difilter berdasarkan daftar aplikasi yang diinstal di perangkat yang dikenal sebagai teknologi iklan atau adtech.
Daftar aplikasi terinstal hanya terlihat dalam alur pemilihan iklan, dan mengandalkan platform sisi beli untuk menandakan bahwa iklan tertentu harus difilter berdasarkan keberadaan aplikasi di perangkat.
Untuk menyiapkan pemfilteran iklan instal aplikasi, ikuti langkah-langkah berikut:
Langkah 1: Daftarkan aplikasi untuk pemfilteran iklan instal aplikasi
Untuk ikut serta dalam pemfilteran iklan instal aplikasi, developer aplikasi memanggil
API pendaftaran aplikasi registerForAdFiltering
dari aplikasi mereka, atau SDK teknologi iklan,
dengan daftar eTLD+1 pembeli teknologi iklan. Hal ini memungkinkan pembeli dalam daftar, dan
hanya pembeli tersebut, memfilter iklan berdasarkan status penginstalan aplikasi, baik
secara langsung atau melalui SDK teknologi iklan mereka. Pendaftaran memberikan kontrol penuh kepada
developer aplikasi terhadap apakah aplikasi mereka harus berpartisipasi atau tidak dalam pemfilteran
iklan instal aplikasi.
java
void registerForAdFiltering(List<AdTechIdentifier> buyers);
Langkah 2: Minta untuk mengecualikan iklan instal aplikasi
Saat iklan dipertimbangkan untuk bidding, pembeli dapat memilih untuk menandai iklan agar dikecualikan berdasarkan status penginstalan aplikasi. Hal ini dilakukan dengan menyertakan nama paket aplikasi dalam metadata iklan. Permintaan pemfilteran iklan instal aplikasi adalah bagian dari data iklan yang dimasukkan ke dalam proses lelang Protected Audience. Data iklan ini dibuat secara berbeda berdasarkan apakah iklan tersebut adalah iklan kontekstual atau pemasaran ulang.
- Untuk kasus penggunaan iklan kontekstual, yang merupakan kasus penggunaan utama untuk pemfilteran iklan instal aplikasi, informasi pemfilteran disertakan sebagai bagian dari data iklan yang dapat diberikan pembeli kepada penjual saat merespons bid kontekstual di luar Protected Audience. Protected Audience mengharapkan informasi pemfilteran ditampilkan sebagai bagian dari respons kontekstual, sama seperti metadata khusus iklan lainnya.
- Untuk kasus penggunaan pemasaran ulang, Protected Audience mengharapkan informasi
pemfilteran disertakan dalam audiens kustom. Ada 2 peluang terjadinya
penyertaan ini: saat bergabung dengan audiens dan saat mengambil data
audiens baru sebagai bagian dari proses pembaruan audiens.
Permintaan untuk mengecualikan iklan instal aplikasi akan terlihat seperti berikut dalam
objek JSON
AdData
:json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }
Langkah 3: Kecualikan iklan instal aplikasi selama pemilihan iklan
Selama permintaan iklan, pembeli dapat meneruskan beberapa iklan kembali ke penjual dengan
informasi pemfilteran sehingga iklan untuk aplikasi terinstal dapat dikecualikan. Sisi
jual diperlukan untuk meneruskan informasi pemfilteran sebagai bagian dari
konfigurasi fungsi selectAds
di kolom adData
. Android mengharapkan
format pesan yang mirip dengan yang di bawah ini.
AdData myAdData = new AdData.Builder()
.setRenderUri(Uri.parse("https://.."))
.setMetadata("{...}")
.setFilters(new AdFilters.Builder()
.setAppInstalledFilter(new AppInstalledFilter.Builder()
.setPackageNames(ImmutableList.of("app1.package", "app2.package"))
.build())
.build())
.build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
.setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
.setDecisionLogicUri(Uri.parse("https://..."))
...
.setContextualAds(ImmutableList.of(new ContextualAd.Builder()
.setBuyer(AdTechIdentifier.fromString("example.com"))
.setReportingUri("https://example.com/reporting")
.setBid(20)
// myAdData could be taken from the JSON above
.setAd(myAdData)
.build()))
.build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);
Pemfilteran diproses dalam selectAds
API. Protected Audience mengecualikan
iklan jika aplikasi yang ditentukan dalam pesan cocok dengan aplikasi dalam daftar penginstalan aplikasi
khusus pembeli teknologi iklan. Ada dua hasil yang memungkinkan:
- Aplikasi tidak ditemukan dalam daftar ini, yang berarti bahwa aplikasi tidak diinstal dan dibuka.
- Aplikasi ditemukan dalam daftar ini, yang berarti bahwa aplikasi telah diinstal dan dibuka.
Jika Protected Audience mendeteksi bahwa aplikasi sudah ada, iklan akan
dikecualikan dari daftar iklan yang digunakan lelang untuk menjalankan
scoreAds
.
Pertimbangan saat iklan kontekstual terlibat
Dengan pemfilteran iklan instal aplikasi, Protected Audience API mulai mendukung pemfilteran iklan kontekstual. Beberapa hal penting untuk ditentukan dalam situasi ketika lelang adalah campuran iklan kontekstual dan pemasaran ulang, atau sepenuhnya terdiri dari iklan kontekstual.
- Saat lelang
selectAd
dijalankan, pembeli memiliki opsi untuk meneruskan daftar objekContextualAd
. Objek ini berisi eTLD+1 pembeli iklan, bid untuk iklan, URL yang mengarah ke logika pelaporan untuk iklan, danAdData
yang berisi URL konten iklan yang sebenarnya, serta tanda tangan verifikasi milik pembeli (lihat penandatanganan iklan kontekstual untuk detail selengkapnya). Perhatikan bahwa formatAdData
digunakan dalam iklan kontekstual dan iklan pemasaran ulang. - Pada awal proses lelang, iklan kontekstual dan pemasaran ulang
difilter menggunakan kumpulan nama paket yang ditentukan yang disertakan dalam
AdData.adFilters.appInstallFilters.packageNames
. Kemudian, nilai bid ditentukan untuk semua iklan pemasaran ulang, dan iklan pemasaran ulang serta iklan kontekstual diberi skor menggunakan fungsiscoreAds
yang disediakan. Iklan dengan skor tertinggi akan menang. Perhatikan bahwa proses ini akan berfungsi meskipun iklan pemasaran ulang tidak ada. Jika iklan kontekstual memenangkan lelang dan pelaporan tayangan dipicu oleh aplikasi, Protected Audience akan mendownload dan menjalankan fungsi JS bernama
reportWin()
dari URL pelaporan yang disertakan dalam data iklan kontekstual. Hal ini mirip dengan cara pelaporan yang dilakukan untuk iklan pemasaran ulang yang memenangkan lelang.Contoh fungsi pelaporan JavaScript:
function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer, contextual_signals) { let reporting_address = 'https://reporting.example.com'; return {'status': 0, 'results': {'reporting_uri': reporting_address + '?some_signal=' + per_buyer_signals.some_signal} }; }
Penandatanganan iklan kontekstual
Iklan kontekstual yang menyertakan pemfilteran penginstalan aplikasi harus ditandatangani oleh pembeli. Platform menggunakan tanda tangan ini untuk memverifikasi teknologi iklan yang menyediakan iklan dan filter penginstalan aplikasi teknologi iklan yang akan diterapkan ke iklan. Hal ini dilakukan untuk mencegah teknologi iklan berbahaya menggunakan identitas teknologi iklan lain untuk mendapatkan manfaat dari pendaftaran pemfilteran penginstalan aplikasi teknologi iklan lain.
Privacy Sandbox akan mengambil kunci ini dari endpoint teknologi iklan yang disediakan selama pendaftaran. Sebagai praktik terbaik, sebaiknya kunci harus sering diperbarui, tetapi tidak lebih dari setiap 6 bulan.
Privacy Sandbox akan meminta teknologi iklan untuk mengonfirmasi ketersediaan endpoint yang disediakan teknologi iklan selama proses pendaftaran. Untuk detail selengkapnya tentang tindakan yang diperlukan oleh teknologi iklan saat ini dan yang baru didaftarkan, lihat Petunjuk pendaftaran.
Panduan Developer yang berisi petunjuk penerapan yang lebih mendetail akan dipublikasikan dalam waktu dekat.
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
- Panduan developer Protected Audience API di Android
- Catatan rilis
- Mendukung penargetan audiens kustom dengan Protected Audience API