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 gli annunci di i-mobile utilizzando la mediazione, che copre le integrazioni 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 di i-mobile utilizza il 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 di 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 deployment iOS 13.0 o versioni successive.
  • Un progetto Unity funzionante configurato con Google Mobile Ads Unity Plugin. Per maggiori dettagli, vedi Configurare Google Mobile Ads Unity 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 サイト／アプリ管理 (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 サイト／アプリ管理 (Gestione siti/applicazioni).

    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 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). Avrai bisogno di questi parametri 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 l'inventario pubblicitario della tua 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

    Configura 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 principale del progetto:

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

    OpenUPM

    Nell'editor del progetto Unity, seleziona Modifica > 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 (Finestra) > Package Manager (Gestore di pacchetti) per aprire Unity Package Manager e seleziona My Registries (I miei registri) 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 Google Mobile Ads per i-mobile dal link di download nella cronologia delle modifiche ed estrai 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

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

    Forza risoluzione

    Passaggio 4: codice aggiuntivo richiesto

    Android

    Non è richiesto alcun codice aggiuntivo per l'integrazione di i-mobile.

    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

    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 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 riceve un annuncio da i-mobile, i publisher possono controllare l'errore sottostante dalla risposta dell'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

    Di seguito sono riportati 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 saperne di più, 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 Le dimensioni dell'annuncio richieste non corrispondono 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 Le dimensioni dell'annuncio richieste non corrispondono a una dimensione del banner supportata da i-mobile.
    103 i-mobile non è riuscita a pubblicare 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 di i-mobile

    Versione 1.3.16

    Versione 1.3.15

    Versione 1.3.14

    Versione 1.3.13

    Versione 1.3.12

    Versione 1.3.11

    Versione 1.3.10

    Versione 1.3.9

    Versione 1.3.8

    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