Integrare Mintegral con Asta (beta)

Questa guida mostra 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'appiOS .

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per Mintegral offre le seguenti funzionalità:

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

Requisiti

• Target di deployment iOS 11.0 o versioni successive

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

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 Mintegral Reporting

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

Aggiungere Mintegral all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti

Segui i passaggi in Impostazioni GDPR e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere Mobvista/Mintegral all'elenco di partner pubblicitari GDPR e ai regolamenti statali degli Stati Uniti nell'interfaccia utente di AdMob.

Passaggio 3: importa l'SDK e l'adattatore Mintegral

Utilizzo di CocoaPods (opzione consigliata)

• Aggiungi la seguente riga al Podfile del progetto:

  pod 'GoogleMobileAdsMediationMintegral'
  

• Dalla riga di comando, esegui:

  pod install --repo-update

Integrazione manuale

• Scarica la versione più recente dell'SDK Mintegral per iOS e collega tutti i file e i pacchetti .framework nel tuo progetto.
• Scarica la versione più recente dell'adattatore Mintegral dal link di download nel log delle modifiche e collegaloMintegralAdapter.xcframework nel tuo 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 passare 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.

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

Per saperne di più, consulta la documentazione sulla privacy di Mintegral.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti obbligano le aziende a garantire agli utenti la possibilità 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 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 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 passare le 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 prima di inizializzare l'SDK Google Mobile Ads per garantire che vengano inoltrati correttamente all'SDK Mintegral.

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

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

Passaggio 5: aggiungi il codice richiesto

Integrazione di SKAdNetwork

Segui la documentazione di Mintegral per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.

Passaggio 6: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob.

Per ottenere annunci di prova Mintegral per banner, annunci interstitial, annunci con premio e formati degli annunci nativi, Mintegral consiglia di utilizzare le chiavi dell'app, gli ID app, gli ID posizionamento e gli ID unità pubblicitarie forniti nella pagina ID 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 in Impostazioni CCPA per aggiungere Mintegral all'elenco dei partner pubblicitari CCPA nell' Ad Manager UI.

Annunci nativi

Visualizzazione dell'annuncio

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

¹ L'adattatore Mintegral non fornisce accesso diretto all'asset immagine principale per i suoi annunci nativi. L'adattatore compila invece il valore GADMediaView 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 GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

GADMediationAdapterMintegral

Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore Mintegral quando non è possibile caricare un annuncio:

Log delle modifiche dell'adattatore di mediazione iOS di Mintegral

Versione 7.7.3.0

• Compatibilità verificata con la versione 7.7.3 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.10.0.
• Versione dell'SDK Mintegral 7.7.3.

Versione 7.7.2.1

• L'adattatore non controlla più se gli annunci interstitial e con premio sono pronti prima della loro visualizzazione.
• CFBundleShortVersionString è stato aggiornato in modo da avere tre componenti anziché quattro.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.10.0.
• SDK Mintegral versione 7.7.2.

Versione 7.7.2.0

• Compatibilità verificata con la versione 7.7.2 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.9.0.
• SDK Mintegral versione 7.7.2.

Versione 7.7.1.0

• Compatibilità verificata con la versione 7.7.1 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.8.0.
• SDK Mintegral versione 7.7.1.

Versione 7.7.0.0

• Compatibilità verificata con la versione 7.7.0 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.8.0.
• SDK Mintegral versione 7.7.0.

Versione 7.6.9.0

• Compatibilità verificata con la versione 7.6.9 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.7.0.
• Versione dell'SDK Mintegral 7.6.9.

Versione 7.6.8.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.6.8.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.7.0.
• Versione dell'SDK Mintegral 7.6.8.

Versione 7.6.7.0

• Compatibilità verificata con la versione 7.6.7 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.6.0.
• Versione dell'SDK Mintegral 7.6.7.

Versione 7.6.6.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.6.6.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.5.0.
• SDK Mintegral versione 7.6.6.

Versione 7.6.4.0

• Compatibilità verificata con la versione 7.6.4 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.4.0.
• SDK Mintegral versione 7.6.4.

Versione 7.6.3.0

• Compatibilità verificata con la versione 7.6.3 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.3.0.
• SDK Mintegral versione 7.6.3.

Versione 7.6.2.0

• Compatibilità verificata con la versione 7.6.2 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.3.0.
• SDK Mintegral versione 7.6.2.

Versione 7.6.1.0

• Compatibilità verificata con la versione 7.6.1 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.3.0.
• SDK Mintegral versione 7.6.1.

Versione 7.6.0.0

• Compatibilità verificata con la versione 7.6.0 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.2.0.
• Versione dell'SDK Mintegral 7.6.0.

Versione 7.5.9.0

• Compatibilità verificata con la versione 7.5.9 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 11.2.0.
• Versione dell'SDK Mintegral 7.5.9.

Versione 7.5.8.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.5.8.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.1.0.
• Versione dell'SDK Mintegral 7.5.8.

Versione 7.5.7.0

• Compatibilità verificata con la versione 7.5.7 dell'SDK Mintegral.
• Ora è necessaria la versione minima di iOS 12.0.
• Ora è richiesta la versione 11.0 o successive dell'SDK Google Mobile Ads.
• Info.plist è stato incluso nei framework di MintegralAdapter.xcframework.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.0.1.
• SDK Mintegral versione 7.5.7.

Versione 7.5.6.0

• Compatibilità verificata con la versione 7.5.6 dell'SDK Mintegral.
• GADMediationAdapterMintegral.h ha impostato un'intestazione pubblica.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 11.0.0.
• Versione dell'SDK Mintegral 7.5.6.

Versione 7.5.3.0

• Compatibilità verificata con la versione 7.5.3 dell'SDK Mintegral.
• È stato aggiunto il supporto per le offerte per il formato dell'annuncio di apertura dell'app.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.14.0.
• Versione dell'SDK Mintegral 7.5.3.

Versione 7.4.8.0

• Compatibilità verificata con la versione 7.4.8 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.13.0.
• SDK Mintegral versione 7.4.8.

Versione 7.4.7.0

• Il file podspec è stato aggiornato in modo che dipenda da MintegralAdSDK/All anziché da MintegralAdSDK.
• Compatibilità verificata con la versione 7.4.7 dell'SDK Mintegral.
• È stato aggiunto il supporto della struttura a cascata per il formato dell'annuncio di apertura dell'app.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.12.0.
• Versione dell'SDK Mintegral 7.4.7.

Versione 7.4.4.0

• È stato aggiunto il supporto della filigrana per gli annunci per l'asta.
• È stata verificata la compatibilità con l'SDK Mintegral versione 7.4.4.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.10.0.
• Versione dell'SDK Mintegral 7.4.4.

Versione 7.4.3.0

• Compatibilità verificata con la versione 7.4.3 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.9.0.
• SDK Mintegral versione 7.4.3.

Versione 7.4.1.0

• Compatibilità verificata con la versione 7.4.1 dell'SDK Mintegral.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.7.0.
• SDK Mintegral versione 7.4.1.

Versione 7.3.9.0

• Compatibilità verificata con la versione 7.3.9 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 10.7.0.
• SDK Mintegral versione 7.3.9.

Versione 7.3.8.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.3.8.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.6.0.
• Versione dell'SDK Mintegral 7.3.8.

Versione 7.3.7.0

• Compatibilità verificata con la versione 7.3.7 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 10.5.0.
• Versione dell'SDK Mintegral 7.3.7.

Versione 7.3.6.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.3.6.
• Rimosso il supporto dell'architettura armv7.
• Ora richiede la versione minima di iOS 11.0.
• Ora è richiesta la versione 10.4.0 o successive dell'SDK Google Mobile Ads.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.5.0.
• SDK Mintegral versione 7.3.6.

Versione 7.3.4.0

• Compatibilità verificata con la versione 7.3.4 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 10.2.0.
• SDK Mintegral versione 7.3.4.

Versione 7.3.3.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.3.3.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.2.0.
• SDK Mintegral versione 7.3.3.

Versione 7.3.0.0

• Compatibilità verificata con la versione 7.3.0 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 10.1.0.
• Versione dell'SDK Mintegral 7.3.0.

Versione 7.2.9.1

• È stato aggiunto il supporto della struttura a cascata per i formati degli annunci banner (inclusi gli annunci MREC), interstitial, con premio e nativi.
• Richiede l'SDK Google Mobile Ads versione 10.0.0 o successive.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 10.0.0.
• Versione dell'SDK Mintegral 7.2.9.

Versione 7.2.9.0

• È stata verificata la compatibilità con l'SDK Mintegral versione 7.2.9.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 9.14.0.
• SDK Mintegral versione 7.2.9.

Versione 7.2.8.0

• Compatibilità verificata con la versione 7.2.8 dell'SDK Mintegral.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 9.14.0.
• Versione dell'SDK Mintegral 7.2.8.

Versione 7.2.6.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.
• Compatibilità verificata con la versione 7.2.6 dell'SDK Mintegral.
• Richiede l'SDK Google Mobile Ads versione 9.8.0 o successive.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 9.13.0.
• SDK Mintegral versione 7.2.6.