Integra i-mobile con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da i-mobile utilizzando Mediazione AdMob, 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' iOS app.

L'interfaccia della dashboard per 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, etichette e pulsanti sono tradotti tra parentesi con l'equivalente in lingua inglese.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per i-mobile ha le seguenti funzionalità:

Integrazione
Offerte
Struttura a 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

  • Completa la Guida introduttiva di mediazione

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

create_ad_spot

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

new_ad_spot_form

Il tuo nuovo spot pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプットpossono取得 (Scarica impostazioni app).

ad_spot_list

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

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 collega 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 di SKAdNetwork al file Info.plist del tuo 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 le seguenti descrizioni dei campi avanzati sugli annunci nativi per un GADNativeAd

Campo Asset sempre inclusi da i-mobile Adapter
Titolo
Immagine
Corpo
Icona dell'app 1
Call to action
Star rating
Negozio
Prezzo

1 Per gli annunci nativi, l'SDK i-mobile non fornisce un asset per l'icona dell'app. L'adattatore i-mobile compila invece l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riceve un annuncio da i-mobile, i publisher possono verificare l'errore sottostante della 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 relativi messaggi generati dall'adattatore i-mobile quando non viene caricato un annuncio:

Codice di errore Motivo
0-99 L'SDK i-mobile ha restituito un errore. Per ulteriori dettagli, consulta il codice.
101 i-mobile richiede un contesto Activity per caricare gli annunci.
102 I parametri del server i-mobile configurati nell' AdMob interfaccia utente mancano o non sono validi.
103 La dimensione dell'annuncio richiesta non corrisponde a una dimensione banner supportata da i-mobile.
104 La callback di successo del carico degli annunci nativi di i-mobile ha restituito un elenco di annunci nativi vuoto.
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' 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 di IMobileAdapter.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 è necessaria 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.