Integrazione di i-mobile con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da i-mobile utilizzando la mediazione e le integrazioni con struttura a cascata. Descrive come aggiungere i-mobile alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore per i-mobile in un' Android app.

L'interfaccia della dashboard per i-mobile utilizza etichette, pulsanti e descrizioni in giapponese. 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 gli equivalenti in lingua inglese tra parentesi.

Integrazioni e formati degli annunci supportati

L' AdMob adattatore di mediazione per i-mobile ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Livello API Android 19 o superiore

• SDK Google Mobile Ads più recente

• Completa la mediazione Guida introduttiva

Passaggio 1: imposta le configurazioni nell'interfaccia utente di i-mobile

Registrati o accedi al tuo account i-mobile.

Aggiungi la tua app alla dashboard per i-mobile facendo clic sulla scheda サイト/アプリ管理 (Gestione sito/applicazione) e sul pulsante Apigee規Androidアプリ (nuova app Android) .

Registra la tua app fornendo i relativi 名称 (Nome) e マーケットURL (Market URL). Dopo aver compilato la parte rimanente del modulo, fai clic sul pulsante Apigee">< (Registrati).

Nota: la registrazione deve essere approvata da i-mobile. Dopo aver ricevuto l'approvazione, puoi creare uno spot pubblicitario.

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

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

Dopodiché, compila il modulo fornendo i dati di 広告すポット (nome dello spot pubblicitario), 広告すポットサイズ (dimensione dello spot pubblicitario) e di altri dettagli. A questo punto, fai clic sul pulsante Ъ規pubads (Registrati).

Il nuovo spot pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプリ設チ取得 (Scarica impostazioni app).

Prendi nota dei valori di パすリッチャーID (Publisher ID)...", a デアID (Media ID) e a すポットID (ID spot). Avrai bisogno di questi parametri in un secondo momento per configurare i-mobile per la mediazione nell' AdMob interfaccia utente.

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

Ora devi aggiungere i-mobile alla configurazione della mediazione per la tua unità pubblicitaria. Per farlo, accedi innanzitutto al tuo account AdMob.

Successivamente, vai alla scheda Mediazione. Se già disponi di un gruppo di mediazione da modificare, fai clic sul nome del gruppo per modificarlo e vai direttamente ad Aggiungere 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. Quindi, imposta lo stato del gruppo di mediazione su Attivato. quindi fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione alle tue unità pubblicitarie AdMob esistenti. Poi fai clic su Fine.

A questo punto, la scheda delle unità pubblicitarie dovrebbe essere completata con quelle selezionate.

Aggiungere i-mobile come origine annuncio

Nella scheda Origini annuncio, seleziona Aggiungi rete pubblicitaria.

Seleziona i-mobile e attiva la funzione Ottimizza. Inserisci il Nome di accesso e la Password API del tuo account i-mobile per configurare l'ottimizzazione dell'origine annuncio per i-mobile. Inserisci un valore eCPM per i-mobile e fai clic su Continua.

Punto chiave: contatta l'account manager di i-mobile o l'assistenza per ricevere la password dell'API.

Se disponi già di una mappatura per i-mobile, puoi semplicemente selezionarla. In alternativa, fai clic su Aggiungi mappatura.

A questo punto, inserisci il tuo ID publisher, l'ID media e l'ID spot ottenuto nella sezione precedente. Poi, fai clic su Fine.

Punto chiave: l'ottimizzazione dell'origine annuncio richiede alcuni giorni per raccogliere i dati al fine di calcolare con precisione l'eCPM per una rete di mediazione. Nel frattempo, lo stato dell'ottimizzazione dell'origine annuncio sarà PENDING, quindi devi impostare manualmente un valore eCPM per la rete. Una volta calcolato l'eCPM, l'ottimizzazione dell'origine annuncio inizierà automaticamente ad aggiornare l'eCPM per tuo conto.

Passaggio 3. Importa l'SDK e l'adattatore per i-mobile

Nota: la mancata integrazione delle versioni compatibili degli SDK i-mobile e Google Mobile Ads potrebbe causare problemi di build.

Integrazione con Android Studio (consigliata)

Aggiungi le seguenti dipendenze di implementazione con le versioni più recenti dell'adattatore e dell'SDK per i-mobile nel file build.gradle a livello di app:

repositories {
    google()
    mavenCentral()
    maven {
      url  "https://imobile.github.io/adnw-sdk-android"
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.1.1'
}
...

Integrazione manuale

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

2. Vai agli elementi dell'adattatore per dispositivi mobili sul Repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore i-mobile e aggiungilo al tuo progetto.

Passaggio 4: aggiungi il codice richiesto

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

Passaggio 5: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob i-mobile fornisce ID spot, ID media e ID publisher per i test. Puoi trovarli qui.

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

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 dell'annuncio

L'adattatore per dispositivi mobili compila le seguenti descrizioni dei campi degli annunci nativi avanzati per un NativeAd.

Campo	Asset sempre inclusi nell'adattatore per i-mobile
Titolo
Immagine
Body
Icona dell'app	^1
Call to action
Star rating
Archiviazione
Prezzo

¹ Per gli annunci nativi, l'SDK i-mobile non fornisce un asset per l'icona dell'app. Al contrario, l'adattatore i-mobile completa 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 di annuncio utilizzando ResponseInfo.getAdapterResponse() 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 messaggi associati generati dall'adattatore per i-mobile quando non viene caricato un annuncio:

Codice di errore	Motivo
0-99	L'SDK i-mobile ha restituito un errore. Consulta 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'interfaccia utente AdMob non sono presenti o non sono validi.
103	Le dimensioni dell'annuncio richieste non corrispondono alle dimensioni dei banner supportate da i-mobile.
104	Il callback di caricamento degli annunci nativi di i-mobile ha restituito un elenco di annunci nativi vuoto.
0-10	L'SDK i-mobile ha restituito un errore. Consulta il codice per ulteriori dettagli.
101	I parametri del server i-mobile configurati nell'interfaccia utente AdMob non sono presenti o non sono validi.
102	Le dimensioni dell'annuncio richieste non corrispondono alle dimensioni dei banner supportate da i-mobile.
103	i-mobile non ha potuto 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 che utilizzano lo stesso ID spot.

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

Versione successiva

• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.

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.

Realizzato 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 versione 21.5.0.

Realizzato e testato con:

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

Realizzato 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.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.
• Aggiornato a 19 il livello API Android minimo richiesto.

Realizzato e testato con:

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

Versione 2.0.22.2

• Sono stati aggiunti messaggi e codici 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.
• SDK IMobile 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.

Realizzato e testato con

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

Versione 2.0.22.0

• Compatibilità verificata con l'SDK i-mobile v2.0.22.
• L'adattatore è stato aggiornato in modo da supportare le richieste di banner adattivi incorporati.

Realizzato e testato con

• SDK Google Mobile Ads versione 19.1.0.
• SDK IMobile 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 la scalabilità degli annunci banner adattivi.

Realizzato e testato con

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

Versione 2.0.20.2

• Aggiunto il supporto per dimensioni flessibili degli annunci banner.
• La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 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

• L'adattatore ora restituisce proporzioni mediaContent 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 banner, interstitial e annunci nativi.