Integrare i-mobile con la mediazione

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

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

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

  1. Scarica l'ultima versione di SDK i-mobile ed estrai android-ad-sdk.aar nella cartella sdk e aggiungilo al tuo 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 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 e targetSdkVersion 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.