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

Integra la monetización en la mediación 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 Liftoff Monetizar con mediación, que abarcan integraciones de ofertas y en cascada. Abarca cómo agregar Liftoff Monetizar a la configuración de mediación de una unidad de anuncios y cómo integrar la El SDK de Vungle y el adaptador se convierten en una Android app.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas	¹
Cascada
Formatos
Aplicación abierta
Banner
Intersticial
Recompensado
Intersticial recompensado	³
Nativo	²

¹ Integración de ofertas se encuentra en versión beta abierta.

² Ofertas La integración de este formato está en versión beta cerrada.

³ Recompensado El anuncio intersticial requiere asistencia para configurarlo. Comunícate con tu cuenta gerente de Liftoff Monetizar o monetize@liftoff.io.

Requisitos

Nivel de API 21 o versiones posteriores de Android

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 monetización de Liftoff

Regístrate o accede a tu cuenta de Monetización de Liftoff.

Para agregar tu app al panel Monetización de Liftoff, haz clic en el botón Add Application.

Completa el formulario y, luego, ingresa todos los detalles necesarios.

Una vez que se haya creado tu app, selecciónala en el panel de Liftoff Monetizar aplicaciones.

Anota el ID de app.

Agregar posiciones nuevas

Si deseas crear una posición nueva para usarla con la Ad Manager mediación, navega al panel de Monetización de Posiciones de Liftoff, haz clic en el botón Agregar posición y selecciona tu app en la lista desplegable.

A continuación, se incluyen los detalles para agregar nuevas posiciones:

Banner

Selecciona Banner, ingresa un Nombre de posición y completa el resto del formulario. [Solo ofertas] En Monetización, activa el interruptor Ofertas en la aplicación Enabled. Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Banner de 300 x 250

Selecciona MREC, ingresa un Nombre de la posición y completa el resto del formulario. [Solo ofertas] En Monetización, activa el interruptor Ofertas en la aplicación Enabled. Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Intersticial

Selecciona Intersticial, ingresa un Nombre de posición y completa el resto del formulario. [Solo ofertas] En Monetización, activa el interruptor Ofertas en la aplicación Enabled. Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Recompensado

Selecciona Recompensado, ingresa un nombre de posición en el campo Nombre de la posición y completa el resto del formulario. [Solo ofertas] En Monetización, activa el interruptor Ofertas en la aplicación Enabled. Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Anuncio intersticial recompensado

Selecciona Recompensado. Ingresa un Nombre de posición, habilita la opción Se puede omitir y completa el resto del formulario. [Solo ofertas] En Monetización, activa el interruptor Ofertas en la aplicación Enabled. Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Nativo

Selecciona Nativo, ingresa un nombre de posición en el campo Nombre de la posición y completa el resto del formulario. [Solo ofertas] En Monetización, activa el interruptor Ofertas en la aplicación Enabled. Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Toma nota del ID de referencia y haz clic en Suena bien.

Banner

Banner de 300 x 250

Intersticial

Recompensado

Anuncio intersticial recompensado

Nativo

Ubica tu clave de API de Reporting

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Además del ID de app y el ID de referencia, también necesitarás la clave de API de Liftoff de monetización para configurar tu Ad Manager ID de unidad de anuncios. Navega al panel de Monetización de informes de Liftoff y haz clic en el botón Clave de API de Reporting para ver tu clave de API de Reporting.

Activar el modo de prueba

Para habilitar los anuncios de prueba, ve al panel Monetizar de Liftoff y navega a Applications.

Selecciona la app para la que quieras habilitar los anuncios de prueba en la sección ID de referencia de posición de la app. Para habilitar los anuncios de prueba, selecciona Modo de prueba como Mostrar solo anuncios de prueba en la sección Estado.

Paso 2: Configura la demanda de monetización de Liftoff en la Ad Manager IU

Accede a tu cuenta de Ad Manager.

Agregar Liftoff Monetize 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 Liftoff Monetize 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 Reporting API 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 Liftoff Monetize ofertas

Ofertas

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

Selecciona Liftoff Monetize 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 deLiftoff Monetize 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 losApplication ID and Placement Reference ID 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 Liftoff Monetize 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 and Placement Reference 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 Liftoff 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 Liftoff 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 Vungle 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 Vungle y adaptador:

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

Integración manual

Descarga el SDK de Vungle para Android más reciente. Luego, extrae los archivos .jar de la carpeta libs y agrégalos a tu en un proyecto final.
Navega a Artefactos de adaptador de monetización de retirada. en el repositorio Maven de Google. Selecciona la versión más reciente y descarga Vungle. .aar de tu adaptador y agrégalo a tu proyecto.

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

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.

Liftoff Monetizar incluye una API que te permite pasar el consentimiento al SDK de Vungle. El siguiente código de muestra indica cómo pasar esta información de consentimiento al SDK de Vungle. Si decides llamar a este método, te recomendamos que lo hagas. antes de solicitar anuncios a través del SDK de anuncios de Google para dispositivos móviles.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

Consulte las instrucciones de implementación recomendadas para el GDPR. para obtener más información y conocer los valores que se pueden proporcionar en el método.

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.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

Consulte Implementación de la CCPA para obtener más información y conocer los valores que se pueden proporcionar en el método.

Paso 5: Agrega el código requerido

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

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 Liftoff Monetize IU.

Cómo verificar los anuncios de prueba

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

Pasos opcionales

Parámetros específicos de la red

El adaptador de monetización de Liftoff admite la siguiente solicitud adicional parámetros que se pueden pasar al adaptador:

userId: Una cadena que representa el ID de usuario incentivado de Liftoff Monetizar.
adOrientation: Es un número entero que especifica la orientación de la presentación para los anuncios de pantalla completa.

A continuación, se incluye un ejemplo de código para crear una solicitud de anuncio que establezca estos parámetros:

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

Renderización de anuncios nativos

El adaptador de monetización de Liftoff muestra sus anuncios nativos como NativeAd objetos. Propaga los siguientes elementos campos durante un NativeAd.

Campo	Los elementos siempre se incluyen en el adaptador de monetización de Liftoff.
Título
Imagen	1
Vista de medios
Cuerpo
Ícono de la aplicación
Llamado a la acción
Calificación por estrellas
Tienda
Precio

¹ La monetización de despegue adaptador no proporciona acceso directo al recurso de imagen principal de su anuncios. En cambio, el adaptador propaga MediaView con un video o una imagen.

Códigos de error

Si el adaptador no recibe un anuncio de Liftoff Monetizar, los editores pueden verifica el error subyacente de la respuesta del anuncio con ResponseInfo.getAdapterResponses() en las siguientes clases:

Formato	Nombre de clase
Banner	com.vungle.mediation.VungleInterstitialAdapter
Intersticial	com.vungle.mediation.VungleInterstitialAdapter
Recompensado	com.vungle.mediation.VungleAdapter

Estos son los códigos y los mensajes adjuntos que arroja la función de monetización de Liftoff cuando un anuncio no se carga:

Código de error	Dominio	Motivo
0-100	com.vungle.warren	El SDK de Vungle mostró un error. Ver el documento para obtener más información.
101	com.google.ads.mediation.vungle	Parámetros de servidor no válidos (p.ej., ID de aplicación o ID de posición).
102	com.google.ads.mediation.vungle	El tamaño de banner solicitado no se asigna a un anuncio de monetización de Liftoff válido. de tamaño del ensamble.
103	com.google.ads.mediation.vungle	La monetización de despegue requiere un contexto `Activity` para solicitar anuncios.
104	com.google.ads.mediation.vungle	El SDK de Vungle no puede cargar varios anuncios para la misma posición ID.
105	com.google.ads.mediation.vungle	No se pudo inicializar el SDK de Vungle.
106	com.google.ads.mediation.vungle	El SDK de Vungle mostró una devolución de llamada de carga correcta, pero Banners.getBanner() o Vungle.getLiveData() mostraron un valor nulo.
107	com.google.ads.mediation.vungle	El SDK de Vungle no está listo para reproducir el anuncio.
1-100	Enviado por el SDK de Vungle	El SDK de Vungle mostró un error. Ver código para obtener más información.
101	com.google.mediation.vungle	Faltan los parámetros del servidor de monetización de despegue configurados en la IU Ad Manager o no son válidos.
102	com.google.mediation.vungle	Ya se cargó un anuncio para esta configuración de red. El SDK de Vungle no puede Carga un segundo anuncio para el mismo ID de posición.
103	com.google.mediation.vungle	El tamaño de anuncio solicitado no coincide con un banner compatible con la monetización de Liftoff. de tamaño del ensamble.
104	com.google.mediation.vungle	El SDK de Vungle no pudo renderizar el anuncio de banner.
105	com.google.mediation.vungle	El SDK de Vungle solo admite cargar 1 anuncio de banner a la vez, independientemente del ID de la posición.
106	com.google.mediation.vungle	El SDK de Vungle envió una devolución de llamada que indica que el anuncio no se puede reproducir.