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, che copre le integrazioni a cascata. Spiega come aggiungere maio alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di maio in un'app Unity.

L'interfaccia della dashboard per 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 qui riportate, le etichette e i pulsanti sono indicati con i loro equivalenti in lingua inglese. "URL スキーム," ad esempio, è "URL Scheme,".

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Annunci interstitial
Con premio

Requisiti

  • SDK Google Mobile Ads più recente
  • Unity 4 o versioni successive
  • Per il deployment su Android
    • Livello API Android 23 o superiore
  • Per il deployment su iOS
    • Target di distribuzione iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la sezione 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 applicazioni 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 l'URL dell'app. Seleziona Interstitial video come Tipo di annuncio, poi fai clic su Aggiorna.

Android

iOS

Con premio

Inserisci il Nome della tua app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Video con premio come Tipo di annuncio e poi fai clic su Aggiorna.

Android

iOS

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

Android

iOS

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

Android

iOS

(Solo struttura a cascata) 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 dell'API di reporting, prendi nota dell'ID API e della CHIAVE API.

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, vedi il passaggio 2 della guida per iOS.

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

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Google Mobile Ads maio 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 > Package Manager per aprire le impostazioni di Unity Package Manager.

Nella scheda Registri con ambito, aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

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

Dettagli OpenUPM

Poi vai a Window > Package Manager per aprire Unity Package Manager e seleziona My Registries dal menu a discesa.

Registri Unity

Seleziona il pacchetto Google Mobile Ads Maio Mediation e fai clic su Installa.

Installare da OpenUPM

Pacchetto Unity

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per maio dal link di download nel Changelog ed estrai GoogleMobileAdsMaioMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Assets > Import Package > Custom Package e trova il file GoogleMobileAdsMaioMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager esegue la risoluzione delle dipendenze da zero e copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

Passaggio 4: aggiungi il codice richiesto

Android

Non è necessario 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 tuo progetto.

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 7.26.0 o successive dell'SDK Google Mobile Ads riceveranno automaticamente gli annunci di test da maio su smartphone e tablet registrati come dispositivi di test quando effettuano richieste.

Verificare gli annunci di prova

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

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 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 restituiti dall'adattatore maio quando un annuncio non viene caricato:

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 Maio non ha un annuncio disponibile.
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 di mediazione Unity di maio

Versione 3.0.2

Versione 3.0.1

Versione 3.0.0

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

  • È stato aggiornato il plug-in per supportare la nuova API Rewarded.
  • Supporta l'adattatore Android maio versione 1.1.7.0.
  • Supporta l'adattatore maio iOS versione 1.4.6.0.

Versione 1.2.2

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

Versione 1.2.1

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

Versione 1.2.0

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

Versione 1.1.3

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

Versione 1.1.2

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

Versione 1.1.1

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

Versione 1.1.0

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

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 la versione 1.0.6 dell'SDK Android di maio.
  • Supporta la versione 1.2.18 dell'SDK maio per iOS.