Integra 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 AdMob, 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 il testo giapponese per etichette, pulsanti e descrizioni. Gli screenshot di 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 offre le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Livello API Android 21 o superiore

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 l'app nella scheda サイト/アプン管理 (Gestione sito/applicazione).

Vai alla scheda 広告promozioneポット管理 (Ad Spot Management) e fai clic sul pulsante webstore規広告 {8}ポット (Nuovo spot pubblicitario).

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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' AdMob interfaccia utente

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 e l'adattatore i-mobile

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 i-mobile e aggiungilo al progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione di i-mobile.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob. i-mobile fornisce gli ID spot, l'ID media e l'ID publisher per i test: li trovi qui.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da i-mobile, attiva la funzionalità di test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio i-mobile (cascata).

Passaggi facoltativi

Utilizzare gli annunci nativi

Visualizzazione dell'annuncio

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 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 verificare l'errore sottostante della risposta dell'annuncio utilizzando ResponseInfo.getAdapterResponses() con le seguenti classi:

Formato Nome del 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 messaggi associati generati dall'adattatore i-mobile quando non riesce a caricare 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' AdMob interfaccia utente sono mancanti/non validi.
103 La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da i-mobile.
104 Il callback di caricamento 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 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.
  • È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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.

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

Sviluppato e testato con:

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

Versione 2.0.23.0

  • Compatibilità verificata con l'SDK i-mobile 2.0.23.
  • È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.1.0.

Realizzato e testato con

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

Versione 2.0.22.1

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