Inizia a utilizzare gli indicatori sicuri

Seleziona la piattaforma: HTML5 Android iOS tvOS

Gli indicatori sicuri sono dati codificati raccolti sul dispositivo client e condivisi con offerenti selezionati. Questa guida spiega come raccogliere e inviare indicatori sicuri a Google Ad Manager utilizzando l'SDK IMA.

L'API indicatori sicuri richiede la versione 3.29.0 o successive dell'SDK IMA per Android.

Per selezionare indicatori e offerenti e attivare la condivisione degli indicatori sicuri, consulta Condividere indicatori sicuri con gli offerenti.

Utilizzare un provider di indicatori di terze parti

Per utilizzare gli indicatori sicuri, devi implementare una classe di adattatore dell'agente di raccolta di indicatori nella tua app per raccogliere gli indicatori, codificarli e passarli all'SDK IMA.

Segui le istruzioni del provider di terze parti per configurare un account, aggiungere dipendenze di build, e configurare l'adattatore di indicatori 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 provider di indicatori di terze parti, puoi anche raccogliere, codificare e inviare indicatori con dati personalizzati. Prima di poter inviare indicatori sicuri con dati personalizzati, devi attivare gli indicatori personalizzati in Ad Manager.

Per ogni richiesta di stream, segui questi passaggi:

1. Crea un oggetto SecureSignals contenente i dati personalizzati codificati, come stringa.
2. Aggiungi l'oggetto SecureSignals alla tua richiesta di stream chiamando il streamRequest.setSecureSignals() metodo:

app/src/main/java/com/example/project name/SampleAdsWrapper.java

 public void requestAndPlayAds() {
    adsLoader.addAdErrorListener(this);
    adsLoader.addAdsLoadedListener(this);
    StreamRequest request = buildStreamRequest();
    SecureSignals signal = SecureSignals.create("My encoded signal string");
    request.setSecureSignals(signal);
    request.setFormat(StreamFormat.HLS);
    adsLoader.requestStream(request);
  }