Integrare Mintegral con l'asta (beta)

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da Mintegral utilizzando mediazione, che copre sia le integrazioni con struttura a cascata che per Asta. Spiega come aggiungere Mintegral alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Mintegral in un'appAndroid .

Integrazioni e formati degli annunci supportati

L'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
Nativo  1  3
1 L'integrazione delle offerte è in versione beta chiusa.

2 L'integrazione della struttura a cascata è in versione beta chiusa.

Requisiti

  • Livello API Android 21 o superiore

  • Versione più recente dell'SDK Google Mobile Ads

  • Completa la Guida introduttiva di mediazione

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

Nel file settings.gradle.kts a livello di progetto, aggiungi i seguenti 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 le seguenti dipendenze e configurazioni di implementazione. Utilizza le ultime versioni dell'SDK e dell'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. Passa agli artefatti dell'adattatore Mintegral nel Repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore Mintegral e aggiungilo al progetto.

Passaggio 4: implementa le impostazioni della privacy nell'SDK Mintegral

Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi garantire che vengano fornite determinate informative agli utenti dello Spazio economico europeo (SEE) e i consensi ottenuti in merito all'utilizzo degli identificatori dei dispositivi e dei dati personali. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può raccogliere, ricevere o utilizzare dati personali e fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di passare automaticamente la scelta dell'utente relativa al consenso a queste reti.

L'SDK Mintegral include il metodo setConsentStatus per passare le informazioni sul consenso all'SDK Mintegral.

Il seguente codice campione mostra come passare le informazioni sul consenso all'SDK Mintegral. Queste opzioni devono essere impostate prima di inizializzare l'SDK Google Mobile Ads per garantire che vengano inoltrate 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)

Per ulteriori informazioni, consulta la documentazione sulla privacy di Mintegral.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti richiedono agli utenti di dare agli utenti il diritto di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di tale normativa), con l'opzione di disattivazione offerta tramite un link"Non vendere le mie informazioni personali " in evidenza nella home page del"venditore". La guida alla conformità alle leggi statali sulla privacy degli Stati Uniti offre la possibilità di attivare il trattamento dati limitato per la pubblicazione di annunci di Google, ma Google non è in grado di applicare questa impostazione a tutte le reti pubblicitarie nella tua catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella catena di mediazione che può partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

L'SDK Mintegral include il metodo setDoNotTrackStatus per passare le informazioni sul consenso all'SDK Mintegral.

Il seguente codice campione mostra come passare le informazioni sul consenso all'SDK Mintegral. Se devi chiamare questo metodo, chiamalo dopo inizializzando l'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)

Per ulteriori informazioni, consulta la documentazione sulla privacy di Mintegral.

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 dei partner pubblicitari CCPA nell' Ad Manager UI.

Annunci nativi

Rendering degli annunci

L'adattatore Mintegral restituisce gli annunci nativi come NativeAd oggetti. Compila i seguenti campi per un NativeAd.

Campo Asset sempre inclusi dall'adattatore Mintegral
Titolo
Immagine 1
Corpo
Icona
Call to action
Star rating
Negozio
Prezzo
Advertiser

1 L'adattatore Mintegral non fornisce accesso diretto all'asset immagine principale per gli annunci nativi. L'adattatore compila invece MediaView con un video o un'immagine.

Codici di errore

Se l'adattatore non riceve un annuncio da Mintegral, puoi controllare l'errore sottostante della risposta dell'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore Mintegral quando non è possibile 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 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.
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 Le dimensioni dell'annuncio richieste non corrispondono a quelle dei banner supportate da Mintegral.

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.