Integrare Unity Ads con la mediazione

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

Questa guida spiega come utilizzare GMA Next-Gen SDK per caricare e mostrare gli annunci di Unity Ads utilizzando la Mediazione AdMob, coprendo le integrazioni di asta e struttura a cascata. Descrive come aggiungere Unity Ads alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di Unity Ads in un'app per Android.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per Unity Ads ha le seguenti funzionalità:

Requisiti

• Livello API Android 24 o versioni successive

• [Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l'adattatore Unity 4.16.0.1 o versioni successive (versione più recente consigliata)

• Più recente GMA Next-Gen SDK

• Completa la mediazione Guida introduttiva

Passaggio 1: configura le impostazioni 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 e fai clic su Inizia.

Nella finestra modale Nuovo progetto, seleziona Utilizzerò la mediazione e Google AdMob per Partner di mediazione, quindi fai clic su Avanti.

Seleziona l'opzione per le impostazioni degli annunci e fai clic su Avanti.

Seleziona la configurazione del posizionamento e fai clic su Avanti.

Compila il modulo e fai clic su Aggiungi progetto.

Prendi nota dell'ID gioco.

Crea unità pubblicitarie e posizionamenti

Vai a Monetizzazione di Unity Ads > Posizionamenti, seleziona il tuo progetto e fai clic su Aggiungi unità pubblicitaria.

Inserisci un nome dell'unità pubblicitaria, quindi seleziona la piattaforma e il formato dell'annuncio.

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

Individua la chiave API di reporting di Unity Ads

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (Venditori autorizzati per app) o app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario degli annunci per app 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 Configurare app-ads.txt per la prima volta.

Attiva la modalità di test

La modalità di test può essere attivata dalla dashboard di Unity Ads. Vai a Monetizzazione di Unity Ads > Test.

Puoi forzare la modalità di test per la tua app facendo clic sul pulsante Modifica accanto a Google Play Store , attivando Esegui l'override della modalità di test del client e selezionando Forza la modalità di test (ovvero utilizza gli annunci di test) per tutti i dispositivi.

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 e fai clic su Salva.

Passaggio 2: configura la domanda di Unity Ads nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere Unity Ads alla configurazione della mediazione per l'unità pubblicitaria.

Innanzitutto, accedi all'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 alla sezione Aggiungere Unity Ads come origine annuncio.

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

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

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

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

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungi Unity Ads come origine annuncio

Asta

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 di offerte con Unity Ads.



Fai clic su Riconosci e accetta, quindi 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 ID posizionamento ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

A 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à 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. Dopodiché, fai clic su Fine.

Aggiungi Unity Ads all'elenco dei partner pubblicitari per il GDPR e le normative statali degli Stati Uniti

Segui i passaggi descritti in Impostazioni relative ai regolamenti europei e Impostazioni relative alle normative statali degli Stati Uniti per aggiungere Unity Ads all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di AdMob.

Passaggio 3: importa l'SDK e l'adattatore di Unity Ads

Integrazione di Android Studio (consigliata)

Nel file gradle a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.17.0.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.25.0-beta01'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.17.0.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'SDK di Unity Ads più recente (unity-ads.aar) dal loro repository GitHub e aggiungilo al progetto.

2. Vai agli artefatti dell'adattatore di Unity Ads nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore di Unity Ads e aggiungilo al progetto.

Passaggio 4: implementa le impostazioni sulla privacy nell'SDK di Unity Ads

Consenso dell'UE e GDPR

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, è obbligatorio informare i tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ricevere il loro consenso per l'utilizzo dei cookie o di altri tipi di archiviazione locale, laddove richiesto dalla legge, nonché per la raccolta, la condivisione e l'utilizzo dei dati personali ai fini della personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. È tua responsabilità verificare che il consenso venga propagato a ogni origine annuncio nella catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta di consenso dell'utente a queste reti.

Nella versione 2.0.0 dell'SDK, Unity Ads ha aggiunto un'API per supportare le impostazioni sulla privacy. Il seguente codice campione mostra come passare queste informazioni sul consenso all'SDK per gli annunci di Unity. Se scegli di trasmettere manualmente le informazioni sul consenso all'SDK di 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 maggiori dettagli e per 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 statali sulla privacy degli Stati Uniti impongono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi 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 statali sulla privacy 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 nella catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella catena di mediazione che potrebbe partecipare alla vendita di informazioni 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 sulla privacy. Il seguente codice campione mostra come passare queste informazioni sul consenso all'SDK per gli annunci di Unity. Se scegli di trasmettere manualmente le informazioni sul consenso all'SDK di 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 maggiori dettagli e per 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

Carica l'annuncio con il contesto dell'attività

Trasmetti il contesto Activity quando carichi i formati degli annunci banner, interstitial e nativi. Senza il contesto dell'attività, il caricamento dell'annuncio non andrà a buon fine.

Passaggio 6: testa l'implementazione

Attiva gli annunci di test

Assicurati di registrare il dispositivo di test per AdMob e attivare la modalità di test nell' interfaccia utente di Unity Ads.

Verifica gli annunci di test

Per verificare di ricevere annunci di test da Unity Ads, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Unity Ads (Offerte) e Unity Ads (Cascata).

Codici di errore

Se l'adattatore non riceve un annuncio da Unity Ads, i publisher possono controllare l'errore sottostante dalla 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 generati dall'adattatore UnityAds quando un annuncio non viene caricato: