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 annunci dalla rete pubblicitaria LY Ads Network utilizzando la Mediazione AdMob, che copre le integrazioni con la struttura a cascata. Viene spiegato come aggiungere LY Ads Network alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di 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.

• Ultima versione di Google Mobile Ads SDK (Legacy).

• Configura Mediazione AdMob.

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.

Compila il modulo e fai clic su Registrazione.

Prendi nota dell'ID app.

Crea un'area annuncio

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

Compila il modulo per i dettagli sullo slot. In Tipo di asta, seleziona Standard per configurare questo slot per la mediazione a cascata o Google SDK Bidding per configurare questo slot per l'asta. Fai clic su Crea dopo aver compilato il modulo.

Nota: il formato pubblicitario e il tipo di asta non possono essere modificati dopo la registrazione dell'area annuncio. Contatta il tuo account manager LY Ads Network per ottenere l'accesso e creare posizionamenti degli annunci nativi nell'interfaccia utente di LY Ads Network.

Prendi nota dell'ID 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.

Crea una chiave API di reporting

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

Compila il modulo e fai clic su Salva.

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

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

Passaggio 2: configura la domanda della rete pubblicitaria LY nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere LY Ads Network alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente ad Aggiungi LY Ads Network come rete pubblicitaria.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Successivamente, imposta lo stato del gruppo di mediazione su Attivato e poi fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie che hai selezionato:

Aggiungi LY Ads Network come rete pubblicitaria

Offerte

Nella sezione Origini annuncio, individua la scheda Asta e seleziona Aggiungi origine annuncio. Poi seleziona LY Ads Network .

Fai clic su Come firmare un contratto di partnership e configura una partnership per l'asta con LY Ads Network.



Fai clic su Conferma e accetta, poi su Continua.



Se hai già una mappatura per LY Rete pubblicitaria, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci l'ID applicazione e l'ID slot ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

Importante: l'ID applicazione deve essere associato all'app target come nell'interfaccia utente di LY rete pubblicitaria.

Cascata

Nella scheda A cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.

Seleziona LY Ads Network e attiva l'opzione Ottimizza. Inserisci l'ID chiave API e il secret della chiave API ottenuti nella sezione precedente per configurare l'ottimizzazione dell'origine dati per LY Ads Network. Poi inserisci un valore eCPM per LY Ads Network e fai clic su Continua.

Nota: devi configurare l'ottimizzazione dell'origine annuncio una sola volta per rete.

Se hai già una mappatura per LY Ads Network, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci l' ID applicazione e l'ID slot ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

Importante: l'ID applicazione deve essere associato all'app target come nell'interfaccia utente di LY Ads Network.

Nota: l'ottimizzazione delle origini annuncio richiede alcuni giorni per raccogliere dati sufficienti per calcolare con precisione l'eCPM per una rete di mediazione. Nel frattempo, lo stato di ottimizzazione dell'origine annuncio è PENDING, quindi devi impostare manualmente un valore eCPM per la rete. Una volta calcolato l'eCPM, l'origine annuncio inizia automaticamente ad aggiornarlo per tuo conto.

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

Nota: la mancata integrazione delle versioni compatibili di LY Ads Network e Google Mobile Ads SDK (Legacy) potrebbe causare problemi di build.

Integrazione di Android Studio (consigliata)

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 rete LY Ads e aggiungilo al progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione di LY Ads Network.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob.

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 inoltrati correttamente all'SDK della rete pubblicitaria LY Ads.

Java

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

Kotlin

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Importante: disattiva la modalità di test per AdMob e LY Ads Network prima di rilasciare l'app.

Verifica gli annunci di prova

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 degli 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();
LineMediationSnippets.java

Kotlin

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

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

Utilizzo degli annunci nativi

Rendering degli annunci

L'adattatore della rete pubblicitaria LY Ads compila le seguenti descrizioni dei campi degli annunci nativi avanzati 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

¹ Per gli annunci nativi, l'SDK della rete pubblicitaria LY non fornisce un asset icona dell'app. Invece, l'adattatore della rete pubblicitaria LY compila l'icona dell'app con un'immagine trasparente.

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 non è possibile caricare un annuncio:

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 annuncio interstitial o 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).

Sviluppato e testato 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

• Viene mappato a AgeRestrictedTreatment nell'API ChildDirectedTreatment di Line.

Sviluppato e testato 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.
• SDK FiveAd versione 3.1.1.0.

Versione 3.1.0.0

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

Sviluppato e testato con:

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

Versione 3.0.1.2

Sviluppato e testato 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 vengono ora sovrascritte dall'SDK FiveAd quando utilizzi 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.

Sviluppato e testato 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.
• SDK FiveAd versione 3.0.0.0.

Versione 2.9.20251028.0

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 24.7.0.
• SDK FiveAd 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 l'SDK FiveAd versione 2.9.20250924.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 24.6.0.
• SDK FiveAd 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.
• SDK FiveAd versione 2.9.20250718.0.

Versione 2.9.20250519.0

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

Sviluppato e testato 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 gli annunci per l'asta 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 l'SDK FiveAd versione 2.9.20250317.

Sviluppato e testato 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.

Sviluppato e testato con:

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

Versione 2.9.20250110.0

• Rimossa la classe UnifiedNativeAdMapper deprecata a favore di NativeAdMapper
• Risolto il problema relativo alla procedura 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 l'SDK FiveAd versione 2.9.20250110.

Sviluppato e testato 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.
• Compatibilità verificata con l'SDK FiveAd versione 2.9.20241129.

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 l'SDK FiveAd versione 2.8.20240827.

Sviluppato e testato con:

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

Versione 2.8.20240808.0

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

Sviluppato e testato con:

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

Versione 2.8.20240722.0

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

Sviluppato e testato 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.
• SDK FiveAd versione 2.7.20240515.0

Versione 2.7.20240214.1

• 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 l'SDK FiveAd versione 2.7.20240112.
• 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.
• SDK FiveAd 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.
• Aggiornamento della versione minima richiesta dell'SDK Google Mobile Ads alla 22.4.0.

Sviluppato e testato con:

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

Versione 2.6.20230607.0

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

Sviluppato e testato con:

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