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).
Compila il modulo e fai clic su 登録 (Registrati).
Prendi nota dell'アプリID (ID app).
Android
iOS
Crea un'area annuncio
Nella scheda アプリ (App), seleziona l'app per visualizzarne i dettagli. Nella sezione スロット (Area annuncio), fai clic su 追加 (Aggiungi).
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).
Prendi nota dell'スロットID (ID area annuncio).
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.