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
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.
Prendi nota dell'ID app della tua applicazione.
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.
Inserisci un Nome posizionamento e un Formato annuncio.
Seleziona Header Bidding come Tipo di offerta. Compila il resto del modulo e fai clic su Salva.
Dopo aver creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento.
Fai clic sul menu a discesa 1 unità pubblicitaria e prendi nota dell'ID unità pubblicitaria.
Individuare la chiave API Mintegral Reporting
Offerte
Questo passaggio non è obbligatorio per le integrazioni dell'asta.
Struttura a cascata
Per configurare l'Ad Manager 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' Ad Manager interfaccia utente
Accedi al tuo account Ad Manager.
Aggiungi Mintegral aziende
Offerte
Questo passaggio non è obbligatorio per le integrazioni dell'asta.
Struttura a cascata
Vai ad Amministrazione > Aziende, quindi fai clic sul pulsante Nuova azienda nella scheda Tutte le aziende. Seleziona Rete pubblicitaria.
Seleziona Mintegral come Rete pubblicitaria, inserisci un Nome univoco e attiva Mediazione.
Non è necessario inserire un nome utente o una password. Al termine, fai clic su Salva.
Attiva la condivisione di indicatori sicuri
Offerte
Vai ad Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange, controlla e attiva l'opzione Condivisione di indicatori sicuri. Fai clic su Salva.
Struttura a cascata
Questo passaggio non è obbligatorio per le integrazioni con struttura a cascata.
Configura le Mintegral offerte
Offerte
Vai a Pubblicazione > Offerenti e fai clic su Nuovo offerente nella scheda Offerte dell'SDK.
Seleziona Mintegral come offerente.
Attiva Aggiungi la libreria di indicatori di questo offerente all'elenco degli indicatori consentiti e Consenti la condivisione di indicatori con questo offerente. Poi, fai clic su Continua.
Fai clic su Continua.
Fai clic su Fine.
Struttura a cascata
Questo passaggio non è obbligatorio per le integrazioni con struttura a cascata.
Configura la mappatura delle unità pubblicitarie
Offerte
Vai a Pubblicazione > Offerenti e seleziona la società perMintegral nella scheda Offerte dell'SDK.
Vai alla scheda Mappatura delle unità pubblicitarie e fai clic su Nuova mappatura delle unità pubblicitarie.
Scegli Unità pubblicitaria specifica. Seleziona un'unità pubblicitaria e un formato, App mobile come Tipo di inventario e la tua App mobile. Poi, inserisci App Key, App ID, Placement ID, and Ad Unit ID ottenuto nella sezione precedente. Infine, fai clic su Salva.
Struttura a cascata
Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento. Seleziona la tua App mobile.
Scorri verso il basso e fai clic su Aggiungi partner di rendimento.
Seleziona l'azienda che hai creato per Mintegral nella sezione precedente. Scegli Mediazione SDK mobile come Tipo di integrazione, Android come Piattaforma e Attivo come Stato.
Inserisci il App Key, App ID, Placement ID, and Ad Unit ID ottenuto nella sezione precedente e il valore del CPM predefinito. Fai clic su Salva.
Aggiungi Mintegral all'elenco di partner pubblicitari relativi al GDPR e ai regolamenti statali degli Stati Uniti
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' Ad Manager UI.
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.11.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 ciascuna 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.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.