Questa guida mostra come utilizzare Google Mobile Ads Flutter Plugin per caricare e mostrare gli annunci di maio utilizzando la mediazione, incluse le integrazioni con struttura a cascata. Descrive come aggiungere maio alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di maio in un'app Flutter.
L'interfaccia della dashboard di maio utilizza testo in giapponese per etichette, pulsanti e descrizioni e gli screenshot in questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni qui, le etichette e i pulsanti sono indicati con i loro equivalenti in lingua inglese. Ad esempio, "URL スキーム" è "URL Scheme".
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per maio ha le seguenti funzionalità:
| Integrazione | |
|---|---|
| Asta | |
| Cascata | |
| Formati | |
| Banner | |
| Annunci interstitial | |
| Con premio | |
| Nativo | |
Requisiti
- Più recente 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 12.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.
- Configura la mediazione.
Passaggio 1: configura le impostazioni nell'UI di maio
Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Application management (Gestione applicazioni) nella barra laterale a sinistra e poi su New app (Nuova app).
Seleziona la scheda corrispondente al tipo di annuncio che preferisci.
Interstitial
Inserisci il nome dell'app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Video interstitial come tipo di annuncio e poi fai clic su Aggiorna.
Android
iOS
Con premio
Inserisci il nome dell'app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Video Rewards (Video con premio) come tipo di annuncio e poi fai clic su Update (Aggiorna).
Android
iOS
Nella pagina Application Management (Gestione applicazioni), prendi nota dell'ID contenuti multimediali. È necessario per configurare l'unità pubblicitaria di Ad Manager nella sezione successiva.
Android
iOS
Nella pagina Zone Management (Gestione zone), prendi nota dell'ID zona. Sarà necessario anche per configurare l'unità pubblicitaria di Ad Manager nella sezione successiva.
Android
iOS
Passaggio 2: configura la domanda di maio nell'UI 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.
Passaggio 3: importa l'SDK e l'adattatore di maio
Integrazione tramite pub.dev
Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore di maio nel file pubspec.yaml del pacchetto:
dependencies:
gma_mediation_maio: ^1.1.3
Integrazione manuale
Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per
maio,
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_maio:
path: path/to/local/package
Passaggio 4: aggiungi il codice richiesto
Android
Non è necessario aggiungere altro codice per l'integrazione di maio.
iOS
Integrazione di SKAdNetwork
Segui la documentazione di maio
per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.
Passaggio 5: testa l'implementazione
Attiva gli annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager.
I publisher che utilizzano la versione 7.26.0 o successive di Google Mobile Ads Flutter Plugin riceveranno automaticamente gli annunci di prova da maio su smartphone e tablet registrati come dispositivi di test quando effettuano richieste.
Verifica gli annunci di prova
Per verificare di ricevere gli annunci di prova da maio, attiva il test di una singola origine annuncio in Strumento di controllo degli annunci utilizzando le maio (Waterfall) origini annuncio.
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da maio, i publisher possono controllare il
errore sottostante dalla risposta dell'annuncio utilizzando
ResponseInfo nelle
seguenti classi:
Android
| Formato | Nome corso |
|---|---|
| Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Con premio | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| Formato | Nome corso |
|---|---|
| Interstitial | GADMMaioInterstitialAdapter |
| Con premio | GADMMaioRewardedAdapter |
Ecco i codici e i messaggi associati generati dall'adattatore di maio quando un annuncio non viene caricato:
Android
| Codice di errore | Motivo |
|---|---|
| 0-10 | maio ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta il codice e la documentazione di maio. |
| 101 | maio non ha un annuncio disponibile. |
| 102 | Parametri del server non validi (ad es. ID posizionamento mancante). |
| 103 | Il contesto utilizzato per caricare un annuncio non era un'istanza di `Activity`. |
iOS
Log delle modifiche dell'adattatore di mediazione Flutter di maio
Versione 1.1.4 (in corso)
Versione 1.1.3
- Supporta la versione 2.0.7.0 dell'adattatore Android di maio.
- Supporta la versione 2.2.0.3 dell'adattatore iOS di maio.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.1.2
- Versione minima di Flutter aggiornata alla 3.35.1
- Aggiornato per supportare la versione 7.0.0 del plug-in Flutter Google Mobile Ads
- Supporta la versione 2.0.8.0 dell'adattatore Android di maio.
- Supporta la versione 2.2.0.1 dell'adattatore iOS di maio.
Versione 1.1.1
- Supporta la versione 2.0.7.0 dell'adattatore Android di maio.
- Supporta la versione 2.2.0.1 dell'adattatore iOS di maio.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.1.0
- Supporta la versione 2.0.6.0 dell'adattatore Android di maio.
- Supporta la versione 2.2.0.0 dell'adattatore iOS di maio .
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.0.3
- Supporta la versione 2.0.5.0 dell'adattatore Android di maio.
- Supporta la versione 2.1.6.1 dell'adattatore iOS di maio.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.0.2
- Supporta la versione 2.0.4.0 dell'adattatore Android di maio.
- Supporta la versione 2.1.6.1 dell'adattatore iOS di maio.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.0.1
- Supporta la versione 2.0.3.1 dell'adattatore Android di maio .
- Supporta la versione 2.1.6.1 dell'adattatore iOS di maio.
- Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.
Versione 1.0.0
- Release iniziale.
- Supporta la versione 2.0.3.0 dell'adattatore Android di maio.
- Supporta la versione 2.1.6.0 dell'adattatore iOS di maio .
- Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.