Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Mintegral utilizzando la mediazione, coprendo sia le integrazioni con la struttura a cascata sia quelle con le offerte. Descrive come aggiungere Mintegral alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Mintegral in un'app Flutter.
Integrazioni e formati degli annunci supportati
L'adattatore di Mediazione AdMob per Mintegral offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | |
Formati | |
Apertura app | 1 |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio | |
Nativo | 2 |
1 Le integrazioni di asta e struttura a cascata per il formato dell'annuncio apertura app sono in versione beta chiusa.
2 Le integrazioni dell'asta e della struttura a cascata per il formato dell'annuncio nativo sono in versione beta aperta.
Requisiti
- SDK Google Mobile Ads più recente
- Flutter 3.7.0 o versioni successive
- [Per le offerte]: per integrare tutti i formati di annunci supportati nelle offerte, utilizza il plug-in di mediazione Google Mobile Ads per Mintegral 1.4.0 o versioni successive (è consigliata la versione più recente)
- Per eseguire il deployment su Android
- Android API 21 o versioni successive
- Per eseguire il deployment su iOS
- Target di deployment iOS 12.0 o versioni successive
- Un progetto Flutter funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
- Completare la mediazione Guida introduttiva
Passaggio 1: configura le impostazioni nell'interfaccia utente di Mintegral
Registrati o accedi al tuo account Mintegral.
Individuare la chiave dell'app
Vai alla scheda Impostazioni app e prendi nota della chiave app.
Aggiungere una nuova applicazione
Nella scheda Impostazioni app, fai clic sul pulsante Aggiungi app.
Seleziona la piattaforma e compila il resto del modulo. Poi, fai clic su Salva.
Android

iOS

Prendi nota dell'ID app della tua applicazione.
Android

iOS

Creare un posizionamento dell'annuncio
Dopo aver creato l'applicazione, vai alla scheda Posizionamenti e unità e fai clic sul pulsante Aggiungi posizionamento come mostrato di seguito per creare il posizionamento dell'annuncio.
Android

iOS

Inserisci un nome del posizionamento e un formato dell'annuncio.
Offerte
Seleziona Offerte su intestazioni come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Cascata
Seleziona Tradizionale come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento.
Android

iOS

Fai clic sul menu a discesa 1 unità pubblicitarie e prendi nota dell'ID unità pubblicitaria.
Android

iOS

Individuare la chiave API dei report di Mintegral
Offerte
Questo passaggio non è necessario per le integrazioni delle offerte.
Cascata
Per configurare l'ID unità pubblicitaria AdMob, dovrai disporre della chiave API Mintegral Reporting. Vai ad Account > Strumenti API. Prendi nota di Skey e Secret.
Passaggio 2: configura la domanda di Mintegral nell'interfaccia utente di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Android
Per istruzioni, vedi il passaggio 2 della guida per Android.
iOS
Per istruzioni, vedi il passaggio 2 della guida per iOS.
Aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti
Segui i passaggi descritti nelle impostazioni relative ai regolamenti europei e nelle impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di AdMob.
Passaggio 3: importa l'SDK e l'adattatore Mintegral
Integrazione tramite pub.dev
Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore Mintegral nel file pubspec.yaml
del pacchetto:
dependencies:
gma_mediation_mintegral: ^1.0.0
Integrazione manuale
Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per
Mintegral,
estrai il file scaricato e aggiungi la cartella del plug-in estratta
(e i relativi contenuti) al tuo progetto Flutter. Poi, fai riferimento al plug-in nel
file pubspec.yaml
aggiungendo la seguente dipendenza:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
Passaggio 4: aggiungi il codice richiesto
Android
Non è necessario alcun codice aggiuntivo per l'integrazione di Mintegral.
iOS
Integrazione di SKAdNetwork
Segui la documentazione di Mintegral per aggiungere gli identificatori SKAdNetwork al file Info.plist
del progetto.
Passaggio 5: testa l'implementazione
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob.
Per ricevere annunci di prova Mintegral per formati di annunci banner, interstitial, con premio e nativi, Mintegral consiglia di utilizzare le chiavi dell'app, gli ID app, gli ID posizionamento e gli ID unità pubblicitarie forniti nella pagina ID test Mintegral.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova da Mintegral, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Mintegral (asta) e Mintegral (struttura a cascata).
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Mintegral, i publisher possono controllare l'errore di fondo della risposta all'annuncio utilizzando
ResponseInfo
nelle seguenti classi:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Mintegral quando non riesce a caricare un annuncio:
Android
Codice di errore | Dominio | Motivo |
---|---|---|
101 | com.google.ads.mediation.mintegral | Parametri del server non validi (ad es. ID app o ID posizionamento mancante). |
102 | com.google.ads.mediation.mintegral | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da Mintegral. |
103 | com.google.ads.mediation.mintegral | Risposta all'offerta mancante o non valida. |
104 | com.google.ads.mediation.mintegral | L'SDK Mintegral ha restituito un errore di mancato riempimento. |
iOS
Codice di errore | Dominio | Motivo |
---|---|---|
101 | com.google.mediation.mintegral | Parametri del server non validi (ad es. ID app o ID posizionamento mancante). |
102 | com.google.mediation.mintegral | L'SDK Mintegral ha restituito un errore di mancato riempimento. |
103 | com.google.mediation.mintegral | L'SDK Mintegral non è riuscito a mostrare un annuncio. |
104 | com.google.mediation.mintegral | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da Mintegral. |
Log delle modifiche dell'adattatore di mediazione Flutter Mintegral
Versione successiva
- Il plug-in per iOS è ora un framework statico.
- Compatibilità verificata con la versione 16.8.61.0 dell'adattatore Android di Mintegral.
- Compatibilità verificata con l'adattatore per iOS di Mintegral versione 7.7.5.0.
- Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.3.1.
1.0.0
- Lancio iniziale.
- Compatibilità verificata con la versione 16.7.21.0 dell'adattatore Android di Mintegral.
- Compatibilità verificata con l'adattatore iOS di Mintegral versione 7.6.3.0.
- Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.1.0.