Integra Mintegral con la mediazione

Seleziona la piattaforma: Android (beta) Android iOS Unity Flutter

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci display di Mintegral utilizzando la mediazione, che copre sia le integrazioni a cascata sia quelle delle 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 ha le seguenti funzionalità:

Requisiti

• Livello API Android 24 o versioni successive

• [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)

• Più recente GMA Next-Gen SDK.

• Completa la Guida introduttiva alla mediazione .

Passaggio 1: configura le impostazioni nell'interfaccia utente di Mintegral

Registrati o accedi al tuo account Mintegral.

Individua la chiave dell'app

Vai alla scheda Impostazioni app e prendi nota della chiave dell'app.

Aggiungi una nuova applicazione

Nella scheda Impostazioni app, fai clic sul pulsante Aggiungi app.

Seleziona la piattaforma e compila il resto del modulo. Quindi, fai clic su Salva.

Prendi nota dell'ID app della tua applicazione.

Crea un posizionamento dell'annuncio

Una volta creata 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 il resto 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.

Individua la chiave API di reporting di Mintegral

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario di annunci per app della tua app solo in canali che hai indicato come autorizzati. Per evitare una riduzione significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, crea un file app-ads.txt per Ad Manager.

Per implementare app-ads.txt per Mintegral, consulta la pagina Come app-ads.txt può aiutare a combattere le frodi pubblicitarie.

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

Accedi al tuo account Ad Manager.

Aggiungi Mintegral in Aziende

Attiva la condivisione di indicatori sicuri

Condividi indicatori sicuri nelle richieste di offerta

Consenti la condivisione di indicatori sicuri per SDK Bidding

Configura le offerte di Mintegral

Configura la mappatura delle unità pubblicitarie

Aggiungi Mobvista/Mintegral all'elenco dei partner pubblicitari per il GDPR e le normative statali degli Stati Uniti

Segui i passaggi descritti nelle impostazioni dei regolamenti europei e nelle impostazioni dei regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco dei partner pubblicitari per i regolamenti europei e 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")
    }
  }
}

Nel file Gradle a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mintegral:17.0.91.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.91.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrazione manuale

1. Per includere l'SDK Mintegral, vai alla pagina SDK Mintegral per Android.

2. Vai 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 tuo progetto.

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

Consenso dell'UE e GDPR

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, è obbligatorio informare i tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ricevere il loro consenso per l'utilizzo dei cookie o di altri tipi di archiviazione locale, laddove richiesto dalla legge, nonché per la raccolta, la condivisione e l'utilizzo dei dati personali ai fini della personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. È tua responsabilità verificare che il consenso venga propagato a ogni origine annuncio nella catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta di consenso dell'utente a queste reti.

L'SDK Mintegral include il metodo setConsentStatus per trasmettere 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 GMA Next-Gen SDK per assicurarti che vengano inoltrate 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)

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

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti impongono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben 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 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 catena di mediazione che potrebbe 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 trasmettere 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 aver inizializzato GMA Next-Gen SDK ma prima di richiedere gli annunci tramite GMA Next-Gen SDK.

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)

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

Passaggio 5: aggiungi il codice richiesto

Non è necessario aggiungere altro codice per l'integrazione di Mintegral.

Passaggio 6: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per Ad Manager.

Per ottenere annunci di prova di Mintegral per i 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à pubblicitaria forniti nella pagina ID di test di Mintegral.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova da Mintegral, attiva il test di una singola origine annuncio nello Strumento di controllo degli annunci utilizzando le origini annuncio Mintegral (offerte) e Mintegral (cascata).

Passaggi facoltativi

Aggiungi Mintegral all'elenco dei partner pubblicitari per il CCPA

Segui i passaggi descritti nelle impostazioni del CCPA per aggiungere Mintegral all'elenco dei partner pubblicitari per il CCPA nell' interfaccia utente 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.

¹ L'adattatore Mintegral non fornisce l'accesso diretto all'asset immagine principale per i suoi annunci nativi. L'adattatore compila invece il MediaView con un video o un'immagine.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da Mintegral, puoi controllare il errore sottostante dalla risposta dell'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

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

Ecco i codici e i messaggi associati generati dall'adattatore Mintegral quando un annuncio non viene caricato: