Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di maio utilizzando mediazione, che copre le integrazioni a cascata. Illustra come aggiungere maio al configurazione della mediazione e come integrare l'SDK e l'adattatore maio in un Android
L'interfaccia della dashboard di maio utilizza testo giapponese per etichette, pulsanti, e descrizioni. Inoltre, gli screenshot in questa guida non sono stati tradotti. Nelle descrizioni e nelle istruzioni di questa guida, tuttavia, etichette e pulsanti sono a cui si fa riferimento con gli equivalenti in lingua inglese. "URL エーム", ad esempio è "Schema URL".
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per maio ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
Requisiti
- Livello API Android 21 o superiore
- maio SDK 1.0.7 o successivo
Versione più recente dell'SDK Google Mobile Ads
Completare la mediazione Guida introduttiva
Passaggio 1: imposta le configurazioni nella UI di maio
Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Gestione applicazioni nella barra laterale sinistra e poi su Nuova app.
Seleziona la scheda corrispondente al Tipo di annuncio che preferisci.
Interstitial
Inserisci il nome della tua app, seleziona la piattaforma e fornisci il tuo URL dell'app. Seleziona Interstitial video come Tipo di annuncio, poi fai clic su Aggiorna.
Con premio
Inserisci il nome della tua app, seleziona la piattaforma e fornisci il tuo URL dell'app. Seleziona Premi video come Tipo di annuncio, quindi fai clic su Aggiorna.
Nella pagina Gestione applicazione, prendi nota dell'ID media. È necessario configurare l' Ad Manager unità pubblicitaria nella sezione successiva.
Nella pagina Gestione zona, prendi nota dell'ID zona. Sarà necessario anche configurare l' Ad Manager unità pubblicitaria nella sezione successiva.
Passaggio 2: configura la domanda maio nell' Ad Manager UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Accedi al tuo account Ad Manager.
Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.
Inserisci un nome univoco per il gruppo di rendimento, imposta lo Stato su Attivo, seleziona il formato dell'annuncio e imposta il Tipo di inventario su App mobile. Nella sezione Targeting > Inventario, seleziona l'unità pubblicitaria in Inventario e App mobile a cui vuoi aggiungere la mediazione.
Fai clic sul pulsante Aggiungi partner di rendimento.
Se hai già un Partner di rendimento per maio, puoi selezionarlo. In caso contrario, seleziona Crea un nuovo partner di rendimento.
Seleziona maio come Rete pubblicitaria, inserisci un nome univoco e attiva Mediazione.
Attiva Raccolta automatica dei dati e inserisci il valore API ID and API KEY ottenuto nella sezione precedente.
Dopo aver selezionato Partner di rendimento, scegli Mediazione SDK mobile come Tipo di integrazione, Android come Piattaforma e Attivo come Stato. Inserisci iMedia ID and Zone ID ottenuti nella sezione precedente. Quindi, inserisci un valore per il CPM predefinito
Al termine, fai clic su Salva nella parte inferiore della pagina.
Passaggio 3: importa l'SDK e l'adattatore maio
Integrazione di Android Studio (consigliata)
Nel file settings.gradle.kts
a livello di progetto, aggiungi quanto segue
repository:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Poi, nel file build.gradle.kts
a livello di app, aggiungi quanto segue
delle dipendenze e configurazioni dell'implementazione. Utilizza le versioni più recenti
SDK e adattatore maio:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Integrazione manuale
- Scarica l'ultima versione di maio Android SDK e aggiungi al tuo progetto.
- Vai agli artefatto dell'adattatore Maio sul Repository Maven di Google. Seleziona la versione più recente, scarica il file ".aar" dell'adattatore maio e aggiungilo al tuo progetto.
Passaggio 4: aggiungi il codice richiesto
Non è necessario alcun codice aggiuntivo per l'integrazione di maio con Android.
Passaggio 5: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager
I publisher che utilizzano la versione 11.6.0 o successiva dell'SDK Google Mobile Ads riceveranno automaticamente gli annunci di prova da maio su telefoni e tablet registrati come dispositivi di test quando effettuano le richieste.
Verifica annunci di prova
Per verificare di ricevere annunci di prova damaio, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le maio (Waterfall) origini annuncio.
Codici di errore
Se l'adattatore non riceve un annuncio da maio,
i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
ResponseInfo.getAdapterResponses()
nelle seguenti classi:
Formato | Nome corso |
---|---|
Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Con premio | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore maio quando non riesce a caricare un annuncio:
Codice di errore | Motivo |
---|---|
0-10 | maio ha restituito un errore specifico dell'SDK. Vedi il codice e la documentazione di maio per ulteriori informazioni. |
101 | Maio non ha annunci disponibili. |
102 | Parametri del server non validi (ad es. ID posizionamento mancante). |
103 | Il contesto utilizzato per caricare un annuncio non era un'istanza "Attività". |
Log delle modifiche dell'adattatore di mediazione Android maio
Versione 1.1.16.3
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.0.0.
- Compatibilità verificata con maio SDK versione 1.1.16.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Maio versione 1.1.16.
Versione 1.1.16.2
- Adattatore aggiornato per utilizzare la nuova classe
VersionInfo
. - La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Maio versione 1.1.16.
Versione 1.1.16.1
compileSdkVersion
etargetSdkVersion
aggiornati all'API 31.- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.
- Il livello API Android minimo richiesto è stato aggiornato a 19.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- SDK Maio versione 1.1.16.
Versione 1.1.16.0
- Codici di errore aggiornati per acquisire altri errori di maio.
- Compatibilità verificata con maio SDK versione 1.1.16.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.4.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.4.0.
- SDK Maio versione 1.1.16.
Versione 1.1.15.0
- Compatibilità verificata con maio SDK versione 1.1.15.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.0.0.
- SDK Maio versione 1.1.15.
Versione 1.1.14.0
- Sono stati aggiunti messaggi e codici di errore dell'adattatore standardizzato.
- Compatibilità verificata con maio SDK versione 1.1.14.
- È stata aggiornata la versione minima dell'SDK Google Mobile Ads richiesta alla versione 19.8.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 19.8.0.
- SDK Maio versione 1.1.14.
Versione 1.1.13.0
- Compatibilità verificata con maio SDK versione 1.1.13.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.5.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 19.5.0.
- SDK Maio versione 1.1.13.
Versione 1.1.12.0
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.4.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 19.4.0.
- SDK Maio versione 1.1.12.
Versione 1.1.11.1
- Per limitare le durate, le richieste di annunci ora non andranno a buon fine se maio non ha un annuncio pronto per essere mostrato.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.1.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 19.1.0.
- SDK Maio versione 1.1.11.
Versione 1.1.11.0
- Compatibilità verificata con maio SDK versione 1.1.11.
- È stata aggiornata la versione minima dell'SDK Google Mobile Ads richiesta alla versione 18.3.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 18.3.0.
- SDK Maio versione 1.1.11.
Versione 1.1.10.0
- Compatibilità verificata con maio SDK versione 1.1.10.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.2.0.
Versione 1.1.8.0
- Compatibilità verificata con maio SDK versione 1.1.8.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.1.0.
Versione 1.1.7.0
- Correzioni di bug.
- Compatibilità verificata con maio SDK versione 1.1.7.
Versione 1.1.6.1
- È stato aggiornato l'adattatore per supportare la nuova API con premio.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 17.2.0.
Versione 1.1.6.0
- È stata verificata la compatibilità con l'SDK maio versione 1.1.6.
Versione 1.1.5.0
- È stata verificata la compatibilità con l'SDK maio versione 1.1.5.
Versione 1.1.4.0
- Compatibilità verificata con maio SDK versione 1.1.4.
Versione 1.1.3.1
- È stato aggiornato l'adattatore in modo che funzioni con la classe di istanza anziché con singleton.
Versione 1.1.3.0
- Compatibilità verificata con maio SDK versione 1.1.3.
Versione 1.1.2.1
- È stato aggiornato l'adattatore con le funzioni di inizializzazione aggiornate.
Versione 1.1.2.0
- Compatibilità verificata con maio SDK versione 1.1.2.
Versione 1.1.1.1
- È stato aggiornato l'adattatore per richiamare l'evento annuncio
onRewardedVideoComplete()
.
Versione 1.1.1.0
- Compatibilità verificata con maio SDK versione 1.1.1.
Versione 1.1.0.0
- È stata verificata la compatibilità con l'SDK maio versione 1.1.0.
Versione 1.0.8.0
- È stata verificata la compatibilità con l'SDK maio versione 1.0.8.
Versione 1.0.7.1
- Risolto un problema che causava le eccezioni NullPointerExceptions in caso di errore degli annunci da caricare.
Versione 1.0.7.0
- Aggiunta la possibilità di attivare la modalità di test aggiungendo l'ID dispositivo di test a
AdRequest
. - Compatibilità verificata con maio SDK versione 1.0.7.
Versione 1.0.6.0
- Prima uscita
- Aggiunto il supporto per interstitial e annunci video con premio.