Integra maio con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di maio utilizzando la mediazione, che copre le integrazioni 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 le etichette, i pulsanti e le descrizioni e gli screenshot di questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni fornite qui, etichette e pulsanti a cui fanno riferimento gli equivalenti in lingua inglese. "URL エーム", 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
  • SDK Google Mobile Ads più recente
  • Per eseguire il deployment su Android
    • Livello API Android 21 o superiore
  • Per eseguire il deployment su iOS
    • Target di deployment iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Consulta Inizia per maggiori dettagli.
  • 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 dell'app, seleziona la piattaforma e fornisci URL dell'app. Seleziona Interstitial video come Tipo di annuncio e poi fai clic su Aggiorna.

Android

iOS

Con premio

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

Android

iOS

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

Android

iOS

Nella pagina Gestione zone, prendi nota dell'ID zona. Inoltre, sarà necessario per 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, annota l'ID API e la CHIAVE API.

Passaggio 2: configura la domanda di Maio nell' AdMob interfaccia utente

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 OpenUPM-CLI puoi installare l'app Google Mobile Ads maio il plug-in di mediazione per Unity al tuo progetto eseguendo questo comando dalla directory radice 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 Unity Package Manager.

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 > Gestione pacchetti per aprire lo Gestore di pacchetti Unity e Seleziona I miei registri dal menu a discesa.

Registri di unità

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

Installa 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 GoogleMobileAdsMaioMediation.unitypackage 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 External Dependency Manager effettuerà 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 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 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 le richieste.

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 un errore sottostante della risposta all'annuncio ResponseInfo nel seguenti classi:

Android

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

iOS

Formato Nome corso
Interstitial GADMMaioInterstitialAdapter
Con premio GADMMaioRewardedAdapter

Ecco i codici e i relativi messaggi generati 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 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 "Attività".

iOS

Codice di errore Motivo
0-10 maio ha restituito un errore specifico dell'SDK. Consulta codice di maio per ulteriori informazioni.
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 Per questa configurazione della rete è già stato caricato un annuncio.

Log delle modifiche del plug-in maio Unity Mediation

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 la versione 1.1.7.0 dell'adattatore Android.
  • Supporta maio iOS adattatore versione 1.4.6.0.

Versione 1.2.2

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

Versione 1.2.1

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

Versione 1.2.0

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

Versione 1.1.3

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

Versione 1.1.2

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

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 maio Android adattatore versione 1.1.0.0.
  • Supporta la versione 1.3.0.0 dell'adattatore per iOS di maio.

Versione 1.0.2

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

Versione 1.0.1

  • Supporta maio Android SDK versione 1.0.7.
  • 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.