Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e annunci display di Mintegral con mediazione, coprendo le integrazioni con struttura a cascata e asta. Copre come aggiungere Mintegral alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Mintegral in un Android .
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per Mintegral ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | 1 |
Cascata | 2 |
Formati | |
Apertura app | |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio | |
Nativo |
2 L'integrazione della struttura a cascata è attiva beta chiusa.
Requisiti
- Livello API Android 21 o superiore
Versione più recente dell'SDK Google Mobile Ads
Completare la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nella UI di Mintegral
Passaggio 2: configura la domanda di Mintegral nell' Ad Manager interfaccia utente
Aggiungi Mintegral all'elenco di partner pubblicitari relativi al GDPR e ai regolamenti statali degli Stati Uniti
Passaggio 3: importa l'SDK e l'adattatore Mintegral
Integrazione di Android Studio (consigliata)
Nel file settings.gradle.kts
a livello di progetto, aggiungi quanto segue
repository:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Poi, nel file build.gradle.kts
a livello di app, aggiungi quanto segue
delle dipendenze e configurazioni dell'implementazione. Utilizza le versioni più recenti
SDK e adattatore Mintegral:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.31.0")
}
Integrazione manuale
Per includere l'SDK Mintegral, vai a Mintegral SDK for Android.
Vai alla sezione Artefatti dell'adattatore Mintegral sul Repository Maven di Google. Seleziona la versione più recente e scarica Mintegral del file
.aar
dell'adattatore e aggiungilo al tuo progetto.
Passaggio 4: implementa le impostazioni della privacy nell'SDK Mintegral
Consenso degli utenti dell'UE e GDPR
Ai sensi del Consenso degli utenti dell'UE di Google norme, devi assicurarti che vengano fornite determinate informative e permessi ottenuti dagli utenti dello Spazio economico europeo (SEE) in relazione a all'uso di identificatori dei dispositivi e dati personali. Queste norme riflettono Requisiti della direttiva e-Privacy e della direttiva generale sulla protezione dei dati dell'UE Regolamento (GDPR). Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può raccogliere, ricevere o utilizzare dati personali, fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere automaticamente a queste reti la scelta dell'utente relativa al consenso.
L'SDK Mintegral include il metodo setConsentStatus
per trasmettere il consenso
le informazioni sull'SDK Mintegral.
Il codice di esempio seguente mostra come passare le informazioni sul consenso a Mintegral l'SDK. Queste opzioni devono essere impostate prima inizializzare l'SDK Google Mobile Ads per garantire che vengano inoltrati correttamente all'SDK Mintegral.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Consulta la documentazione sulla privacy di Mintegral per ulteriori informazioni.
Leggi statali sulla privacy degli Stati Uniti
Stati Uniti leggi statali sulla privacy richiedono dare agli utenti il diritto di disattivare la "vendita" delle loro "informazioni personali" (come definisce la legge tali termini), con la possibilità di disattivare la funzionalità tramite un messaggio "Non vendere i miei dati personali" in evidenza informazioni" sul link "venduto" sulla home page del gruppo. La Stati Uniti privacy degli stati la guida alla conformità alle leggi offre la possibilità di abilitare trattamento dati limitato per la pubblicazione di annunci Google, ma Google non può applicare questa impostazione a ciascun annuncio nella tua catena di mediazione. Di conseguenza, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può partecipare alla vendita di e seguire le indicazioni di ciascuna di queste reti per garantire conformità.
L'SDK Mintegral include il metodo setDoNotTrackStatus
per trasmettere il consenso
le informazioni sull'SDK Mintegral.
Il codice di esempio seguente mostra come passare le informazioni sul consenso a Mintegral l'SDK. Se devi chiamare questo metodo, chiamalo dopo inizializzazione dell'SDK Google Mobile Ads ma prima di richiedere annunci tramite l'SDK Google Mobile Ads.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
Consulta la documentazione sulla privacy di Mintegral per ulteriori informazioni.
Passaggio 5: aggiungi il codice richiesto
Non è richiesto codice aggiuntivo per l'integrazione di Mintegral.
Passaggio 6: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager
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 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.
Passaggi facoltativi
Aggiungi Mintegral all'elenco di partner pubblicitari CCPA
Segui i passaggi in Impostazioni CCPA per aggiungere Mintegral all'elenco di partner pubblicitari CCPA nella Ad Manager UI.
Annunci nativi
Rendering degli annunci
L'adattatore Mintegral restituisce gli annunci nativi
NativeAd
di oggetti strutturati. Compila i seguenti campi
campi
per un
NativeAd
Campo | Asset sempre inclusi dall'adattatore Mintegral |
---|---|
Titolo | |
Immagine | 1 |
Corpo | |
Icona | |
Call to action | |
Valutazione a stelle | |
Negozio | |
Prezzo | |
Inserzionista |
1 L'adattatore Mintegral non
fornire accesso diretto all'asset immagine principale per gli annunci nativi. Invece,
l'adattatore compila la
MediaView
con un video o un'immagine.
Codici di errore
Se l'adattatore non riceve un annuncio da Mintegral, puoi controllare
un errore sottostante della risposta all'annuncio
ResponseInfo.getAdapterResponses()
nelle seguenti classi:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Ecco i codici e i relativi messaggi generati dall'adattatore Mintegral Quando un annuncio non viene caricato:
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. |
Log delle modifiche dell'adattatore di mediazione Android Mintegral
Versione 16.8.31.0
- Compatibilità verificata con l'SDK Mintegral 16.8.31.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK Mintegral versione 16.8.31.
Versione 16.8.11.0
- È stata verificata la compatibilità con l'SDK Mintegral 16.8.11.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK Mintegral versione 16.8.11.
Versione 16.7.91.0
- Compatibilità verificata con l'SDK Mintegral 16.7.91.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK Mintegral versione 16.7.91.
Versione 16.7.81.0
- Compatibilità verificata con l'SDK Mintegral 16.7.81.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK Mintegral versione 16.7.81.
Versione 16.7.71.0
- Compatibilità verificata con l'SDK Mintegral 16.7.71.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Mintegral versione 16.7.71.
Versione 16.7.61.0
- Compatibilità verificata con l'SDK Mintegral 16.7.61.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Mintegral versione 16.7.61.
Versione 16.7.51.0
- Compatibilità verificata con l'SDK Mintegral 16.7.51.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Mintegral versione 16.7.51.
Versione 16.7.41.0
- Compatibilità verificata con l'SDK Mintegral 16.7.41.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Mintegral versione 16.7.41.
Versione 16.7.31.0
- Compatibilità verificata con l'SDK Mintegral 16.7.31.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Mintegral versione 16.7.31.
Versione 16.7.21.0
- Compatibilità verificata con l'SDK Mintegral 16.7.21.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Mintegral versione 16.7.21.
Versione 16.7.11.0
- È stata verificata la compatibilità con l'SDK Mintegral 16.7.11.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Mintegral versione 16.7.11.
Versione 16.6.71.0
- Compatibilità verificata con l'SDK Mintegral 16.6.71.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Mintegral versione 16.6.71.
Versione 16.6.61.0
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.0.0.
- Compatibilità verificata con l'SDK Mintegral 16.6.61.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Mintegral versione 16.6.61.
Versione 16.6.51.0
- Compatibilità verificata con l'SDK Mintegral 16.6.51.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Mintegral versione 16.6.51.
Versione 16.6.41.0
- Compatibilità verificata con l'SDK Mintegral 16.6.41.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Mintegral versione 16.6.41.
Versione 16.6.34.0
- Compatibilità verificata con l'SDK Mintegral 16.6.34.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Mintegral versione 16.6.34.
Versione 16.6.21.0
- Compatibilità verificata con l'SDK Mintegral 16.6.21.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Mintegral versione 16.6.21.
Versione 16.5.91.1
- Aggiunto il supporto delle aste per il formato dell'annuncio apertura app.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Mintegral versione 16.5.91.
Versione 16.5.91.0
- Compatibilità verificata con l'SDK Mintegral 16.5.91.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.6.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Mintegral versione 16.5.91.
Versione 16.5.51.0
- Compatibilità verificata con l'SDK Mintegral 16.5.51.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- SDK Mintegral versione 16.5.51.
Versione 16.5.41.0
- Compatibilità verificata con l'SDK Mintegral 16.5.41.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- SDK Mintegral versione 16.5.41.
Versione 16.5.31.0
- Compatibilità verificata con l'SDK Mintegral 16.5.31.
- È stato ripristinato l'adattatore in modo che dipenda dalla versione 22.3.0 dell'SDK Google Mobile Ads.
- È stato aggiunto il supporto della struttura a cascata per il formato dell'annuncio apertura app.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- SDK Mintegral versione 16.5.31.
Versione 16.5.21.0
- Compatibilità verificata con l'SDK Mintegral 16.5.21.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.4.0.
- SDK Mintegral versione 16.5.21.
Versione 16.5.11.0
- È stato aggiunto il supporto della filigrana per gli annunci con asta.
- È stata verificata la compatibilità con l'SDK Mintegral 16.5.11.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Mintegral versione 16.5.11.
Versione 16.4.91.0
- Compatibilità verificata con l'SDK Mintegral 16.4.91.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Mintegral versione 16.4.91.
Versione 16.4.81.0
- Compatibilità verificata con l'SDK Mintegral 16.4.81.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Mintegral versione 16.4.81.
Versione 16.4.71.0
- Compatibilità verificata con l'SDK Mintegral 16.4.71.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Mintegral versione 16.4.71.
Versione 16.4.61.0
- Compatibilità verificata con l'SDK Mintegral 16.4.61.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.1.0.
- SDK Mintegral versione 16.4.61.
Versione 16.4.51.0
- Compatibilità verificata con l'SDK Mintegral 16.4.51.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.1.0.
- SDK Mintegral versione 16.4.51.
Versione 16.4.41.0
- È stato risolto un problema per cui gli annunci banner venivano visualizzati con dimensioni non corrette.
- Compatibilità verificata con l'SDK Mintegral 16.4.41.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Mintegral versione 16.4.41.
Versione 16.4.31.0
- Compatibilità verificata con l'SDK Mintegral 16.4.31.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Mintegral versione 16.4.31.
Versione 16.4.21.0
- Adattatore aggiornato per utilizzare la nuova classe
VersionInfo
. - La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.
- Compatibilità verificata con l'SDK Mintegral 16.4.21.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Mintegral versione 16.4.21.
Versione 16.3.91.0
- Compatibilità verificata con l'SDK Mintegral 16.3.91.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Mintegral versione 16.3.91.
Versione 16.3.81.0
- Compatibilità verificata con l'SDK Mintegral 16.3.81.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Mintegral versione 16.3.81.
Versione 16.3.71.0
- Compatibilità verificata con l'SDK Mintegral 16.3.71.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Mintegral versione 16.3.71.
Versione 16.3.61.0
- Compatibilità verificata con l'SDK Mintegral 16.3.61.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Mintegral versione 16.3.61.
Versione 16.3.51.1
- È stato aggiunto il supporto della struttura a cascata per i formati di annunci banner (inclusi MREC), interstitial, con premio e nativi.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.5.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Mintegral versione 16.3.51.
Versione 16.3.51.0
- Compatibilità verificata con l'SDK Mintegral 16.3.51.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.4.0.
- SDK Mintegral versione 16.3.51.
Versione 16.3.41.0
- Compatibilità verificata con l'SDK Mintegral 16.3.41.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.4.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.4.0.
- SDK Mintegral versione 16.3.41.
Versione 16.3.11.0
- Compatibilità verificata con l'SDK Mintegral 16.3.11.
- È stato aggiornato l'adattatore in modo da inoltrare
onUserEarnedReward()
prima del giornoonAdClosed()
durante la pubblicazione degli annunci con premio.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.3.0.
- SDK Mintegral versione 16.3.11.
Versione 16.2.61.0
- Versione iniziale
- Aggiunto il supporto delle offerte per i formati di annunci banner (incluso MREC), interstitial, con premio e nativi.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.3.0.
- SDK Mintegral versione 16.2.61.