Cómo integrar AppLovin 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 AppLovin usando mediación, que abarcan integraciones de ofertas y en cascada. Abarca cómo agregar AppLovin en la configuración de mediación de una unidad de anuncios y cómo integrar el SDK de AppLovin y un adaptador en una Unity app.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación AdMob para AppLovin tiene la las siguientes capacidades:

Integración
Ofertas
Cascada
Formatos
Banner  1
Intersticial
Recompensado

Anuncios de banner (excepto MREC) banners) solo se admiten en la mediación. La licitación no admite ningún tipo de anuncios de banner.

Requisitos

  • SDK de anuncios de Google para dispositivos móviles más reciente
  • Unity 5.6 o una versión posterior
  • [For Bidding]: Complemento de mediación de Google Mobile Ads para AppLovin 4.2.0 o más alto (versión recomendada más reciente)
  • Cómo implementar en Android
    • Nivel de API 21 o versiones posteriores de Android
  • Cómo implementar en iOS
    • Objetivo de implementación de iOS 12.0 o superior
  • Un proyecto en funcionamiento Unity configurado con Google SDK de anuncios para dispositivos móviles. Consulta Comienza ahora para obtener más información.
  • Cómo completar la mediación Guía de introducción

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

Regístrate o accede a tu cuenta de AppLovin.

Para configurar tu AdMob unidad de anuncios, necesitarás la clave del SDK y la clave del informe de AppLovin. Para encontrarlas, ve a la IU de AppLovin > Account > Keys para ver ambos valores.

Si solo planeas integrar la licitación, puedes continuar con la configuración de la mediación.

Seleccionar aplicación para la mediación

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

En la IU de AppLovin, selecciona Applications en la sección Monetization para acceder a tus apps registradas. Selecciona la app que quieres usar con la mediación de la lista de apps disponibles.

Crear una zona

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

En la IU de AppLovin, selecciona Zones en la sección Monetization para obtener los IDs de tus zonas registradas. Si ya creaste las zonas requeridas para tu app, avanza al Paso 2. Para crear un ID de zona nuevo, haz clic en Crear zona.

Ingresa el nombre del ID de zona, selecciona Android como la Plataforma y elige el tipo de anuncio.

Configura la opción Precios para la zona. Para ello, selecciona CPM plano o, también, Optimizado por AppLovin. Los CPM se pueden configurar por país para la opción CPM plano. Luego, haz clic en Guardar.

Android

iOS

Una vez creada la zona, el ID de zona se puede encontrar en la columna ID de zona.

Android

iOS

Activar el modo de prueba

Sigue las instrucciones en la guía MAX Test Mode de AppLovin sobre cómo habilitar los anuncios de prueba de AppLovin.

Paso 2: Configura la demanda de AppLovin en la AdMob IU

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

Android

Para obtener instrucciones, consulta el paso 2 de la guía para Android.

iOS

Si quieres obtener instrucciones, consulta el paso 2 de la guía para iOS.

Se agregó AppLovin Corp. a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración del GDPR y Configuración de las reglamentaciones estatales de EE.UU. para agregar AppLovin Corp. a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la AdMob IU.

Paso 3: Importa el SDK de AppLovin y el adaptador

OpenUPM-CLI

Si tienes OpenUPM-CLI instalada, puedes instalar la AppLovin de Google Mobile Ads Complemento de mediación para Unity a tu proyecto ejecutando el siguiente comando desde el directorio raíz de tu proyecto:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

En el editor de proyectos de Unity, selecciona Edit > Configuración del proyecto > Administrador de paquetes para abrir la Configuración de Unity Package Manager.

En la pestaña Registros con alcance (Scoped Registries), agrega OpenUPM como un registro con alcance. los siguientes detalles:

  • Nombre: OpenUPM
  • URL: https://package.openupm.com
  • Alcances: com.google

Detalles de OpenUPM

Luego, navega a Window > Administrador de paquetes para abrir la Unity Package Manager y Seleccione Mis registros en el menú desplegable.

Registros de Unity

Selecciona la opción de mediación de AppLovin de Google Mobile Ads para Unity y haz clic en Install.

Instalar desde OpenUPM

Paquete de Unity

Descarga la versión más reciente del complemento de mediación de anuncios de Google para dispositivos móviles para AppLovin en el vínculo de descarga Registro de cambios y extrae el GoogleMobileAdsAppLovinMediation.unitypackage del archivo ZIP.

En el editor de tu proyecto de Unity, selecciona Assets > Importar paquete > Custom Package y busca el GoogleMobileAdsAppLovinMediation.unitypackage que descargaste. Asegúrate de que todos los archivos estén seleccionados y haz clic en Importar.

Importar desde Unity

Luego, selecciona Recursos > Agente de resolución de Servicios de Play > Agente de resolución de Android > Fuerza la resolución. El agente de resolución de Play Services de Unity biblioteca realizará la resolución de dependencias desde cero y copiará el declaraste las dependencias en el directorio Assets/Plugins/Android de tu App para Unity.

Forzar resolución

Paso 4: Implementa la configuración de privacidad en el SDK de AppLovin

Según el Consentimiento de Usuarios de la UE de Google política, debe asegurarse de que se proporcionen ciertas divulgaciones los consentimientos obtenidos de los usuarios del Espacio Económico Europeo (EEE) en relación con el uso de identificadores de dispositivos y datos personales. Esta política refleja el requisitos de la Directiva de Privacidad Electrónica y de la Protección General de Datos Reglamento General de Protección de Datos (RGPD). Cuando solicite el consentimiento, debe identificar cada red de publicidad de tu cadena de mediación que recopilen, reciban o usen datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.

Desde el complemento de mediación de anuncios de Google para dispositivos móviles versión 7.0.0, AppLovin permite leer la cadena de consentimiento desde las preferencias compartidas y la configuración el estado de consentimiento según corresponda.

Si eres no utiliza el complemento de mediación de Google Mobile Ads para Applovin versión 7.0.0 o posterior no usen una CMP que escriba la cadena de consentimiento en el recurso compartido preferencias, puedes usar AppLovin.SetHasUserConsent() y AppLovin.SetIsAgeRestrictedUser() . En el siguiente código de muestra, se muestra la manera para pasar la información de consentimiento al SDK de AppLovin. Se deben definir estas opciones antes de inicializar el SDK de anuncios de Google para dispositivos móviles para asegurarte de que se reenvíen correctamente al SDK de AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

Además, si se sabe que el usuario está en una categoría con restricción de edad, puedes establece también la siguiente marca en true.

AppLovin.SetIsAgeRestrictedUser(true);

Consulta la configuración de privacidad de AppLovin para obtener más información.

Leyes de privacidad estatales de EE.UU.

EE.UU. leyes de privacidad estatales deben brindar a los usuarios los permisos para inhabilitar la "oferta" de su "información personal" (como lo define la ley condiciones), con la opción de inhabilitación ofrecida por medio de un mensaje destacado "No vender Información" el vínculo en la página la página de inicio del grupo. El EE.UU. privacidad de estados en la guía de cumplimiento de leyes ofrece la posibilidad de habilitar procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada anuncio en tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad de su cadena de mediación que puedan participar en la venta de información y seguir las indicaciones de cada una de esas redes para garantizar y cumplimiento.

El complemento de mediación de Google Mobile Ads para AppLovin Versión 6.3.1 incluye el AppLovin.SetDoNotSell() . En el siguiente código de ejemplo, se muestra cómo pasar la información de consentimiento al SDK de AppLovin. Debes definir estas opciones antes de para inicializar los anuncios de Google para celulares. SDK para asegurarte de que se reenvíen correctamente al SDK de AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

Consulta Privacidad de AppLovin documentación para obtener más información.

Paso 5: Agrega el código requerido

Android

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

iOS

Integración de SKAdNetwork

Sigue la documentación de AppLovin para agregar los identificadores de SKAdNetwork al archivo Info.plist` de tu proyecto.

Paso 6: Prueba tu implementación

Habilitar anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en AdMob y habilitar el modo de prueba en la AppLovin IU.

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba deAppLovin, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la AppLovin (Bidding) and AppLovin (Waterfall) fuente de anuncios.

Pasos opcionales

Optimizaciones

Agregar una llamada a AppLovin.Initialize() a tu actividad de lanzamiento proporciona AppLovin permite hacer un seguimiento de los eventos en cuanto se inicia la app.

Códigos de error

Si el adaptador no recibe un anuncio de AppLovin, los publicadores pueden verificar el error subyacente de la respuesta del anuncio ResponseInfo en el siguientes clases:

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Estos son los códigos y los mensajes adjuntos que arroja el adaptador de AppLovin. Cuando un anuncio no se carga:

Android

Código de error Motivo
De -1009 a -1, 204 El SDK de AppLovin mostró un error. Consulta Documentación de AppLovin para obtener más información.
101 El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con AppLovin.
103 El contexto es nulo.
104 El token de oferta de AppLovin está vacío.
105 Se solicitaron varios anuncios para la misma zona. AppLovin solo puede cargar 1 anuncio a la vez por zona.
106 El anuncio no está listo para mostrarse.
108 El adaptador AppLovin no admite el formato de anuncio que se solicita.

iOS

Código de error Motivo
De -1009 a -1, 204 El SDK de AppLovin mostró un error. Consulta la documentación de AppLovin para obtener más información.
101 El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con AppLovin.
102 Faltan los parámetros del servidor AppLovin configurados en la IU de AdMob o no son válidos.
103 No se pudo mostrar el anuncio de AppLovin.
104 Se solicitaron varios anuncios para la misma zona. AppLovin solo puede cargar 1 anuncio a la vez por zona.
105 No se encontró la clave del SDK de AppLovin.
107 El token de oferta está vacío.
108 El adaptador AppLovin no admite el formato de anuncio que se solicita.
110 AppLovin envió una devolución de llamada de carga correcta, pero no cargó anuncios.

Registro de cambios del complemento de mediación de AppLovin Unity

Versión 7.4.0

Versión 7.3.1

Versión 7.3.0

Versión 7.2.2

Versión 7.2.1

Versión 7.2.0

Versión 7.1.0

Versión 7.0.1

Versión 7.0.0

Versión 6.9.1

Versión 6.9.0

Versión 6.8.0

Versión 6.7.0

Versión 6.6.0

Versión 6.5.1

Versión 6.5.0

Versión 6.4.3

Versión 6.4.2

Versión 6.4.1

Versión 6.4.0

Versión 6.3.1

Versión 6.3.0

Versión 6.2.1

Versión 6.2.0

Versión 6.1.0

Versión 6.0.0

Versión 5.1.3

Versión 5.1.2

Versión 5.1.1

Versión 5.1.0

Versión 5.0.0

Versión 4.8.1

Versión 4.8.0

Versión 4.7.0

Versión 4.6.2

Versión 4.6.1

Versión 4.6.0

Versión 4.5.8

Versión 4.5.7

Versión 4.5.6

Versión 4.5.5

Versión 4.5.4

Versión 4.5.3

Versión 4.5.2

Versión 4.5.1

Versión 4.5.0

Versión 4.4.1

Versión 4.4.0

Versión 4.3.0

Versión 4.2.0

  • Compatible con el adaptador de Android AppLovin versión 9.4.2.0.
  • Compatible con el adaptador de AppLovin para iOS versión 6.6.1.0.

Versión 4.1.0

  • Se actualizó el complemento para que sea compatible con la nueva API de anuncios recompensados en versión beta abierta.
  • Compatible con el adaptador de Android AppLovin versión 9.2.1.1.
  • Compatible con el adaptador de AppLovin para iOS versión 6.3.0.0.

Versión 4.0.0

  • Compatible con el adaptador de Android AppLovin versión 9.2.1.0.
  • Compatible con el adaptador de AppLovin para iOS versión 6.2.0.0.

Versión 3.1.2

  • Compatible con el adaptador de Android AppLovin versión 8.1.4.0.
  • Compatible con el adaptador de AppLovin para iOS versión 5.1.2.0.

Versión 3.1.1

  • Compatible con el adaptador de Android AppLovin versión 8.1.0.0.
  • Compatible con el adaptador de AppLovin para iOS versión 5.1.1.0.

Versión 3.1.0

  • Compatible con el adaptador de Android AppLovin versión 8.1.0.0.
  • Compatible con el adaptador AppLovin para iOS versión 5.1.0.0.

Versión 3.0.3

  • Compatible con el adaptador de Android AppLovin versión 8.0.2.1.
  • Compatible con el adaptador AppLovin para iOS versión 5.0.2.0.

Versión 3.0.2

  • Admite la versión 8.0.1 del SDK de AppLovin para Android.
  • Admite la versión 5.0.1 del SDK de AppLovin para iOS.

Versión 3.0.1

  • Admite la versión 8.0.0 del SDK de AppLovin para Android.
  • Admite la versión 5.0.1 del SDK de AppLovin para iOS.
  • Se agregó el método AppLovin.SetIsAgeRestrictedUser() para indicar si se sabe que el usuario está en una categoría con restricción de edad.

Versión 3.0.0

  • Admite la versión 8.0.0 del SDK de AppLovin para Android.
  • Admite la versión 5.0.1 del SDK de AppLovin para iOS.
  • Se agregó el método AppLovin.SetHasUserConsent() para reenviar la marca de consentimiento del usuario al SDK de AppLovin.

Versión 2.0.0

  • Compatible con la versión 7.8.6 del SDK de AppLovin para Android.
  • Admite la versión 5.0.1 del SDK de AppLovin para iOS.

Versión 1.2.1

  • Compatible con la versión 7.8.6 del SDK de AppLovin para Android.
  • Compatible con la versión 4.8.3 del SDK de AppLovin para iOS.

Versión 1.2.0

  • Compatible con la versión 7.8.5 del SDK de AppLovin para Android.
  • Compatible con la versión 4.8.3 del SDK de AppLovin para iOS.

Versión 1.1.0

  • Admite la versión 7.7.0 del SDK de AppLovin para Android.
  • Admite la versión 4.7.0 del SDK de AppLovin para iOS.

Versión 1.0.0

  • Primera versión
  • Admite la versión 7.4.1 del SDK de AppLovin para Android.
  • Admite la versión 4.4.1 del SDK de AppLovin para iOS.