Integra maio con la mediazione

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
  • Ultima versione GMA Next-Gen SDK.

  • Completa la guida introduttiva alla 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.

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.

Oltre all'ID contenuti multimediali e all'ID zona, avrai bisogno dell'ID API e della chiave API per configurare l'ID unità pubblicitaria per la mediazione. Nella pagina API di reporting, prendi nota dell'ID API e della chiave API.

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

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