Integrare i-mobile con Mediazione AdMob

Questa guida mostra come utilizzare Google Mobile Ads SDK for React Native per caricare e visualizzare annunci di i-mobile utilizzando la mediazione, che copre le integrazioni con la struttura a cascata. Viene spiegato 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 React Native.

L'interfaccia della dashboard di 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 AdMob per i-mobile ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio
Nativo

Prerequisiti

Prima di continuare, verifica quanto segue:

Passaggio 1: imposta 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 サイト／アプリ管理 (Gestione siti/applicazioni) e sul pulsante relativo alla piattaforma della tua app.

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

Il tuo nuovo spot pubblicitario è pronto. Per visualizzare i dettagli dell'integrazione, fai clic sul pulsante アプリ設定取得 (Get App settings).

ad_spot_list

Prendi nota di パブリッシャーID (ID publisher), メディアID (ID elemento multimediale) e スポットID (ID spot). Questi parametri ti serviranno in un secondo momento per configurare i-mobile per la mediazione nell'interfaccia utente di AdMob.

Android

iOS

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (app-ads.txt) è un'iniziativa di IAB Tech Lab che contribuisce a garantire che l'inventario pubblicitario della tua 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, configura un file app-ads.txt per la tua app.

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

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

Configura le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, consulta il passaggio 2 della guida per iOS.

Passaggio 3: importa l'SDK e l'adattatore i-mobile

Nella directory root del progetto, installa l'adattatore di mediazione Google Mobile Ads SDK for React Native per i-mobile. Completa i passaggi seguente:

  1. Copia il file tar dell'adattatore Google Mobile Ads SDK for React Native dalla directory gma-sdk-react-native/adapters/imobile/ nella directory local_packages/ del progetto. Se non hai la cartella adapters, consulta i Prerequisiti.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    Sostituisci EXTRACT_DIR con il percorso della directory in cui hai estratto l'archivio.

  2. Installa il pacchetto dell'adattatore utilizzando il gestore di pacchetti che preferisci:

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    filo

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. Se stai creando per Android, aggiungi il seguente repository al file build.gradle nella directory android del progetto:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://imobile.github.io/adnw-sdk-android")
    }
}

Passaggio 4: codice aggiuntivo richiesto

Android

Non è richiesto alcun codice aggiuntivo per l'integrazione di i-mobile.

iOS

Integrazione di SKAdNetwork

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

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob. i-mobile fornisce ID spot, ID elemento multimediale e ID publisher di prova per i test, che puoi trovare qui.

Verifica gli annunci di prova

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

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da i-mobile, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

Formato Nome classe
Banner com.google.ads.mediation.imobile.IMobileAdapter
Interstitial com.google.ads.mediation.imobile.IMobileAdapter
Nativo com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Formato Nome classe
Banner IMobileAdapter
Interstitial IMobileAdapter
Nativo GADMediationAdapterIMobile

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore i-mobile quando non è possibile caricare un annuncio:

Android

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'interfaccia utente di AdMob sono mancanti o non validi.
103 Le dimensioni dell'annuncio richieste non corrispondono a quelle di un banner supportato da i-mobile.
104 Il callback di caricamento degli annunci nativi di i-mobile ha restituito un elenco di annunci nativi vuoto.

iOS

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 AdMob sono mancanti o non validi.
102 Le dimensioni dell'annuncio richieste non corrispondono a quelle di un banner supportato 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 è riuscita a scaricare gli asset degli annunci nativi.
106 i-mobile non supporta la richiesta di più annunci interstitial utilizzando lo stesso ID spot.

Versione 0.1.0

  • Release iniziale.