Integra maio con la mediazione

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

Questa guida mostra come utilizzare Google Mobile Ads Flutter Plugin per caricare e visualizzare 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 Flutter.

L'interfaccia della dashboard di maio utilizza il testo giapponese per etichette, pulsanti e 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 Flutter Plugin.
  • Framework Flutter versione 3.7.0 o successive.
  • Per 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 Flutter funzionante configurato con Google Mobile Ads Flutter Plugin. Per informazioni dettagliate, consulta Configura Google Mobile Ads Flutter Plugin.
  • Configura la mediazione.

    • Passaggio 1: configura le impostazioni nell'interfaccia utente 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 e poi fai clic su Aggiorna.

    Android

    iOS

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

    Android

    iOS

    Nella pagina Gestione zone, prendi nota dell'ID zona. Sarà necessario anche per configurare l'unità pubblicitaria Ad Manager 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 Ad Manager

    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

    Integrazione tramite pub.dev

    (Solo Android) Aggiungi i seguenti repository al file build.gradle all'interno della directory android del progetto:

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

    Aggiungi la seguente dipendenza con le ultime versioni dell'SDK maio e dell'adattatore nel file pubspec.yaml del pacchetto:

    dependencies:
  gma_mediation_maio: ^1.1.8

    Integrazione manuale

    Scarica l'ultima versione del plug-in di mediazione di Google Mobile Ads per maio, estrai il file scaricato e aggiungi la cartella del plug-in estratta (e i relativi contenuti) al tuo progetto Flutter. Quindi, fai riferimento al plug-in nel file pubspec.yaml aggiungendo la seguente dipendenza:

    dependencies:
  gma_mediation_maio:
    path: path/to/local/package

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

    Passaggio 5: testa l'implementazione

    Attiva gli annunci di prova

    Assicurati di registrare il tuo dispositivo di test per Ad Manager.

    I publisher che utilizzano la versione 7.26.0 o successive di Google Mobile Ads Flutter Plugin riceveranno automaticamente annunci di prova da maio su smartphone e tablet registrati come dispositivi di test 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.

    Log delle modifiche dell'adattatore di mediazione maio Flutter

    Versione 1.1.8

    Versione 1.1.7

    Versione 1.1.6

    Versione 1.1.5

    Versione 1.1.4

    Versione 1.1.3

    Versione 1.1.2

    Versione 1.1.1

    Versione 1.1.0

    Versione 1.0.3

    Versione 1.0.2

    Versione 1.0.1

    Versione 1.0.0