Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Mintegral tramite la mediazione, che tratta le integrazioni con struttura a cascata e Asta. 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.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione 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 per le offerte e la 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 il deployment su Android
- Livello API Android 21 o superiore
- Per 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 informazioni dettagliate, consulta la Guida introduttiva.
- Completare la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nella UI 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 Platform e compila la parte rimanente 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 il resto 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.
Dopo aver creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento.
Android
iOS
Fai clic sul menu a discesa 1 unità pubblicitaria 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 di asta.
Cascata
Per configurare l'ID unità pubblicitaria AdMob, hai bisogno della chiave API Mintegral Reporting. Vai ad Account > Strumenti API. Prendi nota di Skey e Secret.
Passaggio 2: configura la domanda di Mintegral nell' AdMob interfaccia utente
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Android
Per le istruzioni, consulta il passaggio 2 della guida per Android.
iOS
Per le istruzioni, consulta il passaggio 2 nella guida per iOS.
Aggiungi Mintegral all'elenco di partner pubblicitari relativi al GDPR e ai 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 l'ultima versione 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
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per AdMob
Per ottenere annunci di test Mintegral per banner, interstitial, annunci con premio e formati di annunci nativi, Mintegral consiglia di utilizzare le chiavi app, gli ID app, gli ID posizionamento e gli ID unità pubblicitaria forniti nella Pagina dell'ID test Mintegral.
Verifica annunci di prova
Per verificare di ricevere annunci di prova daMintegral, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Mintegral (Bidding) and Mintegral (Waterfall) origini annuncio.
Codici di errore
Se l'adattatore non riceve un annuncio da Mintegral, i publisher possono controllare l'errore sottostante della risposta dell'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 relativi messaggi generati dall'adattatore Mintegral quando non è possibile 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 Mintegral Flutter
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.