Integrare Mintegral con l'asta (beta)

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di Mintegral utilizzando la mediazione, coprendo le integrazioni sia con struttura a cascata che con asta. Descrive come aggiungere Mintegral alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Mintegral in un' Android app.

Integrazioni e formati degli annunci supportati

L' Ad Manager 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 con struttura a cascata è in versione beta chiusa.

Requisiti

  • Livello API Android 21 o superiore

  • Versione più recente dell'SDK Google Mobile Ads

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

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 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' 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 versioni più recenti dell'SDK e dell'adattatore Mintegral:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:mintegral:16.6.61.0")
}

Integrazione manuale

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

  2. Vai agli elementi dell'adattatore Mintegral nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore Mintegral e aggiungilo al tuo progetto.

Passaggio 4: implementa le impostazioni della privacy su Mintegral SDK

Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che vengano fornite determinate informazioni relative all'utilizzo di identificatori di dispositivi e dati personali agli utenti dello Spazio economico europeo (SEE) e il loro consenso è stato ottenuto. 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 catena di mediazione che potrebbe raccogliere, ricevere o utilizzare i dati personali e fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere 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 assicurarti 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)

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 che gli utenti abbiano il diritto di disattivare la "vendita" delle loro "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben visibile nella home page del "venditore". La guida alla conformità alle leggi statali sulla privacy degli Stati Uniti consente di attivare il trattamento dati limitato per la pubblicazione di annunci Google, ma Google non può applicare questa impostazione a ogni rete pubblicitaria nella catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua 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 inizializzare 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 è necessario codice aggiuntivo per l'integrazione con 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

Aggiungere 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 dell'annuncio

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

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

1 L'adattatore Mintegral non fornisce l'accesso diretto all'asset immagine principale per i propri annunci nativi. Invece, l'adattatore compila MediaView con un video o un'immagine.

Codici di errore

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

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

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Mintegral quando non viene caricato 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 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.
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 dell'adattatore di mediazione Android Mintegral

Versione 16.6.51.0

  • Compatibilità verificata con l'SDK Mintegral 16.6.51.

Realizzato 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 Mintegral SDK 16.6.41.

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

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

Realizzato 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 offerte per il formato dell'annuncio apertura app.

Realizzato 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 Mintegral SDK 16.5.91.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.6.0.

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

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

Realizzato 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 dipendesse dalla versione 22.3.0 dell'SDK Google Mobile Ads.
  • Aggiunto il supporto della struttura a cascata per il formato degli annunci apertura app.

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

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.4.0.
  • SDK Mintegral versione 16.5.21.

Versione 16.5.11.0

  • Aggiunto il supporto della filigrana per gli annunci per l'asta.
  • Compatibilità verificata con Mintegral SDK 16.5.11.

Realizzato 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 Mintegral SDK 16.4.91.

Realizzato 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 Mintegral SDK 16.4.81.

Realizzato 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 Mintegral SDK 16.4.71.

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

Realizzato 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 Mintegral SDK 16.4.51.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.1.0.
  • SDK Mintegral versione 16.4.51.

Versione 16.4.41.0

  • Risolto il problema per cui gli annunci banner venivano visualizzati con dimensioni errate.
  • Compatibilità verificata con Mintegral SDK 16.4.41.

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

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.0.0.
  • SDK Mintegral versione 16.4.31.

Versione 16.4.21.0

  • L'adattatore è stato 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.

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

Realizzato 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 Mintegral SDK 16.3.81.

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

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

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.5.0.
  • SDK Mintegral versione 16.3.61.

Versione 16.3.51.1

  • Aggiunto il supporto a cascata per i formati banner (incluso MREC), interstitial, con premio e nativi.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.5.0.

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

Realizzato 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 Mintegral SDK 16.3.41.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.4.0.

Realizzato 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 Mintegral SDK 16.3.11.
  • Adattatore aggiornato in modo da inoltrare onUserEarnedReward() prima del giorno onAdClosed() durante la pubblicazione degli annunci con premio.

Realizzato 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 banner (incluso MREC), interstitial, con premio e annunci nativi.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.3.0.
  • SDK Mintegral versione 16.2.61.