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' Ad Manager 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 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.
Android
iOS
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' Ad Manager interfaccia utente
Configura le impostazioni di mediazione per l'unità pubblicitaria
Android
Per istruzioni, vedi il passaggio 2 della guida per Android.
iOS
Per istruzioni, vedi il passaggio 2 della guida per iOS.
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 USA 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 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
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
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:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore DT Exchange quando non riesce a caricare un annuncio:
Android
| Codice di errore | Motivo |
|---|---|
| 101 | I parametri del server DT Exchange configurati nell' Ad Manager interfaccia utente sono mancanti/non 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. |
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' Ad Manager interfaccia utente sono mancanti/non validi. |
| 102 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da DT Exchange. |
| 103 | Impossibile mostrare l'annuncio perché l'oggetto 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 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.