Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di i-mobile utilizzando la mediazione, nonché 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 tag i-mobile per la mediazione nell'interfaccia utente di Ad Manager.
Passaggio 2: configura la domanda i-mobile nell'interfaccia utente di Ad Manager
Configura 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 App mobile a cui vuoi aggiungere la mediazione.
Fai clic sul pulsante Aggiungi partner di rendimento.
Se hai già un partner di rendimento per i dispositivi i-mobile, puoi selezionarlo. In caso contrario, seleziona Crea un nuovo partner di rendimento.
Seleziona i-mobile come Rete pubblicitaria, inserisci un Nome univoco e attiva Mediazione.
Attiva Raccolta automatica dei dati e inserisci il Nome di accesso e la Password API.
Dopo aver selezionato il partner di rendimento, scegli Mediazione SDK per dispositivi mobili come Tipo di integrazione, iOS come Piattaforma e Attivo come Stato. Inserisci ID publisher, 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.
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 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).
Passaggi facoltativi
Utilizzare gli 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 |
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 Ad Manager 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.