Integrare la Rete di annunci LINE con la mediazione (beta)

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Line utilizzando la mediazione AdMob, che copre le integrazioni con la struttura a cascata. Descrive come aggiungere Line alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di Line in un'app per Android.

L'interfaccia della dashboard per la Rete di annunci LINE utilizza il testo giapponese per etichette, pulsanti e descrizioni. Gli screenshot di questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, le etichette e i pulsanti sono tradotti con i relativi equivalenti in inglese tra parentesi.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per la Rete pubblicitaria LINE offre le seguenti funzionalità:

Requisiti

• Android API 21 o versioni successive

• SDK Google Mobile Ads più recente

• Completare la mediazione Guida introduttiva

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

Devi aggiungere la Rete di annunci LINE alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai a Aggiungere la Rete di annunci 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à di destinazione. Imposta quindi 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à pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungere la Rete di annunci LINE come origine annuncio

Offerte

Nella scheda Asta della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona Rete di annunci LINE.
Fai clic su Come firmare un contratto di partnership e configura una partnership per l'asta con la Rete pubblicitaria LINE.
Fai clic su Acconsento e accetto e poi su Continua.
Se hai già una mappatura per la Rete di annunci LINE, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Inserisci quindi Application ID e Slot ID ottenuti nella sezione precedente. Poi fai clic su Fine.

Cascata

Nella scheda Struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona Rete di annunci LINE.

Seleziona LINE Ads Network. Poi inserisci un valore eCPM per la Rete di annunci LINE e fai clic su Continua.



Se hai già una mappatura per la Rete di annunci LINE, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Inserisci quindi Application ID e Slot ID ottenuti nella sezione precedente. Poi fai clic su Fine.

Passaggio 3: importa l'SDK e l'adattatore della Rete pubblicitaria LINE

Integrazione di Android Studio (consigliata)

Nel file build.gradle.kts a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione. Utilizza le versioni più recenti dell'SDK e dell'adattatore della Rete pubblicitaria LINE:

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

Integrazione manuale

1. Scarica la versione più recente del file .aar dell'SDK della Rete pubblicitaria LINE e aggiungilo al tuo progetto.

2. Vai agli elementi dell'adattatore della Rete di annunci LINE nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore di rete LINE Ads e aggiungilo al progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario codice aggiuntivo per l'integrazione della Rete di annunci LINE.

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

L'adattatore della Rete di annunci LINE supporta un parametro di richiesta aggiuntivo che può essere passato all'adattatore utilizzando la classe LineExtras. Questo costruttore di classi include i seguenti parametri:

enableAdSound

Un boolean per specificare lo stato di inizio predefinito dell'audio per gli annunci banner, interstitial e con premio.

Di seguito è riportato un esempio di codice per creare una richiesta di annuncio che imposta questi parametri:

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

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

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

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

Utilizzare gli annunci nativi

Visualizzazione dell'annuncio

L'adattatore della Rete pubblicitaria LINE compila le seguenti descrizioni dei campi avanzati degli annunci nativi per un NativeAd.

¹ Per gli annunci nativi, l'SDK della Rete pubblicitaria LINE non fornisce un asset icona dell'app. L'adattatore della Rete di annunci LINE compila l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio dalla Rete pubblicitaria LINE, puoi controllare l'errore di fondo della risposta all'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

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

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore della Rete pubblicitaria LINE quando non riesce a caricare un annuncio:

Log delle modifiche dell'adattatore di mediazione Android di LINE

Versione successiva

• È stata corretta la procedura di raccolta degli indicatori.

Versione 2.9.20241129.0

• È stato aggiunto il supporto per le offerte per i formati degli annunci banner, interstitial, con premio e nativi.
• Compatibilità verificata con la versione 2.9.20241129.0 dell'SDK FiveAd

Creato e testato con:

• SDK Google Mobile Ads versione 23.5.0.
• FiveAd SDK versione 2.9.20241129.0

Versione 2.8.20240827.0

• Compatibilità verificata con la versione 2.8.20240827.0 dell'SDK FiveAd

Creato e testato con:

• SDK Google Mobile Ads versione 23.3.0.
• FiveAd SDK versione 2.8.20240827.0

Versione 2.8.20240808.0

• Compatibilità verificata con la versione 2.8.20240808.0 dell'SDK FiveAd

Creato e testato con:

• SDK Google Mobile Ads versione 23.2.0.
• FiveAd SDK versione 2.8.20240808.0

Versione 2.8.20240722.0

• Compatibilità verificata con la versione 2.8.20240722.0 dell'SDK FiveAd

Creato e testato con:

• SDK Google Mobile Ads versione 23.2.0.
• FiveAd SDK versione 2.8.20240722.0

Versione 2.7.20240515.0

• Compatibilità verificata con la versione 2.7.20240515.0 dell'SDK FiveAd

Creato e testato con:

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

Versione 2.7.20240214.1

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 23.0.0.
• Compatibilità verificata con la versione 2.7.20240214.0 dell'SDK FiveAd.

Creato e testato con:

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

Versione 2.7.20240214.0

• Compatibilità verificata con la versione 2.7.20240214.0 dell'SDK FiveAd.

Creato e testato con:

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

Versione 2.7.20240126.0

• Compatibilità verificata con la versione 2.7.20240126.0 dell'SDK FiveAd.

Creato e testato con:

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

Versione 2.7.20240112.0

• FiveAdViewEventListener deprecato rimosso in favore di FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener e FiveAdNativeEventListener.
• Compatibilità verificata con la versione 2.7.20240112 dell'SDK FiveAd.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.6.0.

Creato e testato con:

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

Versione 2.6.20230607.1

• È stata aggiunta la classe LineExtras per consentire ai publisher di definire le impostazioni audio predefinite per i formati di annunci banner, interstitial e con premio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.4.0.

Creato e testato con:

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

Versione 2.6.20230607.0

• Lancio iniziale.
• Aggiunge il supporto per i formati degli annunci banner, interstitial, con premio e nativi.
• Compatibilità verificata con la versione 2.6.20230607 dell'SDK FiveAd.

Creato e testato con:

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