Integra DT Exchange con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da DT Exchange utilizzando la mediazione, riguardando le integrazioni con struttura a cascata. Viene spiegato come aggiungere DT Exchange alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK DT Exchange in un' Android app.

Integrazioni e formati degli annunci supportati

L' Ad Manager adattatore di mediazione per DT Exchange presenta le seguenti funzionalità:

Integrazione
Offerte
Struttura a cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Livello API Android 19 o superiore
  • Versione più recente dell'SDK Google Mobile Ads

  • Completa la mediazione Guida introduttiva

Passaggio 1: imposta le configurazioni nell'interfaccia utente di DT Exchange

Aggiungi nuova app e nuovo posizionamento dell'annuncio

Registrati o accedi a DT Exchange Console.

Fai clic sul pulsante Aggiungi app per aggiungere la tua app.

Gestisci applicazioni

Seleziona la tua Piattaforma, compila la parte restante del modulo e fai clic su Aggiungi posizionamenti.

Inserisci un nome per il nuovo posizionamento nel campo Assegna un nome al posizionamento e seleziona il Tipo di posizionamento desiderato dall'elenco a discesa. Infine, fai clic su Salva posizionamento.

Configurazione

ID app e ID posizionamento

Passa il mouse sopra la barra di navigazione a sinistra. Fai clic su App nel menu a sinistra.

Menu

Nella pagina Gestione app, prendi nota dell'ID app accanto all'app.

ID app

Seleziona l'app, vai alla scheda Posizionamenti e fai clic sull'icona di copia accanto a Nome posizionamento. Prendi nota dell'ID posizionamento.

ID posizionamento

ID publisher, chiave utente e secret del consumatore

Fai clic sul tuo nome utente nel menu a sinistra e seleziona Profilo utente.

Menu Profilo utente

Prendi nota dell'ID publisher, della chiave del consumatore e del segreto del consumatore, perché sono necessari nel passaggio successivo.

Profilo utente

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Accedi al tuo account Ad Manager.

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.

Inserisci un nome univoco per il gruppo di rendimento, imposta lo Stato su Attivo, seleziona il formato dell'annuncio e imposta il Tipo di inventario su App mobile. Nella sezione Targeting > Inventario, seleziona l'unità pubblicitaria in Inventario e App mobile a cui vuoi aggiungere la mediazione.

Fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un Partner di rendimento per DT Exchange, puoi selezionarlo. In caso contrario, seleziona Crea un nuovo partner di rendimento.

Seleziona DT Exchange come Rete pubblicitaria, inserisci un nome univoco e attiva Mediazione.

Attiva Raccolta automatica dei dati e inserisci il valore Publisher ID, Consumer Secret and Consumer Key ottenuto nella sezione precedente.

Dopo aver selezionato Partner di rendimento, scegli Mediazione SDK mobile come Tipo di integrazione, Android come Piattaforma e Attivo come Stato. Inserisci iApplication ID and Placement ID ottenuti nella sezione precedente. Quindi, inserisci un valore per il CPM predefinito

Al termine, fai clic su Salva nella parte inferiore della pagina.

Aggiungi Fyber 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 Fyber all'elenco di partner pubblicitari per le normative GDPR e statali degli Stati Uniti nell' Ad Manager UI.

Passaggio 3: importa l'adattatore e l'SDK DT Exchange

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 DT Exchange:

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

Integrazione manuale

  • Scarica la versione più recente dell'SDK DT Exchange per Android e aggiungi i seguenti file al progetto:
    • ia-mraid-kit-release-x.y.z.aar
    • ia-sdk-core-release-x.y.z.aar
    • ia-video-kit-release-x.y.z.aar
  • Vai agli elementi dell'adattatore DT Exchange nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore DT Exchange e aggiungilo al tuo progetto.

Passaggio 4: implementa le impostazioni sulla privacy nell'SDK DT Exchange

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.

DT Exchange contiene un'API che ti consente di inoltrare il consenso dell'utente al suo SDK. Il seguente codice campione mostra come passare manualmente le informazioni sul consenso all'SDK DT Exchange. Se scegli di trasmettere manualmente le informazioni sul consenso all'SDK DT Exchange, ti consigliamo di chiamare questo codice prima di richiedere gli annunci tramite l'SDK Google Mobile Ads.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

Visita la pagina delle risorse GDPR di DT Exchange e la relativa Guida all'implementazione del GDPR per ulteriori dettagli e per conoscere i valori che possono essere forniti nel metodo.

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

DT Exchange contiene un'API che ti consente di inoltrare il consenso dell'utente al suo SDK. Il seguente codice campione mostra come passare manualmente le informazioni sul consenso all'SDK DT Exchange. Se scegli di trasmettere manualmente le informazioni sul consenso all'SDK DT Exchange, ti consigliamo di chiamare questo codice prima di richiedere gli annunci tramite l'SDK Google Mobile Ads.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Visita la pagina delle risorse CCPA di DT Exchange e la relativa Guida all'implementazione del CCPA per ulteriori dettagli e i valori che possono essere forniti nel metodo.

Passaggio 5: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione DT Exchange.

Passaggio 6: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager

Verifica annunci di prova

Per verificare di ricevere annunci di prova daDT Exchange, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le DT Exchange (Waterfall) origini annuncio.

Passaggi facoltativi

Parametri specifici della rete

L'adattatore DT Exchange supporta parametri di richiesta aggiuntivi che possono essere trasmessi all'adattatore come bundle Android. L'adattatore cerca le seguenti chiavi nel bundle:

Parametri e valori della richiesta
InneractiveMediationDefs.KEY_AGE Numero intero: L'età dell'utente
FyberMediationAdapter.KEY_MUTE_VIDEO Booleano. Disattiva o riattiva l'audio del video

Di seguito è riportato un esempio di codice di come impostare questi parametri di richiesta di annuncio:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request = new AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
       .build();

Kotlin

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

var adrequest = AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
       .build()

Codici di errore

Se l'adattatore non riceve un annuncio da DT Exchange, puoi controllare l'errore sottostante dalla risposta di annuncio utilizzando ResponseInfo.getAdapterResponses() nella seguente classe:

com.google.ads.mediation.fyber.FyberMediationAdapter

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore DT Exchange quando non viene caricato un annuncio:

Codice di errore Motivo
101 I parametri del server DT Exchange configurati nell' Ad Manager interfaccia utente mancano o non sono validi.
103 La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da DT Exchange.
105 L'SDK DT Exchange ha caricato un annuncio, ma ha restituito un controller imprevisto.
106 L'annuncio non è pronto per essere pubblicato.
200-399 L'SDK DT Exchange ha restituito un errore. Consulta il codice per maggiori dettagli.
0-10 L'SDK DT Exchange ha restituito un errore. Per ulteriori dettagli, consulta la documentazione.
101 I parametri del server DT Exchange configurati nell' Ad Manager interfaccia utente mancano o non sono validi.
102 La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da DT Exchange.
103 Impossibile mostrare l'annuncio perché l'oggetto annuncio è già stato utilizzato.
104 Impossibile mostrare gli annunci DT Exchange perché l'annuncio non è pronto.
105 L'SDK DT Exchange ha restituito un errore di inizializzazione.

Log delle modifiche dell'adattatore di mediazione Android di DT Exchange

Versione 8.2.6.0

  • Compatibilità verificata con l'SDK DT Exchange 8.2.6.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.6.0.
  • SDK DT Exchange versione 8.2.6.

Versione 8.2.5.0

  • Compatibilità verificata con l'SDK DT Exchange 8.2.5.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.5.0.
  • SDK DT Exchange versione 8.2.5.

Versione 8.2.4.0

  • Compatibilità verificata con l'SDK DT Exchange 8.2.4.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.3.0.
  • SDK DT Exchange versione 8.2.4.

Versione 8.2.3.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.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 22.0.0.
  • SDK DT Exchange versione 8.2.3.

Versione 8.2.2.1

  • Aggiunto il supporto per il passaggio della chiave muteVideo nella mediazione extra per disattivare gli annunci interstitial.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.5.0.
  • SDK DT Exchange versione 8.2.2.

Versione 8.2.2.0

  • Compatibilità verificata con l'SDK DT Exchange 8.2.2.
  • 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 DT Exchange versione 8.2.2.

Versione 8.2.1.0

  • Il nome dell'adattatore è stato rinominato "DT Exchange".
  • Compatibilità verificata con l'SDK DT Exchange 8.2.1.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.3.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.3.0.
  • SDK DT Exchange versione 8.2.1.

Versione 8.2.0.0

  • Compatibilità verificata con Fyber SDK 8.2.0.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.1.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.1.0.
  • SDK Fyber versione 8.2.0.

Versione 8.1.5.0

  • Compatibilità verificata con l'SDK Fyber 8.1.5.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.0.0.
  • SDK Fyber versione 8.1.5.

Versione 8.1.4.0

  • Compatibilità verificata con l'SDK Fyber 8.1.4.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.0.0.
  • SDK Fyber versione 8.1.4.

Versione 8.1.3.1

  • Aggiornamento di compileSdkVersion e targetSdkVersion all'API 31.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.
  • Il livello API Android minimo richiesto è stato aggiornato a 19.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 21.0.0.
  • SDK Fyber versione 8.1.3.

Versione 8.1.3.0

  • Compatibilità verificata con l'SDK Fyber 8.1.3.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.6.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.6.0.
  • SDK Fyber versione 8.1.3.

Versione 8.1.2.0

  • Compatibilità verificata con l'SDK Fyber 8.1.2.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.5.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.5.0.
  • SDK Fyber versione 8.1.2.

Versione 8.1.0.0

  • Compatibilità verificata con l'SDK Fyber 8.1.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.4.0.
  • SDK Fyber versione 8.1.0.

Versione 7.8.4.1

  • Risolto il problema per cui l'adattatore non veniva inizializzato in presenza di un duplicato o di più ID app univoci nelle configurazioni di mediazione.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.4.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.4.0.
  • SDK Fyber versione 7.8.4.

Versione 7.8.4.0

  • Compatibilità verificata con l'SDK Fyber 7.8.4.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.3.0.
  • Risolto il problema relativo agli annunci display con premio che non hanno ricevuto la chiamata di onVideoComplete().
  • Fyber ora richiede un contesto di attività per mostrare gli annunci.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.3.0.
  • SDK Fyber versione 7.8.4.

Versione 7.8.3.0

  • Compatibilità verificata con l'SDK Fyber 7.8.3.
  • Sono stati aggiunti messaggi e codici di errore relativi all'adattatore standardizzato.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.1.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.1.0.
  • SDK Fyber versione 7.8.3.

Versione 7.8.2.0

  • Compatibilità verificata con l'SDK Fyber 7.8.2.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 20.0.0.
  • SDK Fyber versione 7.8.2.

Versione 7.8.1.0

  • Compatibilità verificata con l'SDK Fyber 7.8.1.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.7.0.
  • SDK Fyber versione 7.8.1.

Versione 7.8.0.0

  • Compatibilità verificata con Fyber SDK 7.8.0.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.7.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.7.0.
  • SDK Fyber versione 7.8.0.

Versione 7.7.4.0

  • Compatibilità verificata con l'SDK Fyber 7.7.4.
  • Risolto il problema per cui onUserEarnedReward() viene inoltrato due volte per gli annunci con premio.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.5.0.
  • SDK Fyber versione 7.7.4.

Versione 7.7.3.0

  • Compatibilità verificata con l'SDK Fyber 7.7.3.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.5.0.
  • SDK Fyber versione 7.7.3.

Versione 7.7.2.0

  • Compatibilità verificata con l'SDK Fyber 7.7.2.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.5.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.5.0.
  • SDK Fyber versione 7.7.2.

Versione 7.7.1.0

  • Compatibilità verificata con Fyber SDK 7.7.1.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.4.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.4.0.
  • SDK Fyber versione 7.7.1.

Versione 7.7.0.0

  • Compatibilità verificata con Fyber SDK 7.7.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.3.0.
  • SDK Fyber versione 7.7.0.

Versione 7.6.1.0

  • Compatibilità verificata con l'SDK Fyber 7.6.1.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.3.0.
  • SDK Fyber versione 7.6.1.

Versione 7.6.0.0

  • Compatibilità verificata con Fyber SDK 7.6.0.
  • L'adattatore è stato aggiornato in modo da supportare le richieste di banner adattivi incorporati.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.3.0.
  • Risolto il bug per cui i metodi onAdOpened()/onAdClosed() non venivano chiamati per gli annunci banner.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.3.0.
  • SDK Fyber versione 7.6.0.

Versione 7.5.4.0

  • Compatibilità verificata con l'SDK Fyber 7.5.4.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.1.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.1.0.
  • SDK Fyber versione 7.5.4.

Versione 7.5.3.0

  • Compatibilità verificata con l'SDK Fyber 7.5.3.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.0.1.
  • SDK Fyber versione 7.5.3.

Versione 7.5.2.0

  • Compatibilità verificata con l'SDK Fyber 7.5.2.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.0.1.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 19.0.1.
  • SDK Fyber versione 7.5.2.

Versione 7.5.0.0

  • Compatibilità verificata con l'SDK Fyber 7.5.0.
  • È stato risolto l'arresto anomalo di NullPointerException durante il caricamento degli annunci Fyber.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 18.3.0.
  • SDK Fyber versione 7.5.0.

Versione 7.4.1.0

  • Compatibilità verificata con l'SDK Fyber 7.4.1.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.3.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 18.3.0.
  • SDK Fyber versione 7.4.1.

Versione 7.3.4.0

  • Versione iniziale
  • Supporta annunci banner, interstitial e con premio.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 18.2.0.
  • SDK Fyber versione 7.3.4.