Integrare Unity Ads con la mediazione AdMob

Questa guida mostra come utilizzare Google Mobile Ads SDK for React Native per caricare e visualizzare 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 per gli annunci e l'adattatore Unity Ads in un'app nativa React Native.

Integrazioni e formati degli annunci supportati

L'adattatore di Mediazione AdMob per Unity Ads offre le seguenti funzionalità:

Integrazione
Offerte
Cascata  1
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio
Nativo

Prerequisiti

Prima di continuare, verifica quanto segue:

Passaggio 1: imposta le configurazioni nell'interfaccia utente di Unity Ads

Registrati o accedi a Unity Ads.

Crea un progetto

Nella dashboard di Unity Ads, vai a Projects (Progetti) e fai clic su New (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 annunci e poi fai clic su Avanti.

Seleziona la configurazione del posizionamento, poi fai clic su Avanti.

Offerte

Cascata

Compila il modulo, quindi fai clic su Aggiungi progetto.

Prendi nota dell'ID gioco.

Crea unità pubblicitarie e posizionamenti

Vai a Unity Ads Monetization > Placements (Posizionamenti), poi seleziona il tuo progetto e fai clic su Add ad unit (Aggiungi unità pubblicitaria).

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

Android

iOS

Offerte

Seleziona Offerte per la Configurazione. In Posizionamento, inserisci il Nome posizionamento.

Prendi nota dell'ID posizionamento.

Cascata

Seleziona A cascata per Configurazione. In Posizionamento, inserisci il Nome posizionamento, il Tagging geografico e il 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

Offerte

Questo passaggio non è obbligatorio per le integrazioni per l'asta.

Cascata

Vai a Unity Ads Monetization > Gestione delle API e prendi nota della chiave API in Monetization Stats API Access.

Poi, vai a Unity Ads Monetization > Organization Settings e prendi nota dell'ID principale dell'organizzazione.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (app-ads.txt) è un'iniziativa di IAB Tech Lab che contribuisce a garantire che l'inventario pubblicitario della tua app venga venduto solo tramite canali che hai identificato come autorizzati. Per evitare una perdita 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 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 Unity Ads Monetization > Testing.

Puoi forzare la modalità di test per la tua app facendo clic sul pulsante di modifica di ogni piattaforma, attivando Esegui l'override della modalità di test del client e selezionando Forza l'attivazione della modalità di test (ovvero utilizza gli annunci di prova) per tutti i dispositivi.

Android

iOS

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 annunci di Unity Ads nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, consulta il passaggio 2 della guida per iOS.

Aggiungi Unity Ads all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti

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

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

Nella directory root del progetto, installa l'adattatore di mediazione Google Mobile Ads SDK for React Native per Unity Ads. Completa i passaggi seguente:

  1. Copia il file tar dell'adattatore Google Mobile Ads SDK for React Native dalla directory gma-sdk-react-native/adapters/unity/ nella directory local_packages/ del progetto. Se non hai la cartella adapters, consulta i Prerequisiti.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/unity/gma-mediation-unity-0.1.0.tgz local_packages/

    Sostituisci EXTRACT_DIR con il percorso della directory in cui hai estratto l'archivio.

  2. Installa il pacchetto dell'adattatore utilizzando il gestore di pacchetti che preferisci:

    npm

    npm install ./local_packages/gma-mediation-unity-0.1.0.tgz

    filo

    yarn add ./local_packages/gma-mediation-unity-0.1.0.tgz

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

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, devi informare gli 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 tua catena di mediazione.

L'adattatore Unity Ads React Native versione 0.1.0 e successive supporta il passaggio degli indicatori di consenso GDPR dalle piattaforme di gestione del consenso che si integrano con il Transparency and Consent Framework (TCF) di IAB all'SDK per gli annunci Unity Ads. Per saperne di più, consulta Configura una configurazione del consenso TCF o non TCF.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti richiedono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di tale normativa), 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 informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

Il plug-in di mediazione Google Mobile Ads per Unity Ads include il metodo UnityMediation.setCCPAConsent(). Il seguente codice campione mostra come trasmettere le informazioni sul consenso all'SDK Unity Ads. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite Google Mobile Ads SDK for React Native.

import { UnityMediation } from '@google/gma-mediation-unity';
// ...

UnityMediation.setCCPAConsent(false);

Imposta il trattamento in base all'età

La versione 0.1.0 e successive del plug-in di mediazione Unity Ads inoltra l'impostazione per i contenuti destinati ai minori e l'impostazione per gli utenti di età inferiore a quella del consenso digitale a Unity Ads.

Per elaborare questi indicatori per utente, Unity Ads richiede di attivare la designazione Pubblico misto nella dashboard di Unity Monetization. Per saperne di più sull'attivazione di una designazione di pubblico misto nel tuo progetto, consulta Impostazione delle designazioni di età a livello di gioco.

Passaggio 5: aggiungi il codice richiesto

Android

Non è necessario codice aggiuntivo per le integrazioni di Unity Ads per Android.

iOS

Integrazione di SKAdNetwork

Segui la documentazione di Unity Ads per aggiungere gli identificatori SKAdNetwork al file Info.plist del tuo progetto.

Passaggio 6: testa l'implementazione

Attiva gli annunci di prova

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

Verifica gli annunci di prova

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

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da Unity Ads, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore UnityAds quando un annuncio non viene caricato:

Android

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 AdMob sono mancanti o non validi.
102 UnityAds ha restituito un posizionamento con uno stato NO_FILL.
103 UnityAds ha restituito un posizionamento con stato DISATTIVATO.
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 pronto per la pubblicazione.
107 UnityAds non è supportato sul dispositivo.
108 UnityAds può caricare un solo annuncio per posizionamento alla volta.
109 UnityAds è terminato con uno stato di ERRORE.
110 La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da UnityAds.
111 UnityAds ha restituito un errore di inizializzazione.
112 Unity Ads ha restituito un token di asta nullo o vuoto.
200-204 UnityAds Banner a specific error. Per maggiori dettagli, consulta il codice.

iOS

0-9 L'SDK UnityAds ha restituito un errore. Per maggiori dettagli, consulta la documentazione di Unity.
101 I parametri del server UnityAds configurati nell'interfaccia utente di AdMob sono mancanti o non validi.
102 Dispositivo non supportato da UnityAds.
103 UnityAds ha terminato la presentazione con lo stato di errore kUnityAdsFinishStateError.
104 L'oggetto annuncio Unity è nil dopo aver chiamato il relativo inizializzatore.
105 Impossibile mostrare gli annunci Unity perché l'annuncio non è pronto.
107 UnityAds ha chiamato un callback di modifica del posizionamento con stato del posizionamento kUnityAdsPlacementStateDisabled.
108 Un annuncio è già stato caricato per questo posizionamento. L'SDK UnityAds non supporta il caricamento di più annunci per lo stesso posizionamento.
109 L'annuncio banner restituito da UnityAds non corrisponde alle dimensioni richieste.
110 UnityAds ha restituito un errore di inizializzazione.
111 Formato dell'annuncio non supportato.
112 UnityAds ha restituito un token di asta nullo o vuoto.

Versione 0.1.0

  • Release iniziale.