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, coprendo le integrazioni con la struttura a cascata. Descrive 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 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 inglese tra parentesi.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio

Requisiti

  • Unity 5.6 o versioni successive
  • SDK Google Mobile Ads più recente
  • Per eseguire il deployment su Android
    • Livello API Android 21 o superiore
  • Per eseguire il deployment su iOS
    • Target di deployment iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
  • 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 sito/applicazione) 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 spot pubblicitario, seleziona la tua app nella scheda サイト／アプリ管理 (Gestione siti/appli).

Android

iOS

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

create_ad_spot

A questo punto, compila il modulo fornendo 広告スポット名 (Nome dell'area annuncio), 広告スポットサイズ (Dimensioni dell'area annuncio) e altri dettagli. Poi, fai clic sul pulsante 新規登録 (Registrati).

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

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

Configura 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 > Gestore pacchetti per aprire le Impostazioni di Gestore pacchetti di Unity.

Nella scheda Registri basati su ambito, aggiungi OpenUPM come registry basato su ambito con i seguenti dettagli:

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

Dettagli OpenUPM

Quindi, vai a Finestra > Gestore pacchetti per aprire Gestore pacchetti Unity e selezionare I miei registry dal menu a discesa.

Registri Unity

Seleziona il pacchetto Google Mobile Ads i-mobile Mediation e fai clic su Installa.

Installazione 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 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 GoogleMobileAdsIMobileMediation.unitypackage file che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > Gestore delle dipendenze esterne > Risolvere Android > Forza risoluzione. La libreria External Dependency Manager effettuerà 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 è necessario 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 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 media e ID publisher di prova, che puoi trovare qui.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da i-mobile, attiva la funzionalità di test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio i-mobile (cascata).

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da i-mobile, i publisher possono controllare l'errore di fondo della risposta all'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

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

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' Ad Manager interfaccia utente sono mancanti/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' Ad Manager interfaccia utente sono mancanti/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 presentare 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 che utilizzano lo stesso ID spot.

Log delle modifiche del plug-in i-mobile Unity Mediation

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