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 di Mintegral in un'app. Flutter
Integrazioni e formati degli annunci supportati
L' Ad Manager adattatore di mediazione per Mintegral offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | 1 |
| Cascata | 2 |
| Formati | |
| Apertura app | |
| Banner | |
| Interstitial | |
| Con premio | |
| Interstitial con premio | |
| Nativo | |
2 L'integrazione della struttura a cascata è in beta chiusa.
Requisiti
- SDK Google Mobile Ads più recente
- Flutter 3.7.0 o versioni successive
- Per eseguire il deployment su Android
- Livello API Android 21 o superiore
- 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 rimanente 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 è obbligatorio 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' Ad Manager interfaccia utente
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 Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti
Segui i passaggi descritti nelle impostazioni GDPR e nelle impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti 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'Mintegral SDK e dell'adattatore nel filepubspec.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,
estrae il file scaricato e aggiungi la cartella del plug-in estratta
(e i relativi contenuti) al 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 ottenere annunci di prova Mintegral per banner, annunci interstitial, annunci con premio e formati degli annunci 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
- Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.2.0.
1.1.0
- Compatibilità verificata con la versione 16.8.31.0 dell'adattatore Android di Mintegral.
- Compatibilità verificata con la versione 7.7.1.0 dell'adattatore Mintegral per iOS.
- Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.1.0.
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.