Implementazione della segmentazione chiave-valore

Seleziona la piattaforma: Android iOS Unity Android (legacy)

La segmentazione delle coppie chiave-valore ti consente di definire il targeting personalizzato per segmentare gli utenti tramite una richiesta di annuncio. Per informazioni dettagliate sulla segmentazione delle coppie chiave-valore, ad esempio l'aggiunta di una coppia chiave-valore nell'interfaccia utente AdMob, vedi Aggiungere la segmentazione delle coppie chiave-valore a un gruppo di mediazione.

Questa pagina ti guida nell'implementazione della segmentazione chiave-valore durante la configurazione di una richiesta di annuncio utilizzando l'SDK Google Mobile Ads per Android.

Prima di iniziare

Per configurare la segmentazione delle coppie chiave-valore nella tua app, devi prima aggiungere la segmentazione delle coppie chiave-valore a un gruppo di mediazione.

Allegare coppie chiave-valore a una richiesta di annuncio

Dopo aver configurato le coppie chiave-valore personalizzate nell'interfaccia utente AdMob, collega le coppie a una richiesta di annuncio nella tua applicazione.

Per allegare le coppie chiave-valore a una richiesta di annuncio, chiama addCustomTargeting() con la chiave e il valore.

I seguenti segmenti di esempio suddividono gli utenti in base alla durata in un'app:

Kotlin

val daysInApp = 1
val request = AdRequest.Builder()
  .addCustomTargeting("USER_DURATION", if (daysInApp < 3) "NEW" else "MATURE")
  .build()

Java

int daysInApp = 1;
AdRequest request = new AdRequest.Builder()
    .addCustomTargeting("USER_DURATION", (daysInApp < 3) ? "NEW" : "MATURE")
    .build();

Testare la configurazione della segmentazione delle coppie chiave-valore

Per testare l'implementazione su coppie chiave-valore personalizzate, invia una richiesta di annuncio e controlla l'oggetto response info. Verifica che il valore del campo mediation_group_name corrisponda al nome del gruppo di mediazione previsto.

L'esempio seguente verifica il nome di un gruppo di mediazione nella risposta all'annuncio:

{
  "Response ID": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "Response Extras": {
    "mediation_group_name": "Mediation group for new users"
  }
}