Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di i-mobile utilizzando Mediazione AdMob che copre le integrazioni a cascata. Spiega come aggiungere i-mobile al configurazione della mediazione e come integrare l'SDK e l'adattatore i-mobile in un' Android app.
L'interfaccia della dashboard per i-mobile utilizza il testo giapponese per etichette, pulsanti e descrizioni. Gli screenshot di questa guida non sono stati tradotto. 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 i-mobile ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
Requisiti
- Livello API Android 21 o superiore
SDK Google Mobile Ads più recente
Completare la mediazione Guida introduttiva
Passaggio 1: configura le impostazioni nell'interfaccia utente di i-mobile
Passaggio 2: configura la domanda di i-mobile nell' AdMob UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere i-mobile 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 i-mobile 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 i-mobile come origine annuncio
Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona i-mobile.
Seleziona i-mobile e attiva l'opzione Ottimizza. Inserisci quanto Login name and API Password ottenuto nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per i-mobile. Inserisci un valore eCPM peri-mobile e fai clic su Continua.Se hai già una mappatura per i-mobile, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' Publisher ID, Media ID and Spot ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Passaggio 3: importa l'SDK i-mobile e l'adattatore
Integrazione di Android Studio (consigliata)
Nel file settings.gradle.kts
a livello di progetto, aggiungi quanto segue
repository:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
Quindi, nel file build.gradle.kts
a livello di app, aggiungi quanto segue
delle dipendenze e configurazioni dell'implementazione. Utilizza le versioni più recenti
SDK e adattatore i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integrazione manuale
Scarica l'ultima versione di SDK i-mobile ed estrai
android-ad-sdk.aar
nella cartellasdk
e aggiungilo al tuo progetto.Vai agli elementi dell'adattatore i-mobile nel repository Maven di Google. Seleziona la versione più recente, scarica il file
.aar
dell'adattatore i-mobile e aggiungilo al progetto.
Passaggio 4: aggiungi il codice richiesto
Non è necessario alcun codice aggiuntivo per l'integrazione i-mobile.
Passaggio 5: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per AdMob i-mobile fornisce ID spot, ID media e ID publisher per i test. Puoi trovarli qui.
Verifica annunci di prova
Per verificare di ricevere annunci di prova dai-mobile, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le i-mobile (Waterfall) origini annuncio.
Passaggi facoltativi
Utilizzo degli annunci nativi
Rendering degli annunci
L'adattatore i-mobile compila i seguenti
campi
per un
NativeAd
.
Campo | Asset sempre inclusi dall'adattatore i-mobile |
---|---|
Titolo | |
Immagine | |
Corpo | |
Icona dell'app | 1 |
Call to action | |
Valutazione a stelle | |
Negozio | |
Prezzo |
1 Per gli annunci nativi, l'SDK i-mobile non fornisce un asset per l'icona dell'app. Invece, l'adattatore i-mobile compila l'icona dell'app con un'immagine trasparente.
Codici di errore
Se l'adattatore non riceve un annuncio da i-mobile,
i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
ResponseInfo.getAdapterResponses()
nelle seguenti classi:
Formato | Nome corso |
---|---|
Banner | com.google.ads.mediation.imobile.IMobileAdapter |
Interstitial | com.google.ads.mediation.imobile.IMobileAdapter |
Nativo | com.google.ads.mediation.imobile.IMobileMediationAdapter |
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore i-mobile. Quando un annuncio non viene caricato:
Codice di errore | Motivo |
---|---|
0-99 | L'SDK i-mobile ha restituito un errore. Vedi il codice per ulteriori dettagli. |
101 | i-mobile richiede un contesto Activity per caricare gli annunci. |
102 | I parametri del server i-mobile configurati nell' AdMob interfaccia utente mancano o non sono validi. |
103 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione banner supportata da i-mobile. |
104 | La callback di successo del carico degli annunci nativi di i-mobile ha restituito un elenco di annunci nativi vuoto. |
Log delle modifiche dell'adattatore di mediazione Android i-mobile
Versione 2.3.2.0
- Compatibilità verificata con l'SDK i-mobile v2.3.2.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- IMobile SDK versione 2.3.2.
Versione 2.3.1.2
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.0.0.
- Compatibilità verificata con l'SDK i-mobile v2.3.1.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- IMobile SDK versione 2.3.1.
Versione 2.3.1.1
- Adattatore aggiornato per utilizzare la nuova classe
VersionInfo
. - La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- IMobile SDK versione 2.3.1.
Versione 2.3.1.0
- Compatibilità verificata con l'SDK i-mobile v2.3.1.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.5.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- IMobile SDK versione 2.3.1.
Versione 2.3.0.0
- Compatibilità verificata con l'SDK i-mobile v2.3.0.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.3.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.3.0.
- IMobile SDK versione 2.3.0.
Versione 2.0.23.1
compileSdkVersion
etargetSdkVersion
aggiornati all'API 31.- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.
- Il livello API Android minimo richiesto è stato aggiornato a 19.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- IMobile SDK versione 2.0.23.
Versione 2.0.23.0
- Compatibilità verificata con l'SDK i-mobile v2.0.23.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.5.0.
Sviluppato e testato con
- SDK Google Mobile Ads versione 20.5.0.
- IMobile SDK versione 2.0.23.
Versione 2.0.22.2
- Sono stati aggiunti codici e messaggi di errore standardizzati per gli adattatori.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.1.0.
Sviluppato e testato con
- SDK Google Mobile Ads versione 20.1.0.
- Versione dell'SDK IMobile 2.0.22.
Versione 2.0.22.1
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.
Realizzato e testato con
- SDK Google Mobile Ads versione 20.0.0.
- IMobile SDK versione 2.0.22.
Versione 2.0.22.0
- Compatibilità verificata con l'SDK i-mobile v2.0.22.
- L'adattatore è stato aggiornato per supportare le richieste di banner adattivi in linea.
Sviluppato e testato con
- SDK Google Mobile Ads versione 19.1.0.
- IMobile SDK versione 2.0.22.
Versione 2.0.21.0
- Compatibilità verificata con l'SDK i-mobile v2.0.21.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.1.0.
- Aggiunto il supporto per il ridimensionamento degli annunci banner adattivi.
Sviluppato e testato con
- SDK Google Mobile Ads versione 19.1.0.
- IMobile SDK versione 2.0.21.
Versione 2.0.20.2
- È stato aggiunto il supporto per le dimensioni flessibili degli annunci banner.
- È stata aggiornata la versione minima dell'SDK Google Mobile Ads richiesta alla versione 18.3.0.
Sviluppato e testato con
- SDK Google Mobile Ads versione 18.3.0.
- IMobile SDK versione 2.0.20.
Versione 2.0.20.1
- L'adattatore ora restituisce proporzioni
mediaContent
diverse da zero.
Sviluppato e testato con
- SDK Google Mobile Ads versione 18.2.0.
- IMobile SDK versione 2.0.20.
Versione 2.0.20.0
- Versione iniziale
- Aggiunto il supporto per annunci banner, interstitial e nativi.