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 le etichette, i pulsanti e le descrizioni e gli screenshot di 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. Ad esempio, "URL スキーム" è "URL Scheme" 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. 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 applicazioni, prendi nota dell'ID media. È necessario configurare l'unità pubblicitaria Ad Manager nella sezione successiva.

Android

iOS

Nella pagina Gestione zone, prendi nota dell'ID zona. Inoltre, sarà necessario configurare l'unità pubblicitaria Ad Manager 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' Ad Manager interfaccia utente

Configura 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 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 Google Mobile Ads 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 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 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

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 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 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, i publisher possono controllare l'errore di fondo dalla risposta all'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 Per questa configurazione della rete è già stato caricato un annuncio.

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

  • Il plug-in è stato aggiornato per supportare la nuova API con premio.
  • Supporta la versione 1.1.7.0 dell'adattatore Android.
  • Supporta la versione 1.4.6.0 dell'adattatore per iOS di maio.

Versione 1.2.2

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

Versione 1.2.1

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