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 Mintegral in un'app Unity.
Integrazioni e formati degli annunci supportati
L'adattatore di Mediazione AdMob per Mintegral offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | |
Formati | |
Apertura app | 1 |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio |
1 Le integrazioni di asta e struttura a cascata per il formato dell'annuncio apertura app sono in versione beta chiusa.
Requisiti
- SDK Google Mobile Ads più recente
- Unity 5.6 o versioni successive
- [Per le offerte]: per integrare tutti i formati di annunci supportati nelle offerte, utilizza il plug-in di mediazione Google Mobile Ads per Mintegral 1.4.0 o versioni successive (è consigliata la versione 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.
- Completare la mediazione Guida introduttiva
Passaggio 1: configura le impostazioni nell'interfaccia utente 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.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=0000&hl=it)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=0000&hl=it)
Prendi nota dell'ID app della tua applicazione.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=0000&hl=it)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=0000&hl=it)
Creare 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.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=0000&hl=it)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=0000&hl=it)
Inserisci un nome del posizionamento e un formato dell'annuncio.
Seleziona Offerte su intestazioni come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Seleziona Tradizionale come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=0000&hl=it)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=0000&hl=it)
Fai clic sul menu a discesa 1 unità pubblicitarie e prendi nota dell'ID unità pubblicitaria.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=0000&hl=it)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=0000&hl=it)
Individuare la chiave API dei report di Mintegral
Questo passaggio non è necessario per le integrazioni delle offerte.
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'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.
Aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti
Segui i passaggi descritti nelle impostazioni relative ai regolamenti europei e nelle impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di AdMob.
Passaggio 3: importa l'SDK e l'adattatore Mintegral
Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Mintegral per 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
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 Mintegral per Google Mobile Ads e fai clic su Installa.
Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per Mintegral dal link di download nel log delle modifiche ed estrai il file 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
Non è necessario alcun codice aggiuntivo per l'integrazione di Mintegral.
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 formati di annunci banner, interstitial, con premio e 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:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
GADMediationAdapterMintegral
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Mintegral quando non riesce a caricare un annuncio:
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 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata 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. |
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 per 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 la versione 16.7.41.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.6.4.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 1.6.1
- Supporta la versione 16.7.21.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.6.3.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 1.6.0
- Supporta la versione 16.7.11.0 dell'adattatore Android Mintegral.
- 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 il plug-in Unity per Google Mobile Ads versione 9.0.0.
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 il plug-in Unity di Google Mobile Ads versione 8.7.0.
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 il plug-in Unity per Google Mobile Ads versione 8.6.0.
Versione 1.2.1
- Supporta l'adattatore Android Mintegral versione 16.4.61.0.
- Supporta l'adattatore Mintegral per iOS versione 7.3.8.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 8.3.0.
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 di Google Mobile Ads versione 8.3.0.
Versione 1.1.0
- Supporta l'adattatore Android Mintegral versione 16.3.61.0.
- 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 la versione 16.2.61.0 dell'adattatore Android Mintegral.
- Supporta l'adattatore Mintegral per iOS versione 7.2.6.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.3.1.