Configurare la mediazione

Seleziona la piattaforma: Android (beta) Nuovo Android iOS Unity Flutter

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 il formato dell'annuncio nella tua app:

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

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

Inizializzare Google Mobile Ads SDK

La guida rapida mostra come inizializzare Google Mobile Ads SDK. 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 partecipazione completa di ogni rete pubblicitaria alla prima richiesta di annunci.

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()));
  }
}
MediationSnippets.java

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",
    )
  }
}

MediationSnippets.kt

Controllare la classe dell'adattatore della rete pubblicitaria che ha caricato l'annuncio

Ecco 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);
ResponseInfoSnippets.java

Kotlin

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

Per i dettagli su questo metodo, consulta la documentazione di ResponseInfo su getMediationAdapterClassName().

Inizializzare l'oggetto annuncio con un'istanza di Activity

Nel costruttore di un nuovo oggetto annuncio (ad esempio, AdManagerAdView), devi passare un oggetto di tipo Context. Questo Context viene passato ad altre reti pubblicitarie quando si utilizza 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 di Activity. Pertanto, ti consigliamo di passare un'istanza di Activity quando inizializzi gli oggetti annuncio per verificare un'esperienza coerente con le 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é Ad Manager attiva anche un aggiornamento in base alla frequenza di aggiornamento dell'unità pubblicitaria banner.

Utilizzare gli annunci nativi con la mediazione

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

Norme di 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.
Utilizzare loadAd() anziché loadAds()
Il metodo loadAds() pubblica solo annunci Google. Per gli annunci di mediazione, utilizza invece loadAd().

Leggi statali sulla privacy degli Stati Uniti e GDPR

Se devi rispettare le leggi sulla privacy degli stati USA o il Regolamento generale sulla protezione dei dati (GDPR), segui i passaggi descritti in Impostazioni delle normative degli stati USA o Impostazioni GDPR per aggiungere i partner di mediazione all'elenco dei partner pubblicitari degli stati USA o GDPR di Privacy e messaggi di Ad Manager. In caso contrario, i partner potrebbero non pubblicare annunci sulla 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