Configura la mediazione

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Questa guida mostra come integrare un adattatore di mediazione con la tua app per Android.

Prerequisiti

Prima di poter integrare la mediazione per un formato dell'annuncio, devi integrare questo formato nell'app:

Non hai mai utilizzato la mediazione? Leggi l'introduzione alla mediazione.

Per le offerte: Google Mobile Ads SDK (Legacy) 18.3.0 o versioni successive.

Inizializza Google Mobile Ads SDK (Legacy)

La guida rapida mostra come inizializzare Google Mobile Ads SDK (Legacy). Durante la chiamata di inizializzazione, vengono inizializzati anche gli adattatori di mediazione. È importante attendere il completamento dell'inizializzazione prima di caricare gli annunci per verificare la piena partecipazione di ogni rete pubblicitaria alla prima richiesta di annuncio.

Il seguente codice campione mostra come controllare lo stato di inizializzazione di ogni adattatore prima di effettuare una richiesta di annuncio.

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

Controlla quale classe di adattatore della rete pubblicitaria ha caricato l'annuncio

Di seguito è riportato un codice campione che registra il nome della classe della rete pubblicitaria per un annuncio banner:

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)

Per informazioni dettagliate su questo metodo, consulta la documentazione di ResponseInfo su getMediationAdapterClassName().

Inizializza l'oggetto annuncio con un'istanza Activity

Nel costruttore di un nuovo oggetto annuncio (ad esempio, AdManagerAdView), devi passare un oggetto di tipo Context. Questo Context viene trasmesso ad altre reti pubblicitarie quando utilizzi la mediazione. Alcune reti pubblicitarie richiedono un Context più restrittivo di tipo Activity e potrebbero non essere in grado di pubblicare annunci senza un'istanza Activity. Pertanto, ti consigliamo di passare un'istanza Activity durante l'inizializzazione degli oggetti annuncio per verificare un'esperienza coerente con le tue reti pubblicitarie di mediazione.

Assicurati di disattivare l'aggiornamento in tutte le UI delle origini annuncio di terze parti per le unità pubblicitarie banner utilizzate nella mediazione. In questo modo, si evita un doppio aggiornamento, poiché anche Ad Manager attiva un aggiornamento in base alla frequenza di aggiornamento dell'unità pubblicitaria banner.

Utilizza gli annunci nativi con la mediazione

Di seguito sono riportate alcune best practice da tenere in considerazione quando implementi la mediazione nativa.

Norme sulla presentazione degli annunci nativi
Ogni rete pubblicitaria ha le proprie norme. Quando utilizzi la mediazione, è importante ricordare che la tua app deve comunque rispettare le norme della rete di mediazione che ha fornito l'annuncio.
Utilizza loadAd() anziché loadAds()
Il metodo loadAds() pubblica solo annunci Google. Per gli annunci con mediazione, utilizza invece loadAd().

Leggi statali sulla privacy degli Stati Uniti e GDPR

Se devi rispettare le leggi statali sulla privacy degli Stati Uniti o il Regolamento generale sulla protezione dei dati (GDPR), segui i passaggi descritti nelle impostazioni relative alle normative degli stati USA o nelle impostazioni GDPR per aggiungere i tuoi partner di mediazione all'elenco dei partner pubblicitari per gli stati USA o il GDPR nella sezione Privacy e messaggi di Ad Manager. In caso contrario, i partner potrebbero non riuscire a pubblicare annunci nella tua app.

Scopri di più su come attivare il trattamento dati limitato (RDP) e ottenere il consenso GDPR con l'SDK Google User Messaging Platform (UMP).

Avanti
Scegliere le origini annuncio