Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di i-mobile utilizzando mediazione, 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' Ad Manager UI
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 Ad Manager 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
descrizioni dei campi avanzati degli annunci nativi
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' Ad Manager 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.