Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di i-mobile utilizzando Mediazione AdMob che copre le integrazioni a cascata. Spiega come aggiungere i-mobile al configurazione della mediazione e come integrare l'SDK e l'adattatore i-mobile in un' iOS app.
L'interfaccia della dashboard per i-mobile utilizza testo giapponese per le etichette, pulsanti e descrizioni. Gli screenshot di questa guida non sono stati tradotto in inglese. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, i pulsanti sono tradotti con gli 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 del deployment di iOS 12.0 o versioni successive
Versione più recente dell'SDK Google Mobile Ads
Completare la mediazione Guida introduttiva
Passaggio 1: imposta le configurazioni nell'interfaccia utente di i-mobile
Sign up or log in to your i-mobile account.
Add your app to the i-mobile dashboard by clicking the サイト/アプリ管理 (Site/Application Management) tab and the button for your app's platform.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/select_platform_iOS.png?authuser=8&hl=it)
Fill out the form and click the 新規登録 (Sign up) button.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/add_app_name_iOS.png?authuser=8&hl=it)
To create a new Advertising Spot, select your app under the サイト/アプリ管理 (Site/Application Management) tab.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/app_list_iOS.png?authuser=8&hl=it)
Navigate to the 広告スポット管理 (Ad Spot Management) tab and click the 新規広告スポット (New Ad Spot) button.
Next, fill out the form by providing the 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) and other details. Then, click the 新規登録 (Sign up) button.
Your new Ad spot is ready. To view its integration details, click the アプリ設定取得 (Get App settings) button.
Take note of the パブリッシャーID (Publisher ID), メディアID (Media ID), and スポットID (Spot ID). You'll need these parameters later when configuring i-mobile for mediation in the AdMob UI.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/ad_spot_details_iOS.png?authuser=8&hl=it)
Passaggio 2: configura la domanda di i-mobile nell' AdMob UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere i-mobile alla configurazione della mediazione per la tua unità pubblicitaria.
Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi 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à da scegliere come target. Imposta 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à pubblicitarieAdMob esistenti. Poi, fai clic su Fine.
A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:
Aggiungi i-mobile come origine annuncio
Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona i-mobile.
Seleziona i-mobile e attiva l'opzione Ottimizza. Inserisci quanto Login name and API Password ottenuto nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per i-mobile. Inserisci un valore eCPM peri-mobile e fai clic su Continua.Se hai già una mappatura per i-mobile, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' Publisher ID, Media ID and Spot ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Passaggio 3: importa l'SDK i-mobile e l'adattatore
Utilizzo di CocoaPods (consigliato)
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 di i-mobile
SDK e link
ImobileSdkAds.framework
nel tuo progetto. - Scarica la versione più recente dell'adattatore i-mobile dal link di download in
Changelog e
collega
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 progetto.
Passaggio 5: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per AdMob i-mobile fornisce ID spot, ID media e ID publisher per i test. Puoi trovarli qui.
Verifica annunci di prova
Per verificare di ricevere annunci di prova dai-mobile, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le i-mobile (Waterfall) origini annuncio.
Passaggi facoltativi
Utilizzo degli annunci nativi
Rendering degli annunci
L'adattatore i-mobile compila i campi seguenti
Descrizioni dei campi avanzati per gli annunci nativi
per un
GADNativeAd
Campo | Asset sempre inclusi da i-mobile Adapter |
---|---|
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 per l'icona dell'app. Invece, L'adattatore i-mobile compila l'icona dell'app con un'immagine trasparente.
Codici di errore
Se l'adattatore non riceve un annuncio da i-mobile,
i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
GADResponseInfo.adNetworkInfoArray
nelle seguenti classi:
Formato | Nome corso |
---|---|
Banner | IMobileAdapter |
Interstitial | IMobileAdapter |
Nativo | GADMediationAdapterIMobile |
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore i-mobile. Quando un annuncio non viene caricato:
Codice di errore | Motivo |
---|---|
0-10 | L'SDK i-mobile ha restituito un errore. Vedi il codice per ulteriori informazioni. |
101 | I parametri del server i-mobile configurati nell' AdMob interfaccia utente mancano o non sono validi. |
102 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione 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 utilizzando lo stesso ID spot. |
Log delle modifiche dell'adattatore di mediazione i-mobile per iOS
Versione 2.3.4.0
- Compatibilità verificata con l'SDK i-mobile 2.3.4.
- Aggiunto il supporto per restituire la versione dell'SDK i-mobile in
adSDKVersion
.
Sviluppato 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.
Sviluppato 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
willBackgroundApplication
deprecato dalle implementazioni di annunci banner, interstitial e nativi. - Ora è necessaria la versione minima di iOS 12.0.
- Ora è necessaria la versione 11.0 o versioni successive dell'SDK Google Mobile Ads.
Info.plist
incluso nei framework all'interno diIMobileAdapter.xcframework
.
Sviluppato 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.
- Rimosso il supporto dell'architettura
armv7
. - Ora richiede la versione minima di iOS 11.0.
- Ora è necessaria la versione 10.4.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato 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.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.3.0.
- SDK i-mobile versione 2.3.1.
Versione 2.3.0.1
- Ora è necessaria la versione 10.0.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato 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 è necessaria la versione 9.8.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK i-mobile versione 2.3.0.
Versione 2.2.0.1
- Ora è necessaria la versione 9.0.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.0.0.
- SDK i-mobile versione 2.2.0.
Versione 2.2.0.0
- È stata verificata la compatibilità con l'SDK i-mobile versione 2.2.0.
Sviluppato e testato con
- SDK Google Mobile Ads versione 8.13.0.
- SDK i-mobile versione 2.2.0.
Versione 2.1.0.1
- Dipendenza informale dall'SDK Google Mobile Ads versione 8.0.0 o successive.
Sviluppato 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 l'SDK i-mobile versione 2.1.0.
- Ora è necessaria la versione 8.1.0 o versioni successive dell'SDK Google Mobile Ads.
- È stato aggiornato l'adattatore per usare il formato
.xcframework
.
Sviluppato 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 messaggi e codici di errore dell'adattatore standardizzato.
- Ora l'adattatore limita la richiesta di più annunci interstitial usando lo stesso ID Spot i-mobile.
- Ora l'adattatore inoltra il callback
-nativeAdWillLeaveApplication:
quando viene toccato un annuncio nativo. - Ora è necessaria la versione 7.68.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato e testato con
- SDK Google Mobile Ads versione 7.68.0.
- SDK i-mobile versione 2.0.33.
Versione 2.0.33.0
- È stata verificata la compatibilità con l'SDK i-mobile versione 2.0.33.
- Ora è necessaria la versione 7.65.0 o versioni successive dell'SDK Google Mobile Ads.
- Ora richiede la versione minima di iOS 9.0.
Sviluppato 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 l'SDK i-mobile versione 2.0.32.
- Ora è necessaria la versione 7.60.0 o versioni successive dell'SDK Google Mobile Ads.
- È stato aggiunto il supporto della scalabilità degli annunci da 320 x 50 e 320 x 100 per adattarsi meglio alle dimensioni delle richieste di banner adattivi.
- Rimosso il supporto per l'architettura i386.
Sviluppato 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 l'SDK i-mobile versione 2.0.31.
Sviluppato 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
- Aggiunto il supporto per annunci banner, interstitial e nativi.
Sviluppato e testato con
- SDK Google Mobile Ads versione 7.52.0.
- SDK i-mobile versione 2.0.29.