Cómo integrar DT Exchange con mediación

Nota: Fyber Marketplace ahora es DT Exchange.

En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de DT Exchange mediante la mediación, que abarca las integraciones en cascada. Se explica cómo agregar DT Exchange a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de DT Exchange en una app de iOS .

Integraciones admitidas y formatos de anuncios

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

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Código nativo

Requisitos

• Objetivo de implementación para iOS 10.0 o versiones posteriores

• SDK de anuncios de Google para dispositivos móviles más reciente

Paso 1: Configura DT Exchange

Agregar nueva ubicación de la aplicación y del anuncio

Regístrate o accede a la consola de Exchange DT.

Haz clic en el botón Agregar app para agregar tu app.

Selecciona iOS en Plataforma, completa el resto del formulario y haz clic en Agregar posiciones.

Ingresa un nombre para la ubicación nueva en el campo Asigna un nombre a tu posición y selecciona el Tipo de posición que desees de la lista desplegable. Por último, haz clic en Guardar posición.

ID de aplicación e ID de posición

Desplácese con el mouse sobre la barra de navegación izquierda para abrirla. Luego, haz clic en Apps en el menú de la izquierda.

En la página App Management, anota el ID de la app que aparece junto a tu app.

Selecciona tu app, navega a la pestaña Posiciones y haz clic en el ícono de copiar junto a Nombre de la posición. Toma nota del ID de posición.

ID de publicador, clave de consumidor y secreto del consumidor

Haz clic en tu nombre de usuario en el menú de la izquierda y selecciona Perfil de usuario.

Toma nota del ID de publicador, la clave del consumidor y el secreto del consumidor, ya que son necesarios en el siguiente paso.

Paso 2: Establezca la configuración de mediación en su AdMob bloque de anuncios

Debe agregar DT Exchange a la configuración de mediación de su bloque de anuncios.

Primero, acceda a su cuenta de AdMob. A continuación, navega 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 de mediación para editarlo y continúa con la sección Agrega DT Exchange como fuente del anuncio.

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

Ingrese el formato del anuncio y la plataforma y, luego, haga clic en Continuar.

Asigne un nombre a su grupo de mediación y seleccione las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación en Enabled y haz clic en Add Ad Units.

Asocie este grupo de mediación con uno o más de sus bloques de anuncios de AdMob existentes. Luego, haga clic en Listo.

Ahora debería ver la tarjeta de bloques de anuncios propagada con los bloques de anuncios que seleccionó.

Agregar DT Exchange como fuente del anuncio

En la tarjeta Cascada, seleccione Agregar fuente del anuncio.

Seleccione DT Exchange y debería ir a Agregar fuente del anuncio: DT Exchange.

Habilite la opción Optimizar. Luego, ingresa el ID de publicador, la clave del consumidor y el secreto del consumidor que obtuviste en la sección anterior.

Revisa y marca la casilla de verificación Authorization a fin de configurar la optimización de la fuente del anuncio para DT Exchange. Ingrese un valor de eCPM para DT Exchange y haga clic en Continuar.

Ingresa el ID de aplicación y el ID de posición que obtuviste en la sección anterior y haz clic en Listo.

Nota: La optimización de la fuente del anuncio tarda unos días en recopilar datos suficientes a fin de calcular el eCPM de forma adecuada para una red de mediación. Mientras tanto, el estado de optimización de la fuente del anuncio es PENDING, por lo que debes establecer un valor de eCPM de forma manual para la red. Una vez que se calcula el eCPM, la fuente del anuncio comienza a actualizar el eCPM automáticamente.

Anuncios recompensados

En la configuración de tu bloque de anuncios recompensados, proporciona valores para el importe y el tipo de recompensa. Para proporcionar la misma recompensa al usuario sin importar qué red de publicidad se publique, selecciona la casilla Aplicar a todas las redes en los grupos de mediación.

Si no aplicas esta configuración, el adaptador de DT Exchange le devolverá la recompensa especificada en el panel de DT Exchange cuando cree la posición.

Para obtener más información sobre cómo establecer valores de recompensa para los bloques de anuncios de AdMob, consulta Cómo crear un bloque de anuncios.

Paso 3: Importa el adaptador y el SDK de Exchange de DT

Uso de CocoaPods (recomendado)

Agrega la siguiente línea al Podfile de tu proyecto:

pod 'GoogleMobileAdsMediationFyber'

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 Exchange de iOS para iOS y vincula los siguientes frameworks a tu proyecto:
  • IASDKCore.framework
  • IASDKMRAID.framework
  • IASDKVideo.framework
• Descarga la versión más reciente del adaptador de DT Exchange desde el vínculo de descarga de Registro de cambios y el vínculo FyberAdapter.framework de tu proyecto.
• Agrega los siguientes marcos de trabajo a tu proyecto:
  • libxml2.2.tbd

Pasos opcionales

Consentimiento de la UE y GDPR

Según la Política de Consentimiento de Usuarios de la UE de Google, debe asegurarse de que se proporcionen ciertas divulgaciones y consentimientos obtenidos de usuarios del Espacio Económico Europeo (EEE) relacionados con el uso de identificadores personales y datos personales. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica de la UE y el Reglamento General de Protección de Datos (GDPR). Cuando solicites consentimiento, debes identificar cada red publicitaria de tu cadena de mediación que pueda recopilar, recibir o usar datos personales y proporcionar información sobre el uso de cada red. Actualmente, Google no puede pasar la elección de consentimiento del usuario a esas redes automáticamente.

DT Exchange contiene una API que le permite reenviar el consentimiento del usuario a su SDK. En el siguiente código de muestra, se indica cómo pasar la información de consentimiento al SDK de DT Exchange de forma manual. Si eliges pasar la información de consentimiento de forma manual al SDK de Exchange de DT, se recomienda llamar a este código antes de solicitar anuncios a través del SDK de Google Mobile Ads.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective‑C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

Consulta la página de recursos del GDPR de DT Exchange y su Guía de implementación del GDPR para obtener más detalles y los valores que se pueden proporcionar en el método.

Agregar DT Exchange a la lista de socios publicitarios del GDPR

Sigue los pasos que se indican en Configuración del GDPR para agregar DT Exchange a la lista de socios de anuncios del GDPR en la AdMob IU.

CCPA

Ley de Privacidad del Consumidor de California (CCPA) requiere que los residentes del estado de California tengan el derecho de rechazar la “venta” de su “información personal” (según la definición de esas condiciones), con la opción de no participar mediante el vínculo destacado “No vender mi información personal” en la página principal del “vendedor”. La guía de preparación de la CCPA ofrece la posibilidad 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 en tu 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 la orientación de cada una de esas redes para garantizar el cumplimiento de la CCPA.

DT Exchange contiene una API que le permite reenviar el consentimiento del usuario a su SDK. En el siguiente código de muestra, se indica cómo pasar la información de consentimiento al SDK de DT Exchange de forma manual. Si eliges pasar la información de consentimiento de forma manual al SDK de Exchange de DT, se recomienda llamar a este código antes de solicitar anuncios a través del SDK de Google Mobile Ads.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective‑C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

Visita la página de recursos de la CCPA de DT Exchange y su Guía de implementación de la CCPA para obtener más detalles y los valores que se pueden proporcionar en el método.

Parámetros específicos de red

El adaptador de DT Exchange admite un parámetro adicional para pasar los datos del usuario como un objeto IAUserData al SDK de Exchange de DT.

A continuación, se incluye un ejemplo de código para configurar este parámetro:

Swift

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GADRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
request.register(extras)

Objective‑C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
[request registerAdNetworkExtras:extras];

Consulta la guía de integración de Exchange de DT para obtener más información.

Códigos de error

Si el adaptador no recibe un anuncio de DT Exchange, puedes verificar el error subyacente de la respuesta del anuncio mediante GADResponseInfo.adNetworkInfoArray en la siguiente clase:

GADMediationAdapterFyber

Estos son los códigos y los mensajes adjuntos que arroja el adaptador de DT Exchange cuando un anuncio no se carga:

Código de error	Razón
101	Faltan parámetros del servidor de DT Exchange configurados en la AdMob IU o estos no son válidos.
103	El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con DT Exchange.
105	El SDK de DT Exchange cargó un anuncio, pero mostró un control inesperado.
106	El anuncio no está listo para mostrarse.
200-399	El SDK de DT Exchange mostró un error. Consulta el código para obtener más detalles.
0-10	El SDK de DT Exchange mostró un error. Consulta la documentación para obtener más detalles.
101	Faltan parámetros del servidor de DT Exchange configurados en la AdMob IU o estos no son válidos.
102	El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con DT Exchange.
103	No se pudo mostrar el anuncio porque el objeto ya se usó.
104	No se pueden mostrar los anuncios de DT Exchange porque el anuncio no está listo.
105	El SDK de DT Exchange mostró un error de inicialización.

Registro de cambios del adaptador de mediación para iOS de DT Exchange

Versión 8.2.0.0

• Compatibilidad verificada con la versión 8.2.0 del SDK de DT Exchange

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 10.2.0.
• SDK de DT Exchange versión 8.2.0.

Versión 8.1.9.1

• Ahora requiere la versión 10.0.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 10.0.0.
• SDK de DT Exchange versión 8.1.9

Versión 8.1.9.0

• Se quitó el uso de las API obsoletas de mediación, ubicación y género.
• Compatibilidad verificada con la versión 8.1.9 del SDK de DT Exchange

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 9.14.0.
• SDK de DT Exchange versión 8.1.9

Versión 8.1.7.0

• Compatibilidad verificada con la versión 8.1.7 del SDK de DT Exchange
• Se modificó el nombre del adaptador por "DT Exchange".

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 9.13.0.
• SDK de DT Exchange versión 8.1.7

Versión 8.1.6.0

• Se agregó compatibilidad para pasar muteAudio adicionales en la clase GADMAdapterFyberExtras.
• Se actualizó el adaptador para usar la API de didRewardUser.
• Ahora requiere la versión 9.8.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.
• Compatibilidad verificada con la versión 8.1.6 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 9.11.0.
• SDK de Fyber Marketplace versión 8.1.6.

Versión 8.1.5.0

• Compatibilidad verificada con la versión 8.1.5 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 9.5.0.
• SDK de Fyber versión 8.1.5.

Versión 8.1.4.0

• Compatibilidad verificada con la versión 8.1.4 del SDK de Fyber Marketplace
• Se agregó compatibilidad con la arquitectura del simulador arm64.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 9.1.0.
• SDK de Fyber Marketplace versión 8.1.4.

Versión 8.1.3.1

• Compatibilidad verificada con la versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles
• Ahora requiere la versión 9.0.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 9.0.0.
• SDK de Fyber Marketplace versión 8.1.3.

Versión 8.1.3.0

• Compatibilidad verificada con la versión 8.1.3 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.13.0.
• SDK de Fyber Marketplace versión 8.1.3.

Versión 8.1.2.0

• Compatibilidad verificada con la versión 8.1.2 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.13.0.
• SDK de Fyber Marketplace versión 8.1.2.

Versión 8.1.1.0

• Compatibilidad verificada con la versión 8.1.1 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.12.0.
• SDK de Fyber Marketplace versión 8.1.1.

Versión 8.1.0.0

• Compatibilidad verificada con la versión 8.1.0 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.12.0.
• SDK de Fyber Marketplace versión 8.1.0.

Versión 8.0.0.0

• Compatibilidad verificada con la versión 8.0.0 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.12.0.
• SDK de Fyber Marketplace versión 8.0.0.

Versión 7.9.0.0

• Compatibilidad verificada con la versión 7.9.0 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.11.0.
• SDK Fyber Marketplace versión 7.9.0.

Versión 7.8.9.0

• Compatibilidad verificada con la versión 7.8.9 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.10.0.
• SDK Fyber Marketplace versión 7.8.9.

Versión 7.8.8.1

• Se movió el evento de anuncio didEndVideo a la devolución de llamada del anuncio recompensado IAAdDidReward.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.9.0.
• SDK de Fyber Marketplace versión 7.8.8.

Versión 7.8.8.0

• Ahora, se requiere la versión 10.0 de iOS como mínimo.
• Compatibilidad verificada con la versión 7.8.8 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.9.0.
• SDK de Fyber Marketplace versión 7.8.8.

Versión 7.8.7.0

• Compatibilidad verificada con la versión 7.8.7 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.8.0.
• SDK versión de Fyber Marketplace 7.8.7.

Versión 7.8.6.0

• Compatibilidad verificada con la versión 7.8.6 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.5.0.
• SDK versión 7.8.6 del SDK de Fyber.

Versión 7.8.5.0

• Compatibilidad verificada con la versión 7.8.5 del SDK de Fyber Marketplace
• Ahora requiere compilación en Xcode 12.5 o una versión posterior.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.5.0.
• SDK versión del SDK de Fyber 7.8.5.

Versión 7.8.1.0

• Compatibilidad verificada con la versión 7.8.1 del SDK de Fyber Marketplace
• Dependencia flexible para la versión 8.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles
• Se agregaron códigos y mensajes de error del adaptador estandarizado.
• Se actualizó el adaptador para usar el formato .xcframework.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 8.0.0.
• SDK versión 7.8.1 del SDK de Fyber.

Versión 7.8.0.0

• Compatibilidad verificada con la versión 7.8.0 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.69.0.
• SDK Fyber Marketplace versión 7.8.0.

Versión 7.7.3.0

• Compatibilidad verificada con la versión 7.7.3 del SDK de Fyber Marketplace
• Ahora, se requiere la versión 7.69.0 o una posterior del SDK de anuncios de Google para dispositivos móviles

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.69.0.
• SDK versión de Fyber Marketplace 7.7.3.

Versión 7.7.2.0

• Compatibilidad verificada con la versión 7.7.2 del SDK de Fyber Marketplace
• Ahora requiere la versión 7.67.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.67.0.
• SDK versión del SDK de Fyber 7.7.2.

Versión 7.7.1.0

• Compatibilidad verificada con la versión 7.7.1 del SDK de Fyber Marketplace
• Ahora, se requiere la versión 7.66.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.66.0.
• SDK de Fyber Marketplace versión 7.7.1.

Versión 7.6.4.0

• Compatibilidad verificada con la versión 7.6.4 del SDK de Fyber Marketplace
• Ahora, se requiere la versión 7.65.0 o una posterior del SDK de anuncios de Google para dispositivos móviles
• Se agregó la clase GADMAdapterFyberExtras, que permite a los publicadores pasar palabras clave y userData al SDK de Fyber Marketplace.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.65.0.
• SDK Fyber Marketplace versión 7.6.4

Versión 7.6.3.0

• Compatibilidad verificada con la versión 7.6.3 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.64.0.
• SDK Fyber Marketplace versión 7.6.3

Versión 7.6.2.0

• Compatibilidad verificada con la versión 7.6.2 del SDK de Fyber Marketplace
• Ahora, se requiere la versión 7.64.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.64.0.
• SDK versión de Fyber Marketplace 7.6.2.

Versión 7.6.0.0

• Compatibilidad verificada con la versión 7.6.0 del SDK de Fyber Marketplace
• Ahora, se requiere la versión 7.62.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.
• Se actualizó el adaptador para admitir solicitudes de banners adaptables intercalados.
• Se agregó compatibilidad con HTML recompensado.
• Se agregó una nueva devolución de llamada de recompensa: IAAdDidReward (para video recompensado y HTML recompensado). IAVideoCompleted ya no se usa para recompensar.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.62.0.
• SDK Fyber Marketplace versión 7.6.0.

Versión 7.5.6.1

• Se quitó temporalmente el registro específico del SDK de Fyber Marketplace.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.60.0.
• SDK versión 7.5.6 del SDK de Fyber.

Versión 7.5.6.0

• Compatibilidad verificada con la versión 7.5.6 del SDK de Fyber Marketplace
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a 7.60.0.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.60.0.
• SDK versión 7.5.6 del SDK de Fyber.

Versión 7.5.5.0

• Compatibilidad verificada con la versión 7.5.5 del SDK de Fyber Marketplace
• Se actualizó la versión mínima requerida del SDK de Google Mobile Ads a 7.59.0.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.59.0.
• SDK Fyber Marketplace versión 7.5.5

Versión 7.5.4.0

• Compatibilidad verificada con la versión 7.5.4 del SDK de Fyber Marketplace
• Se quitó la compatibilidad con la arquitectura i386.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.57.0.
• SDK versión 7.5.4 del SDK de Fyber.

Versión 7.5.3.0

• Compatibilidad verificada con la versión 7.5.3 del SDK de Fyber Marketplace

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.55.0.
• SDK versión 7.5.3 del SDK de Fyber.

Versión 7.5.1.0

• Compatibilidad verificada con la versión 7.5.1 del SDK de Fyber Marketplace
• Se solucionó una falla que ocurría cuando se inicializaba el SDK de Fyber.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.55.0.
• SDK versión del SDK de Fyber 7.5.1.

Versión 7.5.0.0 (obsoleta)

• Se quitó esta versión. Usa la versión 7.5.1.0 o posterior.
• Compatibilidad verificada con la versión 7.5.0 del SDK de Fyber Marketplace
• El adaptador ahora inicializará el SDK de Fyber antes de realizar una solicitud de anuncio si su SDK aún no se inicializó.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.53.0.
• SDK Fyber Marketplace versión 7.5.0.

Versión 7.4.0.0

• Versión inicial
• Se agregó compatibilidad con formatos de anuncios de banner, intersticiales y recompensados.

Compilado y probado con:

• SDK de anuncios de Google para dispositivos móviles versión 7.52.0.
• SDK Fyber Marketplace versión 7.4.0.