Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Mintegral utilizzando la mediazione, coprendo le integrazioni sia con struttura a cascata che con asta. Viene spiegato come aggiungere Mintegral alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK Mintegral in un'app Unity.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per Mintegral ha le seguenti funzionalità:
| Integrazione | ||
|---|---|---|
| Offerte | 1 | |
| Struttura a cascata | 2 | |
| Formati | ||
| Apertura app | 1 2 | |
| Banner | ||
| Interstitial | ||
| Con premio | ||
| Interstitial con premio | ||
2 L'integrazione delle offerte per questo formato è in versione beta chiusa.
Requisiti
- Unity 5.6 o successive
- Versione più recente dell'SDK Google Mobile Ads
- Per eseguire il deployment su Android
- Livello API Android 19 o superiore
- Per eseguire il deployment su iOS
- Target di deployment per 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 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.
Aggiungi una nuova applicazione
Dalla 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
Una volta creata l'applicazione, accedi 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 Header Bidding come Tipo di offerta. Compila il resto del modulo e fai clic su Salva.
Struttura a 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 Mintegral Reporting
Offerte
Questo passaggio non è obbligatorio per le integrazioni dell'asta.
Struttura a cascata
Per configurare l'AdMob ID unità pubblicitaria, avrai bisogno della tua chiave API Mintegral Reporting. Vai ad Account > Strumenti API. Prendi nota della tua Skey e del Secret.
Passaggio 2: configura la domanda di Mintegral nell' AdMob 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.
Aggiungi Mintegral all'elenco di partner pubblicitari ai sensi delle normative GDPR e degli stati USA
Segui i passaggi descritti in Impostazioni GDPR e Impostazioni relative alle normative statali degli Stati Uniti per aggiungere Mintegral all'elenco di partner pubblicitari per le normative GDPR e statali degli Stati Uniti nell' AdMob UI.
Passaggio 3: importa l'SDK e l'adattatore Mintegral
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 GoogleMobileAdsMintegralMediation.unitypackage dal file ZIP.
Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e individua il file GoogleMobileAdsMintegralMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.
Quindi, seleziona Asset > Play Services Resolver > Android Resolver > Forza risoluzione. La libreria di resolver Unity Play Services eseguirà 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 codice aggiuntivo per l'integrazione con 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
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per AdMob
Per ottenere annunci di test Mintegral per banner, interstitial, annunci con premio e formati di annunci nativi, Mintegral consiglia di utilizzare le chiavi app, gli ID app, gli ID posizionamento e gli ID unità pubblicitaria forniti nella Pagina dell'ID test Mintegral.
Verifica annunci di prova
Per verificare di ricevere annunci di prova daMintegral, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Mintegral (Bidding) and Mintegral (Waterfall) origini annuncio.
Codici di errore
Se l'adattatore non riceve un annuncio da Mintegral, i publisher possono controllare l'errore sottostante dalla risposta di 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 viene caricato 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 | 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. |
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 per la mediazione Mintegral Unity
Versione 1.4.0
- Supporta l'adattatore Android Mintegral versione 16.6.34.0.
- Supporta l'adattatore Mintegral per iOS versione 7.5.6.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 8.7.0.
Versione 1.3.0
- Supporta l'adattatore Android Mintegral versione 16.5.91.0.
- Supporta l'adattatore Mintegral per iOS versione 7.5.3.0.
- Sono stati aggiunti i seguenti metodi alla classe
Mintegral:SetConsentStatus(bool)SetDoNotTrackStatus(bool)
- Costruito e testato con il plug-in Unity di 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.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 8.3.0.
Versione 1.2.0
- Contenuti dell'adattatore 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.
- Costruito 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.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.4.1.
Versione 1.0.0
- Release iniziale
- Supporta l'adattatore Android Mintegral versione 16.2.61.0.
- Supporta l'adattatore Mintegral per iOS versione 7.2.6.0.
- Costruito e testato con il plug-in Unity di Google Mobile Ads versione 7.3.1.