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".
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
- Android API 21 o versioni successive
- 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 AdMob nella sezione successiva.
Android
iOS
Nella pagina Gestione zone, prendi nota dell'ID zona. Inoltre, sarà necessario configurare l'unità pubblicitaria AdMob nella sezione successiva.
Android
iOS
Passaggio 2: configura la domanda maio nell'interfaccia utente di AdMob
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
Quindi, vai a Finestra > Gestore pacchetti per aprire Gestore pacchetti Unity e selezionare I miei registry dal menu a discesa.
Seleziona il pacchetto Mediazione Google Mobile Ads e fai clic su Installa.
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.
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.
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 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 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
- Supporta l'adattatore Android di maggio versione 1.1.16.3.
- Supporta l'adattatore per iOS di maio versione 2.1.5.1.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.3.0.
Versione 2.0.3
- Supporta l'adattatore Android di maggio versione 1.1.16.3.
- Supporta l'adattatore per iOS di maio versione 2.1.5.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 2.0.2
- Supporta l'adattatore Android di maggio versione 1.1.16.3.
- Supporta l'adattatore per iOS versione 2.1.4.0 di maggio.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.0.0.
Versione 2.0.1
- Supporta l'adattatore Android di maio versione 1.1.16.2.
- Supporta l'adattatore per iOS di maggio versione 2.1.3.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.0.0.
Versione 2.0.0
- Supporta l'adattatore Android di maio versione 1.1.16.2.
- Supporta l'adattatore per iOS maio versione 2.1.1.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.6.0.
Versione 1.4.3
- I contenuti dell'adattatore sono stati spostati in
GoogleMobileAds/Mediation/Maio/
. - Supporta l'adattatore Android di maio versione 1.1.16.2.
- Supporta l'adattatore per iOS di maio versione 1.6.3.1.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.1.0.
Versione 1.4.2
- Supporta maio Android adapter versione 1.1.16.1.
- Supporta l'adattatore per iOS di maio versione 1.6.3.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.4.0.
Versione 1.4.1
- Supporta maio Android adapter versione 1.1.16.1.
- Supporta l'adattatore per iOS di maio versione 1.6.2.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.1.0.
Versione 1.4.0
- Supporta l'adattatore Android di maggio versione 1.1.16.0.
- Supporta l'adattatore per iOS di maggio versione 1.6.0.1.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.0.0.
Versione 1.3.6
- Supporta l'adattatore Android di maggio versione 1.1.16.0.
- Supporta l'adattatore per iOS di maio versione 1.5.8.0.
Versione 1.3.5
- Supporta l'adattatore Android di maggio versione 1.1.15.0.
- Supporta la versione 1.5.6.1 dell'adattatore per iOS di maio.
Versione 1.3.4
- Supporta l'adattatore Android di maio versione 1.1.11.1.
- Supporta l'adattatore per iOS di maggio versione 1.5.4.0.
Versione 1.3.3
- Supporta l'adattatore Android di maio versione 1.1.11.1.
- Supporta la versione 1.5.3.1 dell'adattatore per iOS di maio.
Versione 1.3.2
- Supporta l'adattatore Android di maio versione 1.1.11.0.
- Supporta l'adattatore per iOS di maio versione 1.5.2.1.
Versione 1.3.1
- Supporta l'adattatore Android di maio versione 1.1.10.0.
- Supporta l'adattatore per iOS di maggio versione 1.5.1.0.
Versione 1.3.0
- Supporta l'adattatore Android di maio versione 1.1.10.0.
- Supporta l'adattatore per iOS di maggio versione 1.5.0.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 l'adattatore Android maio 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 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.