Integra i-mobile con la mediazione

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci di i-mobile utilizzando la mediazione AdMob, che copre le integrazioni con la struttura a cascata. Viene spiegato come aggiungere i-mobile alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore i-mobile in un'app per Android.

L'interfaccia della dashboard di 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 loro equivalenti in 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

Prerequisiti

Prima di continuare, verifica quanto segue:

• Livello API Android 24 o versioni successive.

• Ultima versione di GMA Next-Gen SDK.

• Configura Mediazione AdMob.

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).

Nota: i-mobile deve approvare la tua registrazione. Una volta ottenuta l'approvazione, puoi creare uno spot pubblicitario.

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

Vai alla scheda 広告スポット管理 (Gestione spot pubblicitari) e fai clic sul pulsante 新規広告スポット (Nuovo spot pubblicitario).

Poi, compila il modulo fornendo 広告スポット名 (nome dello spot pubblicitario), 広告スポットサイズ (dimensioni dello spot pubblicitario) e altri dettagli. Poi, fai clic sul pulsante 新規登録 (Registrati).

Il tuo nuovo spot pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプリ設定取得 (Get App settings).

Prendi nota dell'ID publisher (パブリッシャーID), dell'ID elemento multimediale (メディアID) e dell'ID spot (スポットID). Questi parametri ti serviranno in un secondo momento per configurare i-mobile per la mediazione nell'interfaccia utente di AdMob.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (app-ads.txt) è un'iniziativa di IAB Tech Lab che contribuisce a garantire la vendita dell'inventario pubblicitario della tua app solo tramite canali che hai indicato come autorizzati. Per evitare una perdita significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, configura un file app-ads.txt per la tua app.

Per implementare app-ads.txt per i-mobile, consulta le domande frequenti.

Passaggio 2: configura la domanda di i-mobile nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere i-mobile alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente 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. Poi, 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à pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungi i-mobile come origine annuncio

Nella scheda A cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.

Seleziona i-mobile e attiva l'opzione Ottimizza. Inserisci il nome di accesso e la password API ottenuti nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per i-mobile. Poi inserisci un valore eCPM per i-mobile e fai clic su Continua.

Nota: devi configurare l'ottimizzazione dell'origine annuncio una sola volta per rete.

Se hai già una mappatura per i-mobile, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci ID publisher, ID elemento multimediale e ID spot ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.

Nota: l'ottimizzazione delle origini annuncio richiede alcuni giorni per raccogliere dati sufficienti per calcolare con precisione l'eCPM di una rete di mediazione. Nel frattempo, lo stato di ottimizzazione dell'origine annuncio è PENDING, quindi devi impostare manualmente un valore eCPM per la rete. Una volta calcolato l'eCPM, l'origine annuncio inizia automaticamente ad aggiornarlo per tuo conto.

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

Nota: la mancata integrazione delle versioni i-mobile e GMA Next-Gen SDK compatibili potrebbe causare problemi di build.

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")
    }
  }
}

Nel file gradle a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrazione manuale

1. Scarica l'ultima versione dell'SDK i-mobile, estrai il file android-ad-sdk.aar nella cartella sdk e aggiungilo al progetto.

2. Vai agli artefatti dell'adattatore i-mobile nel repository Maven di Google. Seleziona l'ultima versione, scarica il file .aar dell'adattatore i-mobile e aggiungilo al progetto.

Passaggio 4: aggiungi il codice richiesto

Carica l'annuncio con il contesto dell'attività

Passa il contesto Activity durante il caricamento dei formati degli annunci banner, interstitial, con premio e nativi.Senza il contesto dell'attività, il caricamento degli annunci non andrà a buon fine.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

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

Importante: disattiva la modalità di test per AdMob e i-mobile prima di rilasciare l'app.

Verifica 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 (con struttura a cascata).

Passaggi facoltativi

Utilizzo degli annunci nativi

Rendering degli annunci

L'adattatore i-mobile compila le seguenti descrizioni dei campi degli annunci nativi avanzati 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

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

Formato	Nome classe
Banner	com.google.ads.mediation.imobile.IMobileAdapter
Interstitial	com.google.ads.mediation.imobile.IMobileAdapter
Nativo	com.google.ads.mediation.imobile.IMobileMediationAdapter

Ecco i codici e i messaggi associati generati dall'adattatore i-mobile quando non è possibile 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'interfaccia utente di AdMob sono mancanti o non validi.
103	Le dimensioni dell'annuncio richieste non corrispondono a quelle di un banner supportato da i-mobile.
104	Il callback di caricamento degli annunci nativi di i-mobile ha restituito un elenco di annunci nativi vuoto.
105	La richiesta è stata sottoposta a trattamento con limiti di età, ma l'SDK i-mobile non può ricevere indicatori con limiti di età

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

Versione successiva

• L'adattatore è stato aggiornato per utilizzare l'API InitializationCompleteCallback.onInitializationFailed(AdError).
• Il livello API Android minimo richiesto è stato aggiornato alla versione 24.
• È stato risolto un problema per cui i callback di caricamento e presentazione degli annunci interstitial non venivano inoltrati perché un listener vuoto era registrato con l'SDK i-mobile.

Versione 2.3.2.5

• Fissa la dipendenza Kotlin dell'adattatore alla versione 1.9.0 (la versione minima di Kotlin supportata dall'SDK GMA NextGen).
• È stato corretto il comportamento di fall-through nei rami di errore con limiti di età durante l'inizializzazione degli annunci e le richieste di caricamento degli annunci.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 25.4.0.
• SDK Google Mobile Ads Next-Gen versione 1.4.0.
• Versione SDK IMobile 2.3.2.

Versione 2.3.2.4

• Filtra le richieste con limiti di età per l'SDK i-mobile quando il nuovo AgeRestrictedTreatment è impostato su CHILD.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 25.4.0.
• SDK Google Mobile Ads Next-Gen versione 1.2.0.
• Versione SDK IMobile 2.3.2.

Versione 2.3.2.3

• Filtra le richieste con limiti di età per l'SDK i-mobile perché non può ricevere indicatori con limiti di età.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 25.1.0.
• SDK Google Mobile Ads Next-Gen versione 1.1.0.
• Versione SDK IMobile 2.3.2.

Versione 2.3.2.2

• È stata aggiunta la proprietà per creare l'adattatore con la dipendenza dell'SDK GMA Next-Gen.
• Migrazione delle implementazioni di annunci banner, interstitial e nativi dalla vecchia API alla nuova API.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 25.1.0.
• Versione SDK IMobile 2.3.2.

Versione 2.3.2.1

• Il livello API Android minimo richiesto è stato aggiornato alla versione 23.
• Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 24.0.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 24.0.0.
• Versione SDK IMobile 2.3.2.

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.
• Versione SDK IMobile 2.3.2.

Versione 2.3.1.2

• Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 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.
• SDK IMobile versione 2.3.1.

Versione 2.3.1.1

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

Sviluppato e testato con:

• SDK Google Mobile Ads versione 22.0.0.
• SDK IMobile 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 21.5.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 21.5.0.
• SDK IMobile versione 2.3.1.

Versione 2.3.0.0

• È stata verificata la compatibilità con l'SDK i-mobile v2.3.0.
• Aggiornamento della versione minima richiesta dell'SDK Google Mobile Ads alla versione 21.3.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 21.3.0.
• SDK IMobile versione 2.3.0.

Versione 2.0.23.1

• Aggiornamento di compileSdkVersion e targetSdkVersion all'API 31.
• Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 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.
• Versione SDK IMobile 2.0.23.

Versione 2.0.23.0

• Compatibilità verificata con l'SDK i-mobile v2.0.23.
• Aggiornamento della versione minima richiesta dell'SDK Google Mobile Ads alla versione 20.5.0.

Sviluppato e testato con

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

Versione 2.0.22.2

• Sono stati aggiunti codici e messaggi di errore standardizzati per gli adattatori.
• Aggiornamento della versione minima richiesta dell'SDK Google Mobile Ads alla versione 20.1.0.

Sviluppato e testato con

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

Versione 2.0.22.1

• Aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla versione 20.0.0.

Sviluppato e testato con

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

Versione 2.0.22.0

• È stata verificata la compatibilità 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.
• Versione SDK IMobile 2.0.22.

Versione 2.0.21.0

• Compatibilità verificata con l'SDK i-mobile v2.0.21.
• Aggiornamento della versione minima richiesta dell'SDK Google Mobile Ads alla versione 19.1.0.
• È stato aggiunto il supporto per la scalabilità degli annunci banner adattivi.

Sviluppato e testato con

• SDK Google Mobile Ads versione 19.1.0.
• SDK IMobile versione 2.0.21.

Versione 2.0.20.2

• È stato aggiunto il supporto per le dimensioni flessibili degli annunci banner.
• Aggiornamento della versione minima richiesta dell'SDK Google Mobile Ads alla versione 18.3.0.

Sviluppato e testato con

• SDK Google Mobile Ads versione 18.3.0.
• SDK IMobile 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.
• SDK IMobile versione 2.0.20.

Versione 2.0.20.0

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