Sinyal aman adalah data yang dienkode yang dikumpulkan di perangkat klien dan dibagikan kepada bidder tertentu. Panduan ini menunjukkan cara mengumpulkan dan mengirim sinyal aman ke Google Ad Manager menggunakan IMA SDK.
Secure Signals API memerlukan IMA SDK for Android versi 3.29.0 atau yang lebih tinggi.
Untuk memilih sinyal dan bidder, serta mengaktifkan berbagi sinyal aman, lihat Membagikan sinyal aman kepada bidder.
Menggunakan penyedia sinyal pihak ketiga
Untuk menggunakan sinyal aman, Anda harus men-deploy class adaptor kolektor sinyal di aplikasi untuk mengumpulkan sinyal, mengenkodenya, dan meneruskannya ke IMA SDK.
Ikuti petunjuk penyedia pihak ketiga untuk menyiapkan akun dengan mereka, menambahkan dependensi build, dan menyiapkan adaptor sinyal aman mereka di aplikasi Anda.
IMA SDK untuk Android otomatis melakukan inisialisasi setiap adaptor sinyal aman, tanpa perubahan tambahan pada kode Anda.
Berikut adalah contoh cara menambahkan adaptor sinyal aman ke project Anda:
Mengirim data kustom
Selain menggunakan penyedia sinyal pihak ketiga, Anda juga dapat mengumpulkan, mengenkode, dan mengirim sinyal dengan data kustom. Sebelum dapat mengirim sinyal aman dengan data kustom, Anda harus mengaktifkan sinyal kustom di Ad Manager.
Untuk setiap permintaan iklan, buat objek SecureSignals yang berisi data kustom
yang dienkode, sebagai string. Kemudian, tambahkan objek SecureSignals ke permintaan
iklan Anda dengan memanggil adsRequest.setSecureSignals().
Berikut adalah contoh java:
app/src/main/java/com/example/project name/MainActivity.java
...
private void requestAds(String adTagUrl) {
// Create the ads request.
AdsRequest request = sdkFactory.createAdsRequest();
request.setAdTagUrl(adTagUrl);
request.setContentProgressProvider(
() -> {
if (videoPlayer.getDuration() <= 0) {
return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
}
return new VideoProgressUpdate(
videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
});
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
adsLoader.requestAds(request);
}
...