Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Mintegral utilizzando la mediazione, coprendo le integrazioni sia con struttura a cascata che con asta. Viene spiegato come aggiungere Mintegral alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK Mintegral in un'app Flutter .
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per Mintegral ha le seguenti funzionalità:
Integrazione | ||
---|---|---|
Offerte | 1 | |
Struttura a cascata | 2 | |
Formati | ||
Apertura app | 1 2 | |
Banner | ||
Interstitial | ||
Con premio | ||
Interstitial con premio | ||
Nativo | 1 3 |
1 L'integrazione delle offerte per questo formato è in versione beta chiusa.
2 L'integrazione con struttura a cascata per questo formato è in versione beta chiusa.
3 L'integrazione con struttura a cascata per questo formato è in versione beta aperta.
Requisiti
- Versione più recente dell'SDK Google Mobile Ads
- 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 per iOS 12.0 o versioni successive
- Un progetto Flutter funzionante configurato con l'SDK Google Mobile Ads. Consulta la guida introduttiva per i dettagli.
- Completa 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.
Aggiungi una nuova applicazione
Dalla 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
Crea un posizionamento dell'annuncio
Una volta creata l'applicazione, accedi 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 posizionamento e un Formato annuncio.
Offerte
Seleziona Header Bidding come Tipo di offerta. Compila il resto del modulo e fai clic su Salva.
Struttura a 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 Mintegral Reporting
Offerte
Questo passaggio non è obbligatorio per le integrazioni dell'asta.
Struttura a cascata
Per configurare l'AdMob ID unità pubblicitaria, avrai bisogno della tua chiave API Mintegral Reporting. Vai ad Account > Strumenti API. Prendi nota della tua Skey e del 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 ai sensi delle normative GDPR e degli stati USA
Segui i passaggi descritti in Impostazioni GDPR e Impostazioni relative alle normative statali degli Stati Uniti per aggiungere Mintegral all'elenco di partner pubblicitari per le normative GDPR e statali degli Stati Uniti nell' AdMob UI.
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 file pubspec.yaml
del tuo pacchetto:
dependencies:
gma_mediation_mintegral: ^1.0.0
Integrazione manuale
Scarica la versione più recente del plug-in di mediazione di Google Mobile Ads per Mintegral, estrai il file scaricato e aggiungi la cartella del plug-in estratta (e i relativi contenuti) al progetto Flutter. Quindi, 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 codice aggiuntivo per l'integrazione con 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 dalla risposta di 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 viene caricato 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 per la mediazione Flutter Mintegral
1.0.0
- Release iniziale.
- Compatibilità verificata con l'adattatore Android Mintegral versione 16.7.21.0.
- Compatibilità verificata con l'adattatore iOS Mintegral versione 7.6.3.0.
- Costruito e testato con il Google Mobile Ads Flutter Plugin versione 5.1.0.