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 mostrare gli annunci di maio utilizzando la mediazione, incluse le integrazioni con struttura a cascata. Viene descritto come aggiungere maio alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di maio in un'app Flutter.

L'interfaccia della dashboard di maio utilizza testo in giapponese per etichette, pulsanti e descrizioni e le schermate in questa guida non sono state tradotte. Tuttavia, nelle descrizioni e nelle istruzioni qui riportate, le etichette e i pulsanti sono indicati con i loro equivalenti in lingua inglese. Ad esempio, "URL スキーム" è "URL Scheme".

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per maio ha le seguenti funzionalità:

Integrazione
Offerte
Struttura a cascata
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio
Nativo

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Ultima versione Google Mobile Ads Flutter Plugin.
  • Versione del framework Flutter 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 maggiori dettagli, consulta Configurare 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 Application management (Gestione applicazioni) nella barra laterale a sinistra e poi su New app (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 Video interstitial come tipo di annuncio e 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 Rewards (Video con premio) come tipo di annuncio e poi fai clic su Update (Aggiorna).

    Android

    iOS

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

    Android

    iOS

    Nella pagina Zone Management (Gestione zone), prendi nota dell'ID zona. Sarà necessario anche per configurare l'unità pubblicitaria di Ad Manager nella sezione successiva.

    Android

    iOS

    (Solo 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 dell'API di 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 le istruzioni, consulta il passaggio 2 della guida per Android.

    iOS

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

    Passaggio 3: importa l'SDK e l'adattatore di 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 e dell'adattatore di maio nel file pubspec.yaml del pacchetto:

    dependencies:
  gma_mediation_maio: ^1.1.8

    Integrazione manuale

    Scarica l'ultima versione del plug-in di mediazione 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. Poi, 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: prova 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 il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le maio (Waterfall) origini annuncio.

    Codici di errore

    Se l'adattatore non riesce a ricevere un annuncio da maio, i publisher possono controllare il errore sottostante dalla risposta dell'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

    Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore di maio quando un annuncio non viene caricato:

    Android

    Codice di errore Motivo
    0-10 maio ha restituito un errore specifico dell'SDK. Per maggiori 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 di `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 di maio non supporta il formato dell'annuncio richiesto.
    104 È già stato caricato un annuncio per questa configurazione di rete.

    Log delle modifiche dell'adattatore di mediazione Flutter di maio

    Versione 1.1.8

    • Supporta la versione 2.0.9.1 dell'adattatore Android di maio.
    • Supporta la versione 2.2.3.0 dell'adattatore iOS di maio.
    • Creato e testato con la versione 9.1.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.1.7

    • Aggiornato per supportare la versione 9.1.0 del plug-in Flutter Google Mobile Ads.
    • Aggiunto il supporto di Swift Package Manager.
    • Supporta la versione 2.0.9.0 dell'adattatore Android di maio.
    • Supporta la versione 2.2.2.0 dell'adattatore iOS di maio.
    • Creato e testato con la versione 9.1.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.1.6

    Versione 1.1.5

    Versione 1.1.4

    • Versione minima di Flutter aggiornata a 3.38.1.
    • Aggiornato per supportare la versione 8.0.0 del plug-in Flutter Google Mobile Ads.
    • Supporta la versione 2.0.8.2 dell'adattatore Android di maio.
    • Supporta la versione 2.2.1.1 dell'adattatore iOS di maio.
    • Creato e testato con la versione 8.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.1.3

    • Supporta la versione 2.0.7.0 dell'adattatore Android di maio.
    • Supporta la versione 2.2.0.3 dell'adattatore iOS di maio.
    • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.1.2

    • Versione minima di Flutter aggiornata a 3.35.1.
    • Aggiornato per supportare la versione 7.0.0 del plug-in Flutter Google Mobile Ads.
    • Supporta la versione 2.0.8.0 dell'adattatore Android di maio.
    • Supporta la versione 2.2.0.1 dell'adattatore iOS di maio.

    Versione 1.1.1

    • Supporta la versione 2.0.7.0 dell'adattatore Android di maio.
    • Supporta la versione 2.2.0.1 dell'adattatore iOS di maio.
    • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.1.0

    • Supporta la versione 2.0.6.0 dell'adattatore Android di maio.
    • Supporta la versione 2.2.0.0 dell'adattatore iOS di maio .
    • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.0.3

    • Supporta la versione 2.0.5.0 dell'adattatore Android di maio.
    • Supporta la versione 2.1.6.1 dell'adattatore iOS di maio.
    • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.0.2

    • Supporta la versione 2.0.4.0 dell'adattatore Android di maio.
    • Supporta la versione 2.1.6.1 dell'adattatore iOS di maio.
    • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.0.1

    • Supporta la versione 2.0.3.1 dell'adattatore Android di maio .
    • Supporta la versione 2.1.6.1 dell'adattatore iOS di maio.
    • Creato e testato con la versione 6.0.0 del plug-in Flutter Google Mobile Ads.

    Versione 1.0.0

    • Release iniziale.
    • Supporta la versione 2.0.3.0 dell'adattatore Android di maio.
    • Supporta la versione 2.1.6.0 dell'adattatore iOS di maio .
    • Creato e testato con la versione 5.3.1 del plug-in Flutter Google Mobile Ads.