Integrare i-mobile con la mediazione

Questa guida illustra 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'adattatore e l'SDK i-mobile in un' Android app.

L'interfaccia della dashboard di 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 lingua inglese tra parentesi.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Struttura a cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Livello API Android 19 o superiore

• Versione più recente dell'SDK Google Mobile Ads

• Completa la mediazione Guida introduttiva

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

Sign up or log in to your i-mobile account.

Add your app to the i-mobile dashboard by clicking the サイト／アプリ管理 (Site/Application Management) tab and the button for your app's platform.

Fill out the form and click the 新規登録 (Sign up) button.

Note: i-mobile has to approve your registration. Once you are approved, you can create an Advertising Spot.

To create a new Advertising Spot, select your app under the サイト／アプリ管理 (Site/Application Management) tab.

Navigate to the 広告スポット管理 (Ad Spot Management) tab and click the 新規広告スポット (New Ad Spot) button.

Next, fill out the form by providing the 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) and other details. Then, click the 新規登録 (Sign up) button.

Your new Ad spot is ready. To view its integration details, click the アプリ設定取得 (Get App settings) button.

Take note of the パブリッシャーID (Publisher ID), メディアID (Media ID), and スポットID (Spot ID). You'll need these parameters later when configuring i-mobile for mediation in the Ad Manager UI.

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Accedi al tuo account Ad Manager.

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.

Inserisci un nome univoco per il gruppo di rendimento, imposta lo Stato su Attivo, seleziona il formato dell'annuncio e imposta il Tipo di inventario su App mobile. Nella sezione Targeting > Inventario, seleziona l'unità pubblicitaria in Inventario e App mobile a cui vuoi aggiungere la mediazione.

Fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un Partner di rendimento per i-mobile, puoi selezionarlo. In caso contrario, seleziona Crea un nuovo partner di rendimento.

Seleziona i-mobile come Rete pubblicitaria, inserisci un nome univoco e attiva Mediazione.

Attiva Raccolta automatica dei dati e inserisci il valore Login name and API Password

Dopo aver selezionato Partner di rendimento, scegli Mediazione SDK mobile come Tipo di integrazione, Android come Piattaforma e Attivo come Stato. Inserisci iPublisher ID, Media ID and Spot ID ottenuti nella sezione precedente. Quindi, inserisci un valore per il CPM predefinito

Al termine, fai clic su Salva nella parte inferiore della pagina.

Nota: la raccolta automatica dei dati richiede alcuni giorni per raccogliere i dati prima di poter calcolare con precisione il valore del CPM dinamico per una rete di mediazione. Una volta calcolato, l'eCPM viene aggiornato automaticamente.

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

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

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

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

Integrazione manuale

1. Scarica la versione più recente dell'SDK i-mobile, 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 tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario 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.

Importante: disattiva la modalità di test per Ad Manager 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 i-mobile compila i seguenti campi di NativeAd.

Campo	Asset sempre inclusi nell'adattatore 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 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.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 i-mobile quando un annuncio non viene caricato:

Codice di errore	Motivo
0-99	L'SDK i-mobile ha restituito un errore. Consulta il codice per maggiori dettagli.
101	i-mobile richiede un contesto Activity per caricare gli annunci.
102	I parametri del server i-mobile configurati nell' Ad Manager UI mancano o non sono validi.
103	La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da i-mobile.
104	Il callback di successo del 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 maggiori dettagli.
101	I parametri del server i-mobile configurati nell' Ad Manager UI mancano o non sono validi.
102	La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata 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 annuncio nativi.
106	i-mobile non supporta la richiesta di più annunci interstitial utilizzando lo stesso ID spot.

Log delle modifiche all'adattatore per la 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

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

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.
• Il livello API Android minimo richiesto è stato aggiornato a 19.

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 relativi all'adattatore standardizzato.
• 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 le 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

• Ora l'adattatore 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 annunci banner, interstitial e nativi.