Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da i-mobile utilizzando la mediazione e le integrazioni con struttura a cascata. Descrive come aggiungere i-mobile alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK i-mobile in un' iOS app.
L'interfaccia della dashboard di i-mobile utilizza testo in giapponese per etichette, pulsanti e descrizioni. Gli screenshot in 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 lingua inglese tra parentesi.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per i-mobile ha le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Struttura a cascata | |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Nativo | |
Requisiti
- Target di deployment per iOS 12.0 o versioni successive
Versione più recente dell'SDK Google Mobile Ads
Completa la mediazione Guida introduttiva
Passaggio 1: imposta le configurazioni nell'interfaccia utente di i-mobile
Registrati o accedi al tuo account i-mobile.
Aggiungi l'app alla dashboard di i-mobile facendo clic sulla scheda サイト/アプッ管理 (Site/Application Management) e sul pulsante della piattaforma dell'app.
Compila il modulo e fai clic sul pulsante renew規☁ (Registrati).
Per creare un nuovo spot pubblicitario, seleziona l'app nella scheda サイト/アプす管理 (Site/Application Management).
Passa alla scheda 広告ルポット管理 (Ad Spot Management) e fai clic sul pulsante 規広告ちポット (Nuovo spot pubblicitario).
A questo punto, compila il modulo fornendo i seguenti dati: 広告 dirigentiポット名 (nome spot pubblicitario), 広告ちポットサイズ (Dimensione spot pubblicitario) e altri dettagli. A questo punto, fai clic sul pulsante Reminder 規設話 (Registrati).
Il tuo nuovo spot pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプットpossono取得 (Scarica impostazioni app).
Prendi nota di パすチットID (ID publisher), デッアID (Media ID), e finiポットID (ID spot). Avrai bisogno di questi parametri in un secondo momento durante la configurazione di i-mobile per la mediazione nell' AdMob interfaccia utente.
Passaggio 2: configura la domanda di i-mobile nell' AdMob interfaccia utente
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 e l'adattatore per i-mobile
Utilizzo di CocoaPods (consigliato)
Aggiungi la riga seguente 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 collega il link
ImobileSdkAds.frameworknel tuo progetto. - Scarica la versione più recente dell'adattatore i-mobile dal link di download nel log delle modifiche e collega
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
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 dell'annuncio
L'adattatore i-mobile compila i seguenti
Descrizioni dei campi degli annunci nativi avanzati
di
GADNativeAd.
| Campo | Asset sempre inclusi nell'adattatore i-mobile |
|---|---|
| Titolo | |
| Immagine | |
| Body | |
| Icona dell'app | 1 |
| Call to action | |
| Star rating | |
| Archiviazione | |
| Prezzo |
1 Per gli annunci nativi, l'SDK i-mobile non fornisce un asset per l'icona dell'app. Al contrario, 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
nei seguenti corsi:
| Formato | Nome corso |
|---|---|
| Banner | IMobileAdapter |
| Interstitial | IMobileAdapter |
| Nativo | GADMediationAdapterIMobile |
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore i-mobile quando un annuncio non viene caricato:
| Codice di errore | Motivo |
|---|---|
| 0-99 | L'SDK i-mobile ha restituito un errore. Consulta il codice per maggiori dettagli. |
| 101 | i-mobile richiede un contesto Activity per caricare gli annunci. |
| 102 | I parametri del server i-mobile configurati nell' AdMob UI mancano o non sono validi. |
| 103 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da i-mobile. |
| 104 | Il callback di successo del caricamento degli annunci nativi di i-mobile ha restituito un elenco di annunci nativi vuoto. |
| 0-10 | L'SDK i-mobile ha restituito un errore. Consulta il codice per maggiori dettagli. |
| 101 | I parametri del server i-mobile configurati nell' AdMob UI mancano o non sono validi. |
| 102 | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da i-mobile. |
| 103 | i-mobile non ha potuto presentare un annuncio. |
| 104 | i-mobile ha restituito un array di annunci nativi vuoto. |
| 105 | i-mobile non è riuscito a scaricare gli asset annuncio nativi. |
| 106 | i-mobile non supporta la richiesta di più annunci interstitial utilizzando lo stesso ID spot. |
Log delle modifiche all'adattatore per la mediazione iOS per i-mobile
Versione 2.3.3.0
- Compatibilità verificata con l'SDK i-mobile 2.3.3.
Realizzato e testato con:
- SDK Google Mobile Ads versione 11.1.0.
- SDK i-mobile versione 2.3.3.
Versione 2.3.2.1
- Rimosso il metodo delegato
willBackgroundApplicationdeprecato dalle implementazioni banner, interstitial e annunci nativi. - Ora richiede almeno la versione iOS 12.0.
- Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
- Incluso
Info.plistnei framework all'interno diIMobileAdapter.xcframework.
Realizzato 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 almeno la versione 11.0 di iOS.
- Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.
Realizzato 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.
Realizzato e testato con:
- SDK Google Mobile Ads versione 10.3.0.
- SDK i-mobile versione 2.3.1.
Versione 2.3.0.1
- Ora richiede l'SDK Google Mobile Ads versione 10.0.0 o successive.
Realizzato 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 richiede l'SDK Google Mobile Ads versione 9.8.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK i-mobile versione 2.3.0.
Versione 2.2.0.1
- Ora richiede l'SDK Google Mobile Ads versione 9.0.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 9.0.0.
- SDK i-mobile versione 2.2.0.
Versione 2.2.0.0
- Compatibilità verificata con l'SDK i-mobile versione 2.2.0.
Realizzato e testato con
- SDK Google Mobile Ads versione 8.13.0.
- SDK i-mobile versione 2.2.0.
Versione 2.1.0.1
- Dipendenza semplice dall'SDK Google Mobile Ads versione 8.0.0 o successive.
Realizzato e testato con
- SDK Google Mobile Ads versione 8.4.0.
- SDK i-mobile 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 in modo che utilizzi 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 messaggi e codici di errore relativi all'adattatore standardizzato.
- L'adattatore ora limita le richieste di più annunci interstitial utilizzando lo stesso ID Spot per i-mobile.
- L'adattatore ora inoltra il callback
-nativeAdWillLeaveApplication:quando viene toccato gli annunci nativi. - Ora richiede l'SDK Google Mobile Ads 7.68.0 o versioni successive.
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 l'SDK i-mobile versione 2.0.33.
- Ora richiede l'SDK Google Mobile Ads versione 7.65.0 o successive.
- Ora richiede almeno la versione 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
- Compatibilità verificata con l'SDK i-mobile versione 2.0.32.
- Ora richiede l'SDK Google Mobile Ads versione 7.60.0 o successive.
- Aggiunto il supporto per la scalabilità degli annunci da 320 x 50 e 320 x 100 in modo da adattarsi meglio alle dimensioni delle richieste di banner adattivi.
- 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
- Compatibilità verificata con l'SDK i-mobile versione 2.0.31.
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
- Aggiunto il supporto per annunci banner, interstitial e nativi.
Realizzato e testato con
- SDK Google Mobile Ads versione 7.52.0.
- SDK i-mobile versione 2.0.29.