Integrare la Rete di annunci LINE con la mediazione

Questa guida mostra come utilizzare Google Mobile Ads Flutter Plugin per caricare e mostrare gli annunci di LINE Ads Network utilizzando la mediazione, incluse le integrazioni a cascata. Descrive come aggiungere LINE Ads Network alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di LINE Ads Network in un'app Flutter.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione di Ad Manager per LINE Ads Network ha le seguenti funzionalità:

Integrazione
Asta
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.
  • Configurare la mediazione.

Passaggio 1: configura le impostazioni nell'interfaccia utente di LINE Ads Network

Registrati e accedi al tuo account LINE 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 登録 (Registrati).

Nuovo modulo di registrazione

Prendi nota dell'アプリID (ID app).

Android

Dettagli registrazione

iOS

Dettagli registrazione

Crea un'area annuncio

Nella scheda アプリ (App), seleziona l'app per visualizzarne i dettagli. Nella sezione スロット (Area annuncio), fai clic su 追加 (Aggiungi).

Aggiungi spazio

Compila il modulo con i dettagli dello slot. Per Bidding Type (Tipo di offerta), seleziona Standard per configurare questa area annuncio per la mediazione a cascata o Google SDK Bidding per configurarla per le offerte. Una volta compilato il modulo, fai clic su 作成 (Crea).

Aggiungi modulo per lo slot

Prendi nota dell'スロットID (ID area annuncio).

Dettagli slot

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (Venditori autorizzati per app) 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, crea un file app-ads.txt per Ad Manager.

Per implementare app-ads.txt per LINE Ads Network, consulta la pagina Informazioni su app-ads.txt.

Passaggio 2: configura la domanda di LINE Ads Network nell'interfaccia utente di Ad Manager

Configura le impostazioni di mediazione per l'unità pubblicitaria

Android

Per le istruzioni, consulta il passaggio 2 della guida per Android.

iOS

Per le istruzioni, consulta il passaggio 2 della guida per iOS.

Passaggio 3: importa l'SDK e l'adattatore di LINE Ads Network

Integrazione tramite pub.dev

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

dependencies:
  gma_mediation_line: ^2.0.0

Integrazione manuale

Scarica la versione più recente del plug-in di mediazione di Google Mobile Ads per LINE 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 aggiungere altro codice per l'integrazione di LINE Ads Network.

iOS

Integrazione di SKAdNetwork

Segui la documentazione di LINE 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 tuo dispositivo di test per Ad Manager.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova da LINE Ads Network, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio LINE Ads Network (Cascata).

Passaggi facoltativi

Parametri specifici della rete

Il plug-in di mediazione Flutter di LINE 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 audio predefinito degli annunci banner, interstitial e con premio.

Di seguito è riportato un esempio di codice di come 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 LINE 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 di LINE Ads Network quando un annuncio non viene caricato:

Android

Codice di errore Dominio Motivo
1-10 com.five_corp.ad L'SDK di LINE Ads Network ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta la documentazione di LINE Ads Network.
101 com.google.ads.mediation.line ID applicazione mancante o non valido.
102 com.google.ads.mediation.line ID area annuncio mancante o non valido.
103 com.google.ads.mediation.line La dimensione dell'annuncio richiesta non corrisponde a una dimensione dell'annuncio banner supportata da LINE 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 di LINE 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 di LINE Ads Network L'SDK di LINE Ads Network ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta la documentazione di LINE Ads Network.
101 com.google.ads.mediation.line Parametri del server non validi (ad es. ID applicazione o ID area annuncio mancante).
102 com.google.ads.mediation.line La dimensione dell'annuncio richiesta non corrisponde a una dimensione dell'annuncio banner supportata da LINE Ads Network.
103 com.google.ads.mediation.line Impossibile caricare una risorsa immagine dell'icona informativa nell'annuncio nativo.

Log delle modifiche dell'adattatore di mediazione Flutter di LINE

Versione 2.0.2 (in corso)

Versione 2.0.1 (in corso)

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 di LINE.
  • Supporta la versione 3.0.0.0 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20251119.0 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20250930.0 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20250512.0 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20250512.0 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20241106.3 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20241106.2 dell'adattatore iOS di 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 di LINE.
  • Supporta la versione 2.9.20241106.1 dell'adattatore iOS di LINE.
  • Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.