Questa guida mostra come utilizzare Google Mobile Ads SDK for React Native per caricare e visualizzare gli annunci di maio utilizzando la mediazione, che copre le integrazioni con la struttura a cascata. Viene spiegato come aggiungere maio alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore maio in un'app React Native.
L'interfaccia della dashboard di maio utilizza il testo giapponese per le etichette, i pulsanti e le descrizioni e gli screenshot di questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni riportate di seguito, le etichette e i pulsanti sono indicati con i loro equivalenti in lingua inglese. "URL スキーム," ad esempio, è "schema URL,".
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per maio 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:
- Ultima versione di Google Mobile Ads SDK for React Native.
- Framework React Native versione 0.85.0 o successive.
- Per eseguire il deployment su Android
- Livello API Android 24 o versioni successive.
- Per il deployment su iOS
- Target di deployment iOS 15.0 o versioni successive.
- Un progetto React Native funzionante configurato con Google Mobile Ads SDK for React Native.
Per informazioni dettagliate, consulta Configura Google Mobile Ads SDK for React Native.
- Assicurati di aver scaricato ed estratto la cartella
adaptersdalla cartellagma-sdk-react-native. Se non hai la cartellaadapters, segui i passaggi uno, due e tre della sezione Installare Google Mobile Ads SDK for React Native.
- Assicurati di aver scaricato ed estratto la cartella
- Configura Mediazione AdMob.
Passaggio 1: imposta le configurazioni nella UI di maio
Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Gestione applicazioni nella barra laterale sinistra e poi su Nuova app.

Seleziona la scheda corrispondente al tipo di annuncio che preferisci.
Interstitial
Inserisci il nome dell'app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Interstitial video come Tipo di annuncio, poi fai clic su Aggiorna.
Android

iOS

Con premio
Inserisci il nome dell'app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Video con premio come Tipo di annuncio, poi fai clic su Aggiorna.
Android

iOS

Nella pagina Gestione applicazioni, prendi nota dell'ID elemento multimediale. È necessario per configurare l'unità pubblicitaria AdMob nella sezione successiva.
Android

iOS

Nella pagina Gestione zone, prendi nota dell'ID zona. Sarà necessario anche per configurare l'unità pubblicitaria AdMob nella sezione successiva.
Android

iOS


Passaggio 2: configura la domanda di maio 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 maio
Nella directory root del progetto, installa l'adattatore di mediazione Google Mobile Ads SDK for React Native per maio. Completa i passaggi seguente:
Copia il file tar dell'adattatore Google Mobile Ads SDK for React Native dalla directory
gma-sdk-react-native/adapters/maio/nella directorylocal_packages/del progetto. Se non hai la cartellaadapters, consulta i Prerequisiti.mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/maio/gma-mediation-maio-0.1.0.tgz local_packages/Sostituisci EXTRACT_DIR con il percorso della directory in cui hai estratto l'archivio.
Installa il pacchetto dell'adattatore utilizzando il gestore di pacchetti che preferisci:
npm
npm install ./local_packages/gma-mediation-maio-0.1.0.tgzfilo
yarn add ./local_packages/gma-mediation-maio-0.1.0.tgzSe stai creando per Android, aggiungi il seguente repository al file
build.gradlenella directoryandroiddel progetto:repositories { google() mavenCentral() maven { url = uri("https://imobile-maio.github.io/maven") } }
Passaggio 4: aggiungi il codice richiesto
Android
Non è necessario alcun codice aggiuntivo per l'integrazione di maio.
iOS
Integrazione di SKAdNetwork
Segui la documentazione di maio 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 publisher che utilizzano la versione 7.26.0 o successive di Google Mobile Ads SDK for React Native riceveranno automaticamente annunci di prova da maio su smartphone e tablet registrati come dispositivi di prova quando effettuano richieste.
Verifica gli annunci di prova
Per verificare di ricevere annunci di prova da maio, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio maio (con struttura a cascata).
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da maio, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:
Android
| Formato | Nome classe |
|---|---|
| Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Con premio | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| Formato | Nome classe |
|---|---|
| Interstitial | GADMMaioInterstitialAdapter |
| Con premio | GADMMaioRewardedAdapter |
Ecco i codici e i messaggi associati generati dall'adattatore maio quando non è possibile caricare un annuncio:
Android
| Codice di errore | Motivo |
|---|---|
| 0-10 | maio ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta il codice e la documentazione di maio. |
| 101 | Maio non ha un annuncio disponibile. |
| 102 | Parametri del server non validi (ad es. ID luogo mancante). |
| 103 | Il contesto utilizzato per caricare un annuncio non era un'istanza "Activity". |
iOS
| Codice di errore | Motivo |
|---|---|
| 0-10 | maio ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta il codice di maio. |
| 101 | maio non ha ancora un annuncio disponibile. |
| 102 | Parametri del server non validi (ad es. ID luogo mancante). |
| 103 | L'adattatore maio non supporta il formato dell'annuncio richiesto. |
| 104 | Un annuncio è già stato caricato per questa configurazione di rete. |
Versione 0.1.0
- Release iniziale.
- Supporta l'adattatore Android maio versione 2.0.9.1.
- Supporta l'adattatore maio per iOS versione 2.2.1.2.1.