Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Integra i-mobile con la mediazione

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

Questa guida mostra come utilizzare Google Mobile Ads Unity Plugin per caricare e visualizzare annunci di i-mobile utilizzando la mediazione, che copre le integrazioni con la struttura a cascata. Illustra come aggiungere i-mobile alla configurazione della 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 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 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
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio
Nativo

Prerequisiti

Prima di continuare, verifica quanto segue:

Ultima versione di Google Mobile Ads Unity Plugin.
Unity Editor versione 5.6 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 Unity funzionante configurato con Google Mobile Ads Unity Plugin. Per informazioni dettagliate, consulta Configura Google Mobile Ads Unity Plugin.

Configura la mediazione.

Passaggio 1: imposta le configurazioni nella UI 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 relativo alla 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 spot pubblicitari) e fai clic sul pulsante 新規広告スポット (Nuovo spot pubblicitario).

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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.

Android

iOS

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 già 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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

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

iOS

Per istruzioni, consulta 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 root del progetto:

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

OpenUPM

Nell'editor del progetto Unity, seleziona Edit > Impostazioni progetto > Package Manager per aprire le impostazioni di Unity Package Manager.

Nella scheda Scoped Registries (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 dal menu a discesa.

Registri Unity

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

Installare da OpenUPM

Pacchetto Unity

Scarica l'ultima versione del plug-in di mediazione di Google Mobile Ads per i-mobile dal link di download nel log delle modifiche ed estrai il file GoogleMobileAdsIMobileMediation.unitypackage dal file ZIP.

Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > 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

Poi, seleziona Assets > 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 alcun codice aggiuntivo.

iOS

Integrazione di SKAdNetwork

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

Passaggio 5: testa l'implementazione

Attiva 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 di test, che puoi trovare qui.

Verificare gli annunci di test

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

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da i-mobile, i publisher possono verificare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

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

iOS

Formato	Nome classe
Banner	IMobileAdapter
Interstitial	IMobileAdapter
Nativo	GADMediationAdapterIMobile

Ecco i codici e i messaggi associati generati dall'adattatore i-mobile quando non è possibile caricare un annuncio:

Android

Codice di errore	Motivo
0-99	L'SDK i-mobile ha restituito un errore. Per maggiori 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 dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da i-mobile.
104	Il callback di caricamento degli annunci nativi 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 dell'annuncio richiesta non corrisponde a una dimensione del 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.