Integrare Unity Ads con la mediazione

Seleziona la piattaforma: Android (beta) Android iOS Unity Flutter

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci di Unity Ads utilizzando la mediazione AdMob, 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à:

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.

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.

Infine, fai clic su Aggiungi unità pubblicitaria per salvare l'unità pubblicitaria e il posizionamento.

Individuare la chiave API di Unity Ads Reporting

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, configura un file app-ads.txt per la tua app.

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 AdMob

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere Unity Ads alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente a Aggiungere Unity Ads come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato e la piattaforma dell'annuncio, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Successivamente, imposta lo stato del gruppo di mediazione su Attivato e poi fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più delle tue unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie che hai selezionato:

Aggiungere Unity Ads come origine annuncio

Offerte

Nella scheda Offerte della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona Unity Ads .

Fai clic su Come firmare un contratto di partnership e configura una partnership per l'asta con Unity Ads.



Fai clic su Riconosci e accetta, poi su Continua.



Se hai già una mappatura per Unity Ads, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci l'ID gioco e l'ID posizionamento ottenuti nella sezione precedente. Poi fai clic su Fine.

Cascata

Nella scheda Cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.

Seleziona Unity Ads e attiva l'opzione Ottimizza. Inserisci la chiave API e l'ID core dell'organizzazione ottenuti nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per Unity Ads. Poi inserisci un valore eCPM per Unity Ads e fai clic su Continua.



Se hai già un mapping per Unity Ads, puoi selezionarlo. In caso contrario, fai clic su Aggiungi mappatura.

Poi, inserisci l'ID gioco e l'ID posizionamento ottenuti nella sezione precedente. Poi fai clic su Fine.

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

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:

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")
}

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

1. Scarica l'ultima versione dell'SDK Unity Ads (unity-ads.aar) dal repository GitHub e aggiungila al tuo progetto.

2. Vai agli artefatti dell'adattatore Unity Ads nel repository Maven di Google. Seleziona l'ultima versione, scarica il file .aar dell'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.

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

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.

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

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 dispositivo di prova per AdMob 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: