Pemfilteran iklan instal aplikasi untuk Protected Audience

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 dalam daftar aplikasi yang diinstal di perangkat yang dikenal oleh teknologi iklan.

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 ada dalam daftar, dan hanya pembeli tersebut, untuk memfilter iklan berdasarkan status penginstalan aplikasi, secara langsung atau melalui SDK teknologi iklan mereka. Pendaftaran memberikan kontrol penuh pada developer aplikasi mereka terkait apakah aplikasi mereka harus berpartisipasi atau tidak dalam iklan instal aplikasi dan filter. 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 di 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. Filter Protected Audience iklan jika aplikasi yang ditentukan dalam pesan cocok dengan aplikasi di teknologi iklan pembeli daftar penginstalan aplikasi tertentu. 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 objek ContextualAd. Objek ini berisi eTLD+1 dari pembeli iklan, bid untuk iklan, URL yang mengarah ke logika pelaporan iklan, dan AdData yang berisi URL konten iklan yang sebenarnya, dan verifikasi tanda tangan milik pembeli (lihat penandatanganan iklan kontekstual untuk informasi selengkapnya spesifikasi pendukung. Perhatikan bahwa format AdData 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. Selanjutnya, nilai bid memutuskan untuk setiap iklan pemasaran ulang, dan pemasaran ulang dan iklan kontekstual diberi skor menggunakan fungsi scoreAds 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 Pengembang dengan petunjuk penerapan yang lebih detail akan dipublikasikan dalam waktu dekat.