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 questo formato. formato dell'annuncio nella tua app:
- Annunci banner
- Annunci interstitial
- Annunci nativi
- Annunci con premio
- Interstitial con premio Google Ads
Non hai mai utilizzato la mediazione? Letto Introduzione alla mediazione.
Inizializzare l'SDK Mobile Ads
La guida rapida illustra come inizializzare gli annunci per cellulari l'SDK. Durante la chiamata di inizializzazione, anche gli adattatori di mediazione vengono inizializzati. È importante attendere il completamento dell'inizializzazione prima di si caricano gli annunci per garantire la piena partecipazione di ogni rete pubblicitaria la prima richiesta di annuncio.
Il seguente codice campione mostra come controllare l'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
, in modo da poter utilizzare il
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 ad Android
progetti iOS e Android. Puoi aggiungerli aggiornando il livello della tua app build.gradle
su Android e Podfile
su iOS. Google dispone di adattatori open source in GitHub
per entrambi
Android
e
iOS.
Consulta le Android e iOS documentazione di ciascuna rete partner per ottenere indicazioni dettagliate su come aggiungere l'adattatore nella tua app.
Verificare quale classe dell'adattatore di rete pubblicitaria ha caricato l'annuncio
Il codice di esempio riportato di seguito 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 interfacce utente delle origini annuncio di terze parti per l'annuncio banner unità utilizzate nella mediazione. In questo modo doppio aggiornamento poiché anche Ad Manager attiva 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 considerare per l'implementazione di annunci nativi della mediazione.
- Norme relative alla presentazione degli annunci nativi
- Ogni rete pubblicitaria ha le proprie norme. Quando si utilizza la mediazione, è importante ricorda che la tua app deve comunque rispettare le norme dei contenuti che ha fornito l'annuncio.
Leggi statali sulla privacy degli Stati Uniti e GDPR
Se devi rispettare le norme privacy degli stati leggi o sulla protezione dei dati generali Regolamento (GDPR), segui le passaggi nelle normative statali degli Stati Uniti impostazioni o GDPR impostazioni per aggiungere partner di mediazione in Privacy e dei messaggi Elenco degli stati USA o dei partner pubblicitari ai sensi del GDPR. Se non lo fai, i partner potrebbero non pubblicare annunci nella tua app.
Scopri di più sull'attivazione del trattamento dati limitato (RDP) e ottenere il GDPR Consenso con la Google User Messaging Platform (UMP) l'SDK.