Integrare maio con Mediazione AdMob

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:

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

(Solo con struttura a cascata) Oltre all'ID elemento multimediale e all'ID zona, avrai bisogno dell'ID API e della CHIAVE API per configurare l'ID unità pubblicitaria per la mediazione. Nella pagina API Reporting, prendi nota dell'ID API e della CHIAVE API.

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:

  1. Copia il file tar dell'adattatore Google Mobile Ads SDK for React Native dalla directory gma-sdk-react-native/adapters/maio/ 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/maio/gma-mediation-maio-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-maio-0.1.0.tgz
    

    filo

    yarn add ./local_packages/gma-mediation-maio-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-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.