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 a fin de cargar y mostrar anuncios de AppLovin mediante la mediación, que abarca las integraciones en cascada y las licitaciones. Abarca cómo agregar AppLovin a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de AppLovin en una app de Unity.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas
Cascada
Formatos
Banner  1
Intersticial
Recompensado

Los anuncios de banner (excepto los banners de MREC) solo se admiten en la mediación. Las ofertas no admiten ningún tipo de anuncio de banner.

Requisitos

  • Unity 5.6 o versiones posteriores
  • Versión más reciente del SDK de anuncios de Google para dispositivos móviles
  • [Para ofertas]: Complemento de mediación de Google Mobile Ads para AppLovin 4.2.0 o una versión posterior (se recomienda la versión más reciente)
  • Para implementar en Android, haz lo siguiente:
    • Nivel de API de Android 19 o versiones posteriores
  • Para implementar en iOS, haz lo siguiente:
    • Objetivo de implementación de iOS 12.0 o posterior
  • Un proyecto de Unity operativo configurado con el SDK de anuncios de Google para dispositivos móviles. Consulta Cómo comenzar para obtener información detallada.
  • Completa la guía de introducción de la mediación.

Paso 1: Establece parámetros de 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.

Agregar AppLovin Corp. a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR

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 y el adaptador de AppLovin

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

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

Luego, selecciona Assets > Play Services Resolver > Android Resolver > Force Resolve. La biblioteca de resolución de Servicios de Play de Unity resolverá las dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de la app de Unity.

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

Según la Política de Consentimiento de Usuarios de la UE de Google, debes asegurarte de que se proporcionen ciertas divulgaciones a los usuarios del Espacio Económico Europeo (EEE) y el consentimiento de estos respecto del uso de datos personales y identificadores de dispositivos. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y el Reglamento General de Protección de Datos (GDPR) de la UE. Cuando solicites el consentimiento, debes identificar cada red de publicidad en tu cadena de mediación que pueda recopilar, recibir o usar 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 la versión 7.0.0 del complemento de mediación de Google Mobile Ads para dispositivos móviles, AppLovin admite la lectura de la cadena de consentimiento de las preferencias compartidas y la configuración del estado de consentimiento según corresponda.

Si no usas el complemento de mediación de Google Mobile Ads para la versión 7.0.0 o una posterior de Applovin, o no usas una CMP que escriba la cadena de consentimiento en las preferencias compartidas, puedes usar los métodos AppLovin.SetHasUserConsent() y AppLovin.SetIsAgeRestrictedUser(). En el siguiente código de muestra, se indica cómo pasar información de consentimiento al SDK de AppLovin. Debes configurar estas opciones antes de inicializar el SDK de anuncios de Google para dispositivos móviles a fin de garantizar 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 pertenece a una categoría con restricción de edad, también puedes establecer la siguiente marca como true.

AppLovin.SetIsAgeRestrictedUser(true);

Para obtener más información, consulta la configuración de privacidad de AppLovin.

Leyes de privacidad estatales de EE.UU.

Leyes de privacidad estatales de EE.UU. exigen otorgar a los usuarios el derecho a rechazar la "venta" de su "información personal" (según la definición de esos términos en la ley), con un vínculo destacado "No vender mi información personal" en la página principal del vendedor. La guía de cumplimiento de las leyes de privacidad estatales de EE.UU. ofrece la capacidad de habilitar el procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada red de publicidad de la cadena de mediación. Por lo tanto, debes identificar cada red de publicidad en tu cadena de mediación que pueda participar en la venta de información personal y seguir las instrucciones de cada una de esas redes para garantizar el cumplimiento.

El complemento de mediación de Google Mobile Ads para AppLovin versión 6.3.1 incluye el método AppLovin.SetDoNotSell(). En el siguiente código de muestra, se indica cómo pasar información de consentimiento al SDK de AppLovin. Debes configurar estas opciones antes de inicializar el SDK de anuncios de Google para dispositivos móviles a fin de garantizar que se reenvíen correctamente al SDK de AppLovin.

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

AppLovin.SetDoNotSell(true);

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

Paso 5: Agrega el código obligatorio

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

Si agregas una llamada a AppLovin.Initialize() a tu actividad de inicio, AppLovin podrá realizar un seguimiento de los eventos en cuanto se inicie 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 mediante ResponseInfo en las 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 correspondientes que arroja el adaptador 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 la documentación de AppLovin para obtener más detalles.
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 AppLovin Adapter no es compatible con 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 detalles.
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 de 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 AppLovin Adapter no es compatible con el formato de anuncio que se solicita.
110 AppLovin envió una devolución de llamada de carga correcta, pero no cargó ningún anuncio.

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

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

  • Es compatible con la versión 9.4.2.0 del adaptador de Android AppLovin.
  • Compatible con la versión 6.6.1.0 del adaptador AppLovin iOS.

Versión 4.1.0

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

Versión 4.0.0

  • Es compatible con la versión 9.2.1.0 del adaptador de Android AppLovin.
  • Compatible con la versión 6.2.0.0 del adaptador AppLovin iOS.

Versión 3.1.2

  • Es compatible con la versión 8.1.4.0 del adaptador de Android AppLovin.
  • Compatible con la versión 5.1.2.0 del adaptador AppLovin iOS.

Versión 3.1.1

  • Es compatible con la versión 8.1.0.0 del adaptador de Android AppLovin.
  • Compatible con la versión 5.1.1.0 del adaptador AppLovin iOS.

Versión 3.1.0

  • Es compatible con la versión 8.1.0.0 del adaptador de Android AppLovin.
  • Compatible con la versión 5.1.0.0 del adaptador AppLovin iOS.

Versión 3.0.3

  • Compatible con la versión 8.0.2.1 del adaptador de Android AppLovin.
  • Compatible con la versión 5.0.2.0 del adaptador AppLovin iOS.

Versión 3.0.2

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

Versión 3.0.1

  • Compatible con la versión 8.0.0 del SDK de Android de AppLovin.
  • Compatible con 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 pertenece a una categoría con restricción de edad.

Versión 3.0.0

  • Compatible con la versión 8.0.0 del SDK de Android de AppLovin.
  • Compatible con 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 Android de AppLovin.
  • Compatible con 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 Android de AppLovin.
  • 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

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

Versión 1.0.0

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