Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Mintegral utilizzando la mediazione, coprendo sia le integrazioni con la struttura a cascata sia quelle con le offerte. Descrive come aggiungere Mintegral alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di Mintegral in un'app.
Integrazioni e formati degli annunci supportati
L' Ad Manager adattatore di mediazione per Mintegral offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | 1 |
Cascata | 2 |
Formati | |
Apertura app | |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio |
2 L'integrazione della struttura a cascata è in beta chiusa.
Requisiti
- SDK Google Mobile Ads più recente
- Unity 5.6 o versioni successive
- Per 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.
- Completare la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nella UI di Mintegral
Registrati o accedi al tuo account Mintegral.
Individuare la chiave dell'app
Vai alla scheda Impostazioni app e prendi nota della chiave app.
Aggiungere una nuova applicazione
Nella scheda Impostazioni app, fai clic sul pulsante Aggiungi app.
Seleziona la piattaforma e compila il resto del modulo. Poi, fai clic su Salva.
Android
iOS
Prendi nota dell'ID app della tua applicazione.
Android
iOS
Crea un posizionamento dell'annuncio
Dopo aver creato l'applicazione, vai alla scheda Posizionamenti e unità e fai clic sul pulsante Aggiungi posizionamento come mostrato di seguito per creare il posizionamento dell'annuncio.
Android
iOS
Inserisci un Nome posizionamento e un Formato annuncio.
Offerte
Seleziona Offerte su intestazioni come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Cascata
Seleziona Tradizionale come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Dopo aver creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento.
Android
iOS
Fai clic sul menu a discesa 1 unità pubblicitaria e prendi nota dell'ID unità pubblicitaria.
Android
iOS
Individuare la chiave API dei report di Mintegral
Offerte
Questo passaggio non è obbligatorio per le integrazioni delle offerte.
Cascata
Per configurare l'ID unità pubblicitaria AdMob, dovrai disporre della chiave API Mintegral Reporting. Vai ad Account > Strumenti API. Prendi nota di Skey e Secret.
Passaggio 2: configura la domanda di Mintegral nell' Ad Manager 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.
Aggiungere Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti
Segui i passaggi descritti nelle impostazioni GDPR e nelle impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti nell'interfaccia utente di AdMob.
Passaggio 3: importa l'SDK e l'adattatore Mintegral
OpenUPM-CLI
Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Mintegral di Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale del progetto:
openupm add com.google.ads.mobile.mediation.mintegral
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
Successivamente, seleziona Finestra > Gestione pacchetti per aprire il Gestore di pacchetti Unity e seleziona I miei registri dal menu a discesa.
Seleziona il pacchetto Mediazione Mintegral di Google Mobile Ads e fai clic su Installa.
Pacchetto Unity
Scarica la versione più recente del plug-in di mediazione di Google Mobile Ads per Mintegral dal link di download nel Changelog ed estrai il GoogleMobileAdsMintegralMediation.unitypackage
dal file ZIP.
Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto >
Pacchetto personalizzato e trova il
GoogleMobileAdsMintegralMediation.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 è richiesto codice aggiuntivo per l'integrazione di Mintegral.
iOS
Integrazione di SKAdNetwork
Segui la documentazione di Mintegral 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.
Per ottenere annunci di prova Mintegral per banner, annunci interstitial, annunci con premio e formati degli annunci nativi, Mintegral consiglia di utilizzare le chiavi dell'app, gli ID app, gli ID posizionamento e gli ID unità pubblicitarie forniti nella pagina ID test Mintegral.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova da Mintegral, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Mintegral (asta) e Mintegral (struttura a cascata).
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Mintegral, i publisher possono controllare l'errore di fondo della risposta all'annuncio utilizzando
ResponseInfo
nelle seguenti classi:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Mintegral quando non riesce a caricare un annuncio:
Android
Codice di errore | Dominio | Motivo |
---|---|---|
101 | com.google.ads.mediation.mintegral | Parametri del server non validi (ad es. ID app o ID posizionamento mancante). |
102 | com.google.ads.mediation.mintegral | Le dimensioni dell'annuncio richieste non corrispondono a quelle dei banner supportate da Mintegral. |
103 | com.google.ads.mediation.mintegral | Risposta all'offerta mancante o non valida. |
104 | com.google.ads.mediation.mintegral | L'SDK Mintegral ha restituito un errore di mancato riempimento. |
iOS
Codice di errore | Dominio | Motivo |
---|---|---|
101 | com.google.mediation.mintegral | Parametri del server non validi (ad es. ID app o ID posizionamento mancante). |
102 | com.google.mediation.mintegral | L'SDK Mintegral ha restituito un errore di mancato riempimento. |
103 | com.google.mediation.mintegral | L'SDK Mintegral non è riuscito a mostrare un annuncio. |
104 | com.google.mediation.mintegral | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da Mintegral. |
Log delle modifiche del plug-in di mediazione Unity di Mintegral
Versione 1.8.3
- Supporta l'adattatore Android Mintegral versione 16.8.61.0.
- Supporta l'adattatore Mintegral per iOS versione 7.7.3.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.3.0.
Versione 1.8.2
- Supporta l'adattatore Android Mintegral versione 16.8.61.0.
- Supporta l'adattatore Mintegral per iOS versione 7.7.2.1.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.2.1.
Versione 1.8.1
- Supporta l'adattatore Android Mintegral versione 16.8.51.0.
- Supporta l'adattatore Mintegral per iOS versione 7.7.2.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.8.0
- Supporta la versione 16.8.31.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.7.0.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.7.0
DummyClient
rinominato inPlaceholderClient
.- Supporta la versione 16.8.11.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral iOS versione 7.6.9.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.6.5
- Supporta la versione 16.7.81.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.6.8.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.6.4
- Supporta l'adattatore Android Mintegral versione 16.7.61.0.
- Supporta l'adattatore Mintegral per iOS versione 7.6.7.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 1.6.3
- Supporta la versione 16.7.41.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.6.6.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 1.6.2
- Supporta l'adattatore Mintegral Android versione 16.7.41.0.
- Supporta l'adattatore Mintegral per iOS versione 7.6.4.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.6.1
- Supporta l'adattatore Mintegral Android versione 16.7.21.0.
- Supporta l'adattatore Mintegral iOS versione 7.6.3.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.6.0
- Supporta l'adattatore Mintegral Android versione 16.7.11.0.
- Supporta l'adattatore Mintegral per iOS versione 7.6.2.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.0.0.
Versione 1.5.0
- Supporta l'adattatore Android Mintegral versione 16.6.71.0.
- Supporta l'adattatore Mintegral per iOS versione 7.6.0.0.
- Creato e testato con la versione 9.0.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.4.0
- Supporta la versione 16.6.34.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.5.6.0.
- Creato e testato con la versione 8.7.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.3.0
- Supporta la versione 16.5.91.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.5.3.0.
- Sono stati aggiunti i seguenti metodi alla classe
Mintegral
:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- Creato e testato con la versione 8.6.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.2.1
- Supporta la versione 16.4.61.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.3.8.0.
- Creato e testato con la versione 8.3.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.2.0
- I contenuti dell'adattatore sono stati spostati in
GoogleMobileAds/Mediation/Mintegral/
. - Supporta l'adattatore Android Mintegral versione 16.4.41.0.
- Supporta l'adattatore Mintegral per iOS versione 7.3.6.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.3.0.
Versione 1.1.0
- Supporta la versione 16.3.61.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.2.9.1.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.4.1.
Versione 1.0.0
- Versione iniziale.
- Supporta l'adattatore Android Mintegral versione 16.2.61.0.
- Supporta l'adattatore Mintegral per iOS versione 7.2.6.0.
- Sviluppato e testato con la versione 7.3.1 del plug-in Unity degli annunci per dispositivi mobili di Google.