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 Moloco con la mediación, lo que incluye la integración de licitaciones. Además, indica cómo agregar Moloco a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Moloco en una app de Unity.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación de Ad Manager para Moloco tiene las siguientes capacidades:
| Integración | |
|---|---|
| Ofertas | |
| Cascada | |
| Formatos | |
| Apertura de la app | |
| Banner | |
| Intersticial | |
| Recompensado | |
| Intersticial recompensado | |
Requisitos
- SDK de anuncios de Google para dispositivos móviles más reciente
- Unity 5.6 o una versión posterior
- Complemento de Moloco para Unity 1.2.0 o una versión posterior
- Para realizar la implementación en Android
- Nivel de API 23 o posterior de Android
- Para realizar la implementación en iOS:
- Objetivo de implementación de iOS 12.0 o posterior
- Un proyecto de Unity en funcionamiento configurado con el SDK de anuncios de Google para dispositivos móviles Consulta Cómo comenzar para obtener más detalles.
- Completar la guía de introducción a la mediación
Paso 1: Establece los parámetros de configuración en la IU de Moloco
Accede al portal para publicadores de Moloco.
Navega a la pestaña Overview > Apps y, luego, haz clic en el botón Add App para crear una app nueva.
Selecciona los valores de OS y Privacy Settings de tu app, completa el resto del formulario y, luego, haz clic en Create.
Android
iOS
Una vez que se cree tu app, selecciónala en la pestaña Apps para ver los detalles y anota el valor de App Key.
Android
iOS
Navega a la pestaña Overview > Ad Units, selecciona la app en el menú desplegable y, luego, haz clic en New Ad Unit.
Selecciona In-app bidding en Auction method y completa el resto del formulario. Luego, haz clic en Crear.
Navega a la unidad de anuncios que acabas de crear en la pestaña Ad Units para ver sus detalles. Anota el ID de la unidad de anuncios.
Paso 2: Configura la demanda de Moloco en la IU de Ad Manager
Configura los parámetros de la mediación para tu unidad de anuncios
Android
Para obtener instrucciones, consulta el paso 2 de la guía para Android.
iOS
Para obtener instrucciones, consulta el paso 2 de la guía para iOS.
Se agregó Moloco Ads a la lista de socios publicitarios que cumplen con el RGPD y las reglamentaciones estatales de EE.UU.
Sigue los pasos que se indican en Configuración conforme a los reglamentos europeos y Configuración de las reglamentaciones estatales de EE.UU. para agregar Moloco Ads a la lista de socios publicitarios que cumplen con los reglamentos europeos y las reglamentaciones estatales de EE.UU. en la IU de Ad Manager.
Paso 3: Importa el SDK y el adaptador de Moloco
OpenUPM-CLI
Si tienes instalada la CLI de OpenUPM, puedes instalar el complemento de mediación del SDK de anuncios de Moloco para anuncios de Google Mobile en Unity en tu proyecto ejecutando el siguiente comando desde el directorio raíz de tu proyecto:
openupm add com.google.ads.mobile.mediation.molocoOpenUPM
En el editor de tu proyecto de Unity, selecciona Edit > Project Settings > Package Manager para abrir la configuración del administrador de paquetes de Unity.
En la pestaña Scoped Registries, agrega OpenUPM como un registro con alcance con los siguientes detalles:
- Nombre:
OpenUPM - URL:
https://package.openupm.com - Permisos:
com.google
Luego, ve a Window > Package Manager para abrir Unity Package Manager y selecciona My Registries en el menú desplegable.
Selecciona el paquete Google Mobile Ads Moloco Mediation y haz clic en Install.
Paquete de Unity
Descarga la versión más reciente del complemento de mediación de Google Mobile Ads para el SDK de Moloco Ads desde el vínculo de descarga que se encuentra en el Registro de cambios y extrae el archivo GoogleMobileAdsMolocoMediation.unitypackage del archivo ZIP.
En el editor de tu proyecto de Unity, selecciona Assets > Import Package > Custom Package y busca el archivo GoogleMobileAdsMolocoMediation.unitypackage que descargaste. Asegúrate de que todos los archivos estén seleccionados y haz clic en Importar.
Luego, selecciona Assets > External Dependency Manager > Android Resolver > Force Resolve. La biblioteca de External Dependency Manager realizará la resolución de dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de tu app de Unity.
Paso 4: Agrega el código requerido
No se requiere código adicional para la integración de Moloco.
Paso 5: Prueba tu implementación
Habilita los anuncios de prueba
Asegúrate de registrar tu dispositivo de prueba en Ad Manager.
Verifica los anuncios de prueba
Para verificar que recibes anuncios de prueba del SDK de Moloco Ads, habilita la prueba de una única fuente de anuncios seleccionando Moloco (Bidding) en el inspector de anuncios.
Códigos de error
Si el adaptador no recibe un anuncio de Moloco, los publicadores pueden verificar el error subyacente en la respuesta de solicitud de anuncio con ResponseInfo en las siguientes clases:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
A continuación, se indican los códigos y los mensajes correspondientes que arroja el adaptador de Moloco cuando no se carga un anuncio:
Android
| Código de error | Dominio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Falta la clave de app de Moloco o esta no es válida. |
| 102 | com.google.ads.mediation.moloco | Falta el ID de la unidad de anuncios de Moloco o este no es válido. |
| 103 | com.google.ads.mediation.moloco | El objeto de anuncio de Moloco que se devolvió era nulo. |
| De -1 a 5000 | com.moloco.sdk | El SDK de Moloco devolvió un error. Consulta la documentación de Moloco para obtener más detalles. |
iOS
| Código de error | Dominio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | El SDK de Moloco no admite la publicación de anuncios en iOS 12 ni en versiones anteriores. |
| 102 | com.google.ads.mediation.moloco | Falta la clave de app de Moloco o esta no es válida. |
| 103 | com.google.ads.mediation.moloco | Falta el ID de la unidad de anuncios de Moloco o este no es válido. |
| 104 | com.google.ads.mediation.moloco | El anuncio no está listo para mostrarse. |
| 105 | com.google.ads.mediation.moloco | No se mostró el anuncio. |
| 106 | com.google.ads.mediation.moloco | No hay datos de renderización disponibles para mostrar el anuncio. |
| De -1 a 5000 | Enviado por el SDK de Moloco | El SDK de Moloco devolvió un error. Consulta la documentación de Moloco para obtener más detalles. |
Verificación del servidor de anuncios recompensados
Si validas las devoluciones de llamada de la verificación del servidor (SSV), el identificador de la fuente de anuncios de Moloco es 8267622065755668722.
Registro de cambios del complemento de mediación de Moloco para Unity
Versión 1.6.1
- Se admite la versión 3.12.1.0 del adaptador de Moloco para Android.
- Se admite la versión 3.12.1.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.4.1 del complemento Google Mobile Ads para Unity.
Versión 1.6.0
- Es compatible con la versión 3.12.0.0 del adaptador de Moloco para Android.
- Se admite la versión 3.12.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.3.0 del complemento Google Mobile Ads para Unity.
Versión 1.5.0
- Se admite la versión 3.11.0.0 del adaptador de Moloco para Android.
- Es compatible con la versión 3.11.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.3.0 del complemento Google Mobile Ads para Unity.
Versión 1.4.0
- Es compatible con la versión 3.10.0.0 del adaptador de Moloco para Android.
- Se admite la versión 3.10.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.2.0 del complemento Google Mobile Ads para Unity.
Versión 1.3.1
- Es compatible con la versión 3.9.0.0 del adaptador de Moloco para Android.
- Se admite la versión 3.9.1.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.1.0 del complemento Google Mobile Ads Unity.
Versión 1.3.0
- Es compatible con la versión 3.9.0.0 del adaptador de Moloco para Android.
- Se admite la versión 3.9.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.1.0 del complemento Google Mobile Ads Unity.
Versión 1.2.1
- Se admite la versión 3.8.0.1 del adaptador de Moloco para Android.
- Se admite la versión 3.8.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.0.0 del complemento de Google Mobile Ads para Unity.
Versión 1.2.0
- Se admite la versión 3.8.0.0 del adaptador de Moloco para Android.
- Se admite la versión 3.8.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.0.0 del complemento de Google Mobile Ads para Unity.
Versión 1.1.0
- Se admite la versión 3.7.2.0 del adaptador de Moloco para Android.
- Se admite la versión 3.7.2.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 10.0.0 del complemento de Google Mobile Ads para Unity.
Versión 1.0.0
- Esta es la versión inicial.
- Se admite la versión 3.7.0.0 del adaptador de Moloco para Android.
- Se admite la versión 3.6.0.0 del adaptador de Moloco para iOS.
- Se compiló y probó con la versión 9.6.0 del complemento Google Mobile Ads para Unity.