Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Mintegral utilizzando la mediazione, coprendo sia le integrazioni con la struttura a cascata sia quelle con le offerte. Descrive come aggiungere Mintegral alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Mintegral in un'app per Android.
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per Mintegral offre 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 è in beta chiusa.
Requisiti
Livello API Android 21 o superiore
[Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l'adattatore Mintegral 16.5.91.1 o versioni successive (è consigliata la versione più recente)
SDK Google Mobile Ads più recente
Completare la mediazione Guida introduttiva
Passaggio 1: configura le impostazioni nell'interfaccia utente 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.
Aggiungere una nuova applicazione
Nella 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.
Creare un posizionamento dell'annuncio
Dopo aver creato l'applicazione, vai 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 del posizionamento e un formato dell'annuncio.
Seleziona Offerte su intestazioni come Tipo di offerta. Compila la parte restante del modulo e fai clic su Salva.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento.
Fai clic sul menu a discesa 1 unità pubblicitarie e prendi nota dell'ID unità pubblicitaria.
Individuare la chiave API dei report di Mintegral
Offerte
Questo passaggio non è obbligatorio per le integrazioni delle offerte.
Cascata
Per configurare l'ID unità pubblicitaria di Ad Manager, dovrai disporre della chiave API Mintegral Reporting. Vai ad Account > Strumenti API. Prendi nota di Skey e Secret.
Passaggio 2: configura la domanda di Mintegral nell'interfaccia utente di Ad Manager
Accedi al tuo account Ad Manager.
Aggiungere Mintegral nelle aziende
Offerte
Questo passaggio non è obbligatorio per le integrazioni delle offerte.
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 Nome utente o Password. Al termine, fai clic su Salva.
Attivare la condivisione di indicatori sicuri
Offerte
Vai ad Amministrazione > Impostazioni globali. Vai alla scheda Impostazioni account Ad Exchange, controlla e attiva Condivisione di indicatori sicuri. Fai clic su Salva.
Cascata
Questo passaggio non è necessario per le integrazioni con struttura a cascata.
Configurare le offerte Mintegral
Offerte
Vai a Pubblicazione > Offerenti e fai clic su Nuovo offerente nella scheda SDK Bidding.
Seleziona Mintegral come offerente.
Attiva Aggiungi la libreria di indicatori di questo offerente all'elenco di indicatori consentiti e Consenti la condivisione di indicatori con questo offerente. Poi fai clic su Continua.
Fai clic su Continua.
Fai clic su Fine.
Cascata
Questo passaggio non è necessario per le integrazioni con struttura a cascata.
Configurare la mappatura delle unità pubblicitarie
Offerte
Vai a Pubblicazione > Offerenti e seleziona la società per Mintegral nella scheda SDK Bidding.
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 applicazione mobile. Poi, inserisci App Key, App ID, Placement ID e Ad Unit ID ottenuti nella sezione precedente. Infine, fai clic su Salva.
Cascata
Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento. Seleziona l'applicazione 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 per dispositivi mobili come Tipo di integrazione, Android come Piattaforma e Attivo come Stato.
Inserisci App Key, ID app, ID posizionamento e ID unità pubblicitaria ottenuti nella sezione precedente, nonché il valore CPM predefinito. Fai clic su Salva.
Aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti
Segui i passaggi descritti nelle impostazioni GDPR e nelle impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti nell'interfaccia utente di Ad Manager.
Passaggio 3: importa l'SDK e l'adattatore Mintegral
Integrazione di Android Studio (consigliata)
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 configurazioni e dipendenze di implementazione. Utilizza le versioni più recenti dell'SDK e dell'adattatore Mintegral:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}
Integrazione manuale
Per includere l'SDK Mintegral, vai a SDK Mintegral per Android.
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 progetto.
Passaggio 4: implementa le impostazioni della privacy nell'SDK Mintegral
Consenso degli utenti dell'UE e GDPR
Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che determinate informative vengano fornite agli utenti nello Spazio economico europeo (SEE) e che questi abbiano dato il loro consenso all'utilizzo di identificatori dei dispositivi e 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 catena di mediazione che potrebbe raccogliere, ricevere o utilizzare dati personali e fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere automaticamente la scelta dell'utente in merito al consenso a queste reti.
L'SDK Mintegral include il metodo setConsentStatus
per trasmettere le informazioni sul consenso all'SDK Mintegral.
Il seguente codice di esempio mostra come trasmettere le informazioni sul consenso all'SDK Mintegral. Queste opzioni devono essere impostate prima di inizializzare l'SDK Google Mobile Ads per assicurarti 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 di garantire agli utenti il diritto di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante un link ben visibile e recante la dicitura "Non vendere i miei dati personali" 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 Google, ma Google non è in grado di applicare questa impostazione a ogni rete pubblicitaria nella catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che potrebbe partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la compliance.
L'SDK Mintegral include il metodo setDoNotTrackStatus
per trasmettere informazioni sul consenso all'SDK Mintegral.
Il seguente codice di esempio mostra come trasmettere le informazioni sul consenso all'SDK Mintegral. Se devi chiamare questo metodo, chiamalo dopo aver inizializzato l'SDK Google Mobile Ads ma prima di richiedere gli 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 alcun codice aggiuntivo per l'integrazione di Mintegral.
Passaggio 6: testa l'implementazione
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager.
Per ottenere annunci di prova Mintegral per formati di annunci banner, interstitial, con premio e nativi, Mintegral consiglia di utilizzare le chiavi dell'app, gli ID app, gli ID posizionamento e gli ID unità pubblicitarie forniti nella pagina ID di test Mintegral.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova da Mintegral, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Mintegral (asta) e Mintegral (struttura a cascata).
Passaggi facoltativi
Aggiungere Mintegral all'elenco dei partner pubblicitari CCPA
Segui i passaggi descritti in Impostazioni CCPA per aggiungere Mintegral all'elenco dei partner pubblicitari CCPA nell'UI di Ad Manager.
Annunci nativi
Rendering dell'annuncio
L'adattatore Mintegral restituisce i suoi 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 | |
Valutazione a stelle | |
Negozio | |
Prezzo | |
Inserzionista |
1 L'adattatore Mintegral non fornisce accesso diretto all'asset immagine principale per i suoi annunci nativi. L'adattatore compila invece il campo MediaView
con un video o un'immagine.
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Mintegral, puoi controllare l'errore di fondo dalla risposta all'annuncio utilizzando
ResponseInfo.getAdapterResponses()
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 riesce a 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 | 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. |
Log delle modifiche dell'adattatore di mediazione Android di Mintegral
Versione successiva
- Inizializza l'SDK Mintegral in un thread in background (per correggere gli errori ANR).
Versione 16.8.61.0
- Compatibilità verificata con l'SDK Mintegral 16.8.61.
Creato e testato con:
- SDK Google Mobile Ads versione 23.3.0.
- SDK Mintegral versione 16.8.61.
Versione 16.8.51.0
- Compatibilità verificata con l'SDK Mintegral 16.8.51.
Creato e testato con:
- SDK Google Mobile Ads versione 23.3.0.
- Versione dell'SDK Mintegral 16.8.51.
Versione 16.8.41.0
- Compatibilità verificata con l'SDK Mintegral 16.8.41.
Creato e testato con:
- SDK Google Mobile Ads versione 23.3.0.
- Versione dell'SDK Mintegral 16.8.41.
Versione 16.8.31.0
- Compatibilità verificata con l'SDK Mintegral 16.8.31.
Creato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- Versione dell'SDK Mintegral 16.8.31.
Versione 16.8.11.0
- Compatibilità verificata con l'SDK Mintegral 16.8.11.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- Versione dell'SDK Mintegral 16.7.91.
Versione 16.7.81.0
- Compatibilità verificata con l'SDK Mintegral 16.7.81.
Creato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- Versione SDK Mintegral 16.7.81.
Versione 16.7.71.0
- Compatibilità verificata con l'SDK Mintegral 16.7.71.
Creato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- Versione dell'SDK Mintegral 16.7.71.
Versione 16.7.61.0
- Compatibilità verificata con l'SDK Mintegral 16.7.61.
Creato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- Versione dell'SDK Mintegral 16.7.61.
Versione 16.7.51.0
- Compatibilità verificata con l'SDK Mintegral 16.7.51.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- Versione dell'SDK Mintegral 16.7.41.
Versione 16.7.31.0
- Compatibilità verificata con l'SDK Mintegral 16.7.31.
Creato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- Versione dell'SDK Mintegral 16.7.31.
Versione 16.7.21.0
- Compatibilità verificata con l'SDK Mintegral 16.7.21.
Creato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- Versione dell'SDK Mintegral 16.7.21.
Versione 16.7.11.0
- Compatibilità verificata con l'SDK Mintegral 16.7.11.
Creato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- Versione dell'SDK Mintegral 16.7.11.
Versione 16.6.71.0
- Compatibilità verificata con l'SDK Mintegral 16.6.71.
Creato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- Versione dell'SDK Mintegral 16.6.71.
Versione 16.6.61.0
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 23.0.0.
- Compatibilità verificata con l'SDK Mintegral 16.6.61.
Creato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- Versione dell'SDK Mintegral 16.6.61.
Versione 16.6.51.0
- Compatibilità verificata con l'SDK Mintegral 16.6.51.
Creato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- Versione dell'SDK Mintegral 16.6.51.
Versione 16.6.41.0
- Compatibilità verificata con l'SDK Mintegral 16.6.41.
Creato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- Versione dell'SDK Mintegral 16.6.41.
Versione 16.6.34.0
- Compatibilità verificata con l'SDK Mintegral 16.6.34.
Creato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- Versione dell'SDK Mintegral 16.6.34.
Versione 16.6.21.0
- Compatibilità verificata con l'SDK Mintegral 16.6.21.
Creato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- Versione dell'SDK Mintegral 16.6.21.
Versione 16.5.91.1
- È stato aggiunto il supporto per le offerte per il formato dell'annuncio di apertura dell'app.
Creato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- Versione dell'SDK Mintegral 16.5.91.
Versione 16.5.91.0
- Compatibilità verificata con l'SDK Mintegral 16.5.91.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.6.0.
Creato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- Versione dell'SDK Mintegral 16.5.91.
Versione 16.5.51.0
- Compatibilità verificata con l'SDK Mintegral 16.5.51.
Creato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- Versione dell'SDK Mintegral 16.5.51.
Versione 16.5.41.0
- Compatibilità verificata con l'SDK Mintegral 16.5.41.
Creato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- Versione dell'SDK Mintegral 16.5.41.
Versione 16.5.31.0
- Compatibilità verificata con l'SDK Mintegral 16.5.31.
- È stata ripristinata la dipendenza dell'adattatore dalla versione 22.3.0 dell'SDK Google Mobile Ads.
- È stato aggiunto il supporto della struttura a cascata per il formato dell'annuncio di apertura dell'app.
Creato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- Versione dell'SDK Mintegral 16.5.31.
Versione 16.5.21.0
- Compatibilità verificata con l'SDK Mintegral 16.5.21.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.4.0.
Creato e testato con:
- SDK Google Mobile Ads versione 22.4.0.
- Versione dell'SDK Mintegral 16.5.21.
Versione 16.5.11.0
- È stato aggiunto il supporto della filigrana per gli annunci per l'asta.
- Compatibilità verificata con l'SDK Mintegral 16.5.11.
Creato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- Versione dell'SDK Mintegral 16.5.11.
Versione 16.4.91.0
- Compatibilità verificata con l'SDK Mintegral 16.4.91.
Creato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- Versione dell'SDK Mintegral 16.4.91.
Versione 16.4.81.0
- Compatibilità verificata con l'SDK Mintegral 16.4.81.
Creato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- Versione dell'SDK Mintegral 16.4.81.
Versione 16.4.71.0
- Compatibilità verificata con l'SDK Mintegral 16.4.71.
Creato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- Versione dell'SDK Mintegral 16.4.71.
Versione 16.4.61.0
- Compatibilità verificata con l'SDK Mintegral 16.4.61.
Creato e testato con:
- SDK Google Mobile Ads versione 22.1.0.
- Versione dell'SDK Mintegral 16.4.61.
Versione 16.4.51.0
- Compatibilità verificata con l'SDK Mintegral 16.4.51.
Creato e testato con:
- SDK Google Mobile Ads versione 22.1.0.
- Versione dell'SDK Mintegral 16.4.51.
Versione 16.4.41.0
- È stato risolto un problema per cui gli annunci banner venivano visualizzati con dimensioni errate.
- Compatibilità verificata con l'SDK Mintegral 16.4.41.
Creato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- Versione dell'SDK Mintegral 16.4.41.
Versione 16.4.31.0
- Compatibilità verificata con l'SDK Mintegral 16.4.31.
Creato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- Versione dell'SDK Mintegral 16.4.31.
Versione 16.4.21.0
- L'adattatore è stato aggiornato per utilizzare la nuova classe
VersionInfo
. - È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.0.0.
- Compatibilità verificata con l'SDK Mintegral 16.4.21.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- Versione dell'SDK Mintegral 16.3.91.
Versione 16.3.81.0
- Compatibilità verificata con l'SDK Mintegral 16.3.81.
Creato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- Versione dell'SDK Mintegral 16.3.81.
Versione 16.3.71.0
- Compatibilità verificata con l'SDK Mintegral 16.3.71.
Creato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- Versione dell'SDK Mintegral 16.3.71.
Versione 16.3.61.0
- Compatibilità verificata con l'SDK Mintegral 16.3.61.
Creato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- Versione dell'SDK Mintegral 16.3.61.
Versione 16.3.51.1
- È stato aggiunto il supporto della struttura a cascata per i formati degli annunci banner (inclusi gli annunci MREC), interstitial, con premio e nativi.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.5.0.
Creato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- Versione dell'SDK Mintegral 16.3.51.
Versione 16.3.51.0
- Compatibilità verificata con l'SDK Mintegral 16.3.51.
Creato e testato con:
- SDK Google Mobile Ads versione 21.4.0.
- Versione dell'SDK Mintegral 16.3.51.
Versione 16.3.41.0
- Compatibilità verificata con l'SDK Mintegral 16.3.41.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.4.0.
Creato e testato con:
- SDK Google Mobile Ads versione 21.4.0.
- Versione dell'SDK Mintegral 16.3.41.
Versione 16.3.11.0
- Compatibilità verificata con l'SDK Mintegral 16.3.11.
- L'adattatore è stato aggiornato in modo da inoltrare
onUserEarnedReward()
prima dionAdClosed()
quando vengono mostrati gli annunci con premio.
Creato e testato con:
- SDK Google Mobile Ads versione 21.3.0.
- Versione dell'SDK Mintegral 16.3.11.
Versione 16.2.61.0
- Versione iniziale
- È stato aggiunto il supporto per le offerte per i formati degli annunci banner (inclusi gli annunci MREC), interstitial, con premio e nativi.
Creato e testato con:
- SDK Google Mobile Ads versione 21.3.0.
- Versione dell'SDK Mintegral 16.2.61.