Se usó la API de Cloud Translation para traducir esta página.

Cómo integrar maio con la mediación

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles para cargar y mostrar anuncios de maio con mediación, que abarcan integraciones en cascada. Aquí se explica cómo agregar Maio a la API de una unidad de anuncios configuración de mediación y cómo integrar el SDK de Maio y el adaptador a una Android app.

La interfaz del panel de maio usa texto en japonés para las etiquetas, los botones y descripciones, y las capturas de pantalla de esta guía no se tradujeron. Sin embargo, en las descripciones e instrucciones de esta guía, las etiquetas y los botones a las que se hace referencia con sus equivalentes en inglés. "URL 炭ー," por ejemplo, es "Esquema de URL".

Integraciones y formatos de anuncios admitidos

El adaptador de mediación para Maio tiene las siguientes funciones:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

Nivel de API 21 o versiones posteriores de Android

SDK de maio 1.0.7 o superior

SDK de anuncios de Google para dispositivos móviles más reciente
Cómo completar la mediación Guía de introducción

Paso 1: Establece la configuración en la IU de Maio

Primero, regístrate o accede a tu cuenta principal. Haz clic en el botón Application management en la barra lateral izquierda y, luego, en New app.

Selecciona la pestaña correspondiente al Tipo de anuncio que prefieras.

Intersticial

Ingresa el Nombre de tu app, selecciona la plataforma y proporciona la URL de tu app. Selecciona Intersticial de video como el Tipo de anuncio y, luego, haz clic en Actualizar.

Recompensado

Ingresa el Nombre de tu app, selecciona la plataforma y proporciona la URL de tu app. Selecciona Recompensas de video como el Tipo de anuncio y, luego, haz clic en Actualizar.

En la página Administración de aplicaciones, toma nota del ID de medios. Es necesario que configures tu Ad Manager unidad de anuncios en la siguiente sección.

En la página Administración de zonas, toma nota del ID de zona. También la necesitarás para configurar tu Ad Manager unidad de anuncios en la siguiente sección.

Además de Media ID y Zone ID, necesitarás el ID de API y la CLAVE DE API para configurar el ID de tu unidad de anuncios para la mediación. En la página de API de Reporting, toma nota del ID de API y de la CLAVE DE API.

Paso 2: Configura la demanda de CPA en la Ad Manager IU

Cómo configurar la mediación para tu unidad de anuncios

Accede a tu cuenta de Ad Manager.

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento.

Ingresa un Nombre único para tu grupo de rendimiento, establece el Estado en Activo, selecciona el Formato del anuncio y establece el Tipo de inventario en Aplicación para dispositivos móviles. En la sección Segmentación > Inventario, selecciona la unidad de anuncios en Inventario y Aplicación para dispositivos móviles a la que deseas agregar la mediación.

Luego, haz clic en el botón Agregar socio de rendimiento.

Si ya tienes un socio de rendimiento paramaio, puedes seleccionarlo. De lo contrario, selecciona Crear un socio de rendimiento nuevo.

Selecciona maio como la Red de publicidad, ingresa un Nombre único y habilita la Mediación.

Activa Recopilación de datos automática y, luego, ingresa el API ID and API KEY obtenido en la sección anterior.

Una vez que hayas seleccionado el Socio de rendimiento, elige Mediación del SDK para dispositivos móviles como el Tipo de integración, Android como la Plataforma y Activo como el Estado. Ingresa elMedia ID and Zone ID obtenido en la sección anterior. Luego, ingresa un valor de CPM predeterminado.

Haz clic en Guardar en la parte inferior de la página cuando termines.

Paso 3: Importa el SDK y el adaptador de maio

Integración de Android Studio (recomendada)

En el archivo settings.gradle.kts de nivel de proyecto, agrega lo siguiente: repositorios:

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

Luego, en el archivo build.gradle.kts a nivel de la app, agrega lo siguiente: las dependencias y configuraciones de la implementación. Usa las versiones más recientes del SDK y adaptador de maio:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Integración manual

Descarga la última versión de SDK de maio Android y agrega a tu proyecto.
Navega a los artefactos del adaptador maio en el repositorio de Maven de Google. Selecciona la versión más reciente y descarga el archivo ".aar" del adaptador maio y agregarlo a tu proyecto.

Paso 4: Agrega el código requerido

No se requiere ningún código adicional para la integración de maio Android.

Paso 5: Prueba tu implementación

Habilitar anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en Ad Manager.

Los publicadores que usen la versión 11.6.0 o una posterior del SDK de anuncios de Google para dispositivos móviles recibirán automáticamente anuncios de prueba de Maio en teléfonos y tablets registrados como dispositivos de prueba cuando realicen solicitudes.

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba demaio, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la maio (Waterfall) fuente de anuncios.

Códigos de error

Si el adaptador no recibe un anuncio de Maio, los publicadores pueden verificar el error subyacente de la respuesta del anuncio ResponseInfo.getAdapterResponses() en las siguientes clases:

Formato	Nombre de clase
Intersticial	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Recompensado	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

A continuación, se muestran los códigos y los mensajes adjuntos que arroja el adaptador maio cuando no se puede cargar un anuncio:

Código de error	Motivo
0-10	maio mostró un error específico del SDK. Ver código y la documentación de Maio para obtener más información.
101	María no tiene un anuncio disponible.
102	Parámetros de servidor no válidos (p.ej., falta el ID de posición).
103	El contexto que se usó para cargar un anuncio no fue una instancia de "Activity".
0-10	maio mostró un error específico del SDK. Consulta código de maio para obtener más información.
101	María aún no tiene un anuncio disponible.
102	Parámetros de servidor no válidos (p.ej., falta el ID de posición).
103	El adaptador maio no admite el formato de anuncio que se solicita.
104	Ya se cargó un anuncio para esta configuración de red.