Integrazione di DT Exchange con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e mostrare gli annunci di DT Exchange utilizzando la mediazione AdMob, laintegrazioni con la struttura a cascata. Descrive come aggiungere DT Exchange alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di DT Exchange in un' Android app.

Integrazioni e formati degli annunci supportati

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

Requisiti

• Livello API Android 21 o superiore

• SDK Google Mobile Ads più recente

• Completare la mediazione Guida introduttiva

Passaggio 1: configura le impostazioni nell'interfaccia utente di DT Exchange

Aggiungi una nuova app e un nuovo posizionamento dell'annuncio

Registrati o accedi a DT Exchange Console.

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

Seleziona la piattaforma, compila il resto 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

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

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

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

ID publisher, chiave consumer e secret consumer

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

Prendi nota di Publisher ID, Consumer Key e Consumer Secret, poiché sono necessari nel passaggio successivo.

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere DT Exchange alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi DT Exchange come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.

A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:

Aggiungi DT Exchange come origine annuncio

Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona DT Exchange.

Se hai già una mappatura per DT Exchange, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Quindi, inserisci l' Application ID and Placement ID ottenuto nella sezione precedente. Poi, fai clic su Fine.

Aggiungi DT Exchange (Fyber Monetization) all'elenco di partner pubblicitari relativi al GDPR e ai regolamenti statali degli Stati Uniti

Segui i passaggi in Impostazioni GDPR e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere DT Exchange (Fyber Monetization) all'elenco di partner pubblicitari GDPR e dei regolamenti statali degli Stati Uniti nell'interfaccia utente di AdMob.

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

Integrazione di Android Studio (consigliata)

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.5.0")
    implementation("com.google.ads.mediation:fyber:8.3.2.0")
}

Integrazione manuale

• Scarica la versione più recente dell'SDK DT Exchange per Android e aggiungi i seguenti file al 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
• Accedi agli artefatto dell'adattatore DT Exchange sul Repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore DT Exchange e aggiungilo al progetto.

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

Consenso degli utenti dell'UE e GDPR

Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi garantire che vengano fornite determinate informative agli utenti dello Spazio economico europeo (SEE) e i consensi ottenuti in merito all'utilizzo degli identificatori dei dispositivi e dei 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.

DT Exchange contiene un'API che ti consente di inoltrare il consenso dell'utente al suo SDK. Il seguente codice di esempio 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.

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

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

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 maggiori dettagli e i valori che potrebbero essere forniti nel metodo.

Leggi statali sulla privacy degli Stati Uniti

Leggi statali sulla privacy degli Stati Uniti richiedono agli utenti di dare agli utenti il diritto di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di tale normativa), con l'opzione di disattivazione offerta tramite un link "Non vendere le mie informazioni personali" in evidenza nella home page del "venditore". La guida alla conformità alle leggi sulla privacy degli stati 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 della 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.

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

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Per ulteriori dettagli e i valori che possono essere forniti nel metodo, visita la pagina di risorse CCPA di DT Exchange e consulta la guida all'implementazione del CCPA .

Passaggio 5: aggiungi il codice richiesto

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

Passaggio 6: testa l'implementazione

Passaggi facoltativi

Parametri specifici della rete

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

Ecco un esempio di codice su come impostare questi parametri di richiesta di annunci:

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();

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 verificare l'errore sottostante della risposta dell'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 riesce a caricare un annuncio:

Log delle modifiche dell'adattatore DT Exchange per la mediazione Android

Versione 8.3.2.0

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 23.4.0.
• SDK DT Exchange versione 8.3.2.

Versione 8.3.1.0

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 23.3.0.
• SDK DT Exchange versione 8.3.1.

Versione 8.3.0.0

• È stato aggiunto il supporto per il passaggio della versione dell'SDK Google Mobile Ads all'SDK DT Exchange.
• È stata verificata la compatibilità con l'SDK DT Exchange 8.3.0.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 23.2.0.
• SDK DT Exchange versione 8.3.0.

Versione 8.2.7.0

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

Sviluppata e testata 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.
• Compatibilità verificata 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.

Sviluppata e testata 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.

Sviluppata e testata 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.

Sviluppata e testata 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.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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 passaggio della chiave muteVideo in un 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

• Compatibilità verificata con l'SDK DT Exchange 8.2.2.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.5.0.

Sviluppata e testata 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 in "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.

Sviluppata e testata con:

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

Versione 8.2.0.0

• Compatibilità verificata con l'SDK Fyber 8.2.0.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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

• Compatibilità verificata con l'SDK Fyber 8.1.5.

Sviluppata e testata 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.

Sviluppata e testata con:

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

Versione 8.1.3.1

• compileSdkVersion e targetSdkVersion sono stati aggiornati all'API 31.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.0.0.
• È stato aggiornato il livello API Android minimo richiesto 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.

Sviluppata e testata 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.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.5.0.

Sviluppata e testata 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

• È stato risolto un problema per cui l'adattatore non si inizializza se è presente un ID app univoco duplicato o più di uno nelle configurazioni di mediazione.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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.

Sviluppata e testata 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 codici e messaggi di errore dell'adattatore standardizzati.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.1.0.

Sviluppata e testata 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.

Sviluppata e testata 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

• Compatibilità verificata 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.
• Versione dell'SDK Fyber 7.7.2.

Versione 7.7.1.0

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 19.4.0.
• Versione dell'SDK Fyber 7.7.1.

Versione 7.7.0.0

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

Sviluppata e testata 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.

Sviluppata e testata con:

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

Versione 7.6.0.0

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

Sviluppata e testata con:

• SDK Google Mobile Ads versione 19.3.0.
• Versione dell'SDK Fyber 7.6.0.

Versione 7.5.4.0

• Compatibilità verificata con l'SDK Fyber 7.5.4.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.1.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 19.1.0.
• Versione dell'SDK Fyber 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.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.0.1.

Sviluppata e testata 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 richiesta dell'SDK Google Mobile Ads a 18.3.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 18.3.0.
• Versione dell'SDK Fyber 7.4.1.

Versione 7.3.4.0

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

Sviluppato e testato con:

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