Integrazione di 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 per iOS.

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Target di distribuzione iOS 12.0 o versioni successive

• SDK Google Mobile Ads più recente

• 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.

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

Nota: i-mobile deve approvare la tua registrazione. Una volta approvato, puoi creare uno spazio pubblicitario.

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

Vai alla scheda 広告スポット管理 (Gestione 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 アプリ設定取得 (Get App settings).

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.

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

Accedi al tuo account Ad Manager.

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.

Inserisci un nome univoco per il gruppo di rendimento, imposta lo stato su Attivo, seleziona il formato dell'annuncio e imposta il tipo di inventario su App mobile. Nella sezione Targeting > Inventario, seleziona l'unità pubblicitaria in Inventario e Applicazione mobile a cui vuoi aggiungere la mediazione.

Poi, fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un partner di rendimento per i-mobile, puoi selezionarlo. In alternativa, seleziona Crea un nuovo partner di rendimento.

Seleziona i-mobile come Rete pubblicitaria, inserisci un Nome univoco e attiva la Mediazione.

Attiva Raccolta automatica dei dati e inserisci il Nome di accesso e la password API.

Una volta selezionato il partner di rendimento, scegli Mediazione SDK per dispositivi mobili come tipo di integrazione, iOS come piattaforma e Attivo come stato. Inserisci ID editore, ID media e ID spot ottenuti nella sezione precedente. Poi, inserisci un valore CPM predefinito.

Al termine, fai clic su Salva nella parte inferiore della pagina.

Nota: la raccolta automatica dei dati ha bisogno di raccogliere dati per qualche giorno prima di poter calcolare con precisione un valore di CPM dinamico per una rete di mediazione. Una volta calcolato l'eCPM, questo verrà aggiornato automaticamente per tuo conto.

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

Nota: la mancata integrazione delle versioni compatibili dell'SDK i-mobile e Google Mobile Ads potrebbe causare problemi di build.

Utilizzo di CocoaPods (opzione consigliata)

Aggiungi la seguente riga al Podfile del progetto:

pod 'GoogleMobileAdsMediationIMobile'

Dalla riga di comando esegui:

pod install --repo-update

Integrazione manuale

• Scarica l'ultima versione dell'SDK i-mobile e collega ImobileSdkAds.framework nel tuo progetto.
• Scarica l'ultima versione dell'adattatore i-mobile dal link di download in Changelog e link IMobileAdapter.framework nel tuo progetto.

Passaggio 4: aggiungi il codice richiesto

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 dispositivo di test per Ad Manager. i-mobile fornisce ID spot, ID elemento multimediale e ID publisher per i test. Puoi trovarli qui.

Importante: disattiva la modalità di test per Ad Manager e i-mobile prima di rilasciare l'app.

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 l'origine o le origini annuncio i-mobile (cascata).

Passaggi facoltativi

Utilizzo degli annunci nativi

Rendering dell'annuncio

L'adattatore i-mobile compila i seguenti campi per un GADNativeAd.

Campo	Asset sempre inclusi dall'adattatore i-mobile
Titolo
Immagine
Corpo
Icona dell'app	^1
Call to action
Valutazione a stelle
Negozio
Prezzo

¹ Per gli annunci nativi, l'SDK i-mobile non fornisce un asset icona dell'app. Al contrario, l'adattatore i-mobile riempie l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riceve un annuncio da i-mobile, gli editori possono controllare l'errore sottostante dalla risposta dell'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

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:

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 non sono presenti/non sono 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 dell'adattatore di mediazione i-mobile per iOS

Versione successiva

• Attiva -fobjc-arc e -fstack-protector-all.

Versione 2.3.4.2

• Ora richiede l'SDK Google Mobile Ads versione 12.0.0 o successive.

Creata e testata con:

• SDK Google Mobile Ads versione 12.0.0.
• i-mobile SDK versione 2.3.4.

Versione 2.3.4.1

• CFBundleShortVersionString aggiornato in modo da avere tre componenti anziché quattro.

Creata e testata con:

• SDK Google Mobile Ads versione 11.10.0.
• i-mobile SDK versione 2.3.4.

Versione 2.3.4.0

• Compatibilità verificata con l'SDK i-mobile 2.3.4.
• È stato aggiunto il supporto per restituire la versione dell'SDK i-mobile in adSDKVersion.

Creata e testata con:

• SDK Google Mobile Ads versione 11.2.0.
• i-mobile SDK versione 2.3.4.

Versione 2.3.3.0

• Compatibilità verificata con l'SDK i-mobile 2.3.3.

Creata e testata con:

• SDK Google Mobile Ads versione 11.1.0.
• Versione 2.3.3 dell'SDK i-mobile.

Versione 2.3.2.1

• È stato rimosso il metodo delegato willBackgroundApplication deprecato dalle implementazioni di annunci banner, interstitial e nativi.
• Ora richiede la versione minima di iOS 12.0.
• Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
• Incluso Info.plist nei framework all'interno di IMobileAdapter.xcframework.

Creata e testata con:

• SDK Google Mobile Ads versione 11.0.1.
• i-mobile SDK versione 2.3.2.

Versione 2.3.2.0

• Compatibilità verificata con l'SDK i-mobile 2.3.2.
• È stato rimosso il supporto dell'architettura armv7.
• Ora richiede almeno iOS 11.0.
• Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.

Creata e testata con:

• SDK Google Mobile Ads versione 10.4.0.
• i-mobile SDK versione 2.3.2.

Versione 2.3.1.0

• Compatibilità verificata con l'SDK i-mobile 2.3.1.

Creata e testata con:

• SDK Google Mobile Ads versione 10.3.0.
• i-mobile SDK versione 2.3.1.

Versione 2.3.0.1

• Ora richiede l'SDK Google Mobile Ads versione 10.0.0 o successive.

Creata e testata con:

• SDK Google Mobile Ads versione 10.0.0.
• i-mobile SDK versione 2.3.0.

Versione 2.3.0.0

• Compatibilità verificata con l'SDK i-mobile 2.3.0.
• Ora richiede l'SDK Google Mobile Ads versione 9.8.0 o successive.

Creata e testata con:

• SDK Google Mobile Ads versione 9.13.0.
• i-mobile SDK versione 2.3.0.

Versione 2.2.0.1

• Ora richiede l'SDK Google Mobile Ads versione 9.0.0 o successive.

Creata e testata con:

• SDK Google Mobile Ads versione 9.0.0.
• Versione 2.2.0 dell'SDK i-mobile.

Versione 2.2.0.0

• Compatibilità verificata con la versione 2.2.0 dell'SDK i-mobile.

Realizzato e testato con

• SDK Google Mobile Ads versione 8.13.0.
• Versione 2.2.0 dell'SDK i-mobile.

Versione 2.1.0.1

• Dipendenza meno rigida dalla versione 8.0.0 o successive dell'SDK Google Mobile Ads.

Realizzato e testato con

• SDK Google Mobile Ads versione 8.4.0.
• i-mobile SDK versione 2.1.0.

Versione 2.1.0.0

• Compatibilità verificata con l'SDK i-mobile versione 2.1.0.
• Ora richiede l'SDK Google Mobile Ads versione 8.1.0 o successive.
• È stato aggiornato l'adattatore per utilizzare il formato .xcframework.

Realizzato e testato con

• SDK Google Mobile Ads versione 8.1.0.
• i-mobile SDK versione 2.1.0.

Versione 2.0.33.1

• Sono stati aggiunti codici e messaggi di errore dell'adattatore standardizzati.
• L'adattatore ora limita la richiesta di più annunci interstitial utilizzando lo stesso ID spot i-mobile.
• L'adattatore ora inoltra il callback -nativeAdWillLeaveApplication: quando vengono toccati gli annunci nativi.
• Ora richiede l'SDK Google Mobile Ads versione 7.68.0 o successive.

Realizzato e testato con

• SDK Google Mobile Ads versione 7.68.0.
• i-mobile SDK versione 2.0.33.

Versione 2.0.33.0

• Compatibilità verificata con l'SDK i-mobile versione 2.0.33.
• Ora richiede l'SDK Google Mobile Ads versione 7.65.0 o successive.
• Ora richiede la versione minima di iOS 9.0.

Realizzato e testato con

• SDK Google Mobile Ads versione 7.65.0.
• i-mobile SDK versione 2.0.33.

Versione 2.0.32.0

• Compatibilità verificata con l'SDK i-mobile versione 2.0.32.
• Ora richiede l'SDK Google Mobile Ads versione 7.60.0 o successive.
• È stato aggiunto il supporto per il ridimensionamento degli annunci 320x50 e 320x100 in modo che si adattino meglio alle dimensioni delle richieste di banner adattivi.
• È stato rimosso il supporto per l'architettura i386.

Realizzato e testato con

• SDK Google Mobile Ads versione 7.60.0.
• i-mobile SDK versione 2.0.32.

Versione 2.0.31.0

• Compatibilità verificata con l'SDK i-mobile versione 2.0.31.

Realizzato e testato con

• SDK Google Mobile Ads versione 7.53.1.
• i-mobile SDK versione 2.0.31.

Versione 2.0.29.0

• Versione iniziale
• È stato aggiunto il supporto per gli annunci banner, interstitial e nativi.

Realizzato e testato con

• SDK Google Mobile Ads versione 7.52.0.
• i-mobile SDK versione 2.0.29.