Integrare LY Ads Network con la mediazione

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

Questa guida mostra come utilizzare Google Mobile Ads SDK (Legacy) per caricare e visualizzare gli annunci dalla rete pubblicitaria 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 per Android.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Livello API Android 24 o versioni successive.

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.

New Registration Form

Prendi nota dell'ID app.

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 dello spazio. 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.

Modulo Aggiungi 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 ancora 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

Accedi al tuo account Ad Manager.

Aggiungi LY Ads Network in Aziende

Offerte

Questo passaggio non è obbligatorio per le integrazioni di asta.

Cascata

Vai ad Amministrazione > Aziende, poi fai clic sul pulsante Nuova azienda nella scheda Tutte le aziende. Seleziona Rete pubblicitaria.

Seleziona LY Ads Network come Rete pubblicitaria, inserisci un Nome univoco e attiva la Mediazione. Attiva Raccolta automatica dei dati e inserisci ID chiave API e Secret chiave API ottenuti nella sezione precedente.

Non è necessario inserire un Nome utente o una Password. Al termine, fai clic su Salva.

Attiva la condivisione di indicatori sicuri

Offerte

Vai su Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange, esamina e attiva Condivisione di indicatori sicuri. Fai clic su Salva.

Cascata

Questo passaggio non è obbligatorio per le integrazioni a cascata.

Condividere indicatori sicuri nelle richieste di offerta

Offerte

Vai a Inventario > Indicatori sicuri. Nella sezione Indicatori sicuri, cerca LY Ads Network e attiva Attiva integrazione app.

Fai clic su Salva.

Cascata

Questo passaggio non è obbligatorio per le integrazioni a cascata.

Consenti la condivisione di indicatori sicuri per SDK Bidding

Offerte

Vai a Pubblicazione > Impostazioni canali di domanda. Nella scheda Impostazioni predefinite, attiva Consenti la condivisione di indicatori sicuri per SDK Bidding.

Fai clic su Salva.

Cascata

Questo passaggio non è obbligatorio per le integrazioni con la struttura a cascata.

Configurare le offerte LY Ads Network

Offerte

Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.

Fai clic su Nuovo offerente.

Seleziona LY Ads Network come offerente.

Fai clic su Continua per attivare SDK Bidding per questo offerente.

Fai clic su Fine.

Cascata

Questo passaggio non è obbligatorio per le integrazioni con la struttura a cascata.

Configura la mappatura delle unità pubblicitarie

Offerte

Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.

Seleziona l'azienda per LY Ads Network.

Vai alla scheda Mappatura delle unità pubblicitarie e fai clic su Nuova mappatura delle unità pubblicitarie.

Scegli Unità pubblicitaria specifica. Seleziona un'unità pubblicitaria e un formato, App mobile come Tipo di inventario e la tua Applicazione mobile. Poi, inserisci l'ID applicazione e l'ID slot ottenuti nella sezione precedente.

Infine, fai clic su Salva.

Cascata

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento. Seleziona Inventario e App.

Scorri fino a Partner di rendimento e fai clic su Aggiungi partner di mediazione.

Seleziona la società che hai creato per LY Ads Network nella sezione precedente. Scegli Mediazione SDK per dispositivi mobili come Tipo di integrazione, Android come Piattaforma e Attivo come Stato.

Inserisci l'ID applicazione e l'ID slot ottenuti nella sezione precedente e il valore CPM predefinito. Fai clic su Salva.

Passaggio 3: importa l'SDK e l'adattatore della rete pubblicitaria LY Ads

Nel file gradle a livello di app, aggiungi le seguenti dipendenze di implementazione:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

Integrazione manuale

  1. Scarica l'ultima versione del file .aar dell'SDK LY Ads Network e aggiungilo al tuo progetto.

  2. Vai agli artefatti dell'adattatore della rete pubblicitaria LY Ads nel repository Maven di Google. Seleziona l'ultima versione, scarica il file .aar dell'adattatore di LY Ads Network e aggiungilo al tuo progetto.

Passaggio 4: aggiungi il codice richiesto

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

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager.

L'adattatore LY Ads Network contiene un metodo di supporto per attivare la modalità di test per LY Ads Network. Devi impostare questa opzione prima di inizializzare Google Mobile Ads SDK (Legacy) per assicurarti che vengano inoltrate correttamente all'SDK LY Ads Network.

Java 

LineMediationAdapter.Companion.setTestMode(true);

Kotlin 

LineMediationAdapter.setTestMode(true)

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 della rete

L'adattatore LY Ads Network supporta un parametro di richiesta aggiuntivo che può essere passato all'adattatore utilizzando la classe LineExtras. Questo costruttore di classi include i seguenti parametri:

enableAdSound
Un boolean per specificare lo stato di avvio predefinito dell'audio di annunci banner, interstitial e con premio.

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

Java 

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();

Kotlin 

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()

Utilizzo degli annunci nativi

Rendering degli annunci

L'adattatore LY Ads Network compila i seguenti campi per un NativeAd.

Campo Asset sempre inclusi dall'adattatore LY Ads Network
Titolo
Immagine
Corpo
Icona dell'app 1
Call to action
Valutazione a stelle
Negozio
Prezzo

1 Per gli annunci nativi, l'SDK LY Ads Network non fornisce un asset icona dell'app. L'adattatore LY Ads Network inserisce invece un'immagine trasparente nell'icona dell'app.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da LY Ads Network, puoi controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

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

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

Codice di errore Dominio Motivo
1-10 com.five_corp.ad 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 ID applicazione mancante o non valido.
102 com.google.ads.mediation.line ID slot mancante o non valido.
103 com.google.ads.mediation.line Le dimensioni dell'annuncio richieste non corrispondono a quelle degli annunci banner supportate dalla rete pubblicitaria LY Ads Network.
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.

Log delle modifiche dell'adattatore di mediazione LINE per Android

Versione 3.1.1.2

  • Fissa la dipendenza Kotlin dell'adattatore alla versione 1.9.0 (la versione minima di Kotlin supportata dall'SDK GMA NextGen).

Creata e testata con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.4.0.
  • SDK FiveAd versione 3.1.1.1.

Versione 3.1.1.1

  • Maps AgeRestrictedTreatment all'API ChildDirectedTreatment di Line.

Creata e testata con:

  • SDK Google Mobile Ads versione 25.4.0.
  • SDK Google Mobile Ads Next-Gen versione 1.2.1.
  • SDK FiveAd versione 3.1.1.1.

Versione 3.1.1.0

  • Compatibilità verificata con l'SDK FiveAd versione 3.1.1.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.2.0.
  • SDK Google Mobile Ads Next-Gen versione 1.2.1.
  • Versione 3.1.1.0 dell'SDK FiveAd.

Versione 3.1.0.0

  • È stata aggiunta la proprietà per creare l'adattatore con la dipendenza dell'SDK GMA Next-Gen.
  • Compatibilità verificata con la versione 3.1.0.0 dell'SDK FiveAd.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 25.1.0.
  • SDK Google Mobile Ads Next-Gen versione 0.25.0-beta01.
  • FiveAd SDK versione 3.1.0.0.

Versione 3.0.1.2

Creata e testata con:

  • SDK Google Mobile Ads versione 25.1.0.
  • SDK FiveAd versione 3.0.1.2.

Versione 3.0.1.1

  • Le impressioni degli annunci nativi ora vengono sovrascritte dall'SDK FiveAd quando si utilizza l'SDK Google Mobile Ads v24.4.0 o versioni successive.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.9.0.
  • SDK FiveAd versione 3.0.1.1.

Versione 3.0.1.0

  • È stato aggiunto il supporto per l'inoltro del parametro tagForUnderAgeOfConsent dell'SDK Google Mobile Ads all'SDK FiveAd.
  • Compatibilità verificata con l'SDK FiveAd versione 3.0.1.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.9.0.
  • SDK FiveAd versione 3.0.1.0.

Versione 3.0.0.0

  • Compatibilità verificata con l'SDK FiveAd versione 3.0.0.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.9.0.
  • FiveAd SDK versione 3.0.0.0.

Versione 2.9.20251028.0

  • Compatibilità verificata con la versione 2.9.20251028 dell'SDK FiveAd.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.7.0.
  • FiveAd SDK versione 2.9.20251028.0

Versione 2.9.20250924.1

  • Rimossi i riferimenti a livello di classe a Context. Può aiutare a ridurre i problemi di perdita di memoria.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.7.0.
  • SDK FiveAd versione 2.9.20250924.1.

Versione 2.9.20250924.0

  • Compatibilità verificata con la versione 2.9.20250924 dell'SDK FiveAd.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.6.0.
  • FiveAd SDK versione 2.9.20250924.0

Versione 2.9.20250718.0

  • Compatibilità verificata con l'SDK FiveAd versione 2.9.20250718.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.3.0.
  • FiveAd SDK versione 2.9.20250718.0.

Versione 2.9.20250519.0

  • Compatibilità verificata con l'SDK FiveAd versione 2.9.20250519.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.3.0.
  • SDK FiveAd versione 2.9.20250519.0.

Versione 2.9.20250317.1

  • Corregge le dimensioni di caricamento dei banner per le offerte per gli annunci con la nuova API FiveAd

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 24.1.0.
  • SDK FiveAd versione 2.9.20250317.0

Versione 2.9.20250317.0

  • Compatibilità verificata con la versione 2.9.20250317 dell'SDK FiveAd.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.1.0.
  • SDK FiveAd versione 2.9.20250317.0

Versione 2.9.20250110.1

  • Il livello API Android minimo richiesto è stato aggiornato alla versione 23.
  • Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 24.0.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 24.0.0.
  • FiveAd SDK versione 2.9.20250110.0

Versione 2.9.20250110.0

  • Rimossa la classe UnifiedNativeAdMapper deprecata a favore di NativeAdMapper
  • È stato corretto il processo di raccolta degli indicatori.
  • È stato corretto il processo di inizializzazione per i formati degli annunci interstitial e con premio con struttura a cascata.
  • Compatibilità verificata con la versione 2.9.20250110 dell'SDK FiveAd.

Creata e testata con:

  • SDK Google Mobile Ads versione 23.6.0.
  • SDK FiveAd versione 2.9.20250110.0

Versione 2.9.20241129.0

  • Aggiunto il supporto per l'asta per i formati degli annunci banner, interstitial, con premio e nativi.
  • È stata verificata la compatibilità con la versione 2.9.20241129 dell'SDK FiveAd.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 23.5.0.
  • SDK FiveAd versione 2.9.20241129.0

Versione 2.8.20240827.0

  • Compatibilità verificata con la versione 2.8.20240827 dell'SDK FiveAd.

Creata e testata con:

  • SDK Google Mobile Ads versione 23.3.0.
  • SDK FiveAd versione 2.8.20240827.0

Versione 2.8.20240808.0

  • Compatibilità verificata con la versione 2.8.20240808 dell'SDK FiveAd.

Creata e testata con:

  • SDK Google Mobile Ads versione 23.2.0.
  • SDK FiveAd versione 2.8.20240808.0

Versione 2.8.20240722.0

  • Compatibilità verificata con la versione 2.8.20240722 dell'SDK FiveAd.

Creata e testata con:

  • SDK Google Mobile Ads versione 23.2.0.
  • FiveAd SDK versione 2.8.20240722.0

Versione 2.7.20240515.0

  • Compatibilità verificata con l'SDK FiveAd versione 2.7.20240515.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 23.1.0.
  • Versione 2.7.20240515.0 dell'SDK FiveAd

Versione 2.7.20240214.1

  • È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 23.0.0.
  • Compatibilità verificata con l'SDK FiveAd versione 2.7.20240214.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 23.0.0.
  • SDK FiveAd versione 2.7.20240214.0.

Versione 2.7.20240214.0

  • Compatibilità verificata con l'SDK FiveAd versione 2.7.20240214.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 22.6.0.
  • SDK FiveAd versione 2.7.20240214.0.

Versione 2.7.20240126.0

  • È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240126.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 22.6.0.
  • SDK FiveAd versione 2.7.20240126.0.

Versione 2.7.20240112.0

  • Rimosso FiveAdViewEventListener deprecato a favore di FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener e FiveAdNativeEventListener.
  • Compatibilità verificata con la versione 2.7.20240112 dell'SDK FiveAd.
  • Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 22.6.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 22.6.0.
  • FiveAd SDK versione 2.7.20240112.

Versione 2.6.20230607.1

  • È stata aggiunta la classe LineExtras per consentire ai publisher di definire le impostazioni audio predefinite per i formati degli annunci banner, interstitial e con premio.
  • È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 22.4.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 22.4.0.
  • Versione 2.6.20230607 dell'SDK FiveAd.

Versione 2.6.20230607.0

  • Release iniziale.
  • Aggiunge il supporto per i formati degli annunci banner, interstitial, con premio e nativi.
  • Compatibilità verificata con la versione 2.6.20230607 dell'SDK FiveAd.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 22.1.0.
  • SDK FiveAd versione 2.6.20230607.