Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci di Unity Ads utilizzando la mediazione, che copre le integrazioni di Asta e con struttura a cascata. Spiega come aggiungere Unity Ads alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Unity Ads in un'app per Android.
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per Unity Ads offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Cascata | 1 |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Nativo | |
Requisiti
- Livello API Android 24 o superiore
- [Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l'adattatore Unity 4.16.0.1 o versioni successive (consigliata l'ultima versione)
Le ultime novità di GMA Next-Gen SDK
Completa la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nell'interfaccia utente di Unity Ads
Registrati o accedi a Unity Ads.
Crea un progetto
Nella dashboard di Unity Ads, vai a Progetti e fai clic su Nuovo.
Compila il modulo e fai clic su Crea per aggiungere il progetto.
Vai a Monetizzazione di Unity Ads, quindi fai clic su Inizia.
Nella finestra modale Nuovo progetto, seleziona Utilizzerò la mediazione e Google AdMob per Partner di mediazione, poi fai clic su Avanti.
Seleziona l'opzione per le impostazioni degli annunci, poi fai clic su Avanti.
Seleziona la configurazione del posizionamento, quindi fai clic su Avanti.
Offerte
Cascata
Compila il modulo, quindi fai clic su Aggiungi progetto.
Prendi nota dell'ID gioco.
Creare unità pubblicitarie e posizionamenti
Vai a Monetizzazione di Unity Ads > Posizionamenti, quindi seleziona il tuo progetto e fai clic su Aggiungi unità pubblicitaria.
Inserisci un nome dell'unità pubblicitaria, poi seleziona la piattaforma e il formato dell'annuncio.
Vai a Monetizzazione > Posizionamenti, quindi fai clic su Aggiungi unità pubblicitaria.
Inserisci un nome dell'unità pubblicitaria, poi seleziona la piattaforma e il formato dell'annuncio.
Seleziona Cascata per la configurazione. In Posizionamento, inserisci il nome del posizionamento, il tagging GEO e il target.
Prendi nota dell'ID posizionamento.
Infine, fai clic su Aggiungi unità pubblicitaria per salvare l'unità pubblicitaria e il posizionamento.
Individuare la chiave API di Unity Ads Reporting
Offerte
Questo passaggio non è obbligatorio per le integrazioni delle offerte.
Cascata
Vai a Monetizzazione di Unity Ads > Gestione API e prendi nota della chiave API in Accesso API statistiche monetizzazione.
A questo punto, vai a Monetizzazione di Unity Ads > Impostazioni dell'organizzazione e prendi nota dell'ID di riferimento dell'organizzazione.
Aggiorna il file app-ads.txt
Authorized Sellers for Apps (Venditori autorizzati per app) app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario pubblicitario della tua app solo in canali che hai indicato come autorizzati. Per evitare una
riduzione significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt.
Se non l'hai ancora fatto,
crea un file app-ads.txt per Ad Manager.
Per implementare app-ads.txt per Unity Ads, consulta la sezione
Configurazione di app-ads.txt per la prima volta.
Attivare la modalità di test
La modalità di test può essere attivata dalla dashboard di Unity Ads. Vai a Unity Ads Monetization > Testing.
Puoi forzare la modalità di test per la tua app facendo clic sul pulsante di modifica accanto a Google Play Store , attivando Override client test mode e selezionando Force test mode ON (i.e. use test ads) for all devices.
In alternativa, puoi attivare la modalità di test per dispositivi specifici facendo clic su Aggiungi dispositivo di test.
Inserisci i dettagli del dispositivo di test, quindi fai clic su Salva.
Passaggio 2: configura la domanda di Unity Ads nell'interfaccia utente di Ad Manager
Accedi al tuo account Ad Manager.
Aggiungere Unity Ads in Società
Offerte
Questo passaggio non è obbligatorio per le integrazioni delle offerte.
Cascata
Vai ad Amministrazione > Aziende, poi fai clic sul pulsante Nuova azienda nella scheda Tutte le aziende. Seleziona Rete pubblicitaria.
Seleziona Unity Ads come Rete pubblicitaria, inserisci un Nome univoco e attiva la Mediazione. Attiva l'opzione Raccolta automatica dei dati e inserisci la chiave API e l'ID core dell'organizzazione ottenuti nella sezione precedente.
Non è necessario inserire un nome utente o una password. Al termine, fai clic su Salva.
Attivare la condivisione di indicatori sicuri
Offerte
Vai ad Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange, esamina e attiva Condivisione di indicatori sicuri. Fai clic su Salva.
Cascata
Questo passaggio non è obbligatorio per le integrazioni a cascata.
Condividere indicatori sicuri nelle richieste di offerta
Offerte
Vai a Inventario > Indicatori sicuri. In Indicatori sicuri, cerca Unity Ads e attiva Attiva integrazione app.
Fai clic su Salva.
Cascata
Questo passaggio non è obbligatorio per le integrazioni a cascata.
Consenti la condivisione di indicatori sicuri per SDK Bidding
Offerte
Vai a Pubblicazione > Impostazioni canali di domanda. Nella scheda Impostazioni predefinite, attiva l'opzione Consenti la condivisione di indicatori sicuri per SDK Bidding.
Fai clic su Salva.
Cascata
Questo passaggio non è obbligatorio per le integrazioni a cascata.
Configurare le offerte Unity Ads
Offerte
Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.
Fai clic su Nuovo offerente.
Seleziona Unity Ads come offerente.
Fai clic su Continua per attivare le offerte dell'SDK per questo offerente.
Fai clic su Fine.
Cascata
Questo passaggio non è obbligatorio per le integrazioni a cascata.
Configurare la mappatura delle unità pubblicitarie
Offerte
Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.
Seleziona l'azienda per Unity Ads.
Vai alla scheda Mappatura delle unità pubblicitarie e fai clic su Nuova mappatura delle unità pubblicitarie.
Scegli Unità pubblicitaria specifica. Seleziona un'unità pubblicitaria e un formato, App mobile come Tipo di inventario e la tua Applicazione mobile. Poi inserisci ID gioco e ID posizionamento ottenuti nella sezione precedente. Infine, fai clic su Salva.
Cascata
Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento. Seleziona la tua applicazione mobile.
Scorri verso il basso e fai clic su Aggiungi partner di rendimento.
Seleziona l'azienda che hai creato per Unity Ads nella sezione precedente. Scegli Mediazione SDK per dispositivi mobili come Tipo di integrazione, Android come Piattaforma e Attivo come Stato.
Inserisci l'ID gioco e l'ID posizionamento ottenuti nella sezione precedente e il valore CPM predefinito. Fai clic su Salva.
Nota: la raccolta automatica dei dati ha bisogno di raccogliere dati per qualche giorno prima di poter calcolare con precisione un valore di CPM dinamico per una rete di mediazione. Una volta che l'eCPM può essere calcolato, viene aggiornato automaticamente per tuo conto.
Aggiungere Unity Ads all'elenco dei partner pubblicitari ai sensi del GDPR e delle normative statali degli Stati Uniti
Segui i passaggi descritti in Impostazioni dei regolamenti europei e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere Unity Ads all'elenco dei partner pubblicitari ai sensi dei regolamenti europei e statali degli Stati Uniti nell'UI di Ad Manager.
Passaggio 3: importa l'SDK e l'adattatore Unity Ads
Integrazione di Android Studio (consigliata)
Nel file Gradle a livello di app, aggiungi le seguenti dipendenze di implementazione e configurazioni:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.unity3d.ads:unity-ads:4.16.5") implementation("com.google.ads.mediation:unity:4.16.6.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.unity3d.ads:unity-ads:4.16.5' implementation 'com.google.ads.mediation:unity:4.16.6.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Integrazione manuale
Scarica l'ultima versione dell'SDK Unity Ads (
unity-ads.aar) dal repository GitHub e aggiungila al tuo progetto.Vai agli artefatti dell'adattatore Unity Ads nel repository Maven di Google. Seleziona l'ultima versione, scarica il file
.aardell'adattatore Unity Ads e aggiungilo al tuo progetto.
Passaggio 4: implementa le impostazioni della privacy nell'SDK Unity Ads
Consenso degli utenti dell'UE e GDPR
Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, devi fornire determinate informative ai tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere il loro consenso per l'utilizzo di cookie o altro spazio di archiviazione locale ove legalmente richiesto, nonché per la raccolta, la condivisione e l'utilizzo dei dati personali per la personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Sei responsabile della verifica che il consenso venga propagato a ogni origine annuncio nella tua catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta del consenso dell'utente a queste reti.
Nella versione 2.0.0 dell'SDK, Unity Ads ha aggiunto un'API per supportare le impostazioni della privacy. Il seguente codice campione mostra come trasmettere queste informazioni sul consenso all'SDK Unity Ads. Se scegli di trasmettere manualmente le informazioni sul consenso all'SDK Unity Ads, ti consigliamo di chiamare questo codice prima di richiedere gli annunci tramite GMA Next-Gen SDK.
Java
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Kotlin
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
Per ulteriori dettagli e i valori che possono essere forniti in ogni metodo, consulta la sezione Conformità al GDPR di Unity Ads.
Leggi statali sulla privacy degli Stati Uniti
Le leggi sulla privacy degli stati degli Stati Uniti impongono di garantire agli utenti il diritto di disattivare la "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 nella tua catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che potrebbe partecipare alla vendita di dati personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.
Nella versione 2.0.0 dell'SDK, Unity Ads ha aggiunto un'API per supportare le impostazioni della privacy. Il seguente codice campione mostra come trasmettere queste informazioni sul consenso all'SDK Unity Ads. Se scegli di trasmettere manualmente le informazioni sul consenso all'SDK Unity Ads, ti consigliamo di chiamare questo codice prima di richiedere gli annunci tramite GMA Next-Gen SDK.
Java
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
Kotlin
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
Per ulteriori dettagli e i valori che possono essere forniti in ogni metodo, consulta la sezione Conformità al Consumer Privacy Act di Unity Ads.
Passaggio 5: aggiungi il codice richiesto
Caricare l'annuncio con il contesto dell'attività
Trasmetti il contesto Activity durante il caricamento dei formati degli annunci banner, interstitial e nativi.
Senza il contesto dell'attività, il caricamento degli annunci non andrà a buon fine.
Passaggio 6: testa l'implementazione
Attivare gli annunci di prova
Assicurati di registrare il tuo dispositivo di test per Ad Manager e di attivare la modalità di test nell'interfaccia utente di Unity Ads.
Verificare gli annunci di prova
Per verificare di ricevere annunci di test da Unity Ads, attiva il test di singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Unity Ads (asta) e Unity Ads (struttura a cascata).
Codici di errore
Se l'adattatore non riceve un annuncio da Unity Ads,
gli editori possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
ResponseInfo.getAdSourceResponses()
nelle seguenti classi:
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
Di seguito sono riportati i codici e i messaggi associati restituiti dall'adattatore UnityAds quando un annuncio non viene caricato:
| Codice di errore | Motivo |
|---|---|
| 0-10 | L'SDK UnityAds ha restituito un errore. Per ulteriori dettagli, consulta il codice. |
| 101 | I parametri del server UnityAds configurati nell'interfaccia utente di Ad Manager non sono presenti o non sono validi. |
| 102 | UnityAds ha restituito un posizionamento con stato NO_FILL. |
| 103 | UnityAds ha restituito un posizionamento con stato DISABLED. |
| 104 | UnityAds ha tentato di mostrare un annuncio con un contesto nullo. |
| 105 | Il contesto utilizzato per inizializzare, caricare e/o mostrare gli annunci di Unity Ads non è un'istanza di attività. |
| 106 | UnityAds ha tentato di mostrare un annuncio non ancora pronto per la pubblicazione. |
| 107 | UnityAds non è supportato sul dispositivo. |
| 108 | UnityAds può caricare solo un annuncio per posizionamento alla volta. |
| 109 | UnityAds è stato completato con lo stato ERROR. |
| 200-204 | Errore specifico del banner UnityAds. Per ulteriori dettagli, consulta il codice. |