Mediazione

Questa guida mostra come integrare un'app di mediazione con la tua app Flutter.

Prerequisiti

Prima di poter integrare la mediazione per un formato dell'annuncio, devi integrare il formato dell'annuncio nella tua app:

• Annunci banner
• Annunci interstitial
• Annunci nativi
• Annunci con premio
• Annunci interstitial con premio

Non hai mai utilizzato la mediazione? Leggi Introduzione alla mediazione.

Inizializza l'SDK Mobile Ads

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

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Aggiorna le impostazioni di Gradle (solo Android)

Aggiungi le seguenti righe al file settings.gradle per poter utilizzare le API Android del plug-in:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

Aggiungere dipendenze per le emittenti partner

Gli adattatori di mediazione e le relative dipendenze devono essere aggiunti ai progetti Android e iOS. Possono essere aggiunti aggiornando il file build.gradle a livello di app su Android e Podfile su iOS. Google ha adattatori open source su GitHub sia per Android sia per iOS.

Consulta la documentazione di Android eiOS per ogni emittente partner per indicazioni dettagliate su come aggiungere il relativo adattatore nella tua app.

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

Il seguente codice di esempio mostra come registrare il nome della classe della rete pubblicitaria per un annuncio banner:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Utilizzare gli annunci banner con la 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 viene evitato 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 presenti quando si implementa la mediazione nativa.

Norme relative alla 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 mediata che ha fornito l'annuncio.

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 relative al GDPR per aggiungere i tuoi partner di mediazione nell'elenco dei partner pubblicitari per gli stati USA o per il GDPR in Privacy e messaggi di Ad Manager. In caso contrario, i partner potrebbero non pubblicare annunci nella tua app.