Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da Line utilizzando la mediazione, per coprire le integrazioni con struttura a cascata. Viene spiegato come aggiungere una riga alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK Line in un' Android app.
L'interfaccia della dashboard per Line utilizza testo in giapponese per etichette, pulsanti e 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 lingua inglese tra parentesi.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per la linea ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Struttura a cascata | 1 |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
1 L'integrazione con struttura a cascata è in versione beta aperta.
Requisiti
- Livello API Android 19 o superiore
Versione più recente dell'SDK Google Mobile Ads
Completa la mediazione Guida introduttiva
Passaggio 1: imposta le configurazioni nell'interfaccia utente a riga
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.
Prendi nota dell'ID area annuncio.
Passaggio 2: configura la domanda pubblicitaria nella 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.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.
Passaggio 3: importa l'SDK Line e l'adattatore
Integrazione con 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 Line:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:line:2.7.20240214.0")
}
Integrazione manuale
Scarica la versione più recente del file
.aar
dell'SDK Line e aggiungila al tuo progetto.Vai agli Elementi dell'adattatore a riga nel repository Maven di Google. Seleziona la versione più recente, scarica il file
.aar
dell'adattatore di riga e aggiungilo al tuo progetto.
Passaggio 4: aggiungi il codice richiesto
Non è necessario codice aggiuntivo per l'integrazione della linea.
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.
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 riga supporta un parametro di richiesta aggiuntivo che può essere trasmesso all'adattatore utilizzando la classe LineExtras
. Questo costruttore di classe include
i seguenti parametri:
enableAdSound
- Un
boolean
per specificare lo stato di inizio dell'audio predefinito degli annunci banner, interstitial e con premio.
Di seguito è riportato un esempio di codice di 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 dell'annuncio
L'adattatore di riga compila i seguenti
Descrizioni dei campi degli annunci nativi avanzati
di
NativeAd
.
Campo | Asset sempre inclusi dall'adattatore pubblicitario |
---|---|
Titolo | |
Immagine | |
Body | |
Icona dell'app | 1 |
Call to action | |
Star rating | |
Archiviazione | |
Prezzo |
1 Per gli annunci nativi, l'SDK Line non fornisce un asset icona dell'app. che compila l'icona dell'app con un'immagine trasparente.
Codici di errore
Se l'adattatore non riceve un annuncio da Line, puoi controllare l'errore sottostante dalla risposta dell'annuncio utilizzando
ResponseInfo.getAdapterResponse()
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 riga quando non viene caricato un annuncio:
Codice di errore | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | L'SDK a riga ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di Line. |
101 | com.google.ads.mediation.line | ID richiesta mancante o non valido. |
102 | com.google.ads.mediation.line | ID area 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 riga. |
104 | com.google.ads.mediation.line | Impossibile caricare un annuncio interstitial o con premio a causa di un contesto di attività mancante. |
105 | com.google.ads.mediation.line | L'SDK riga 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 | L'SDK a riga ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di Line. |
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 dalla riga. |
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.20240214.0
- Compatibilità verificata con l'SDK FiveAd versione 2.7.20240214.0.
Realizzato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK FiveAd versione 2.7.20240214.0.
Versione 2.7.20240126.0
- Compatibilità verificata con l'SDK FiveAd versione 2.7.20240126.0.
Realizzato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK FiveAd versione 2.7.20240126.0.
Versione 2.7.20240112.0
- Rimosso
FiveAdViewEventListener
deprecato a favore diFiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
eFiveAdNativeEventListener
. - Compatibilità verificata con l'SDK FiveAd versione 2.7.20240112.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.6.0.
Realizzato 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 ai publisher di definire le impostazioni audio predefinite per i formati degli annunci banner, interstitial e con premio. - La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.
Realizzato e testato con:
- SDK Google Mobile Ads versione 22.4.0.
- SDK FiveAd versione 2.6.20230607.
Versione 2.6.20230607.0
- Release iniziale.
- Aggiunge il supporto per i formati di annunci banner, interstitial, con premio e nativi.
- Compatibilità verificata con l'SDK FiveAd versione 2.6.20230607.
Realizzato e testato con:
- SDK Google Mobile Ads versione 22.1.0.
- SDK FiveAd versione 2.6.20230607.