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.
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.
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.
Nella pagina Gestione applicazioni, prendi nota dell'ID media. È necessario configurare l'unità pubblicitaria AdMob nella sezione successiva.
Nella pagina Gestione zone, prendi nota dell'ID zona. Inoltre, sarà necessario per configurare l'unità pubblicitaria AdMob nella sezione successiva.
Passaggio 2: configura la domanda maio nell'interfaccia utente di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Per istruzioni, vedi il passaggio 2 della guida per Android.
Per istruzioni, vedi il passaggio 2 della guida per iOS.
Passaggio 3: importa l'SDK e l'adattatore maio
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
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.
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
Non è necessario alcun codice aggiuntivo per l'integrazione di maio.
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 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 di fondo dalla risposta all'annuncio utilizzando ResponseInfo
nelle seguenti classi:
Formato | Nome del corso |
---|---|
Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Con premio | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
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:
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". |
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 versione 2.1.5.1 di maggio.
- 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 l'adattatore Android maio 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 l'adattatore Android maio 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 di 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 di 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 maggio 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 maio Android Adapter versione 1.1.10.0.
- Supporta l'adattatore per iOS di maggio versione 1.5.1.0.
Versione 1.3.0
- Supporta maio Android Adapter versione 1.1.10.0.
- Supporta l'adattatore per iOS di maio 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.
- 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.
- 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 l'adattatore per iOS maio 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 la versione 1.0.6 dell'SDK Android di maio.
- Supporta la versione 1.2.18 dell'SDK iOS di maio.