Mediazione

Questa guida mostra come integrare un adattatore di mediazione con l'app Flutter.

Prerequisiti

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

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

Inizializzare l'SDK Mobile Ads

La guida rapida illustra come inizializzare l'SDK Mobile Ads. Durante la chiamata di inizializzazione, anche gli adattatori di mediazione vengono inizializzati. È 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 codice di esempio riportato di seguito mostra come controllare lo stato di inizializzazione di ogni adattatore prima di effettuare una richiesta di annuncio.

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

Aggiornare 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
}

Aggiungi dipendenze per le reti partner

Gli adattatori di mediazione e le loro dipendenze devono essere aggiunti ai progetti Android e iOS. Puoi aggiungerli aggiornando il file build.gradle a livello di app su Android e Podfile su iOS. Google dispone di adattatori open source in GitHub per Android e iOS.

Consulta la documentazione Android e iOS per ogni rete partner per indicazioni dettagliate su come aggiungere l'adattatore nell'app.

Controllare quale classe dell'adattatore di rete pubblicitaria ha caricato l'annuncio

Il seguente codice di esempio illustra 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 interfacce utente 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 basato sulla frequenza di aggiornamento dell'unità pubblicitaria banner.

Utilizzare gli annunci nativi con la mediazione

Di seguito sono riportate alcune best practice da considerare durante l'implementazione della 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 dei regolamenti statali degli Stati Uniti o nelle impostazioni GDPR per aggiungere i tuoi partner di mediazione all'elenco dei partner pubblicitari degli stati USA o GDPR di Ad Manager. In caso contrario, i partner potrebbero non pubblicare annunci sulla tua app.

Scopri di più sull'attivazione del trattamento dati limitato (RDP) e sull'ottenimento del consenso GDPR con l'SDK Google User Messaging Platform (UMP).
Avanti
Scegli le reti