Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e mostrare gli annunci di maio utilizzando la mediazione AdMob, 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 maio in un'app per Android.
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. Nelle descrizioni e nelle istruzioni di questa guida, tuttavia, le etichette e i pulsanti vengono indicati con i relativi 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 | |
| A cascata | |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Nativo | |
Requisiti
- Livello API Android 24 o superiore
- SDK maio 1.0.7 o versioni successive
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.

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).

Nella pagina Application Management (Gestione applicazioni), prendi nota dell'ID contenuti multimediali. È necessario per configurare l'unità pubblicitaria AdMob nella sezione successiva.

Nella pagina Zone Management (Gestione zone), prendi nota dell'ID zona. Sarà necessario anche per configurare l'unità pubblicitaria AdMob nella sezione successiva.


Passaggio 2: configura la domanda di maio nell'UI di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere maio alla configurazione di mediazione per l'unità pubblicitaria.
Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente a Aggiungere maio come origine annuncio.
Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, quindi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Poi, imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più delle tue unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie che hai selezionato:

Aggiungi maio come origine annuncio
Nella scheda Cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.
Seleziona maio e attiva l'opzione Ottimizza. Inserisci l'ID API e la chiave API ottenuti nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per maio. Poi, inserisci un valore eCPM per maio e fai clic su Continua.

Se hai già un mapping per maio, puoi selezionarlo. In caso contrario, fai clic su Aggiungi mappatura.

Poi, inserisci l' ID contenuti multimediali e ID zona ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

Passaggio 3: importa l'SDK e l'adattatore maio
Integrazione di Android Studio (consigliata)
Nel file settings.gradle.kts a livello di progetto, aggiungi i seguenti repository:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Nel file Gradle a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:maio:2.0.8.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:maio:2.0.8.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Integrazione manuale
- Scarica l'ultima versione dell' SDK Android di maio e aggiungilo al tuo progetto.
- Vai agli artefatti dell'adattatore maio nel repository Maven di Google. Seleziona l'ultima versione, 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 Android.
Passaggio 5: verifica l'implementazione
Attiva gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob.
I publisher che utilizzano la versione 11.6.0 o successive di GMA Next-Gen SDK riceveranno automaticamente annunci di prova da maio su smartphone e tablet registrati come dispositivi di prova quando effettuano richieste.
Verifica gli annunci di prova
Per verificare di ricevere annunci di prova da maio, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le orig101}maio (Cascata)ini annuncio.
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da maio,
i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
ResponseInfo.getAdSourceResponses()
nelle seguenti classi:
| Formato | Nome classe |
|---|---|
| Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Con premio | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Ecco i codici e i messaggi associati generati dall'adattatore maio quando un annuncio non viene caricato:
| 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 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 di `Activity`. |