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, che include le integrazioni di offerte e con struttura a cascata. Viene illustrato come aggiungere Unity Ads alla configurazione di 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 unità pubblicitaria, quindi seleziona Piattaforma e Formato annuncio.

Vai a Monetizzazione > Posizionamenti e fai clic su Aggiungi unità pubblicitaria.

Inserisci un Nome unità pubblicitaria, quindi seleziona Piattaforma e Formato annuncio.

Seleziona A cascata per la Configurazione. In Posizionamento, inserisci Nome posizionamento, Tagging geografico e Target.

Prendi nota dell'ID posizionamento.

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 app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario di 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, crea un file app-ads.txt per Ad Manager.

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 Ignora modalità di test del client e selezionando Forza la modalità di test (ovvero utilizza gli annunci di test) su 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 Ad Manager

Accedi al tuo account Ad Manager.

Aggiungi Unity Ads in Aziende

Attiva la condivisione di indicatori sicuri

Condividi indicatori sicuri nelle richieste di offerta

Consenti la condivisione di indicatori sicuri per SDK Bidding

Configura le offerte di Unity Ads

Configura la mappatura delle unità pubblicitarie

Aggiungi Unity Ads all'elenco dei partner pubblicitari per il GDPR e le 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 per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di Ad Manager.

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 Unity Ads più recente (unity-ads.aar) dal loro repository GitHub e aggiungilo al progetto.

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

Passaggio 4: implementa le impostazioni sulla privacy nell'SDK 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 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 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" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben in evidenza 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 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 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 Ad Manager 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 riesce a ricevere un annuncio da Unity Ads, gli editori 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: