Integra DT Exchange con la mediazione

Nota: Fyber Marketplace ora si chiama DT Exchange.

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare di annunci di DT Exchange utilizzando mediazione, che copre le integrazioni a cascata. Spiega come aggiungere DT Exchange a un annuncio configurazione di mediazione dell'unità e come integrare l'SDK DT Exchange in un'app. Android

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per DT Exchange ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Livello API Android 21 o superiore

• Versione più recente dell'SDK Google Mobile Ads

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

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.

ID app e ID posizionamento

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

Nella pagina Gestione app, prendi nota dell'ID app accanto all'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 publisher, chiave utente e secret del consumatore

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

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

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

Importante: il Application ID deve essere associato all'app scelta come target come nell'DT Exchange UI.

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

Nota: la raccolta automatica dei dati richiede alcuni giorni per raccogliere i dati prima di poter calcolare con precisione il valore del CPM dinamico per una rete di mediazione. Una volta calcolato, l'eCPM viene aggiornato automaticamente.

Aggiungi Fyber all'elenco di partner pubblicitari relativi al GDPR e ai regolamenti statali degli Stati Uniti

Importante: Verifica di disporre dell'autorizzazione di gestione dell'account per completare il per il consenso degli utenti dell'UE, GDPR, CPRA e piattaforma di messaggistica per gli utenti. Consulta Gestisci l'accesso degli utenti al tuo Google Cloud per i dettagli.

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'SDK e l'adattatore DT Exchange

Nota: mancata integrazione di DT Exchange e SDK Google Mobile Ads compatibili potrebbero causare problemi di build.

Integrazione di Android Studio (consigliata)

Nel file build.gradle.kts a livello di app, aggiungi la seguente implementazione di dipendenze e configurazioni. Utilizza le versioni più recenti dell'SDK DT Exchange e l'adattatore:

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

Integrazione manuale

• Scarica l'ultima versione di DT Exchange SDK for Android e aggiungi i seguenti file nel tuo 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 alla sezione Artefatti dell'adattatore DT Exchange sul Repository Maven di Google. Seleziona la versione più recente, scarica il file DT il file .aar dell'adattatore di scambio e aggiungilo al tuo progetto.

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

Consenso degli utenti dell'UE e GDPR

Ai sensi del Consenso degli utenti dell'UE di Google norme, devi assicurarti che vengano fornite determinate informative e permessi ottenuti dagli utenti dello Spazio economico europeo (SEE) in relazione a all'uso di identificatori dei dispositivi e dati personali. Queste norme riflettono Requisiti della direttiva e-Privacy e della direttiva generale sulla protezione dei dati dell'UE Regolamento (GDPR). Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può raccogliere, ricevere o utilizzare dati personali, fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere automaticamente a queste reti la scelta dell'utente relativa al consenso.

DT Exchange contiene un'API che ti consente di inoltrare il consenso dell'utente al suo SDK. La il seguente codice di esempio mostra come trasferire le informazioni sul consenso a DT Exchange manualmente l'SDK. Se scegli di trasmettere le informazioni sul consenso a DT Exchange SDK manualmente, si consiglia di richiamare questo codice prima di richiedere 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 consulta le Guida all'implementazione del GDPR per ulteriori dettagli e i valori che possono essere forniti nel metodo.

Leggi statali sulla privacy degli Stati Uniti

Stati Uniti leggi statali sulla privacy richiedono dare agli utenti il diritto di disattivare la "vendita" delle loro "informazioni personali" (come definisce la legge tali termini), con la possibilità di disattivare la funzionalità tramite un messaggio "Non vendere i miei dati personali" in evidenza informazioni" sul link "venduto" sulla home page del gruppo. La Stati Uniti privacy degli stati la guida alla conformità alle leggi offre la possibilità di abilitare trattamento dati limitato per la pubblicazione di annunci Google, ma Google non può applicare questa impostazione a ciascun annuncio nella tua catena di mediazione. Di conseguenza, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può partecipare alla vendita di e seguire le indicazioni di ciascuna di queste reti per garantire conformità.

DT Exchange contiene un'API che ti consente di inoltrare il consenso dell'utente al suo SDK. La il seguente codice di esempio mostra come trasferire le informazioni sul consenso a DT Exchange manualmente l'SDK. Se scegli di trasmettere le informazioni sul consenso a DT Exchange SDK manualmente, si consiglia di richiamare questo codice prima di richiedere 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 le relative 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 di DT Exchange.

Passaggio 6: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager

Importante: disattiva la modalità di test per Ad Manager e DT Exchange prima di rilasciare l'app.

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 aggiuntivi di richiesta che possono essere trasmesso all'adattatore come un bundle Android. L'adattatore cerca i seguenti componenti chiavi nel bundle:

Parametri e valori delle richieste
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 che mostra 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)

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
   .build()

Codici di errore

Se l'adattatore non riceve un annuncio da DT Exchange, puoi controllare un errore sottostante della risposta all'annuncio ResponseInfo.getAdapterResponses() nel seguente corso:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

Codice di errore	Motivo
101	I parametri del server DT Exchange configurati nell' Ad Manager interfaccia utente non sono presenti o non sono validi.
103	La dimensione dell'annuncio richiesta non corrisponde a una dimensione 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. Vedi il codice per ulteriori dettagli.
0-10	L'SDK DT Exchange ha restituito un errore. Consulta la documentazione per ulteriori dettagli.
101	I parametri del server DT Exchange configurati nell' Ad Manager interfaccia utente non sono presenti o non sono validi.
102	La dimensione dell'annuncio richiesta non corrisponde a una dimensione banner supportata da DT Exchange.
103	Impossibile pubblicare l'annuncio perché l'oggetto dell'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 successiva:

• Trasferisci la versione di MobileAds all'SDK DT Exchange.

Versione 8.2.7.0

• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.7.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 23.0.0.
• SDK DT Exchange versione 8.2.7.

Versione 8.2.6.1

• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.0.0.
• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.6.

Sviluppato e testato con:

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

Versione 8.2.6.0

• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.6.

Sviluppato e testato con:

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

Versione 8.2.5.0

• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.5.

Sviluppato e testato con:

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

Versione 8.2.4.0

• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.4.

Sviluppato e testato con:

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

Versione 8.2.3.0

• Adattatore aggiornato per utilizzare la nuova classe VersionInfo.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.

Sviluppato e testato con:

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

Versione 8.2.2.1

• È stato aggiunto il supporto per il trasferimento della chiave muteVideo nell'extra di mediazione per disattivare l'audio degli annunci interstitial.

Sviluppato e testato con:

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

Versione 8.2.2.0

• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.2.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.5.0.

Sviluppato 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 ha cambiato nome in "DT Exchange".
• È stata verificata la compatibilità con l'SDK DT Exchange 8.2.1.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.3.0.

Sviluppato e testato con:

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

Versione 8.2.0.0

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

Sviluppato e testato con:

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

Versione 8.1.5.0

• È stata verificata la compatibilità con l'SDK Fyber 8.1.5.

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

Sviluppato e testato con:

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

Versione 8.1.3.1

• compileSdkVersion e targetSdkVersion aggiornati 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.

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

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

Sviluppato e testato con:

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

Versione 8.1.0.0

• È stata verificata la compatibilità con l'SDK Fyber 8.1.0.

Sviluppato e testato con:

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

Versione 7.8.4.1

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

Sviluppato 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.
• È stato risolto un problema relativo agli annunci display con premio che non veniva chiamato onVideoComplete().
• Fyber ora richiede un contesto attività per mostrare gli annunci.

Sviluppato e testato con:

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

Versione 7.8.3.0

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

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

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

Sviluppato e testato con:

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

Versione 7.8.0.0

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

Sviluppato 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.
• È stato risolto un problema per cui onUserEarnedReward() viene inoltrato due volte per gli annunci con premio.

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

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

Sviluppato 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 l'SDK Fyber 7.7.1.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.4.0.

Sviluppato e testato con:

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

Versione 7.7.0.0

• È stata verificata la compatibilità con l'SDK Fyber 7.7.0.

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

Sviluppato e testato con:

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

Versione 7.6.0.0

• È stata verificata la compatibilità con l'SDK Fyber 7.6.0.
• È stato aggiornato l'adattatore per supportare le richieste di banner adattivi in linea.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.3.0.
• È stato corretto un bug per cui i metodi onAdOpened()/onAdClosed() non venivano chiamati per gli annunci banner.

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

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

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

Sviluppato e testato con:

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

Versione 7.5.0.0

• È stata verificata la compatibilità con l'SDK Fyber 7.5.0.
• È stato corretto l'arresto anomalo di NullPointerException durante il caricamento degli annunci Fyber.

Sviluppato 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.
• È stata aggiornata la versione minima dell'SDK Google Mobile Ads richiesta alla versione 18.3.0.

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

Sviluppato e testato con:

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