Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di DT Exchange utilizzando la mediazione AdMob, che copre le integrazioni 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'app per Android.
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per DT Exchange offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
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
Aggiungere nuovi posizionamenti di app e annunci
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 Dai un nome al posizionamento e seleziona il Tipo di posizionamento che preferisci dall'elenco a discesa. Infine, fai clic su Salva posizionamento.
ID app e ID posizionamento
Apri la barra di navigazione a sinistra passandoci il mouse sopra. 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'interfaccia utente di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere DT Exchange alla configurazione della mediazione per la tua unità pubblicitaria.
Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai a Aggiungere 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à di destinazione. Imposta quindi 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à pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.
Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:
Aggiungere DT Exchange come origine annuncio
Nella scheda Struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona DT Exchange.
Seleziona DT Exchange e attiva l'opzione Ottimizza. Inserisci ID publisher, Segreto consumatore e Chiave utente ottenuti nella sezione precedente per configurare l'ottimizzazione delle sorgenti annuncio per DT Exchange. Poi inserisci un valore eCPM per la piattaforma di scambio pubblicitario DT e fai clic su Continua.
Se hai già una mappatura per DT Exchange, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Inserisci quindi Application ID e Placement ID ottenuti nella sezione precedente. Poi fai clic su Fine.
Aggiungere DT Exchange (Fyber Monetization) all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti
Segui i passaggi descritti nelle impostazioni GDPR e nelle impostazioni relative alle normative statali degli Stati Uniti per aggiungere DT Exchange (Fyber Monetization) all'elenco dei partner pubblicitari ai sensi del GDPR e delle normative 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.3.0")
}
Integrazione manuale
- Scarica la versione più recente dell'SDK DT Exchange per Android e aggiungi al progetto i seguenti file:
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 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 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.
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.
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")
Per ulteriori dettagli e i valori che possono essere forniti nel metodo, visita la pagina di risorse GDPR e la guida all'implementazione del GDPR di DT Exchange.
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 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 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")
Per ulteriori dettagli e i valori che possono essere forniti nel metodo, visita la pagina di risorse CCPA e la guida all'implementazione del CCPA di DT Exchange.
Passaggio 5: aggiungi il codice richiesto
Non è necessario codice aggiuntivo per l'integrazione di DT Exchange.
Passaggio 6: testa l'implementazione
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova da DT Exchange, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio DT Exchange (con struttura a cascata).
Passaggi facoltativi
Parametri specifici della rete
L'adattatore DT Exchange supporta parametri di richiesta aggiuntivi che possono essere passati 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
|
Valore booleano. Disattivare o riattivare l'audio del video |
Ecco un esempio di codice su come impostare questi parametri di richiesta di annunci:
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 riesce a ricevere un annuncio da DT Exchange, puoi controllare l'errore di fondo della risposta all'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:
Codice di errore | Motivo |
---|---|
101 | I parametri del server DT Exchange configurati nell'interfaccia utente di AdMob non sono presenti/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 la pubblicazione. |
200-399 | L'SDK DT Exchange ha restituito un errore. Per ulteriori dettagli, consulta il codice. |
Log delle modifiche dell'adattatore DT Exchange per la mediazione Android
Versione 8.3.3.0
- Compatibilità verificata con l'SDK DT Exchange 8.3.3.
Creato e testato con:
- SDK Google Mobile Ads versione 23.5.0.
- SDK DT Exchange versione 8.3.3.
Versione 8.3.2.0
- Compatibilità verificata con l'SDK DT Exchange 8.3.2.
Creato 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.
Creato 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.
- Compatibilità verificata con l'SDK DT Exchange 8.3.0.
Creato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK DT Exchange versione 8.3.0.
Versione 8.2.7.0
- Compatibilità verificata con l'SDK DT Exchange 8.2.7.
Creato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK DT Exchange versione 8.2.7.
Versione 8.2.6.1
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 23.0.0.
- Compatibilità verificata con l'SDK DT Exchange 8.2.6.
Creato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK DT Exchange versione 8.2.6.
Versione 8.2.6.0
- Compatibilità verificata con l'SDK DT Exchange 8.2.6.
Creato 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.
Creato 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.
Creato 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
. - È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.0.0.
Creato 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.
Creato 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.
Creato 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 in "DT Exchange".
- Compatibilità verificata con l'SDK DT Exchange 8.2.1.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.3.0.
Creato 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 l'SDK Fyber 8.2.0.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.1.0.
Creato 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.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- SDK Fyber versione 8.1.4.
Versione 8.1.3.1
compileSdkVersion
etargetSdkVersion
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.
Creato 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.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.6.0.
Creato 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.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.5.0.
Creato 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.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 20.4.0.
- Versione dell'SDK Fyber 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, in cui
onVideoComplete()
non veniva chiamato. - Ora Fyber richiede un contesto Attività per mostrare gli annunci.
Creato e testato con:
- SDK Google Mobile Ads versione 20.3.0.
- Versione dell'SDK Fyber 7.8.4.
Versione 7.8.3.0
- Compatibilità verificata con l'SDK Fyber 7.8.3.
- Sono stati aggiunti codici e messaggi di errore standardizzati per gli adattatori.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.1.0.
Creato e testato con:
- SDK Google Mobile Ads versione 20.1.0.
- Versione dell'SDK Fyber 7.8.3.
Versione 7.8.2.0
- Compatibilità verificata con l'SDK Fyber 7.8.2.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.0.0.
Creato 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.
Creato 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.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla versione 19.7.0.
Creato e testato con:
- SDK Google Mobile Ads versione 19.7.0.
- Versione dell'SDK Fyber 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.
Creato e testato con:
- SDK Google Mobile Ads versione 19.5.0.
- Versione dell'SDK Fyber 7.7.4.
Versione 7.7.3.0
- Compatibilità verificata con l'SDK Fyber 7.7.3.
Creato e testato con:
- SDK Google Mobile Ads versione 19.5.0.
- Versione dell'SDK Fyber 7.7.3.
Versione 7.7.2.0
- Compatibilità verificata con l'SDK Fyber 7.7.2.
- È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.5.0.
Creato 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 richiesta dell'SDK Google Mobile Ads a 19.4.0.
Creato e testato con:
- SDK Google Mobile Ads versione 19.4.0.
- Versione dell'SDK Fyber 7.7.1.
Versione 7.7.0.0
- Compatibilità verificata con l'SDK Fyber 7.7.0.
Creato e testato con:
- SDK Google Mobile Ads versione 19.3.0.
- Versione dell'SDK Fyber 7.7.0.
Versione 7.6.1.0
- Compatibilità verificata con l'SDK Fyber 7.6.1.
Creato e testato con:
- SDK Google Mobile Ads versione 19.3.0.
- Versione dell'SDK Fyber 7.6.1.
Versione 7.6.0.0
- Compatibilità verificata con l'SDK Fyber 7.6.0.
- L'adattatore è stato aggiornato 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 richiamati per gli annunci banner.
Creato e testato 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.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 19.0.1.
- Versione dell'SDK Fyber 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 alla versione 19.0.1.
Creato e testato con:
- SDK Google Mobile Ads versione 19.0.1.
- Versione dell'SDK Fyber 7.5.2.
Versione 7.5.0.0
- Compatibilità verificata con l'SDK Fyber 7.5.0.
- È stato corretto l'arresto anomalo NullPointerException durante il caricamento degli annunci Fyber.
Creato e testato con:
- SDK Google Mobile Ads versione 18.3.0.
- Versione dell'SDK Fyber 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.
Creato 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.
Creato e testato con:
- SDK Google Mobile Ads versione 18.2.0.
- Versione dell'SDK Fyber 7.3.4.