Integra maio con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di maio utilizzando la mediazione, nonché le integrazioni con la struttura a cascata. Descrive come aggiungere maio alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore maio in un'app Android.

L'interfaccia della dashboard di maio utilizza il testo giapponese per le etichette, i pulsanti e le descrizioni e gli screenshot di questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, le etichette e i pulsanti sono 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 offre le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Livello API Android 21 o superiore

• SDK maio 1.0.7 o versioni successive

• SDK Google Mobile Ads più recente

• Completare la mediazione Guida introduttiva

Passaggio 1: configura le configurazioni nell'interfaccia utente di maio

Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Gestione app nella barra laterale a 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 URL dell'app. Seleziona Interstitial video come Tipo di annuncio e poi fai clic su Aggiorna.

Nota: gli annunci interstitial di maio sono ignorabili per impostazione predefinita.

Con premio

Inserisci il nome della tua app, seleziona la piattaforma e fornisci il URL dell'app. Seleziona Premi video come Tipo di annuncio e poi fai clic su Aggiorna.

Nota: per impostazione predefinita, gli annunci video con premio di maio NON sono ignorabili.

Nella pagina Gestione applicazioni, prendi nota dell'ID media. È necessario configurare l'unità pubblicitaria Ad Manager nella sezione successiva.

Nella pagina Gestione zone, prendi nota dell'ID zona. Inoltre, sarà necessario configurare l'unità pubblicitaria Ad Manager nella sezione successiva.

Oltre a ID media e ID zona, per configurare l'ID unità pubblicitaria per la mediazione sono necessari ID API e CHIAVE API. Nella pagina dell'API di reporting, annota l'ID API e la CHIAVE API.

Nota: se è la prima volta che configuri il tuo account maio, potresti dover contattare il team di assistenza di maio per ricevere l'ID API e la chiave API.

Passaggio 2: configura la domanda maio nell'interfaccia utente di Ad Manager

Configura 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 il mese di maggio, 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 ID API e CHIAVE API ottenuti nella sezione precedente.

Dopo aver selezionato il partner di rendimento, scegli Mediazione SDK per dispositivi mobili come Tipo di integrazione, Android come Piattaforma e Attivo come Stato. Inserisci ID media e ID zona ottenuti nella sezione precedente. Poi, inserisci un valore CPM predefinito.

Importante: l'ID media deve essere associato all'app di destinazione come nell'interfaccia utente di Maio.

Al termine, fai clic su Salva nella parte inferiore della pagina.

Nota: la raccolta automatica dei dati ha bisogno di raccogliere dati per qualche giorno prima di poter calcolare con precisione un valore di CPM dinamico per una rete di mediazione. Nel momento in cui è possibile calcolare l'eCPM, il relativo valore verrà aggiornato automaticamente per tuo conto.

Passaggio 3: importa l'SDK e l'adattatore maio

Nota: l'integrazione di versioni compatibili di maio e dell'SDK Google Mobile Ads potrebbe causare problemi di compilazione.

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")
    }
  }
}

Poi, nel file build.gradle.kts a livello di app, aggiungi le seguenti configurazioni e dipendenze di implementazione. Utilizza le versioni più recenti dell'SDK e dell'adattatore maio:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Integrazione manuale

• Scarica la versione più recente dell'SDK Android di maio e aggiungila al tuo progetto.
• Vai agli elementi dell'adattatore maio nel repository Maven di Google. Seleziona la versione più recente, scarica il file ".aar" dell'adattatore Maio e aggiungilo al progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione di maio per Android.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager.

I publisher che utilizzano la versione 11.6.0 o successive dell'SDK Google Mobile Ads riceveranno automaticamente annunci di prova da maio su telefoni e tablet registrati come dispositivi di test quando effettuano richieste.

Importante: disattiva la modalità di test per Ad Manager e maio prima di rilasciare l'app.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da maio, attiva il test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio maio (a cascata).

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da maio, gli editori possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

Formato	Nome del 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 messaggi associati 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. Per ulteriori dettagli, consulta il codice e la documentazione di maio.
101	Per Maio non è disponibile alcun annuncio.
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".

Log delle modifiche dell'adattatore di mediazione Android maio

Versione 1.1.16.3

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 23.0.0.
• Compatibilità verificata con la versione 1.1.16 dell'SDK maio.

Creato e testato con:

• SDK Google Mobile Ads versione 23.0.0.
• SDK Maio versione 1.1.16.

Versione 1.1.16.2

• L'adattatore è stato aggiornato per utilizzare la nuova classe VersionInfo.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.0.0.

Creato e testato con:

• SDK Google Mobile Ads versione 22.0.0.
• SDK Maio versione 1.1.16.

Versione 1.1.16.1

• compileSdkVersion e targetSdkVersion sono stati aggiornati all'API 31.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.0.0.
• È stato aggiornato il livello API Android minimo richiesto a 19.

Creato 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 ulteriori errori di maio.
• Compatibilità verificata con la versione 1.1.16 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.4.0.

Creato e testato con:

• SDK Google Mobile Ads versione 20.4.0.
• SDK Maio versione 1.1.16.

Versione 1.1.15.0

• È stata verificata la compatibilità con la versione 1.1.15 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.0.0.

Creato 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 codici e messaggi di errore standardizzati per gli adattatori.
• È stata verificata la compatibilità con la versione 1.1.14 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.8.0.

Creato 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 la versione 1.1.13 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.5.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.5.0.
• SDK Maio versione 1.1.13.

Versione 1.1.12.0

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.4.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.4.0.
• SDK Maio versione 1.1.12.

Versione 1.1.11.1

• Per limitare i timeout, le richieste di annunci ora non andranno a buon fine immediatamente se Maio non ha un annuncio pronto per la pubblicazione.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.1.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.1.0.
• SDK Maio versione 1.1.11.

Versione 1.1.11.0

• È stata verificata la compatibilità con la versione 1.1.11 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 18.3.0.

Creato e testato con:

• SDK Google Mobile Ads versione 18.3.0.
• SDK Maio versione 1.1.11.

Versione 1.1.10.0

• È stata verificata la compatibilità con la versione 1.1.10 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 18.2.0.

Versione 1.1.8.0

• Compatibilità verificata con la versione 1.1.8 dell'SDK maio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla versione 18.1.0.

Versione 1.1.7.0

• Correzioni di bug.
• È stata verificata la compatibilità con la versione 1.1.7 dell'SDK maio.

Versione 1.1.6.1

• È stato aggiornato l'adattatore per supportare la nuova API con premio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 17.2.0.

Versione 1.1.6.0

• Compatibilità verificata con la versione 1.1.6 dell'SDK maio.

Versione 1.1.5.0

• Compatibilità verificata con la versione 1.1.5 dell'SDK maio.

Versione 1.1.4.0

• Compatibilità verificata con la versione 1.1.4 dell'SDK maio.

Versione 1.1.3.1

• L'adattatore è stato aggiornato in modo da funzionare con la classe di istanza anziché con il singleton.

Versione 1.1.3.0

• Compatibilità verificata con la versione 1.1.3 dell'SDK maio.

Versione 1.1.2.1

• L'adattatore è stato aggiornato con funzioni di inizializzazione aggiornate.

Versione 1.1.2.0

• È stata verificata la compatibilità con la versione 1.1.2 dell'SDK maio.

Versione 1.1.1.1

• È stato aggiornato l'adattatore per richiamare l'evento annuncio onRewardedVideoComplete().

Versione 1.1.1.0

• Compatibilità verificata con la versione 1.1.1 dell'SDK maio.

Versione 1.1.0.0

• Compatibilità verificata con la versione 1.1.0 dell'SDK maio.

Versione 1.0.8.0

• Compatibilità verificata con la versione 1.0.8 dell'SDK maio.

Versione 1.0.7.1

• È stato risolto un problema che poteva causare NullPointerExceptions quando non si riusciva a caricare gli annunci.

Versione 1.0.7.0

• È stata aggiunta la possibilità di attivare la modalità di test aggiungendo l'ID del dispositivo di test a AdRequest.
• È stata verificata la compatibilità con la versione 1.0.7 dell'SDK maio.

Versione 1.0.6.0

• Prima release!
• È stato aggiunto il supporto per gli interstitial e gli annunci video con premio.