Integrazione di i-mobile con la mediazione

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Questa guida mostra come utilizzare Google Mobile Ads SDK per caricare e visualizzare gli annunci di i-mobile utilizzando la mediazione, 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'app per iOS.

L'interfaccia della dashboard per i-mobile utilizza testo giapponese per etichette, pulsanti e descrizioni. Gli screenshot in questa guida non sono stati tradotti. Nelle descrizioni e nelle istruzioni di questa guida, tuttavia, le etichette e i pulsanti sono tradotti con i loro equivalenti in lingua 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

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Target di distribuzione iOS 13.0 o versioni successive.

Passaggio 1: configura le configurazioni 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 サイト／アプリ管理 (Site/Application Management) e sul pulsante relativo alla piattaforma della tua app.

Compila il modulo e fai clic sul pulsante 新規登録 (Registrati).

Per creare un nuovo spazio pubblicitario, seleziona la tua app nella scheda サイト／アプリ管理 (Site/Application Management).

Vai alla scheda 広告スポット管理 (Gestione degli spazi pubblicitari) e fai clic sul pulsante 新規広告スポット (Nuovo spazio pubblicitario).

create_ad_spot

Poi, compila il modulo fornendo 広告スポット名 (nome dello spazio pubblicitario), 広告スポットサイズ (dimensioni dello spazio pubblicitario) e altri dettagli. Poi, fai clic sul pulsante 新規登録 (Registrati).

new_ad_spot_form

Il tuo nuovo spazio pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプリ設定取得 (Ottieni impostazioni app).

ad_spot_list

Prendi nota dell'ID publisher (Publisher ID), dell'ID elemento multimediale (Media ID) e dell'ID spot (Spot ID). Questi parametri ti serviranno in un secondo momento per configurare i-mobile per la mediazione nell'interfaccia utente di Ad Manager.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa di IAB Tech Lab che contribuisce a garantire che il tuo inventario pubblicitario dell'app venga venduto solo tramite canali che hai identificato come autorizzati. Per evitare una perdita significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, crea un file app-ads.txt per Ad Manager.

Per implementare app-ads.txt per i-mobile, consulta le relative domande frequenti.

Passaggio 2: configura la domanda di i-mobile nell'interfaccia utente di Ad Manager

Configurare 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 Applicazione mobile a cui vuoi aggiungere la mediazione.

Poi, fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un partner di rendimento per 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 la Mediazione.

Attiva Raccolta automatica dei dati e inserisci il Nome di accesso e la password API.

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

Utilizzare Swift Package Manager

Prima di continuare, devi avere la versione minima supportata dell'adattatore 2.3.4.2.

Per aggiungere una dipendenza del pacchetto al tuo progetto, segui questi passaggi:

  1. In Xcode, vai a File > Add Package Dependencies… (File > Aggiungi dipendenze pacchetto…).

  2. Nel prompt visualizzato, cerca il seguente URL del pacchetto:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. In Regola di dipendenza, seleziona Branch.

  4. Nel campo di testo, inserisci main.

Utilizzare CocoaPods

  • Aggiungi la seguente riga al Podfile del tuo progetto:

    pod 'GoogleMobileAdsMediationIMobile'

  • Dalla riga di comando, esegui:

    pod install --repo-update

Integrazione manuale

  • Scarica l'ultima versione dell'SDK i-mobile e collega ImobileSdkAds.framework nel tuo progetto.
  • Scarica l'ultima versione dell'adattatore i-mobile dal link di download in Changelog e link IMobileAdapter.framework nel tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Implementare SKAdNetwork

Segui la documentazione di i-mobile per aggiungere gli identificatori SKAdNetwork al file Info.plist del tuo progetto.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per Ad Manager. i-mobile fornisce ID spot, ID media e ID publisher di test, che puoi trovare qui.

Verificare gli annunci di test

Per verificare di ricevere annunci di test da i-mobile, attiva il test di singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio i-mobile (cascata).

Passaggi facoltativi

Utilizzo degli annunci nativi

Rendering degli annunci

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 una risorsa icona dell'app. Al contrario, l'adattatore i-mobile riempie l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riceve un annuncio da i-mobile, gli editori possono controllare l'errore sottostante dalla risposta dell'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

Formato Nome classe
Banner IMobileAdapter
Interstitial IMobileAdapter
Nativo GADMediationAdapterIMobile

Di seguito sono riportati i codici e i messaggi associati restituiti dall'adattatore i-mobile quando un annuncio non viene caricato:

Codice di errore Motivo
0-10 L'SDK i-mobile ha restituito un errore. Per maggiori dettagli, consulta il codice.
101 I parametri del server i-mobile configurati nell'interfaccia utente di Ad Manager non sono presenti o non sono validi.
102 Le dimensioni dell'annuncio richieste non corrispondono a una dimensione del banner supportata da i-mobile.
103 i-mobile non è riuscito a mostrare 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.
107 Filtra le richieste soggette a limiti di età per l'SDK i-mobile perché non può ricevere segnali soggetti a limiti di età.

Log delle modifiche dell'adattatore di mediazione i-mobile per iOS

Versione 2.3.4.8

  • È stata aggiornata la versione minima di iOS per allentare la dipendenza dell'SDK Google Mobile Ads e consentire le versioni secondarie.

Creata e testata con:

  • SDK Google Mobile Ads versione 13.7.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.7

  • Filtra le richieste con limitazioni di età per l'SDK i-mobile quando il nuovo ageRestrictedTreatment è impostato su GADAgeRestrictedTreatmentChild.

Creata e testata con:

  • SDK Google Mobile Ads versione 13.4.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.6

  • Filtra le richieste soggette a limiti di età per l'SDK i-mobile perché non può ricevere segnali soggetti a limiti di età.

Creata e testata con:

  • SDK Google Mobile Ads versione 13.2.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.5

  • È stata aggiornata la dipendenza dell'SDK Google Mobile Ads alla versione 13.0.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 13.0.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.4

  • È stata aggiornata la versione iOS minima di CocoaPods a 13.0.

Creata e testata con:

  • SDK Google Mobile Ads versione 13.0.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.3

  • Sono stati corretti i nomi delle intestazioni del framework e dell'ombrello in IMobileAdapter modulemap.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.12.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.2

  • Ora richiede l'SDK Google Mobile Ads versione 12.0.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 12.0.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.4.1

  • CFBundleShortVersionString è stato aggiornato e ora è composto da tre componenti anziché quattro.

Creata e testata con:

  • SDK Google Mobile Ads versione 11.10.0.
  • i-mobile SDK 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.

Creata e testata con:

  • SDK Google Mobile Ads versione 11.2.0.
  • i-mobile SDK versione 2.3.4.

Versione 2.3.3.0

  • Compatibilità verificata con l'SDK i-mobile 2.3.3.

Creata e testata con:

  • SDK Google Mobile Ads versione 11.1.0.
  • Versione 2.3.3 dell'SDK i-mobile.

Versione 2.3.2.1

  • È stato rimosso il metodo delegato willBackgroundApplication deprecato dalle implementazioni di annunci banner, interstitial e nativi.
  • Ora richiede la versione minima di iOS 12.0.
  • Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
  • Incluso Info.plist nei framework all'interno di IMobileAdapter.xcframework.

Creata e testata con:

  • SDK Google Mobile Ads versione 11.0.1.
  • i-mobile SDK 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 richiede almeno iOS 11.0.
  • Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 10.4.0.
  • i-mobile SDK versione 2.3.2.

Versione 2.3.1.0

  • Compatibilità verificata con l'SDK i-mobile 2.3.1.

Creata e testata con:

  • SDK Google Mobile Ads versione 10.3.0.
  • i-mobile SDK versione 2.3.1.

Versione 2.3.0.1

  • Ora richiede l'SDK Google Mobile Ads versione 10.0.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 10.0.0.
  • i-mobile SDK 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.

Creata e testata con:

  • SDK Google Mobile Ads versione 9.13.0.
  • i-mobile SDK versione 2.3.0.

Versione 2.2.0.1

  • Ora richiede l'SDK Google Mobile Ads versione 9.0.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 9.0.0.
  • i-mobile SDK versione 2.2.0.

Versione 2.2.0.0

  • Compatibilità verificata con la versione 2.2.0 dell'SDK i-mobile.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 8.13.0.
  • i-mobile SDK versione 2.2.0.

Versione 2.1.0.1

  • Dipendenza rilassata dalla versione 8.0.0 o successive dell'SDK Google Mobile Ads.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 8.4.0.
  • i-mobile SDK versione 2.1.0.

Versione 2.1.0.0

  • Compatibilità verificata con la versione 2.1.0 dell'SDK i-mobile.
  • Ora richiede l'SDK Google Mobile Ads versione 8.1.0 o successive.
  • È stato aggiornato l'adattatore per utilizzare il formato .xcframework.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 8.1.0.
  • i-mobile SDK versione 2.1.0.

Versione 2.0.33.1

  • Sono stati aggiunti codici e messaggi di errore dell'adattatore standardizzati.
  • L'adattatore ora limita la richiesta di più annunci interstitial utilizzando lo stesso ID spot i-mobile.
  • L'adattatore ora inoltra il callback -nativeAdWillLeaveApplication: quando vengono toccati gli annunci nativi.
  • Ora richiede l'SDK Google Mobile Ads versione 7.68.0 o successive.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 7.68.0.
  • i-mobile SDK versione 2.0.33.

Versione 2.0.33.0

  • Compatibilità verificata con la versione 2.0.33 dell'SDK i-mobile.
  • Ora richiede l'SDK Google Mobile Ads versione 7.65.0 o successive.
  • Ora richiede la versione minima di iOS 9.0.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 7.65.0.
  • i-mobile SDK versione 2.0.33.

Versione 2.0.32.0

  • Compatibilità verificata con la versione 2.0.32 dell'SDK i-mobile.
  • Ora richiede l'SDK Google Mobile Ads versione 7.60.0 o successive.
  • È stato aggiunto il supporto per il ridimensionamento degli annunci 320x50 e 320x100 per adattarsi meglio alle dimensioni delle richieste di banner adattivi.
  • È stato rimosso il supporto per l'architettura i386.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 7.60.0.
  • i-mobile SDK versione 2.0.32.

Versione 2.0.31.0

  • Compatibilità verificata con la versione 2.0.31 dell'SDK i-mobile.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 7.53.1.
  • i-mobile SDK versione 2.0.31.

Versione 2.0.29.0

  • Versione iniziale
  • È stato aggiunto il supporto per gli annunci banner, interstitial e nativi.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 7.52.0.
  • i-mobile SDK versione 2.0.29.