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

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 con mediación, que abarcan las integraciones en cascada y de ofertas. 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 Android app.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas
Cascada
Formatos
Banner	¹
Intersticial
Recompensado
Nativo

¹ 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

Nivel de API 21 o versiones posteriores de Android

[Para ofertas]: Adaptador de AppLovin 9.4.2.0 o superior (versión recomendada más reciente)

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 AppLovin

Regístrate o accede a tu cuenta de AppLovin.

Para configurar tu Ad Manager 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.

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

Activar el modo de prueba

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

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

Accede a tu cuenta de Ad Manager.

Agregar AppLovin en Empresas

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Navega a Administrador > Empresas y, luego, haz clic en el botón Nueva empresa en la pestaña Todas las empresas. Selecciona Red de publicidad.

Selecciona AppLovin 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 Report Key que obtuviste en la sección anterior.

No es necesario que ingreses un nombre de usuario ni una contraseña. Haz clic en Save cuando termines.

Habilitar el uso compartido de indicadores seguros

Ofertas

Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange, revisa y activa Uso compartido de indicadores seguros. Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura las AppLovin ofertas

Ofertas

Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Ofertas de SDK.

Selecciona AppLovin como ofertante.

Activa Agregar la biblioteca de indicadores de este ofertante a la lista de indicadores permitidos y Permitir que se compartan indicadores con este ofertante. Luego, haz clic en Continuar.

Haz clic en Continuar.

Haz clic en Listo.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura la asignación de unidades de anuncios

Ofertas

Navega a Publicación > Ofertantes y selecciona la empresa deAppLovin en la pestaña Ofertas de SDK.

Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidades de anuncios.

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa losSDK Key obtenidos en la sección anterior. Por último, haz clic en Guardar.

Cascada

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento. Selecciona tu Aplicación para dispositivos móviles.

Desplázate hacia abajo y haz clic en Agregar socio de rendimiento.

Selecciona la empresa para la que creaste AppLovin en la sección anterior. 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 el Application ID of your app along with the SDK Key and the Zone ID obtenido en la sección anterior y el valor de CPM predeterminado. Haz clic en Guardar.

Nota: La recopilación automática de datos tarda algunos días en recopilar datos antes de poder calcular con precisión un valor de CPM dinámico para una red de mediación. Una vez que se puede calcular el eCPM, se actualiza automáticamente por ti.

Agregar 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 Ad Manager IU.

Paso 3: Importa el SDK de AppLovin y el adaptador

Integración de Android Studio (recomendada)

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

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

Integración manual

Descarga el SDK de AppLovin para Android, extrae el objeto applovin-sdk-x.y.z.jar y agrégalo a tu proyecto.
Ve a la sección Artefactos del adaptador AppLovin en el repositorio Maven de Google. Selecciona la versión más reciente, descarga al archivo .aar del adaptador AppLovin y agrégalo a tu proyecto.

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

Consentimiento para la UE y GDPR

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 la versión 12.0.0 del SDK, AppLovin admite la lectura de la cadena de consentimiento de preferencias compartidas y de configurar el estado de consentimiento según corresponda.

Si no usas la versión 12.0.0 o una posterior del SDK de AppLovin, o no usas una CMP que escriba la cadena de consentimiento preferencias compartidas , puedes usar setHasUserContent y setIsAgeRestrictedUser. En el siguiente código de muestra, se muestra cómo pasar información de consentimiento al SDK de AppLovin. Debes establecer estas opciones antes de inicializar SDK de anuncios de Google para dispositivos móviles para asegurarte de que se reenvíen correctamente al SDK de AppLovin.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context)

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.

Java

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Kotlin

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

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 SDK de AppLovin incluye el método setDoNotSell para permitir que los publicadores lo opten la venta de información personal.

El siguiente código de muestra indica cómo pasar esta información de consentimiento al SDK de AppLovin. Debes establecer estas opciones antes de inicializar SDK de anuncios de Google para dispositivos móviles para asegurarte de que se reenvíen correctamente al SDK de AppLovin.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setDoNotSell(true, context)

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

Paso 5: Agrega el código requerido

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

Paso 6: Prueba tu implementación

Habilitar anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en Ad Manager 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

Parámetros específicos de la red

El adaptador AppLovin admite setMuteAudio(), que puede inhabilitar el audio en anuncios de video. Se puede llamar a este método desde un objeto AppLovinExtras.Builder():

Java

Bundle extras = new AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter.class, extras)
   .build();

Kotlin

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Optimizaciones

Si inicializas el SDK de AppLovin en cuanto se lance tu app, AppLovin permite hacer un seguimiento de los eventos en cuanto se inicia la app.

Java

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk();

Kotlin

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk()

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.getAdapterResponses() en las siguientes clases:

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

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

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.
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.
102	Faltan los parámetros del servidor AppLovin configurados en la IU de Ad Manager 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.