Questa guida mostra come utilizzare Google Mobile Ads Flutter Plugin per caricare e visualizzare gli annunci di Moloco utilizzando la mediazione, incluse le integrazioni delle offerte. Descrive come aggiungere Moloco alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Moloco in un'app Flutter.
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione di Ad Manager per Moloco ha le seguenti funzionalità:
| Integrazione | |
|---|---|
| Asta | |
| Cascata | |
| Formati | |
| Apertura app | |
| Banner | |
| Interstitial | |
| Con premio | |
| Interstitial con premio | |
| Nativo | |
Requisiti
- Ultimo Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 o versioni successive
- Per il deployment su Android
- Livello API Android 23 o versioni successive
- Per il deployment su iOS
- Target di deployment iOS 13.0 o versioni successive
- Un progetto Flutter funzionante configurato con Google Mobile Ads Flutter Plugin. Per maggiori dettagli, consulta Configurare Google Mobile Ads Flutter Plugin.
- Configurare la mediazione
Passaggio 1: configura le impostazioni nell'interfaccia utente di Moloco
Accedi al Portale dei publisher di Moloco.
Vai alla scheda Panoramica > App e fai clic sul pulsante Aggiungi app per creare una nuova app.
Seleziona il sistema operativo e le impostazioni sulla privacy per la tua app, compila il resto del modulo e fai clic su Crea.
Android
iOS
Una volta creata l'app, selezionala dalla scheda App per visualizzarne i dettagli e prendere nota della chiave dell'app.
Android
iOS
Vai alla scheda Panoramica > Unità pubblicitarie , seleziona l'app dal menu a discesa e fai clic su Nuova unità pubblicitaria.
Seleziona Offerte in-app come metodo di asta e compila il resto del modulo. Poi fai clic su Crea.
Vai all'unità pubblicitaria appena creata nella scheda Unità pubblicitarie per visualizzarne i dettagli. Prendi nota dell'ID unità pubblicitaria.
Passaggio 2: configura la domanda di Moloco nell'interfaccia utente di Ad Manager
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.
Aggiungi Moloco Ads all'elenco dei partner pubblicitari per i regolamenti GDPR e statali degli Stati Uniti
Segui i passaggi descritti in Impostazioni dei regolamenti europei e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere Moloco Ads all' elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di Ad Manager.
Passaggio 3: importa l'SDK e l'adattatore Moloco
Integrazione tramite pub.dev
Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore Moloco Ads nel file pubspec.yaml del pacchetto:
dependencies:
gma_mediation_moloco: ^3.4.0
Integrazione manuale
Scarica l'ultima versione del plug-in di mediazione degli annunci mobile di Google per
l'SDK Moloco Ads,
estrai il file scaricato e aggiungi la cartella del plug-in estratta
(e il relativo contenuto) al tuo progetto Flutter. Poi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
Passaggio 4: aggiungi il codice richiesto
Non è necessario alcun codice aggiuntivo per l'integrazione di Moloco.
Passaggio 5: testa l'implementazione
Attiva gli annunci di prova
Assicurati di registrare il tuo dispositivo di test per Ad Manager.
Verifica gli annunci di prova
Per verificare di ricevere annunci di prova dall' SDK Moloco Ads, attiva il test di una singola origine annuncio in Strumento di controllo degli annunci utilizzando le origini annuncio Moloco (Offerte).
Codici di errore
Se l'adattatore non riceve un annuncio da Moloco, gli editori possono controllare il
errore sottostante dalla risposta dell'annuncio utilizzando
ResponseInfo nelle seguenti classi:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Ecco i codici e i messaggi associati generati dall'adattatore Moloco quando un annuncio non viene caricato:
Android
| Codice di errore | Dominio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Chiave dell'app Moloco mancante o non valida. |
| 102 | com.google.ads.mediation.moloco | ID unità pubblicitaria Moloco mancante o non valido. |
| 103 | com.google.ads.mediation.moloco | L'oggetto annuncio Moloco restituito era null. |
| -1 to 5000 | com.moloco.sdk | L'SDK Moloco ha restituito un errore. Per maggiori dettagli, consulta la documentazione di Moloco. |
iOS
| Codice di errore | Dominio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | L'SDK Moloco non supporta la pubblicazione di annunci su iOS 12 e versioni precedenti. |
| 102 | com.google.ads.mediation.moloco | Chiave dell'app Moloco mancante o non valida. |
| 103 | com.google.ads.mediation.moloco | ID unità pubblicitaria Moloco mancante o non valido. |
| 104 | com.google.ads.mediation.moloco | L'annuncio non è pronto per essere mostrato. |
| 105 | com.google.ads.mediation.moloco | Impossibile mostrare l'annuncio. |
| 106 | com.google.ads.mediation.moloco | Dati di rendering non disponibili per il rendering dell'annuncio. |
| -1 to 5000 | Inviato dall'SDK Moloco | L'SDK Moloco ha restituito un errore. Per maggiori dettagli, consulta la documentazione di Moloco. |
Verifica lato server degli annunci con premio
Log delle modifiche dell'adattatore di mediazione Flutter di Moloco
Versione 3.4.0
- Versione minima di Flutter aggiornata alla 3.38.1
- Aggiornato per supportare la versione 8.0.0 del plug-in Flutter Google Mobile Ads
- Supporta la versione 4.7.0.0 dell'adattatore Android di Moloco .
- Supporta la versione 4.5.1.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 8.0.0 del plug-in Flutter Google Mobile Ads.
Versione 3.3.0
- Supporta la versione 4.5.0.0 dell'adattatore Android di Moloco .
- Supporta la versione 4.3.0.2 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 7.0.0 del plug-in Flutter Google Mobile Ads.
Versione 3.2.0
- Supporta la versione 4.4.0.0 dell'adattatore Android di Moloco .
- Supporta la versione 4.2.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 7.0.0 del plug-in Flutter Google Mobile Ads.
Versione 3.1.0
- Versione minima di Flutter aggiornata alla 3.35.1
- Supporta la versione 4.4.0.0 dell'adattatore Android di Moloco .
- Supporta la versione 4.1.2.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 7.0.0 del plug-in Flutter Google Mobile Ads.
Versione 3.0.0
- Supporta la versione 4.3.1.0 dell'adattatore Android di Moloco.
- Supporta la versione 4.1.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 2.1.0
- Supporta la versione 4.2.0.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.13.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 2.0.0
- Supporta la versione 4.0.0.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.13.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.6.0
- Supporta la versione 3.12.0.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.12.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.5.0
- Supporta la versione 3.11.0.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.11.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.4.0
- Supporta la versione 3.10.0.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.10.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.3.1
- Supporta la versione 3.9.0.0 dell'adattatore Android di Moloco .
- Supporta la versione 3.9.1.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.3.0
- Supporta la versione 3.9.0.0 dell'adattatore Android di Moloco .
- Supporta la versione 3.9.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.2.0
- Supporta la versione 3.8.0.1 dell'adattatore Android di Moloco.
- Supporta la versione 3.8.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.1.0
- Supporta la versione 3.7.0.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.6.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.
Versione 1.0.0
- Release iniziale.
- Supporta la versione 3.6.1.0 dell'adattatore Android di Moloco.
- Supporta la versione 3.6.0.0 dell'adattatore iOS di Moloco.
- Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.