Integrare LY Ads Network con la mediazione

Seleziona la piattaforma: Android Android iOS Unity Flutter

Questa guida mostra come utilizzare Google Mobile Ads SDK per caricare e visualizzare gli annunci della rete LY Ads utilizzando la mediazione AdMob, 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 di LY Ads Network in un'app per Android.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per LY Ads Network offre le seguenti funzionalità:

Requisiti

• Livello API Android 23 o versioni successive

• Le ultime novità di Google Mobile Ads SDK

• Completa la guida introduttiva alla mediazione.

Passaggio 1: configura le configurazioni nell'interfaccia utente della rete LY Ads

Registrati e accedi al tuo account LY Ads Network.

Aggiungere 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.

Creare un'area annunci

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

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. Una volta compilato il modulo, fai clic su Crea.

Prendi nota dell'ID slot.

Dopo aver creato il primo slot, fai clic su Rivedi nella pagina dei dettagli dell'app per ottenere l'approvazione dalla rete LY Ads. Questa operazione potrebbe richiedere del tempo. Contatta il tuo rappresentante di LY Ads Network in caso di domande.

Creare 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 segreto della chiave API.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (Venditori autorizzati per app) app-ads.txt è un'iniziativa di IAB Tech Lab che garantisce la vendita dell'inventario pubblicitario della tua app solo in canali che hai indicato come autorizzati. Per evitare una riduzione 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 LY Ads nell'interfaccia utente di AdMob

Configurare 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 un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai alla sezione Aggiungere LY Ads Network come origine annuncio.

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

Inserisci il formato e la piattaforma dell'annuncio, 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ù delle tue 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:

Aggiungere LY Ads Network come origine annuncio

Offerte

Nella scheda Offerte della sezione Origini annuncio, 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 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. Poi fai clic su Fine.

Cascata

Nella scheda 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 annuncio per LY Ads Network. Poi inserisci un valore eCPM per la rete pubblicitaria LY e fai clic su Continua.




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. Poi fai clic su Fine.

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

Integrazione di Android Studio (consigliata)

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

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

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

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 LY Ads Network nel repository Maven di Google. Seleziona l'ultima versione, scarica il file .aar dell'adattatore di LY Ads Network e aggiungilo al 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 AdMob.

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

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova dalla rete LY Ads, attiva i 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

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

enableAdSound

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

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

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

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

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 LY Ads Network compila le seguenti Descrizioni dei campi avanzati degli annunci nativi per un NativeAd.

¹ Per gli annunci nativi, l'SDK LY Ads Network non fornisce un asset icona dell'app. L'adattatore LY Ads Network compila l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riceve un annuncio dalla rete LY Ads, puoi controllare l'errore sottostante nella risposta dell'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

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

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

Log delle modifiche dell'adattatore di mediazione LINE per Android

Versione successiva

• Maps AgeRestrictedTreatment all'API ChildDirectedTreatment di Line.

Versione 3.1.1.0 (in corso)

Versione 3.1.0.0

• È stata aggiunta una 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.

Creato e testato con:

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

Versione 3.0.1.2

Creato e testato con:

• SDK Google Mobile Ads versione 25.1.0.
• FiveAd SDK 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 versione 24.4.0 o successive.

Creato e testato con:

• SDK Google Mobile Ads versione 24.9.0.
• FiveAd SDK 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 la versione 3.0.1.0 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 24.9.0.
• Versione 3.0.1.0 dell'SDK FiveAd.

Versione 3.0.0.0

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

Creato 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.

Creato e testato con:

• SDK Google Mobile Ads versione 24.7.0.
• Versione 2.9.20251028.0 dell'SDK FiveAd

Versione 2.9.20250924.1

• Rimossi i riferimenti a Contesto a livello di classe. Può contribuire a ridurre i problemi di perdita di memoria.

Creato e testato con:

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

Versione 2.9.20250924.0

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

Creato 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 la versione 2.9.20250718 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 24.3.0.
• Versione 2.9.20250718.0 dell'SDK FiveAd.

Versione 2.9.20250519.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 24.3.0.
• Versione 2.9.20250519.0 dell'SDK FiveAd.

Versione 2.9.20250317.1

• Corregge le dimensioni di caricamento dei banner per le aste degli annunci con la nuova API FiveAd

Creato e testato con:

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

Versione 2.9.20250317.0

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

Creato e testato con:

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

Versione 2.9.20250110.1

• È stato aggiornato il livello API Android minimo richiesto a 23.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 24.0.0.

Creato e testato 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 a cascata.
• Compatibilità verificata con la versione 2.9.20250110 dell'SDK FiveAd.

Creato e testato con:

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

Versione 2.9.20241129.0

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

Creato e testato con:

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

Versione 2.8.20240827.0

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

Creato e testato con:

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

Versione 2.8.20240808.0

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

Creato e testato con:

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

Versione 2.8.20240722.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 23.2.0.
• Versione 2.8.20240722.0 dell'SDK FiveAd

Versione 2.7.20240515.0

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

Creato 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 la versione 2.7.20240214 dell'SDK FiveAd.

Creato e testato con:

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

Versione 2.7.20240214.0

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

Creato e testato con:

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

Versione 2.7.20240126.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 22.6.0.
• Versione 2.7.20240126.0 dell'SDK FiveAd.

Versione 2.7.20240112.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 22.6.0.
• Versione 2.7.20240112 dell'SDK FiveAd.

Versione 2.6.20230607.1

• È stata aggiunta la classe LineExtras per consentire agli editori 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.

Creato 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.

Creato e testato con:

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