Integra maio con la mediazione

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

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e mostrare gli annunci di maio utilizzando la mediazione, incluse le integrazioni con struttura a cascata. Viene illustrato come aggiungere maio alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di maio in un'app per Android.

L'interfaccia della dashboard di maio utilizza testo in giapponese per etichette, pulsanti e descrizioni e gli screenshot in questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, le etichette e i pulsanti vengono indicati con i relativi 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à:

Requisiti

• Livello API Android 24 o versioni successive

• SDK maio 1.0.7 o versioni successive

• L'ultima versione GMA Next-Gen SDK.

• Completa la Guida introduttiva alla mediazione .

Passaggio 1: configura le impostazioni nell'UI di maio

Per prima cosa, 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.

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

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.

Passaggio 2: configura la domanda di maio nell'UI di Ad Manager

Configura le impostazioni di mediazione per l'unità pubblicitaria

Accedi al tuo account Ad Manager.

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.

Inserisci un nome univoco per il gruppo di rendimento, imposta lo stato su Attivo, seleziona il formato dell'annuncio e imposta il tipo di inventario su App mobile. Nella sezione Targeting > Inventario , seleziona l'unità pubblicitaria in Inventario e Applicazione mobile a cui vuoi aggiungere la mediazione.

Fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un partner di rendimento per maio, puoi selezionarlo. In caso contrario, seleziona Crea un nuovo partner di rendimento.

Seleziona maio come rete pubblicitaria, inserisci un nome univoco e attiva Mediazione.

Attiva la raccolta automatica dei dati e inserisci l' ID API e la chiave API ottenuti nella sezione precedente.

Una volta selezionato il partner di rendimento , scegli Mediazione SDK per dispositivi mobili come tipo di integrazione, Android come la piattaforma e Attivo come lo stato. Inserisci l' ID contenuti multimediali e l'ID zona ottenuti nella sezione precedente. Poi, inserisci un valore di CPM predefinito.

Al termine, fai clic su Salva nella parte inferiore della pagina.

Passaggio 3: importa l'SDK e l'adattatore di maio

Integrazione di Android Studio (consigliata)

Nel file settings.gradle.kts a livello di progetto, aggiungi i seguenti repository:

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

Nel file gradle a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrazione manuale

• Scarica l'ultima versione dell' SDK Android di maio e aggiungilo al tuo progetto.
• Vai agli artefatti dell'adattatore di maio nel repository Maven di Google. Seleziona l'ultima versione, scarica il file `.aar` dell'adattatore di maio e aggiungilo al tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Non è necessario aggiungere altro codice per l'integrazione di maio su Android.

Passaggio 5: prova l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager.

I publisher che utilizzano la versione 11.6.0 o successive di GMA Next-Gen SDK riceveranno automaticamente gli 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 il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le maio (struttura a cascata) origini annuncio.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da maio, i publisher possono controllare l'errore sottostante dalla risposta dell'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

Ecco i codici e i messaggi associati generati dall'adattatore di maio quando un annuncio non viene caricato: