Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Integra DT Exchange con la mediación

Selecciona la plataforma: Android iOS Unity Flutter Android (heredado)

Esta guía le muestra cómo usar Google Mobile Ads SDK para cargar y mostrar anuncios de DT Exchange usando Mediación de AdMob, cubriendo integraciones en cascada. Además, indica 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 en una app para iOS.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de DT Exchange ofrece las siguientes funciones:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos previos

Antes de continuar, verifica lo siguiente:

Objetivo de implementación de iOS 15.0 o posterior
[Para la licitación]: Usar el adaptador de DT Exchange 8.4.2.1 o una versión posterior (se recomienda la versión más reciente) para integrar todos los formatos de anuncios admitidos en la licitación

Es la versión más reciente de Google Mobile Ads SDK.
Configura la Mediación de AdMob.

Paso 1: Establece los parámetros de configuración en la IU de DT Exchange

Agregar nueva aplicación y ubicación de anuncios

Regístrese o inicie sesión en la consola de DT Exchange.

Haz clic en Add App (Agregar aplicación).

Administrar aplicaciones

Elige tu plataforma y tus posiciones, completa el resto del formulario y, luego, haz clic en Create app (Crear app).

Ingresa los nombres y selecciona los tipos de posiciones. Luego, haz clic en Save placement (Guardar posición).

Configuración

ID de la aplicación e ID de ubicación

Coloca el cursor sobre la barra de navegación izquierda para abrirla y, luego, haz clic en App Management (Administración de apps).

En la página App Management (Administración de apps), presta atención al App ID (ID de app) que aparece junto a tu app.

Selecciona tu app y navega a la pestaña Placements (Posiciones). Presta atención al Placement ID (ID de posición).

ID de posición

ID de publicador, clave del consumidor y secreto del consumidor

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

Observa el Publisher ID (ID de publicador), la Consumer Key (Clave de consumidor) y el Consumer Secret (Secreto de consumidor), ya que los necesitarás en el siguiente paso.

Actualiza tu archivo app-ads.txt

El archivo app-ads.txt de Authorized Sellers for Apps es una iniciativa de IAB Tech Lab que ayuda a garantizar que tu inventario de anuncios de aplicación solo se venda a través de los canales que identificaste como autorizados. Para evitar pérdidas significativas en los ingresos publicitarios, deberás implementar un archivo app-ads.txt. Si aún no lo hiciste, configura un archivo app-ads.txt para tu aplicación.

Para implementar app-ads.txt en DT Exchange, agrega DT a tu archivo app-ads.txt.

Paso 2: Configura la demanda de DT Exchange en la IU de AdMob

Configura los parámetros de la mediación para tu unidad de anuncios

Debes agregar DT Exchange a la configuración de mediación de tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. A continuación, navega a la pestaña Mediación. Si tiene un grupo de mediación existente que desea modificar, haga clic en el nombre de ese grupo de mediación para editarlo y pase a Agregar DT Exchange como fuente de anuncios.

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

Ingresa el formato de anuncios y la plataforma. Luego, haz clic en Continuar.

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación como Habilitado y haz clic en Agregar unidades de anuncios.

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

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

Agrega DT Exchange como fuente de anuncios

Ofertas

En la sección Fuentes de anuncios, busca la tarjeta Licitación y selecciona Agregar fuente de anuncios. Luego, selecciona DT Exchange.

Haga clic en Cómo firmar un acuerdo de asociación y establecer una asociación de licitación con DT Exchange.

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

Si ya tiene una asignación para DT Exchange, puede seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, introduzca el ID de aplicación y el ID de la colocación obtenidos en la sección anterior. Luego, haz clic en Listo.

Cascada

En la tarjeta Cascada de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios.

Seleccione DT Exchange y habilite el interruptor Optimize. Introduzca el ID de publicador, el Secreto de consumidor y la Clave de consumidor obtenidos en la sección anterior para configurar la optimización de la fuente de anuncios para DT Exchange. Luego ingrese un valor eCPM para DT Exchange y haga clic en Continuar.

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

A continuación, introduzca el ID de aplicación y el ID de la colocación obtenidos en la sección anterior. Luego, haz clic en Listo.

Nota: La optimización de la fuente de anuncios tarda algunos días en recopilar suficientes datos para calcular con precisión el eCPM de una red de mediación. Mientras tanto, el estado de optimización de la fuente de anuncios es PENDING, por lo que debes establecer manualmente un valor de eCPM para la red. Una vez que se pueda calcular el eCPM, la fuente de anuncios comenzará a actualizarlo automáticamente.

Agregar DT Exchange (Fyber Monetization) a la lista de socios publicitarios sujetos al RGPD y a las regulaciones estatales de EE. UU.

Siga los pasos en Configuración de reglamentos europeos y Configuración de regulaciones estatales de EE. UU. para agregar DT Exchange (Fyber Monetization) a la lista de socios publicitarios de reglamentos europeos y regulaciones estatales de EE. UU. en la interfaz de usuario de AdMob.

Paso 3: Importa el SDK y el adaptador de DT

Usa Swift Package Manager

Antes de continuar, debe tener instalada la versión mínima compatible del adaptador: 8.3.8.0.

Para agregar una dependencia de paquete a tu proyecto, sigue estos pasos:

En Xcode, navega a File > Add Package Dependencies….

En la instrucción que aparece, busca la siguiente URL del paquete:

https://github.com/googleads/googleads-mobile-ios-mediation-dtexchange.git

En Dependency Rule, selecciona Branch.
En el campo de texto, ingresa main.

Usar CocoaPods

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

pod 'GoogleMobileAdsMediationFyber'

Desde la línea de comandos, ejecuta lo siguiente:

pod install --repo-update

Integración manual

Descarga la última versión del SDK DT para iOS y enlaza el IASDKCore.xcframework.
Descarga la versión más reciente del adaptador de DT Exchange desde el vínculo de descarga en el Registro de cambios y vincula DTExchangeAdapter.xcframework en tu proyecto.

Paso 4: Implementar la configuración de privacidad en el SDK de DT

RGPD y consentimiento de usuarios de la UE

Para cumplir con la Política de Consentimiento de Usuarios de la UE de Google, debes divulgar cierta información a tus usuarios del Espacio Económico Europeo (EEE), el Reino Unido y Suiza, y obtener su consentimiento para el uso de cookies o cualquier otro tipo de almacenamiento local cuando sea obligatorio por ley, y para la recopilación, el uso compartido y el uso de datos personales para la personalización de anuncios. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y del Reglamento General de Protección de Datos (RGPD) de la UE. Tú eres responsable de verificar que el consentimiento se propague a cada fuente de anuncios de tu cadena de mediación. Google no puede pasar automáticamente a esas redes las selecciones de consentimiento de los usuarios.

A partir de la versión 8.3.1 del SDK de DT Exchange, DT Exchange lee automáticamente el consentimiento del RGPD establecido por las plataformas de administración de consentimiento que admiten la especificación del Consentimiento adicional de Google. Para obtener más información, consulta la guía de implementación del RGPD de DT Exchange.

Leyes de privacidad estatales de EE.UU.

Las leyes de privacidad estatales de EE.UU. exigen otorgar a los usuarios el derecho a inhabilitar la "venta" de su "información personal" (según la definición de esos términos en la ley), con la opción de hacerlo a través de un vínculo destacado que indique que no desean que se venda su 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 posibilidad de habilitar el tratamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar este parámetro de configuración a cada red de publicidad de 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 las instrucciones de cada una de esas redes para garantizar el cumplimiento.

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

Swift

IASDKCore.sharedInstance().ccpaString = usPrivacyStringDTExchangeMediationSwiftSnippets.swift

Reemplaza usPrivacyString por tu cadena de privacidad de EE.UU.

Objective-C

[[IASDKCore sharedInstance] setCCPAString:kUSPrivacyString];DTExchangeMediationObjectiveCSnippets.m

Reemplaza kUSPrivacyString por tu cadena de privacidad de EE.UU.

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

Paso 5: Agrega el código requerido

Implementa SKAdNetwork

Sigue la documentación de DT Exchange para agregar los identificadores de SKAdNetwork al archivo Info.plist de tu proyecto.

Paso 6: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para AdMob.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de DT Exchange, habilita la prueba de una única fuente de anuncios seleccionando las opciones de DT Exchange (ofertas) y DT Exchange (cascada) en el inspector de anuncios.

Pasos opcionales

Parámetros específicos de la red

El adaptador DT Exchange admite parámetros de solicitud adicionales que se pueden pasar al adaptador mediante GADMAdapterFyberExtras(). El adaptador busca las siguientes claves en el paquete:

Parámetros y valores de la solicitud
`setUserData` La edad, el género y el código postal del usuario.	`IAUserData`
`setMuteAudio`	Booleano. Silenciar o activar el sonido del vídeo

A continuación, se muestra un ejemplo de código para establecer estos parámetros de solicitud de anuncio:

Swift

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

let request = Request()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)DTExchangeMediationSwiftSnippets.swift

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;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];DTExchangeMediationObjectiveCSnippets.m

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

Códigos de error

Si el adaptador no recibe un anuncio de DT Exchange, puede verificar el error subyacente de la respuesta de solicitud de anuncio usando GADResponseInfo.adNetworkInfoArray en la siguiente clase:

GADMediationAdapterFyber

A continuación, se indican los códigos y los mensajes correspondientes que arroja el adaptador de DT Exchange cuando no se carga un anuncio:

Código de error	Motivo
0-10	El SDK de DT devolvió un error. Consulta la documentación para obtener más detalles.
101	Faltan o no son válidos los parámetros del servidor DT Exchange configurados en la interfaz de usuario de AdMob.
102	El tamaño del anuncio solicitado no coincide con un tamaño de banner admitido por DT Exchange.
103	No se pudo mostrar el anuncio porque el objeto publicitario ya se ha utilizado.
104	No se pudieron mostrar anuncios de DT Exchange porque el anuncio no está listo.
105	El SDK de DT devolvió un error de inicialización.