Integrare Mintegral con l'asta (beta)

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à:

² 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

Passaggio 2: configura la domanda di Mintegral nell' Ad Manager interfaccia utente

Accedi al tuo account Ad Manager.

Aggiungi Mintegral aziende

Attiva la condivisione di indicatori sicuri

Configura le Mintegral offerte

Configura la mappatura delle unità pubblicitarie

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.2.0")
    implementation("com.google.ads.mediation:mintegral:16.7.81.0")
}

Integrazione manuale

1. Per includere l'SDK Mintegral, vai a Mintegral SDK for Android.

2. 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.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

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.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

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

¹ 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:

Log delle modifiche dell'adattatore di mediazione Android Mintegral

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 giorno onAdClosed() 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.