Integra i-mobile con la mediazione

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

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci di i-mobile utilizzando la mediazione, incluse le integrazioni a cascata. Viene illustrato come aggiungere i-mobile alla configurazione di 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 testo in 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 ha le seguenti funzionalità:

Requisiti

• Livello API Android 24 o versioni successive

• Più recente GMA Next-Gen SDK

• Completa la mediazione Guida introduttiva

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 della piattaforma della tua app.

Compila il modulo e fai clic sul pulsante 新規登録 (Registrati).

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

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

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

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

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

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario di annunci per app della tua app solo in canali che hai indicato come autorizzati. Per evitare una riduzione significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, crea un file app-ads.txt per Ad Manager.

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

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

Configura 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 Applicazione mobile a cui vuoi aggiungere la mediazione.

Poi, fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un partner di rendimento per i-mobile, puoi selezionarlo. In alternativa, 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 nome di accesso e la password API

Una volta selezionato il partner di rendimento , scegli Mediazione SDK per dispositivi mobili come tipo di integrazione, Android come la piattaforma e Attivo come lo stato. Inserisci l' ID publisher, ID elemento multimediale e ID spazio ottenuti nella sezione precedente. Poi, inserisci un valore di CPM predefinito.

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

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

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:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:imobile:2.3.2.1'
}

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 la versione più recente dell' SDK i-mobile, estrai il android-ad-sdk.aar dalla cartella sdk e aggiungilo al progetto.

2. Vai agli artefatti 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

Carica l'annuncio con il contesto dell'attività

Trasmetti il contesto Activity quando carichi i formati degli annunci banner, interstitial, con premio e nativi.Senza il contesto dell'attività, il caricamento dell'annuncio non andrà a buon fine.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager. i-mobile fornisce test ID spazio, ID elemento multimediale, e ID publisher di test che puoi trovare qui.

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

Passaggi facoltativi

Utilizzo degli annunci nativi

Rendering dell'annuncio

L'adattatore i-mobile completa i seguenti campi per un NativeAd.

¹ Per gli annunci nativi, l'SDK i-mobile non fornisce un asset dell'icona dell'app. 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 dell'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore i-mobile quando un annuncio non viene caricato: