Gli indicatori sicuri sono dati codificati raccolti sul dispositivo client e condivisi con offerenti selezionati. Questa guida mostra come raccogliere e inviare indicatori sicuri a Google Ad Manager utilizzando l'SDK IMA.
L'API Secure Signals richiede la versione 3.29.0 o successive dell'SDK IMA per Android.
Per selezionare gli indicatori e gli offerenti e attivare la condivisione di indicatori sicuri, consulta Condividere indicatori sicuri con gli offerenti.
Utilizzare un fornitore di indicatori di terze parti
Per utilizzare gli indicatori sicuri, devi implementare una classe adattatore per la raccolta degli indicatori nella tua app per raccogliere gli indicatori, codificarli e trasmetterli all'SDK IMA.
Segui le istruzioni del fornitore di terze parti per configurare un account, aggiungere le dipendenze di build, e configurare l'adattatore dei segnali sicuri nella tua app.
L'SDK IMA per Android inizializza automaticamente ogni adattatore di indicatori sicuri, senza ulteriori modifiche al codice.
Ecco un esempio di come potresti aggiungere un adattatore di indicatori sicuri al tuo progetto:
Inviare dati personalizzati
Oltre a utilizzare un fornitore di segnali di terze parti, puoi anche raccogliere, codificare e inviare segnali con dati personalizzati. Prima di poter inviare indicatori sicuri con dati personalizzati, devi attivare gli indicatori personalizzati in Ad Manager.
Per ogni richiesta di annuncio,
crea un oggetto SecureSignals contenente i tuoi dati personalizzati codificati, come
stringa. Quindi, aggiungi l'oggetto SecureSignals alla tua
richiesta di annuncio
chiamando il
metodo adsRequest.setSecureSignals():
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);
}
...