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 di 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 le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza il plug-in di mediazione 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 maggiori dettagli, vedi Configurare 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 Progetti e fai clic su Nuovo.

    Compila il modulo e fai clic su Crea per aggiungere il progetto.

    Vai a Monetizzazione con 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 e fai clic su Avanti.

    Offerte

    Cascata

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

    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.

    Individuare la chiave API di Unity Ads Reporting

    Offerte

    Questo passaggio non è obbligatorio per le integrazioni delle offerte.

    Cascata

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

    A questo punto, 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 il tuo inventario pubblicitario dell'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 la modalità di test ON (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

    Configurare le impostazioni di mediazione per l'unità pubblicitaria

    Android

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

    iOS

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

    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 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 e l'adattatore Unity Ads

    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 informative ai tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere il loro consenso all'utilizzo di cookie o di altro spazio di archiviazione locale ove richiesto dalla legge e alla raccolta, alla condivisione e all'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. È tua responsabilità verificare che il consenso venga propagato a ogni origine annuncio nella tua catena di mediazione.

    L'adattatore Flutter di Unity Ads versione 1.10.0 e successive supporta il trasferimento 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 di Unity Ads. Per saperne di più, consulta Configurare una configurazione del consenso TCF o non TCF.

    Leggi statali sulla privacy degli Stati Uniti

    Le leggi statali sulla privacy degli Stati Uniti impongono di garantire agli utenti il diritto di disattivare la "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di questi termini fornita dalla legge), mediante un link ben visibile 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 GmaMediationUnity.setCCPAConsent(). Il seguente codice di esempio 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.

    Verificare gli annunci di test

    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 riceve un annuncio da Unity Ads, i publisher possono controllare l'errore sottostante nella risposta dell'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 maggiori dettagli, consulta il codice.
    101 I parametri del server UnityAds configurati nella UI di AdMob non sono presenti o non sono 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 ancora 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 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 saperne di più, 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 Il 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 Ads perché l'annuncio non è pronto.
    107 UnityAds ha chiamato un callback di modifica del posizionamento con lo stato del posizionamento kUnityAdsPlacementStateDisabled.
    108 Per questo posizionamento è già stato caricato un annuncio. 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.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.