Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci della Rete pubblicitaria LINE utilizzando la mediazione, coprendo le integrazioni con la struttura a cascata. Descrive come aggiungere LINE Ads Network alla configurazione della 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 AdMob per la Rete pubblicitaria LINE offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | 1 |
Cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
1 L'integrazione delle offerte è in versione beta chiusa. Contatta il tuo account manager per richiedere l'accesso.
Requisiti
- SDK Google Mobile Ads più recente
- Flutter 3.7.0 o versioni successive
- Per eseguire il deployment su Android
- Android API 21 o versioni successive
- Per eseguire il deployment su iOS
- Target di deployment iOS 12.0 o versioni successive
- Un progetto Flutter funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
- Completa la guida introduttiva alla mediazione
Passaggio 1: configura le impostazioni nell'interfaccia utente della Rete di annunci LINE
Accedi al tuo account Rete di annunci LINE.
Aggiungere una nuova applicazione
Fai clic su 広告枠管理 (Gestione area annuncio) > メディア (Media). Poi, fai clic su 新規作成 (Crea nuova).
Compila il modulo e fai clic su 登録 (Registrati).
Prendi nota dell'ID applicazione.
Creare un posizionamento dell'annuncio
Fai clic sull'ID dell'applicazione a cui vuoi aggiungere un posizionamento dell'annuncio. Quindi, seleziona 詳細 (Dettagli).
Fai clic su スロット 追加 (Aggiungi area).
Compila il modulo e, al termine, fai clic su (登録) Registrati.
Prendi nota dell'ID slot.
Passaggio 2: configura la domanda della Rete di annunci LINE nell'interfaccia utente di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Per istruzioni, vedi il passaggio 2 della guida per Android.
Per istruzioni, vedi il passaggio 2 della guida per iOS.
Passaggio 3: importa l'SDK e l'adattatore della Rete pubblicitaria LINE
Integrazione tramite pub.dev
Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore della Rete pubblicitaria LINE nel file pubspec.yaml
del pacchetto:
dependencies:
gma_mediation_line: ^
Integrazione manuale
Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per la LINE Ads Network, estrai il file scaricato e aggiungi la cartella del plug-in estratta (e i relativi contenuti) al 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
Non è necessario codice aggiuntivo per l'integrazione della Rete di annunci LINE.
Integrazione di SKAdNetwork
Segui la documentazione della Rete di annunci LINE 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 AdMob.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova dalla Rete di annunci LINE, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Rete di annunci LINE (struttura a cascata).
Passaggi facoltativi
Parametri specifici della rete
Il plug-in di mediazione Flutter della Rete pubblicitaria LINE supporta il seguente
parametro di richiesta aggiuntivo che può essere passato all'adattatore tramite la
classe LineMediationExtras
:
-
enableAdSound
: specifica lo stato di avvio predefinito dell'audio 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 riesce a ricevere un annuncio dalla Rete pubblicitaria LINE,
i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando
ResponseInfo
nelle seguenti classi:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
GADMediationAdapterLine
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore della Rete pubblicitaria LINE quando non riesce a caricare un annuncio:
Codice di errore | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | L'SDK LINE Ads Network ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione della Rete di annunci LINE. |
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 di annunci LINE. |
104 | com.google.ads.mediation.line | Impossibile caricare un annuncio in-app o con premio a causa del contesto dell'attività mancante. |
105 | com.google.ads.mediation.line | L'SDK 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 di asset mancanti. |
Codice di errore | Dominio | Motivo |
---|---|---|
1-10 | Inviata dall'SDK LINE Ads Network | L'SDK LINE Ads Network ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione della Rete di annunci LINE. |
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 di annunci LINE. |
103 | com.google.ads.mediation.line | Impossibile caricare un asset immagine icona informativa nell'annuncio nativo. |
Log delle modifiche dell'adattatore di mediazione Flutter di Line
1.0.0
- Lancio iniziale.
- Supporta l'adattatore per Android di Line versione 2.9.20250110.0.
- Supporta la versione 2.9.20241106.1 dell'adattatore Line per iOS.
- Creato e testato con il plug-in Flutter di Google Mobile Ads versione 5.3.1.