Integra i-mobile con la mediazione

Questa guida mostra come utilizzare Google Mobile Ads Flutter Plugin per caricare e visualizzare gli annunci di i-mobile utilizzando la mediazione, che copre le integrazioni a cascata. Spiega 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 Flutter.

L'interfaccia della dashboard per i-mobile utilizza testo giapponese per etichette, pulsanti e descrizioni. Gli screenshot in questa guida non sono stati tradotti. Nelle descrizioni e nelle istruzioni di questa guida, tuttavia, le etichette e i pulsanti sono tradotti con i loro equivalenti in lingua inglese tra parentesi.

Integrazioni e formati degli annunci supportati

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

Prerequisiti

Prima di continuare, verifica quanto segue:

• Ultima versione di Google Mobile Ads Flutter Plugin.
• Framework Flutter versione 3.7.0 o successive.
• Per il deployment su Android
  • Livello API Android 24 o versioni successive.
• Per il deployment su iOS
  • Target di distribuzione iOS 13.0 o versioni successive.
• Un progetto Flutter funzionante configurato con Google Mobile Ads Flutter Plugin. Per maggiori dettagli, vedi Configurare Google Mobile Ads Flutter Plugin.
• Configura la mediazione.

Passaggio 1: configura le configurazioni 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 サイト／アプリ管理 (Site/Application Management) e sul pulsante relativo alla piattaforma della tua app.

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

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

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

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

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

Prendi nota dell'ID publisher (Publisher ID), dell'ID elemento multimediale (Media ID) e dell'ID spot (Spot ID). 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 di IAB Tech Lab che contribuisce a garantire che il tuo inventario pubblicitario dell'app venga venduto solo tramite canali che hai identificato come autorizzati. Per evitare una perdita 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 relative domande frequenti.

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

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

Integrazione tramite pub.dev

(Solo Android) Aggiungi i seguenti repository al file build.gradle all'interno della directory android del progetto:

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

Aggiungi la seguente dipendenza con le versioni più recenti dell'SDK e dell'adattatore i-mobile nel file pubspec.yaml del pacchetto:

dependencies:
  gma_mediation_imobile: ^1.0.6

Integrazione manuale

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per i-mobile, estrai il file scaricato e aggiungi la cartella del plug-in estratto (e i relativi contenuti) al tuo progetto Flutter. Poi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

Passaggio 4: codice aggiuntivo richiesto

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per Ad Manager. i-mobile fornisce ID spot, ID media e ID publisher di test, che puoi trovare qui.

Verificare gli annunci di test

Per verificare di ricevere annunci di test da i-mobile, attiva il test di singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio i-mobile (cascata).

Codici di errore

Se l'adattatore non riceve un annuncio da i-mobile, i publisher possono controllare l'errore sottostante dalla risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

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

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

Versione 1.0.6

• Supporta i-mobile Android adapter versione 2.3.2.5.
• Supporta la versione 2.3.4.8 dell'adattatore i-mobile iOS.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 9.1.0.

Versione 1.0.5

• È stato eseguito l'aggiornamento per supportare il plug-in Flutter Google Mobile Ads versione 9.1.0.
• Aggiungi il supporto di Swift Package Manager.
• Supporta i-mobile Android adapter versione 2.3.2.4.
• Supporta la versione 2.3.4.8 dell'adattatore i-mobile iOS.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 9.1.0.

Versione 1.0.4

• Supporta i-mobile Android adapter versione 2.3.2.3.
• Supporta i-mobile iOS adapter versione 2.3.4.7.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 8.0.0.

Versione 1.0.3

• Aggiornamento della versione minima di Flutter alla 3.38.1
• È stato effettuato un aggiornamento per supportare la versione 8.0.0 del plug-in Flutter Google Mobile Ads
• Supporta i-mobile Android adapter versione 2.3.2.3.
• Supporta la versione 2.3.4.6 dell'adattatore i-mobile iOS.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 8.0.0.

Versione 1.0.2

• Supporta i-mobile Android adapter versione 2.3.2.1.
• Supporta i-mobile iOS adapter versione 2.3.4.3.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

Versione 1.0.1

• Supporta i-mobile Android adapter versione 2.3.2.1.
• Supporta l'adattatore i-mobile iOS versione 2.3.4.2.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 6.0.0.

Versione 1.0.0

• Release iniziale.
• Supporta l'adattatore Android i-mobile versione 2.3.2.0.
• Supporta l'adattatore i-mobile iOS versione 2.3.4.1.
• Creato e testato con il plug-in Flutter Google Mobile Ads versione 5.3.1.