Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di i-mobile utilizzando la mediazione AdMob, che copre 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 per iOS.
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'adattatore di mediazione per i-mobile offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Cascata | |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Nativo | |
Requisiti
- Target di deployment iOS 12.0 o versioni successive
SDK Google Mobile Ads più recente
Completare 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.
Compila il modulo e fai clic sul pulsante 新規登録 (Registrati).
Per creare un nuovo spot pubblicitario, seleziona la tua app nella scheda サイト／アプリ管理 (Gestione siti/appli).
Vai alla scheda 広告スポット管理 (Gestione degli annunci) e fai clic sul pulsante 新規広告スポット (Nuovo annuncio).
A questo punto, compila il modulo fornendo 広告スポット名 (Nome dell'area annuncio), 広告スポットサイズ (Dimensioni dell'area annuncio) e altri dettagli. Poi, fai clic sul pulsante 新規登録 (Registrati).
Il nuovo annuncio è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプリ設定取得 (Ottieni impostazioni app).
Prendi nota di パブリッシャーID (ID publisher), メディアID (ID media) e スポットID (ID spot). Questi parametri ti serviranno in seguito per configurare i-mobile per la mediazione nell'interfaccia utente di AdMob.
Passaggio 2: configura la domanda i-mobile nell'interfaccia utente di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere i-mobile alla configurazione della mediazione per la tua unità pubblicitaria.
Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai a Aggiungere i-mobile come origine annuncio.
Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.
Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.
Assegna un nome al gruppo di mediazione e seleziona le località di destinazione. Imposta quindi lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.
Associa questo gruppo di mediazione a una o più unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.
Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:
Aggiungere i-mobile come origine annuncio
Nella scheda Struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Quindi seleziona i-mobile.
Seleziona i-mobile e attiva l'opzione Ottimizza. Inserisci il nome utente e la password API ottenuti nella sezione precedente per configurare l'ottimizzazione delle sorgenti annuncio per i annunci i-mobile. Poi inserisci un valore eCPM per i-mobile e fai clic su Continua.
Se hai già una mappatura per i dispositivi i-mobile, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Inserisci quindi ID publisher, ID media e ID spot ottenuti nella sezione precedente. Poi fai clic su Fine.
Passaggio 3: importa l'SDK e l'adattatore i-mobile
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 la versione più recente dell'SDK i-mobile e collegalo
ImobileSdkAds.frameworknel tuo progetto. - Scarica la versione più recente dell'adattatore i-mobile dal link di download nel
Changelog e
link
IMobileAdapter.frameworknel 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 progetto.
Passaggio 5: testa l'implementazione
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob. 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).
Passaggi facoltativi
Utilizzare gli annunci nativi
Rendering dell'annuncio
L'adattatore i-mobile compila le seguenti
descrizioni dei campi avanzati degli annunci nativi
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 |
1 Per gli annunci nativi, l'SDK i-mobile non fornisce un asset icona dell'app. Invece, l'adattatore i-mobile compila l'icona dell'app con un'immagine trasparente.
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da i-mobile,
i publisher possono controllare l'errore sottostante della risposta all'annuncio utilizzando
GADResponseInfo.adNetworkInfoArray
nelle seguenti classi:
| 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:
| 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 AdMob non sono presenti/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 dell'adattatore di mediazione per iOS i-mobile
Versione 2.3.4.1
CFBundleShortVersionStringè stato aggiornato in modo da avere tre componenti anziché quattro.
Creato e testato con:
- SDK Google Mobile Ads versione 11.10.0.
- SDK i-mobile 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.
Creato e testato con:
- SDK Google Mobile Ads versione 11.2.0.
- SDK i-mobile versione 2.3.4.
Versione 2.3.3.0
- Compatibilità verificata con l'SDK i-mobile 2.3.3.
Creato e testato con:
- SDK Google Mobile Ads versione 11.1.0.
- SDK i-mobile versione 2.3.3.
Versione 2.3.2.1
- È stato rimosso il metodo delegato
willBackgroundApplicationdeprecato dalle implementazioni degli annunci banner, interstitial e nativi. - Ora è richiesta la versione minima iOS 12.0.
- Ora è richiesta la versione 11.0 o successive dell'SDK Google Mobile Ads.
Info.plistè stato incluso nei framework diIMobileAdapter.xcframework.
Creato e testato con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK i-mobile 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 è richiesta la versione minima iOS 11.0.
- Ora è richiesta la versione 10.4.0 o successive dell'SDK Google Mobile Ads.
Creato e testato con:
- SDK Google Mobile Ads versione 10.4.0.
- SDK i-mobile versione 2.3.2.
Versione 2.3.1.0
- Compatibilità verificata con l'SDK i-mobile 2.3.1.
Creato e testato con:
- SDK Google Mobile Ads versione 10.3.0.
- SDK i-mobile versione 2.3.1.
Versione 2.3.0.1
- Ora è richiesta la versione 10.0.0 o successive dell'SDK Google Mobile Ads.
Creato e testato con:
- SDK Google Mobile Ads versione 10.0.0.
- SDK i-mobile versione 2.3.0.
Versione 2.3.0.0
- Compatibilità verificata con l'SDK i-mobile 2.3.0.
- Ora è richiesta la versione 9.8.0 o successive dell'SDK Google Mobile Ads.
Creato e testato con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK i-mobile versione 2.3.0.
Versione 2.2.0.1
- Ora è richiesta la versione 9.0.0 o successive dell'SDK Google Mobile Ads.
Creato e testato con:
- SDK Google Mobile Ads versione 9.0.0.
- Versione SDK i-mobile 2.2.0.
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 SDK i-mobile 2.2.0.
Versione 2.1.0.1
- Dipendenza allentata alla versione 8.0.0 o successive dell'SDK Google Mobile Ads.
Realizzato e testato con
- SDK Google Mobile Ads versione 8.4.0.
- SDK i-mobile versione 2.1.0.
Versione 2.1.0.0
- È stata verificata la compatibilità con la versione 2.1.0 dell'SDK i-mobile.
- Ora è richiesta la versione 8.1.0 o successive dell'SDK Google Mobile Ads.
- L'adattatore è stato aggiornato in modo da utilizzare il formato
.xcframework.
Realizzato e testato con
- SDK Google Mobile Ads versione 8.1.0.
- SDK i-mobile versione 2.1.0.
Versione 2.0.33.1
- Sono stati aggiunti codici e messaggi di errore standardizzati per gli adattatori.
- Ora l'adattatore limita la richiesta di più annunci interstitial che utilizzano lo stesso ID spot i-mobile.
- Ora l'adattatore inoltra il callback
-nativeAdWillLeaveApplication:quando vengono toccati gli annunci nativi. - Ora è richiesta la versione 7.68.0 o successive dell'SDK Google Mobile Ads.
Realizzato e testato con
- SDK Google Mobile Ads versione 7.68.0.
- SDK i-mobile versione 2.0.33.
Versione 2.0.33.0
- Compatibilità verificata con la versione 2.0.33 dell'SDK i-mobile.
- Ora è richiesta la versione 7.65.0 o successive dell'SDK Google Mobile Ads.
- Ora è richiesta la versione minima di iOS 9.0.
Realizzato e testato con
- SDK Google Mobile Ads versione 7.65.0.
- SDK i-mobile versione 2.0.33.
Versione 2.0.32.0
- È stata verificata la compatibilità con la versione 2.0.32 dell'SDK i-mobile.
- Ora è richiesta la versione 7.60.0 o successive dell'SDK Google Mobile Ads.
- È stato aggiunto il supporto per la ridimensionamento degli annunci 320 x 50 e 320 x 100 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.
- SDK i-mobile versione 2.0.32.
Versione 2.0.31.0
- È stata verificata la compatibilità con la versione 2.0.31 dell'SDK i-mobile.
Realizzato e testato con
- SDK Google Mobile Ads versione 7.53.1.
- SDK i-mobile 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.
- SDK i-mobile versione 2.0.29.