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

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 eseguire 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.
• 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' AdMob interfaccia utente

Configura le impostazioni di mediazione per l'unità pubblicitaria

Aggiungere Fyber 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 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 la versione più recente del plug-in di mediazione Google Mobile Ads per DT Exchange, estrae il file scaricato e aggiungi la cartella del plug-in estratta (e i relativi contenuti) al 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 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.

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 passaggio delle informazioni sul consenso all'SDK DT Exchange.

Passaggio 5: aggiungi il codice richiesto

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

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio dalla piattaforma di scambio DT, i publisher possono controllare l'errore di fondo della risposta all'annuncio utilizzando ResponseInfo nella seguente classe:

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

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 di mediazione Flutter DT Exchange

Versione successiva

• Creato e testato con il plug-in Flutter di Google Mobile Ads 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 per 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 DT Exchange per Android versione 8.2.7.0.
• Compatibilità verificata con l'adattatore DT Exchange per iOS versione 8.2.8.0.
• Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.1.0.