Integrare LY Ads Network con la mediazione

Seleziona la piattaforma: Android Nuovo Android iOS Unity Flutter

Questa guida mostra come utilizzare Google Mobile Ads Flutter 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 Flutter.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Le ultime novità di 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.3 o versioni successive
  • Un progetto Flutter funzionante configurato con Google Mobile Ads Flutter Plugin. Per maggiori dettagli, consulta Configurare Google Mobile Ads Flutter Plugin.
  • Configurare la 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.

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

Creare un'area annunci

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

Aggiungi spazio

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.

Aggiungi modulo per gli slot

Prendi nota dell'ID slot.

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

Richiedi una revisione

Creare 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 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) 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, 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 LY Ads nell'interfaccia utente di Ad Manager

Configurare 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 della rete LY Ads

Integrazione tramite pub.dev

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

dependencies:
  gma_mediation_line: ^2.1.0

Integrazione manuale

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per LY Ads Network, estrai il file scaricato e aggiungi la cartella del plug-in estratto (e i relativi contenuti) al tuo progetto Flutter. Quindi, 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

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

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

  • enableAdSound : specifica lo stato di avvio dell'audio predefinito di banner, interstitial e annunci 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 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 restituiti 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 del contesto dell'attività mancante.
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.

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 ulteriori 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 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 icona informativa nell'annuncio nativo.

Log delle modifiche dell'adattatore di mediazione Line Flutter

Versione 2.1.1 (in corso)

Versione 2.1.0

Versione 2.0.0

Versione 1.0.6

Versione 1.0.5

Versione 1.0.4

Versione 1.0.3

Versione 1.0.2

Versione 1.0.1

Versione 1.0.0