Integrare LY Ads Network 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 mostrare gli annunci di LY Ads Network utilizzando la mediazione, incluse le integrazioni a cascata. Descrive 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 Flutter.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Più recente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 o versioni successive
  • Per il deployment su Android
    • Livello API Android 23 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, consulta Configurare Google Mobile Ads Flutter Plugin.
  • Configura la mediazione AdMob.

Passaggio 1: configura le impostazioni nell'UI di LY Ads Network

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 uno slot annuncio

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

Aggiungi spazio

Compila il modulo con i dettagli dello slot. Per Tipo di offerte, seleziona Standard per configurare questo slot per la mediazione a cascata o Offerte SDK Google per configurare questo slot per le offerte. Una volta compilato il modulo, fai clic su Crea.

Aggiungi modulo per lo 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 molto tempo. Se hai domande, contatta il tuo rappresentante di LY Ads Network.

Richiedi una revisione

Crea una chiave API per i report

Vai alla scheda Gestione delle chiavi API per i report e fai clic sul pulsante Crea chiave API.

Scheda Chiave API di reporting

Compila il modulo e fai clic su Salva.

Modulo della chiave API di reporting

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

Modulo della chiave API di reporting

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (Venditori autorizzati per app) o app-ads.txt è un'iniziativa 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 di LY Ads Network nell'UI di AdMob

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

Integrazione tramite pub.dev

Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore LY Ads Network nel file pubspec.yaml del pacchetto:

dependencies:
  gma_mediation_line: ^2.1.0

Integrazione manuale

Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per LY Ads Network, estrai il file scaricato e aggiungi la cartella del plug-in estratta (e i relativi contenuti) al tuo progetto Flutter. Poi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

Passaggio 4: aggiungi il codice richiesto

Android

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

iOS

Integrazione di SKAdNetwork

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

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova da LY Ads Network, attiva il test di una singola origine annuncio in Strumento di controllo degli annunci utilizzando le origini annuncio LY Ads Network.

Passaggi facoltativi

Parametri specifici della rete

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

  • enableAdSound : specifica lo stato di avvio del suono 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:

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

Codici di errore

Se l'adattatore non riceve un annuncio da LY Ads Network, i publisher 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

Di seguito sono riportati 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 maggiori 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 Le dimensioni dell'annuncio richieste non corrispondono a una dimensione dell'annuncio banner supportata da 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 della mancanza di asset.

iOS

Codice di errore Dominio Motivo
1-10 Inviato dall'SDK LY Ads Network L'SDK LY Ads Network ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta la documentazione di LY Ads Network.
101 com.google.ads.mediation.line Parametri del server non validi (ad es. ID applicazione o ID slot mancante).
102 com.google.ads.mediation.line Le dimensioni dell'annuncio richieste non corrispondono a una dimensione dell'annuncio banner supportata da LY Ads Network.
103 com.google.ads.mediation.line Impossibile caricare un asset immagine dell'icona informativa nell'annuncio nativo.

Log delle modifiche dell'adattatore di mediazione Flutter Line

Versione 2.1.1 (in corso)

Versione 2.1.0

  • Versione minima di Flutter aggiornata alla 3.38.1
  • Aggiornamento per supportare la versione 8.0.0 del plug-in Flutter Google Mobile Ads
  • Supporta la versione 3.1.0.0 dell'adattatore Android Line.
  • Supporta la versione 3.0.1.0 dell'adattatore iOS Line.
  • Creato e testato con la versione 8.0.0 del plug-in Flutter Google Mobile Ads

Versione 2.0.0

  • Versione minima di Flutter aggiornata alla 3.35.1
  • Aggiornamento per supportare la versione 7.0.0 del plug-in Flutter Google Mobile Ads
  • Supporta la versione 3.0.1.0 dell'adattatore Android Line.
  • Supporta la versione 3.0.0.0 dell'adattatore iOS Line.
  • Creato e testato con la versione 7.0.0 del plug-in Flutter Google Mobile Ads

Versione 1.0.6

  • Supporta la versione 2.9.20251028.0 dell'adattatore Android Line.
  • Supporta la versione 2.9.20251119.0 dell'adattatore iOS Line.
  • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads

Versione 1.0.5

  • Supporta la versione 2.9.20250924.1 dell'adattatore Android Line.
  • Supporta la versione 2.9.20250930.0 dell'adattatore iOS Line.
  • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads

Versione 1.0.4

  • Supporta la versione 2.9.20250718.0 dell'adattatore Android Line.
  • Supporta la versione 2.9.20250512.0 dell'adattatore iOS Line.
  • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads

Versione 1.0.3

  • Supporta la versione 2.9.20250519.0 dell'adattatore Android Line.
  • Supporta la versione 2.9.20250512.0 dell'adattatore iOS Line.
  • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads

Versione 1.0.2

  • Supporta la versione 2.9.20250317.1 dell'adattatore Android Line.
  • Supporta la versione 2.9.20241106.3 dell'adattatore iOS Line.
  • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads

Versione 1.0.1

  • Supporta la versione 2.9.20250110.1 dell'adattatore Android Line.
  • Supporta la versione 2.9.20241106.2 dell'adattatore iOS Line.
  • Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.

Versione 1.0.0

  • Release iniziale.
  • Supporta la versione 2.9.20250110.0 dell'adattatore Android Line.
  • Supporta la versione 2.9.20241106.1 dell'adattatore iOS Line.
  • Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.