Integrazione di i-mobile con la mediazione

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. Descrive come aggiungere i-mobile alla configurazione della 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, 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 i-mobile ha le seguenti funzionalità:

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

Registrati o accedi al tuo account i-mobile.

Aggiungi la tua app alla dashboard di i-mobile facendo clic sulla scheda サイト／アプリ管理 (Gestione siti/applicazioni) e sul pulsante relativo alla piattaforma della tua app.

Compila il modulo e fai clic sul pulsante 新規登録 (Registrati).

Per creare un nuovo spot pubblicitario, seleziona la tua app nella scheda サイト／アプリ管理 (Gestione siti/appli).

Vai alla scheda 広告スポット管理 (Gestione degli annunci) e fai clic sul pulsante 新規広告スポット (Nuovo annuncio).

A questo punto, compila il modulo fornendo 広告スポット名 (Nome dell'area annuncio), 広告スポットサイズ (Dimensioni dell'area annuncio) e altri dettagli. Poi, fai clic sul pulsante 新規登録 (Registrati).

Il nuovo annuncio è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプリ設定取得 (Ottieni impostazioni app).

Prendi nota di パーチッチチーID (Publisher ID)), che ti abbia anche accolto i seguenti dati: learning デイアID (Media ID) e LicenseポットID (Spot ID) (ID Spot). Questi parametri ti serviranno in seguito per configurare i-mobile per la mediazione nell'interfaccia utente di AdMob.

Passaggio 2: configura la domanda i-mobile nell' Ad Manager interfaccia utente

Passaggio 3: importa l'SDK e l'adattatore i-mobile

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 configurazioni e dipendenze di implementazione. Utilizza le versioni più recenti dell'SDK e dell'adattatore i-mobile:

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

Integrazione manuale

1. Scarica la versione più recente dell'SDK i-mobile ed estrai il file android-ad-sdk.aar nella cartella sdk, quindi aggiungilo al progetto.

2. Vai agli elementi dell'adattatore i-mobile nel 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 di i-mobile.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob. i-mobile fornisce ID spot, ID media e ID publisher di prova, che puoi trovare qui.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da i-mobile, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio i-mobile (a cascata).

Passaggi facoltativi

Utilizzare gli annunci nativi

Visualizzazione dell'annuncio

L'adattatore i-mobile compila i seguenti descrizioni dei campi avanzati degli annunci nativi per un NativeAd.

¹ 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 riesce a ricevere un annuncio da i-mobile, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore i-mobile quando non riesce a caricare un annuncio:

Log delle modifiche dell'adattatore di mediazione Android i-mobile

Versione 2.3.2.0

• Compatibilità verificata con l'SDK i-mobile 2.3.2.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 23.1.0.
• Versione dell'SDK IMobile 2.3.2.

Versione 2.3.1.2

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 23.0.0.
• Compatibilità verificata con l'SDK i-mobile v2.3.1.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 23.0.0.
• Versione 2.3.1 dell'SDK IMobile.

Versione 2.3.1.1

• L'adattatore è stato aggiornato per utilizzare la nuova classe VersionInfo.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.

Sviluppata e testata con:

• SDK Google Mobile Ads versione 22.0.0.
• Versione 2.3.1 dell'SDK IMobile.

Versione 2.3.1.0

• Compatibilità verificata con l'SDK i-mobile v2.3.1.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.5.0.

Sviluppata e testata 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 2.3.0.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.3.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 21.3.0.
• Versione 2.3.0 dell'SDK IMobile.

Versione 2.0.23.1

• compileSdkVersion e targetSdkVersion sono stati aggiornati all'API 31.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 21.0.0.
• È stato aggiornato il livello API Android minimo richiesto a 19.

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

Realizzato e testato con

• SDK Google Mobile Ads versione 20.5.0.
• Versione dell'SDK IMobile 2.0.23.

Versione 2.0.22.2

• Sono stati aggiunti codici e messaggi di errore dell'adattatore standardizzati.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.1.0.

Realizzato e testato con

• SDK Google Mobile Ads versione 20.1.0.
• IMobile SDK versione 2.0.22.

Versione 2.0.22.1

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 20.0.0.

Realizzato e testato con

• SDK Google Mobile Ads versione 20.0.0.
• Versione dell'SDK IMobile 2.0.22.

Versione 2.0.22.0

• Compatibilità verificata con l'SDK i-mobile 2.0.22.
• L'adattatore è stato aggiornato per supportare le richieste di banner adattivi in linea.

Realizzato e testato con

• SDK Google Mobile Ads versione 19.1.0.
• Versione dell'SDK IMobile 2.0.22.

Versione 2.0.21.0

• Compatibilità verificata con l'SDK i-mobile 2.0.21.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.1.0.
• È stato aggiunto il supporto per la scalabilità degli annunci banner adattivi.

Realizzato e testato con

• SDK Google Mobile Ads versione 19.1.0.
• Versione 2.0.21 dell'SDK IMobile.

Versione 2.0.20.2

• È stato aggiunto il supporto per le dimensioni flessibili degli annunci banner.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 18.3.0.

Realizzato e testato con

• SDK Google Mobile Ads versione 18.3.0.
• SDK IMobile versione 2.0.20.

Versione 2.0.20.1

• Ora l'adattatore restituisce un'area mediaContent con proporzioni diverse da zero.

Realizzato e testato con

• SDK Google Mobile Ads versione 18.2.0.
• SDK IMobile versione 2.0.20.

Versione 2.0.20.0

• Versione iniziale
• Aggiunto il supporto per annunci banner, interstitial e nativi.