Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da i-mobile utilizzando mediazione, che copre le integrazioni a cascata. Spiega come aggiungere i-mobile alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore i-mobile in un' Android app.
L'interfaccia della dashboard per i-mobile 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, etichette e pulsanti sono tradotti tra parentesi con l'equivalente in lingua inglese.
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per i-mobile ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Struttura a cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
Requisiti
- Livello API Android 21 o superiore
Versione più recente dell'SDK Google Mobile Ads
Completa la Guida introduttiva di mediazione
Passaggio 1: imposta le configurazioni nell'interfaccia utente di i-mobile
Registrati o accedi al tuo account i-mobile.
Aggiungi l'app alla dashboard di i-mobile facendo clic sulla scheda サイト/アプッ管理 (Site/Application Management) e sul pulsante della piattaforma dell'app.
![](https://developers.google.cn/admob/images/mediation/imobile/select_platform_Android.png?authuser=7&hl=it)
Compila il modulo e fai clic sul pulsante renew規☁ (Registrati).
![](https://developers.google.cn/admob/images/mediation/imobile/add_app_name_Android.png?authuser=7&hl=it)
Per creare un nuovo spot pubblicitario, seleziona l'app nella scheda サイト/アプす管理 (Site/Application Management).
![](https://developers.google.cn/admob/images/mediation/imobile/app_list_Android.png?authuser=7&hl=it)
Passa alla scheda 広告ルポット管理 (Ad Spot Management) e fai clic sul pulsante 規広告ちポット (Nuovo spot pubblicitario).
A questo punto, compila il modulo fornendo i seguenti dati: 広告 dirigentiポット名 (nome spot pubblicitario), 広告ちポットサイズ (Dimensione spot pubblicitario) e altri dettagli. A questo punto, fai clic sul pulsante Reminder 規設話 (Registrati).
Il tuo nuovo spot pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプットpossono取得 (Scarica impostazioni app).
Prendi nota di パすチットID (ID publisher), デッアID (Media ID), e finiポットID (ID spot). Avrai bisogno di questi parametri in un secondo momento durante la configurazione di i-mobile per la mediazione nell' Ad Manager interfaccia utente.
![](https://developers.google.cn/admob/images/mediation/imobile/ad_spot_details_Android.png?authuser=7&hl=it)
Passaggio 2: configura la domanda di i-mobile nell' Ad Manager UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Accedi al tuo account Ad Manager.
Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.
Inserisci un nome univoco per il gruppo di rendimento, imposta lo Stato su Attivo, seleziona il formato dell'annuncio e imposta il Tipo di inventario su App mobile. Nella sezione Targeting > Inventario, seleziona l'unità pubblicitaria in Inventario e App mobile a cui vuoi aggiungere la mediazione.
Fai clic sul pulsante Aggiungi partner di rendimento.
Se hai già un Partner di rendimento per i-mobile, puoi selezionarlo. In caso contrario, seleziona Crea un nuovo partner di rendimento.
Seleziona i-mobile come Rete pubblicitaria, inserisci un nome univoco e attiva Mediazione.
Attiva Raccolta automatica dei dati e inserisci il valore Login name and API Password
Dopo aver selezionato Partner di rendimento, scegli Mediazione SDK mobile come Tipo di integrazione, Android come Piattaforma e Attivo come Stato. Inserisci iPublisher ID, Media ID and Spot ID ottenuti nella sezione precedente. Quindi, inserisci un valore per il CPM predefinito
Al termine, fai clic su Salva nella parte inferiore della pagina.
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 i seguenti repository:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
Poi, nel file build.gradle.kts
a livello di app, aggiungi le seguenti
dipendenze e configurazioni di implementazione. Utilizza le ultime versioni
dell'SDK e dell'adattatore per i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.2.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integrazione manuale
Scarica la versione più recente dell'SDK i-mobile, estrai l'
android-ad-sdk.aar
nella cartellasdk
e aggiungila al tuo progetto.Vai agli artefatto dell'adattatore i-mobile sul Repository Maven di Google. Seleziona la versione più recente, scarica il file
.aar
dell'adattatore per i-mobile e aggiungilo al tuo 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 le seguenti
campi
per un
NativeAd
.
Campo | Asset sempre inclusi da i-mobile Adapter |
---|---|
Titolo | |
Immagine | |
Corpo | |
Icona dell'app | 1 |
Call to action | |
Star rating | |
Negozio | |
Prezzo |
1 Per gli annunci nativi, l'SDK i-mobile non fornisce un asset per l'icona dell'app. L'adattatore i-mobile compila invece l'icona dell'app con un'immagine trasparente.
Codici di errore
Se l'adattatore non riceve un annuncio da i-mobile,
i publisher possono verificare l'errore sottostante della risposta dell'annuncio utilizzando
ResponseInfo.getAdapterResponses()
con le 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 non viene caricato un annuncio:
Codice di errore | Motivo |
---|---|
0-99 | L'SDK i-mobile ha restituito un errore. Per ulteriori dettagli, consulta il codice. |
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. |
0-10 | L'SDK i-mobile ha restituito un errore. Per ulteriori dettagli, consulta il codice. |
101 | I parametri del server i-mobile configurati nell' Ad Manager interfaccia utente mancano o non sono validi. |
102 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione banner supportata da i-mobile. |
103 | i-mobile non è riuscito a presentare un annuncio. |
104 | i-mobile ha restituito un array di annunci nativi vuoto. |
105 | i-mobile non è riuscito a scaricare gli asset degli annunci nativi. |
106 | i-mobile non supporta la richiesta di più annunci interstitial utilizzando lo stesso ID spot. |
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 messaggi e codici di errore dell'adattatore standardizzato.
- 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.
- IMobile SDK versione 2.0.22.
Versione 2.0.22.1
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.
Sviluppato 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.
- È stato aggiornato l'adattatore 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
- Aggiunta del supporto delle 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.