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, coprendo 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 Unity.

L'interfaccia della dashboard di maio utilizza il testo giapponese per etichette, pulsanti e descrizioni e gli screenshot in questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni riportate di seguito, le etichette e i pulsanti sono indicati con i relativi equivalenti in inglese. "URL difettoso," ad esempio, è "Schema URL" e così via.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per maio offre le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Annunci interstitial
Con premio

Requisiti

  • Unity 4 o versioni successive
  • Versione più recente dell'SDK Google Mobile Ads
  • Per eseguire il deployment su Android
    • Livello API Android 21 o superiore
  • Per il deployment su iOS:
    • Target di deployment iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
  • Completa 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.

Android

iOS

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.

Android

iOS

Nella pagina Gestione dell'applicazione, prendi nota dell'ID multimediale. Devi configurare l'unità pubblicitaria AdMob nella prossima sezione.

Android

iOS

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

Android

iOS

(Solo struttura a cascata) 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, prendi nota di ID API e Chiave API.

Passaggio 2: configura la domanda maio nell' Ad Manager UI

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per le istruzioni, consulta il passaggio 2 della guida per Android.

iOS

Per le istruzioni, consulta il passaggio 2 nella guida per iOS.

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

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale del progetto:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Gestore pacchetti per aprire le Impostazioni di Gestore pacchetti di Unity.

Nella scheda Registri basati su ambito, aggiungi OpenUPM come registry basato su ambito con i seguenti dettagli:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Ambiti: com.google

Dettagli OpenUPM

Quindi, vai a Finestra > Gestore pacchetti per aprire Gestore pacchetti Unity e selezionare I miei registry dal menu a discesa.

Registri Unity

Seleziona il pacchetto Mediazione maio annunci per dispositivi mobili di Google e fai clic su Installa.

Installazione da OpenUPM

Pacchetto Unity

Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per maio dal link di download nel Changelog ed estrae il GoogleMobileAdsMaioMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e trova il GoogleMobileAdsMaioMediation.unitypackage file che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > Gestore delle dipendenze esterne > Risolvere Android > Forza risoluzione. La libreria di External Dependency Manager eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

Passaggio 4: aggiungi il codice richiesto

Android

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

iOS

Integrazione di SKAdNetwork

Segui la documentazione di maio per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob.

I publisher che utilizzano la versione 7.26.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.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da maio, attiva i 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, i publisher possono controllare l'errore sottostante della risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

Formato Nome del corso
Interstitial jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Con premio jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Formato Nome del corso
Interstitial GADMMaioInterstitialAdapter
Con premio GADMMaioRewardedAdapter

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore maio quando non riesce a caricare un annuncio:

Android

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

iOS

Codice di errore Motivo
0-10 maio ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta il codice di Maio.
101 maio non ha ancora un annuncio disponibile.
102 Parametri del 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 del plug-in maio Unity Mediation

Versione 2.0.4

Versione 2.0.3

Versione 2.0.2

Versione 2.0.1

Versione 2.0.0

Versione 1.4.3

Versione 1.4.2

Versione 1.4.1

Versione 1.4.0

Versione 1.3.6

Versione 1.3.5

Versione 1.3.4

Versione 1.3.3

Versione 1.3.2

Versione 1.3.1

Versione 1.3.0

Versione 1.2.3

  • Aggiornato il plug-in per supportare la nuova API Reward.
  • Supporta maio Android adattatore versione 1.1.7.0.
  • Supporta maio iOS adattatore versione 1.4.6.0.

Versione 1.2.2

  • Supporta maio Android adattatore versione 1.1.6.0.
  • Supporta la versione 1.4.2.0 dell'adattatore per iOS di maio.

Versione 1.2.1

  • Supporta maio Android adattatore versione 1.1.6.0.
  • Supporta l'adattatore per iOS maio versione 1.4.1.0.

Versione 1.2.0

  • Supporta la versione 1.1.4.1 dell'adattatore Android maio.
  • Supporta l'adattatore per iOS maio versione 1.4.0.0.

Versione 1.1.3

  • Supporta maio Android adattatore versione 1.1.3.1.
  • Supporta la versione 1.3.2.0 dell'adattatore per iOS di maio.

Versione 1.1.2

  • Supporta la versione 1.1.3.0 dell'adattatore Android di maio.
  • Supporta maio iOS adattatore versione 1.3.2.0.

Versione 1.1.1

  • Supporta la versione 1.1.1.0 dell'adattatore Android.
  • Supporta la versione 1.3.1.1 dell'adattatore iOS di maio.

Versione 1.1.0

  • Supporta la versione 1.1.0.0 dell'adattatore Android.
  • Supporta maio iOS adattatore versione 1.3.0.0.

Versione 1.0.2

  • Supporta la versione 1.0.8 dell'SDK Android di maio.
  • Supporta la versione 1.2.19 dell'SDK iOS di maio.

Versione 1.0.1

  • Supporta la versione 1.0.7 dell'SDK Android di maio.
  • Supporta la versione 1.2.19 dell'SDK iOS di maio.

Versione 1.0.0

  • Prima release!
  • Supporta maio Android SDK versione 1.0.6.
  • Supporta la versione 1.2.18 dell'SDK per iOS di maio.