Integrazione di DT Exchange con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di DT Exchange utilizzando la mediazione, coprendo 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' Flutter app.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio

Requisiti

• SDK Google Mobile Ads più recente
• Flutter 3.7.0 o versioni successive
• Per eseguire il deployment su Android
  • Livello API Android 21 o superiore
• Per il deployment su iOS:
  • Target di deployment iOS 12.0 o versioni successive
• Un progetto Flutter funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
• Completa la Guida introduttiva di mediazione

Passaggio 1: imposta le configurazioni 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.

Android

iOS

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 passandoci il mouse sopra. Quindi, 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 utente e segreto utente

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

Android

Per le istruzioni, consulta il passaggio 2 della guida per Android.

iOS

Per le istruzioni, consulta il passaggio 2 nella guida per iOS.

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

Importante: verifica di disporre dell'autorizzazione di gestione dell'account per completare la configurazione per il consenso degli utenti dell'UE, GDPR, CPRA e piattaforma di messaggistica per gli utenti. Per informazioni dettagliate, consulta Gestire l'accesso degli utenti al tuo account.

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

Nota: la mancata integrazione delle versioni compatibili di DT Exchange e Google Mobile Ads potrebbe causare problemi alla build.

Integrazione tramite pub.dev

Aggiungi la seguente dipendenza con le versioni più recenti dell'DT Exchange SDK e dell'adattatore nel filepubspec.yaml del pacchetto:

dependencies:
  gma_mediation_dtexchange: ^1.0.0

Integrazione manuale

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per DT Exchange, estrai il file scaricato e aggiungi la cartella del plug-in estratta (e i relativi contenuti) al tuo progetto Flutter. Poi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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.

Il plug-in di mediazione Google Mobile Ads per DT Exchange non supporta il passaggio delle informazioni sul consenso all'SDK 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.

Il plug-in di mediazione Google Mobile Ads per DT Exchange non supporta il trasferimento delle informazioni sul consenso all'SDK di DT Exchange.

Passaggio 5: aggiungi il codice richiesto

Android

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

iOS

Integrazione di SKAdNetwork

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

Passaggio 6: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob

Importante: disattiva la modalità di test per AdMob 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.

Codici di errore

Se l'adattatore non riceve un annuncio da DT Exchange, i publisher possono controllare l'errore sottostante della risposta dell'annuncio utilizzando ResponseInfo nella seguente classe:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

Codice di errore	Motivo
101	I parametri del server DT Exchange configurati nell' AdMob interfaccia utente sono mancanti/non 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. Per ulteriori dettagli, consulta il codice.

iOS

Codice di errore	Motivo
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' AdMob interfaccia utente sono mancanti o non 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 Flutter DT Exchange

Versione successiva

• Creato e testato con il plug-in Flutter degli annunci per dispositivi mobili di Google versione 5.2.0.

1.1.0

• Compatibilità verificata con l'adattatore Android DT Exchange versione 8.3.0.0.
• Compatibilità verificata con l'adattatore DT Exchange iOS versione 8.3.1.0.
• Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.1.0.

1.0.0

• Lancio iniziale.
• Compatibilità verificata con l'adattatore Android DT Exchange versione 8.2.7.0.
• Compatibilità verificata con l'adattatore DT Exchange iOS versione 8.2.8.0.
• Creato e testato con il plug-in Flutter degli annunci per dispositivi mobili di Google versione 5.1.0.