Integrare Line con la mediazione (beta)

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da Line utilizzando Mediazione AdMob che copre le integrazioni a cascata. Descrive come aggiungere elementi pubblicitari al riquadro configurazione della mediazione e come integrare Line SDK e l'adattatore in un' Android app.

L'interfaccia della dashboard per le linee utilizza testo giapponese per le etichette, pulsanti e descrizioni. Gli screenshot di questa guida non sono stati tradotto in inglese. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, i pulsanti sono tradotti con gli equivalenti in lingua inglese tra parentesi.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per la linea ha le seguenti funzionalità:

Integrazione
Offerte
Cascata	^1
Formati
Banner
Interstitial
Con premio
Nativo

¹ L'integrazione della struttura a cascata è in versione beta aperta.

Requisiti

• Livello API Android 21 o superiore

• Versione più recente dell'SDK Google Mobile Ads

• Completare la mediazione Guida introduttiva

Passaggio 1: configura le configurazioni nella UI a linee

Accedi al tuo account Line.

Aggiungi una nuova applicazione

Fai clic su 広告枠管理 (Gestione aree annuncio) > デア (Media). Quindi, fai clic su Authenticator規作成 (Crea nuovo).

Compila il modulo e fai clic su Ұ (Registra).

Prendi nota dell'ID applicazione.

Crea un posizionamento dell'annuncio

Fai clic sull'ID dell'applicazione a cui vuoi aggiungere un posizionamento dell'annuncio. Poi, seleziona 詳細 (Dettaglio).

Fai clic su ytcット 追加 (Add Slot) (Aggiungi slot).

Compila il modulo e, una volta terminato, fai clic su (⤷Ұ) Registrati.

Nota: contatta il tuo account manager di rete Line Ads per avere accesso alla creazione di posizionamenti di annunci nativi nell'interfaccia utente di Line.

Prendi nota dell'ID area annuncio.

Passaggio 2: configura la domanda pubblicitaria nell' AdMob UI

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere Line alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi Line come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.

A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:

Aggiungi Line come origine annuncio

Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Line.

Seleziona Line. Inserisci un valore eCPM perLine e fai clic su Continua.

Nota: devi configurare l'ottimizzazione dell'origine annuncio solo una volta per ogni rete.

Se hai già una mappatura per Line, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Quindi, inserisci l' Application ID and Slot ID ottenuto nella sezione precedente. Poi, fai clic su Fine.

Importante: Application ID deve essere associato all'app scelta come target come nell'Line interfaccia utente.

Passaggio 3: importa l'SDK e l'adattatore Line

Nota: mancata integrazione dell'SDK Line e Google Mobile Ads compatibile potrebbero causare problemi di build.

Integrazione di Android Studio (consigliata)

Nel file build.gradle.kts a livello di app, aggiungi la seguente implementazione di dipendenze e configurazioni. Utilizza le versioni più recenti dell'SDK Line e l'adattatore:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:line:2.7.20240515.0")
}

Integrazione manuale

1. Scarica l'ultima versione di .aar dell'SDK Line e aggiungilo al tuo progetto.

2. Vai alla sezione Artefatti dell'adattatore di linea. sul Repository Maven di Google. Seleziona la versione più recente e scarica l'app del file .aar dell'adattatore e aggiungilo al tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione di Line.

Passaggio 5: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob

Segui le istruzioni riportate nella documentazione di Line su come attivare gli annunci di prova di Line.

Importante: disattiva la modalità di test per AdMob e Line prima di rilasciare l'app.

Verifica annunci di prova

Per verificare di ricevere annunci di prova daLine, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Line (Waterfall) origini annuncio.

Passaggi facoltativi

Parametri specifici della rete

L'adattatore di linea supporta un parametro di richiesta aggiuntivo che può essere passato all'adattatore usando la classe LineExtras. Questo costruttore della classe include i seguenti parametri:

enableAdSound

Un boolean per specificare lo stato predefinito di avvio dell'audio del banner, interstitial e con premio.

Di seguito è riportato un esempio di codice che mostra come creare una richiesta di annuncio che imposti questi parametri:

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

Richiesta di annuncio request = new Richiesta di annuncio.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

Kotlin

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = Richiesta di annuncio.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

Utilizzo degli annunci nativi

Rendering degli annunci

L'adattatore di linea compila i campi seguenti Descrizioni dei campi avanzati per gli annunci nativi per un NativeAd

Campo	Asset sempre inclusi dall'adattatore di rete
Titolo
Immagine
Corpo
Icona dell'app	^1
Call to action
Valutazione a stelle
Negozio
Prezzo

¹ Per gli annunci nativi, l'SDK Line non fornisce un asset per l'icona dell'app. L'adattatore di linea compila invece l'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riceve un annuncio da Line, puoi controllare un errore sottostante della risposta all'annuncio ResponseInfo.getAdapterResponses() nelle seguenti classi:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore di linea quando un annuncio non viene caricato:

Codice di errore	Dominio	Motivo
1-10	com.five_corp.ad	Line SDK ha restituito un errore specifico dell'SDK. Consulta Documentazione di Line per ulteriori dettagli.
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 linea.
104	com.google.ads.mediation.line	Impossibile caricare un annuncio interstitial o con premio a causa di un contesto dell'attività mancante.
105	com.google.ads.mediation.line	L'SDK Line 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.
1-10	Inviato da Line SDK	Line SDK ha restituito un errore specifico dell'SDK. Consulta Documentazione di Line per ulteriori dettagli.
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 linea.
103	com.google.ads.mediation.line	Impossibile caricare un asset immagine per l'icona delle informazioni nell'annuncio nativo.

Log delle modifiche dell'adattatore di mediazione Android LINE

Versione 2.7.20240515.0

• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.1.0.
• Compatibilità verificata con l'SDK FiveAd versione 2.7.20240515.0

Sviluppato e testato con:

• SDK Google Mobile Ads versione 23.1.0.
• SDK FiveAd versione 2.7.20240515.0

Versione 2.7.20240214.1

• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.0.0.
• È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240214.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 23.0.0.
• SDK FiveAd versione 2.7.20240214.0.

Versione 2.7.20240214.0

• È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240214.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 22.6.0.
• SDK FiveAd versione 2.7.20240214.0.

Versione 2.7.20240126.0

• È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240126.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 22.6.0.
• SDK FiveAd versione 2.7.20240126.0.

Versione 2.7.20240112.0

• Rimozione di FiveAdViewEventListener deprecata a favore di FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener FiveAdInterstitialEventListener e FiveAdNativeEventListener.
• È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240112.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.6.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 22.6.0.
• SDK FiveAd versione 2.7.20240112.

Versione 2.6.20230607.1

• È stata aggiunta la classe LineExtras per consentire agli editori di definire le impostazioni audio predefinite per banner, interstitial e con premio.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 22.4.0.
• SDK FiveAd versione 2.6.20230607.

Versione 2.6.20230607.0

• Rilascio iniziale.
• Aggiunge il supporto per i formati di annunci banner, interstitial, con premio e nativi.
• È stata verificata la compatibilità con l'SDK FiveAd versione 2.6.20230607.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 22.1.0.
• SDK FiveAd versione 2.6.20230607.