Integrare Line con la mediazione (beta)

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci pubblicitari da Line usando mediazione, che riguardano le integrazioni a cascata. Spiega come aggiungere Line alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Line in un'app Android .

L'interfaccia della dashboard di Line utilizza il testo giapponese per le etichette, i pulsanti e le descrizioni. Gli screenshot in 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 Line offre le seguenti funzionalità:

Integrazione
Offerte
Cascata  1
Formati
Banner
Interstitial
Con premio
Nativo

1 L'integrazione con struttura a cascata è in versione beta chiusa. Contatta il tuo account manager per richiedere l'accesso.

Requisiti

  • Livello API Android 21 o superiore

  • Versione più recente dell'SDK Google Mobile Ads

  • Completare la mediazione Guida introduttiva

Passaggio 1: configura le impostazioni nell'interfaccia utente di Line

Accedi al tuo account 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, una volta terminato, fai clic su (Blog Trascina).

Prendi nota dell'ID slot.

Passaggio 2: configura la domanda pubblicitaria nell' Ad Manager UI

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

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 Line:

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

Integrazione manuale

  1. Scarica la versione più recente del .aar file dell'SDK Line e aggiungilo al progetto.

  2. Passa agli elementi dell'adattatore di linea sul Repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore di linea e aggiungilo al progetto.

Passaggio 4: aggiungi il codice richiesto

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

Passaggio 5: testa l'implementazione

Attiva gli 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.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da Line, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Line (a cascata).

Passaggi facoltativi

Parametri specifici della rete

L'adattatore 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:

Java 

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

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

Kotlin 

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

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

Utilizzare gli annunci nativi

Visualizzazione dell'annuncio

L'adattatore di linea compila i seguenti campi campi per un NativeAd.

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

1 Per gli annunci nativi, l'SDK Line non fornisce un asset per l'icona dell'app. L'adattatore a linee popola l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da 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 Line quando non riesce a caricare un annuncio:

Codice di errore Dominio Motivo
1-10 com.five_corp.ad Line SDK ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di 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 da Line.
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.

Log delle modifiche dell'adattatore di mediazione Android di LINE

Versione successiva

  • È stato implementato AdLoader per abilitare l'RTB per gli annunci banner.
  • È stato implementato AdLoader per abilitare l'RTB per gli annunci interstitial.
  • È stato implementato AdLoader per attivare la RTB per gli annunci con premio.
  • È stato implementato AdLoader per abilitare RTB per gli annunci nativi.

Versione 2.8.20240827.0

  • Compatibilità verificata con l'SDK FiveAd versione 2.8.20240827.0

Sviluppata e testata con:

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

Versione 2.8.20240808.0

  • Compatibilità verificata con l'SDK FiveAd versione 2.8.20240808.0

Sviluppata e testata con:

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

Versione 2.8.20240722.0

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

Sviluppato 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

Sviluppata e testata 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.
  • È 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.
  • FiveAd SDK versione 2.7.20240214.0.

Versione 2.7.20240214.0

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

Sviluppato e testato con:

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

Versione 2.7.20240126.0

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

Sviluppata e testata 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.
  • È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240112.
  • È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.6.0.

Sviluppata e testata 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 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.

Sviluppata e testata 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.
  • È stata verificata la compatibilità con l'SDK FiveAd versione 2.6.20230607.

Sviluppata e testata con:

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