Integrare Unity Ads con la mediazione

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

Questa guida mostra come utilizzare Google Mobile Ads Flutter Plugin 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 Flutter.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata  1
Formati
Banner
Interstitial
Con premio

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Ultima versione di Google Mobile Ads Flutter Plugin.
  • Framework Flutter versione 3.7.0 o successive.
  • [Per l'asta]: per integrare tutti i formati degli annunci supportati nell'asta, utilizza il plug-in di mediazione di Google Mobile Ads per Unity Ads 1.1.0 o versioni successive (consigliata l'ultima versione).
  • Per il deployment su Android
    • Livello API Android 24 o versioni successive.
  • Per il deployment su iOS
    • Target di deployment iOS 13.0 o versioni successive.
  • Un progetto Flutter funzionante configurato con Google Mobile Ads Flutter Plugin. Per informazioni dettagliate, consulta Configura Google Mobile Ads Flutter Plugin.
  • Configura la mediazione.

    • 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 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, poi 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 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

    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.

    Android

    iOS

    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 Accesso all'API Monetization Stats.

    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 già fatto, crea un file app-ads.txt per Ad Manager.

    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 Ad Manager

    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 per il GDPR e i regolamenti statali degli Stati Uniti

    Segui i passaggi descritti in Impostazioni relative ai regolamenti europei e Impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Unity Ads all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'UI di Ad Manager.

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

    Integrazione tramite pub.dev

    Aggiungi la seguente dipendenza con le ultime versioni dell'SDK per gli annunci Unity e dell'adattatore nel file pubspec.yaml del pacchetto:

    dependencies:
  gma_mediation_unity: ^1.11.1

    Integrazione manuale

    Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per Unity Ads, estrai il file scaricato e aggiungi la cartella del plug-in estratto (e i relativi contenuti) al tuo progetto Flutter. Quindi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:

    dependencies:
  gma_mediation_unity:
    path: path/to/local/package

    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 fornire determinate informazioni agli utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere 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.

    L'adattatore Unity Ads Flutter versione 1.10.0 e successive supporta la trasmissione di 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 raccolta del consenso conforme o non conforme al 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 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 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 di Google Mobile Ads per Unity Ads include il metodo GmaMediationUnity.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 Flutter Plugin.

    import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

    Imposta il trattamento in base all'età

    La versione 1.6.5 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 classificazione per pubblico misto nel tuo progetto, consulta Impostazione delle classificazioni per 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 Ad Manager 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 saperne di più, 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 provato a 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 ha terminato con uno stato di ERRORE.
    110 Le dimensioni dell'annuncio richieste non corrispondono a quelle di un banner supportato 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 ulteriori dettagli, consulta il codice.

    iOS

    0-9 L'SDK UnityAds ha restituito un errore. Per ulteriori dettagli, consulta la documentazione di Unity.
    101 I parametri del server UnityAds configurati nell'interfaccia utente di Ad Manager 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 è nullo 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 lo 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.

    Log delle modifiche dell'adattatore di mediazione Flutter di Unity Ads

    Versione 1.12.0 (in corso)

    Versione 1.11.1

    Versione 1.11.0

    Versione 1.10.0

    Versione 1.9.0

    Versione 1.8.1

    Versione 1.8.0

    Versione 1.7.0

    Versione 1.6.5

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.6.4

    Versione 1.6.3

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.6.2

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.6.1

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.6.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.5.1

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.5.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.4.1

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.4.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

    Versione 1.3.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 5.3.1.

    Versione 1.2.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 5.3.1.

    Versione 1.1.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 5.2.0.

    Versione 1.0.0

    • Creato e testato con il plug-in Flutter Google Mobile Ads versione 5.0.0.