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

Integra la monetización de efectividad 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 de AdMob, 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 iOS 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	^{1 3}
Banner	²
Intersticial
Recompensado
Intersticial recompensado	²
Nativo	²

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

² Ofertas La integración para este formato está en versión beta abierta.

³ Cascada La integración de este formato está en versión beta cerrada.

Requisitos

Objetivo de implementación de iOS 12.0 o superior
[Para ofertas]: Adaptador de monetización de Liftoff 6.11.0.1 o posterior (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 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 AdMob 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:

Aplicación abierta

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

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.

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.

Aplicación abierta

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 AdMob 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 AdMob IU

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

Debes agregar Liftoff Monetize a la configuración de mediación para tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. A continuación, ve a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en el nombre de ese grupo para editarlo y ve a Agregar Liftoff Monetize como fuente del anuncio.

Para crear un grupo de mediación nuevo, selecciona Crear grupo de mediación.

Ingresa el formato del anuncio y la plataforma y, luego, haz clic en Continuar.

Asígnale un nombre a tu grupo de mediación y selecciona las ubicaciones para la que deseas segmentar tus anuncios. A continuación, establece el estado del grupo de mediación en Habilitado y haz clic en Agregar bloques de anuncios.

Asocia este grupo de mediación a una o más de tusAdMob unidades de anuncios existentes. Luego, haga clic en Listo.

Ahora deberías ver la tarjeta Bloques de anuncios propagada con las unidades de anuncios que seleccionaste:

Agregar Liftoff Monetize como fuente del anuncio

Ofertas

En la tarjeta Ofertas de la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. Luego, selecciona Liftoff Monetize.

Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de licitación conLiftoff Monetize.

Haz clic en Confirmar y aceptar y, luego, en Continuar.

Si ya tienes una asignación para Liftoff Monetize, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el Application ID and Placement Reference IDobtenido en la sección anterior. Luego, haga clic en Listo.

Importante: Los Application ID deben estar asociados con la app de destino como en la IU deLiftoff Monetize .

Cascada

En la tarjeta Waterfall de la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. Luego, selecciona Liftoff Monetize.

Selecciona Liftoff Monetize y habilita el interruptor Optimizar. Ingresa el Reporting API Keyque obtuviste en la sección anterior para configurar la optimización de la fuente del anuncio paraLiftoff Monetize. Luego, ingresa un valor de eCPM para Liftoff Monetize y haz clic en Continuar.

Si ya tienes una asignación para Liftoff Monetize, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el Application ID and Placement Reference IDobtenido en la sección anterior. Luego, haga clic en Listo.

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 AdMob IU.

Paso 3: Importa el SDK de Vungle y el adaptador

Usando CocoaPods (recomendado)

Agrega la siguiente línea al Podfile de tu proyecto:
```
pod 'GoogleMobileAdsMediationVungle'
```
Desde la línea de comandos, ejecuta lo siguiente:
```
pod install --repo-update
```

Integración manual

Descarga la versión más reciente del SDK de Vungle. y vincula VungleSDK.framework en tu proyecto.
Descarga la versión más reciente del adaptador Liftoff Monetizar del de descarga en el Registro de cambios y vincula LiftoffMonetizeAdapter.framework en tu proyecto.
Agrega los siguientes frameworks a tu proyecto:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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.

Swift

import VungleAdsSDK
// ...

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

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setGDPRStatus:YES];
[VunglePrivacySettings setGDPRMessageVersion:@"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.

Swift

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setCCPAStatus:YES];

Consulte las instrucciones de implementación recomendadas en virtud 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

Integración de SKAdNetwork

Sigue la documentación de Liftoff Monetizar. 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 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 un parámetro de solicitud adicional que puede al adaptador con la clase VungleAdNetworkExtras. Esta clase incluye las siguientes propiedades:

userId: Una cadena que representa el ID de usuario incentivado de Liftoff Monetizar.
nativeAdOptionPosition: Es un número entero que especifica la posición del ícono de privacidad para los anuncios nativos.

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

Swift

#import "VungleAdapter.h"
// ...

let request = GADRequest()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = 1
// ...
request.register(extras)

Objective-C

#import <LiftoffMonetizeAdapter/VungleAdapter.h>
// ...

GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = 1;
// ...
[request registerAdNetworkExtras:extras];

Renderización de anuncios nativos

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

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 GADMediaView 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 GADResponseInfo.adNetworkInfoArray en las siguientes clases:

Formato	Nombre de clase
Banner	GADMAdapterVungleInterstitial
Intersticial	GADMAdapterVungleInterstitial
Recompensado	GADMAdapterVungleRewardBasedVideoAd

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 de `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 AdMob 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.