Integra i-mobile con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads 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 Unity.

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 Ad Manager per i-mobile ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio

Requisiti

  • SDK Google Mobile Ads più recente
  • Unity 5.6 o versioni successive
  • Per il deployment su Android
    • Livello API Android 23 o superiore
  • Per il deployment su iOS
    • Target di distribuzione iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la sezione Guida introduttiva.
  • Completa la mediazione Guida introduttiva

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario pubblicitario della tua app solo in 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, 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'UI di Ad Manager

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, vedi il passaggio 2 della guida per iOS.

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

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione i-mobile di Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale del progetto:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Package Manager (Gestione pacchetti) per aprire le impostazioni di Unity Package Manager.

Nella scheda Registri con ambito, aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Ambiti: com.google

Dettagli OpenUPM

Poi vai a Window > Package Manager per aprire Unity Package Manager e seleziona My Registries (I miei registri) dal menu a discesa.

Unity Registries

Seleziona il pacchetto Google Mobile Ads IMobile Mediation e fai clic su Installa.

Installare da OpenUPM

Pacchetto Unity

Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per i-mobile dal link di download nel Changelog ed estrai GoogleMobileAdsIMobileMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Assets (Asset) > Import Package (Importa pacchetto) > Custom Package (Pacchetto personalizzato) e trova il file GoogleMobileAdsIMobileMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager esegue la risoluzione delle dipendenze da zero e copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

Passaggio 4: codice aggiuntivo richiesto

Android

Per l'integrazione di i-mobile non è necessario codice aggiuntivo.

iOS

Integrazione di SKAdNetwork

Segui la documentazione di i-mobile per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager. i-mobile fornisce ID spot, ID elemento multimediale e ID publisher per i test. Puoi trovarli qui.

Verificare gli annunci di prova

Per verificare di ricevere annunci di test da i-mobile, attiva il test di una 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 nella risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

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

iOS

Formato Nome del corso
Banner IMobileAdapter
Interstitial IMobileAdapter
Nativo GADMediationAdapterIMobile

Ecco i codici e i messaggi associati restituiti dall'adattatore i-mobile quando un annuncio non viene caricato:

Android

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 Ad Manager sono mancanti o non validi.
103 La dimensione annuncio richiesta non corrisponde a una dimensione banner supportata da i-mobile.
104 Il callback di caricamento riuscito dell'annuncio nativo di i-mobile ha restituito un elenco di annunci nativi vuoto.

iOS

Codice di errore Motivo
0-10 L'SDK i-mobile ha restituito un errore. Per ulteriori dettagli, consulta il codice.
101 I parametri del server i-mobile configurati nell'interfaccia utente di Ad Manager sono mancanti o non validi.
102 La dimensione annuncio richiesta non corrisponde a una dimensione banner supportata da i-mobile.
103 i-mobile non è riuscito a mostrare 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 utilizzando lo stesso ID spot.

Log delle modifiche del plug-in di mediazione Unity i-mobile

Versione 1.3.7

Versione 1.3.6

Versione 1.3.5

Versione 1.3.4

Versione 1.3.3

Versione 1.3.2

Versione 1.3.1

Versione 1.3.0

Versione 1.2.2

Versione 1.2.1

Versione 1.2.0

Versione 1.1.0

Versione 1.0.2

Versione 1.0.1

Versione 1.0.0