Integra maio con Mediazione

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

L'interfaccia della dashboard per 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 di questa guida, a etichette e pulsanti viene fatto riferimento ai rispettivi equivalenti in lingua inglese. ad esempio, "URL mondialeム" è "Schema URL" e così via.

Integrazioni e formati degli annunci supportati

L' Ad Manager adattatore di mediazione per maio ha le seguenti funzionalità:

Integrazione
Offerte
Struttura a cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Livello API Android 19 o superiore

• SDK maio 1.0.7 o versioni successive

• Versione più recente dell'SDK Google Mobile Ads

• Completa 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.

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 tuo URL dell'app. Seleziona Premi video come Tipo di annuncio, quindi fai clic su Aggiorna.

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

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.

Oltre all'ID media 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 di ID API e CHIAVE API.

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

Passaggio 2: configura la domanda maio nella 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

Importante: il Media ID deve essere associato all'app scelta come target come nell'maio UI.

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

Nota: la raccolta automatica dei dati richiede alcuni giorni per raccogliere i dati prima di poter calcolare con precisione il valore del CPM dinamico per una rete di mediazione. Una volta calcolato, l'eCPM viene aggiornato automaticamente.

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

Nota: la mancata integrazione delle versioni compatibili dell'SDK maio e dell'SDK Google Mobile Ads potrebbe causare problemi di creazione.

Integrazione con 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 dipendenze e configurazioni di implementazione. Utilizza le versioni più recenti dell'adattatore e dell'SDK Maio:

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

Integrazione manuale

• Scarica la versione più recente dell'SDK Maio Android e aggiungila al tuo progetto.
• Vai agli elementi dell'adattatore Mai nel 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 è richiesto codice aggiuntivo per l'integrazione con 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.

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

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 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. Consulta il codice e la documentazione di maio per ulteriori dettagli.
101	Maio non dispone di annunci disponibili.
102	Parametri server non validi (ad es. ID posizionamento mancante).
103	Il contesto utilizzato per caricare un annuncio non era un'istanza di tipo "Attività".
0-10	maio ha restituito un errore specifico dell'SDK. Consulta il codice di maio per ulteriori dettagli.
101	maio non ha ancora un annuncio disponibile.
102	Parametri server non validi (ad es. ID posizionamento mancante).
103	L'adattatore maio non supporta il formato dell'annuncio richiesto.
104	È già stato caricato un annuncio per questa configurazione di rete.

Log delle modifiche dell'adattatore di mediazione Android maio

Versione successiva

• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.

Versione 1.1.16.2

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

Realizzato e testato con:

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

Versione 1.1.16.1

• Aggiornamento di compileSdkVersion e targetSdkVersion 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.

Realizzato 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 maio.
• Compatibilità verificata con l'SDK maio versione 1.1.16.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.4.0.

Realizzato 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 l'SDK maio versione 1.1.15.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.

Realizzato 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 relativi all'adattatore standardizzato.
• Compatibilità verificata con l'SDK maio versione 1.1.14.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.8.0.

Realizzato 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 l'SDK maio versione 1.1.13.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.5.0.

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

Realizzato 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 tempi di scadenza, 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.

Realizzato 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 l'SDK maio versione 1.1.11.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.3.0.

Realizzato 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 l'SDK maio 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 l'SDK maio 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 l'SDK maio versione 1.1.7.

Versione 1.1.6.1

• L'adattatore è stato aggiornato 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

• Compatibilità verificata con l'SDK maio versione 1.1.6.

Versione 1.1.5.0

• Compatibilità verificata con l'SDK maio versione 1.1.5.

Versione 1.1.4.0

• Compatibilità verificata con l'SDK maio versione 1.1.4.

Versione 1.1.3.1

• Aggiornato l'adattatore in modo che funzioni con la classe di istanza anziché con singleton.

Versione 1.1.3.0

• Compatibilità verificata con l'SDK maio versione 1.1.3.

Versione 1.1.2.1

• Adattatore aggiornato con funzioni di inizializzazione aggiornate.

Versione 1.1.2.0

• Compatibilità verificata con l'SDK maio 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 l'SDK maio versione 1.1.1.

Versione 1.1.0.0

• Compatibilità verificata con l'SDK maio versione 1.1.0.

Versione 1.0.8.0

• Compatibilità verificata con l'SDK maio versione 1.0.8.

Versione 1.0.7.1

• Risolto un problema che potrebbe causare il verificarsi di NullPointerExceptions quando gli annunci non vengono caricati.

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 l'SDK maio versione 1.0.7.

Versione 1.0.6.0

• Prima uscita.
• Aggiunto il supporto per interstitial e annunci video con premio.