Integrare LY Ads Network con la mediazione

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

Questa guida mostra come utilizzare Google Mobile Ads Unity Plugin per caricare e visualizzare annunci della rete LY Ads utilizzando la mediazione, che copre le integrazioni a cascata. Spiega come aggiungere LY Ads Network alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore LY Ads Network in un'app Unity.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione Ad Manager per la rete pubblicitaria LY Ads ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Ultima versione di Google Mobile Ads Unity Plugin.
  • Unity Editor versione 4 o successive.
  • [Per l'asta]: per integrare tutti i formati degli annunci supportati nell'asta, utilizza il plug-in di mediazione Google Mobile Ads per LY Ads Network 1.5.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 distribuzione iOS 13.0 o versioni successive.
  • Un progetto Unity funzionante configurato con Google Mobile Ads Unity Plugin. Per maggiori dettagli, vedi Configurare Google Mobile Ads Unity Plugin.
  • Configura la mediazione.

    • Passaggio 1: configura le impostazioni nell'interfaccia utente della rete pubblicitaria LY Ads

    Registrati e accedi al tuo account LY Ads Network.

    Aggiungi una nuova applicazione

    Vai alla scheda App e fai clic sul pulsante Nuova registrazione.

    Nuova registrazione

    Compila il modulo e fai clic su Registrazione.

    Nuovo modulo di registrazione

    Prendi nota dell'ID app.

    Android

    Dettagli registrazione

    iOS

    Dettagli registrazione

    Crea un'area annuncio

    Nella scheda App, seleziona la tua app per visualizzarne i dettagli. Nella sezione Slot, fai clic su Aggiungi.

    Aggiungi slot

    Compila il modulo per i dettagli sullo slot. Per Tipo di offerta, seleziona Standard per configurare questo slot per la mediazione a cascata oppure SDK Bidding di Google per configurare questo slot per le offerte. Fai clic su Crea dopo aver compilato il modulo.

    Aggiungi modulo slot

    Prendi nota dell'ID slot.

    Dettagli slot

    Dopo aver creato il primo slot, fai clic su Revisione nella pagina dei dettagli dell'app per ottenere l'approvazione da LY Ads Network. Questa operazione potrebbe richiedere del tempo. Per eventuali domande, contatta il tuo rappresentante di LY Ads Network.

    Richiedi una revisione

    Crea una chiave API di reporting

    Vai alla scheda Gestione delle chiavi API di reporting e fai clic sul pulsante Crea chiave API.

    Scheda Chiave API di reporting

    Compila il modulo e fai clic su Salva.

    Modulo per la chiave API di reporting

    Prendi nota dell'ID chiave API e del secret della chiave API.

    Modulo per la chiave API di reporting

    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 LY Ads Network, consulta Informazioni su app-ads.txt.

    Passaggio 2: configura la domanda della rete pubblicitaria LY 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, vedi il passaggio 2 della guida per iOS.

    Passaggio 3: importa l'SDK e l'adattatore LY Ads Network

    OpenUPM-CLI

    Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione rete pubblicitaria LY di Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory root del progetto:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    Nell'editor del progetto Unity, seleziona Edit > Impostazioni progetto > Package Manager per aprire le impostazioni di Unity Package Manager.

    Nella scheda Scoped Registries (Registri con ambito), aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Ambiti: com.google

    Dettagli OpenUPM

    Poi, vai a Window (Finestra) > Package Manager (Gestore di pacchetti) per aprire Unity Package Manager e seleziona My Registries (I miei registri) dal menu a discesa.

    Registri Unity

    Seleziona il pacchetto Google Mobile Ads Line Mediation e fai clic su Installa.

    Installa da OpenUPM

    Pacchetto Unity

    Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per la rete pubblicitaria LY Ads Network dal link di download nel Changelog ed estrai GoogleMobileAdsLineMediation.unitypackage dal file zip.

    Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e trova il file GoogleMobileAdsLineMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

    Importa da Unity

    Poi, seleziona Assets > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

    Forza risoluzione

    Passaggio 4: aggiungi il codice richiesto

    Android

    Per l'integrazione di LY Ads Network non è necessario codice aggiuntivo.

    iOS

    Integrazione di SKAdNetwork

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

    Passaggio 5: testa l'implementazione

    Attivare gli annunci di prova

    Assicurati di registrare il dispositivo di test per Ad Manager.

    Verificare gli annunci di test

    Per verificare che stai ricevendo annunci di prova dalla rete pubblicitaria LY Ads Network, attiva il test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio LY Ads Network.

    Passaggi facoltativi

    Parametri specifici per la rete

    Il plug-in di mediazione Unity di LY Ads Network supporta il seguente parametro di richiesta aggiuntivo che può essere passato all'adattatore tramite la classe LineMediationExtras:

    • SetEnableAdSound(boolean) : specifica lo stato di avvio dell'audio predefinito degli annunci banner, interstitial e con premio.

    Di seguito è riportato un esempio di codice per creare una richiesta di annuncio che imposta questi parametri:

    using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

    Codici di errore

    Se l'adattatore non riceve un annuncio dalla rete LY Ads, gli editori possono controllare l'errore sottostante dalla risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

    Android

    com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

    iOS

    GADMediationAdapterLine

    Ecco i codici e i messaggi associati generati dall'adattatore LY Ads Network quando un annuncio non viene caricato:

    Android

    Codice di errore Dominio Motivo
    1-10 com.five_corp.ad L'SDK LY Ads Network ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di LY Ads Network.
    101 com.google.ads.mediation.line ID applicazione mancante o non valido.
    102 com.google.ads.mediation.line ID slot mancante o non valido.
    103 com.google.ads.mediation.line La dimensione dell'annuncio richiesta non corrisponde a una dimensione dell'annuncio banner supportata dalla rete LY Ads.
    104 com.google.ads.mediation.line Impossibile caricare un annuncio interstitial o con premio a causa della mancanza del contesto dell'attività.
    105 com.google.ads.mediation.line L'SDK LY Ads Network non è riuscito a mostrare un interstitial o un annuncio con premio.
    106 com.google.ads.mediation.line Impossibile caricare un annuncio nativo a causa di asset mancanti.
    107 com.google.ads.mediation.line L'SDK FiveAd ha restituito un caricatore di annunci nullo.

    iOS

    Codice di errore Dominio Motivo
    1-10 Inviati dall'SDK LY Ads Network L'SDK LY Ads Network ha restituito un errore specifico dell'SDK. Per saperne di più, consulta la documentazione di LY Ads Network.
    101 com.google.ads.mediation.line Parametri del server non validi (ad es. ID applicazione o ID area annuncio mancante).
    102 com.google.ads.mediation.line La dimensione dell'annuncio richiesta non corrisponde a una dimensione dell'annuncio banner supportata dalla rete LY Ads.
    103 com.google.ads.mediation.line Impossibile caricare un asset immagine dell'icona informazioni nell'annuncio nativo.
    104 com.google.ads.mediation.line Impossibile raccogliere indicatori per le offerte.
    105 com.google.ads.mediation.line Impossibile inizializzare il caricatore di annunci dell'SDK LINE Ads.

    Log delle modifiche del plug-in di mediazione Unity di Line

    Versione 2.2.1

    Versione 2.2.0

    Versione 2.1.1

    Versione 2.1.0

    Versione 2.0.2

    Versione 2.0.1

    Versione 2.0.0

    Versione 1.5.10

    Versione 1.5.9

    Versione 1.5.8

    Versione 1.5.7

    Versione 1.5.6

    Versione 1.5.5

    • Risolto un problema per cui l'installazione tramite OpenUPM impediva l'importazione corretta dei pacchetti da parte del plug-in.

    Versione 1.5.4

    Versione 1.5.3

    Versione 1.5.2

    Versione 1.5.1

    Versione 1.5.0

    Versione 1.4.0

    Versione 1.3.1

    Versione 1.3.0

    Versione 1.2.0

    Versione 1.1.2

    Versione 1.1.1

    Versione 1.1.0

    Versione 1.0.0