Integra BidMachine con la mediación

Selecciona la plataforma: Android (beta)

En esta guía, se muestra cómo usar Google Mobile Ads SDK para cargar y mostrar anuncios de BidMachine con la Mediación de AdMob, lo que incluye la integración de licitaciones. Además, indica cómo agregar BidMachine a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de BidMachine en una app para iOS.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de BidMachine ofrece las siguientes funciones:

Integración
Ofertas	¹
Cascada	³
Formatos
Inicio de aplicación
Banner
Intersticial
Recompensado
Intersticial recompensado
Nativo	²

¹ La integración de licitación se encuentra en versión beta cerrada. Para solicitar acceso, comunícate con tu administrador de cuentas.

² El formato del anuncio nativo está en versión alfa. Todos los demás formatos de anuncios admitidos están en versión beta. Comunícate con tu administrador de cuentas para solicitar acceso.

³ La integración en cascada se encuentra en versión beta cerrada. Para solicitar acceso, comunícate con tu administrador de cuentas.

Requisitos

Objetivo de implementación de iOS 13.0 o posterior

Lo más reciente de Google Mobile Ads SDK
Completar la guía de introducción a la mediación

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

Accede al panel de tu cuenta de BidMachine.

Crea posiciones nuevas

Navega a la pestaña Fuente y, en la tabla Fuentes, selecciona el botón Editar.

Panel de fuentes

Se te mostrará una lista de todas las posiciones que tienes. Para crear una posición nueva, haz clic en el botón Agregar posición del diálogo.

Diálogo Edit Source

Completa el formulario y haz clic en Guardar.

Crear posición

Por último, toma nota del ID de posición.

Detalles de la ubicación

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 todavía no lo hiciste, configura un archivo app-ads.txt para tu app.

Para implementar app-ads.txt en BidMachine, navega a la pestaña app-ads.txt desde el Panel. Luego, copia la lista y agrégala al archivo app-ads.txt de tu sitio web.

Paso 2: Configura la demanda de BidMachine en la IU de AdMob

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

Debes agregar BidMachine 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 tienes un grupo de mediación existente que deseas modificar, haz clic en su nombre para editarlo y pasa directamente a la sección Agrega BidMachine 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 BidMachine como fuente de anuncios

Ofertas

En la tarjeta Licitación de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona BidMachine.

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

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

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

A continuación, ingresa el ID de posición que obtuviste 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.

Selecciona BidMachine. Luego, ingresa un valor de eCPM para BidMachine y haz clic en Continuar.

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

A continuación, ingresa el ID de posición que obtuviste en la sección anterior. Luego, haz clic en Listo.

Agrega BidMachine a la lista de socios publicitarios que cumplen con el RGPD y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración de los reglamentos europeos y Configuración de las reglamentaciones estatales de EE.UU. para agregar BidMachine a la lista de socios publicitarios que cumplen con los reglamentos europeos y las reglamentaciones estatales de EE.UU. en la IU de AdMob.

Paso 3: Importa el SDK y el adaptador de BidMachine

CocoaPods (recomendado)

Agrega la siguiente línea al archivo Podfile de tu proyecto:
```
pod 'GoogleMobileAdsMediationBidMachine'
```
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 BidMachine para iOS y vincula todos los archivos .xcframework y los paquetes en tu proyecto.
Descarga la versión más reciente del adaptador de BidMachine desde el vínculo de descarga en el Registro de cambios y vincula BidMachineAdapter.xcframework en tu proyecto.

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

Para cumplir con la Política de Consentimiento de los 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 almacenamiento local cuando sea obligatorio por ley, y para la recopilación, el uso y el intercambio 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.

BidMachine lee automáticamente el consentimiento según el RGPD establecido por las plataformas de administración de consentimiento, incluido el SDK de UMP. Para obtener más información, consulta el RGPD.

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.

BidMachine lee automáticamente el consentimiento del GPP establecido por las plataformas de administración de consentimiento, incluido el SDK de UMP. Para obtener más información, consulta GPP.

Paso 5: Agrega el código requerido

Integración de SKAdNetwork

Sigue la documentación de BidMachine 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.

Sigue las instrucciones de la documentación de BidMachine para iOS y habilita el modo de prueba de BidMachine.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de BidMachine, habilita la prueba de una única fuente de anuncios seleccionando BidMachine (Bidding) en el inspector de anuncios.

Pasos opcionales

Anuncios nativos

Renderización de anuncios

El adaptador de BidMachine devuelve anuncios nativos como objetos GADNativeAd. Específicamente, completa los siguientes campos para un GADNativeAd.

Campo	Recursos que siempre incluye el adaptador de BidMachine
Título
Imagen
Cuerpo
Ícono
Llamado a la acción
Calificación por estrellas
Tienda
Precio
Anunciante

Códigos de error

Si el adaptador no recibe un anuncio de BidMachine, puedes verificar el error subyacente en la respuesta de solicitud de anuncio con GADResponseInfo.adNetworkInfoArray en las siguientes clases:

GADMediationAdapterBidMachine

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

Código de error	Dominio	Motivo
101	com.google.mediation.bidmachine	Falta un ID de publicador obligatorio en la configuración del servidor.
102	com.google.mediation.bidmachine	La solicitud de recopilación de indicadores de ofertas falló porque los parámetros de RTB no contienen un formato de anuncio o el formato especificado no es compatible.
103	com.google.mediation.bidmachine	La configuración del anuncio no es válida para cargar un anuncio.
104	com.google.mediation.bidmachine	El SDK de BidMachine devolvió un anuncio que no es de banner al método delegado `BidMachineAdProtocol didLoadAd` del anuncio de banner. Nunca debería ocurrir.
105	com.google.mediation.bidmachine	El anuncio de pantalla completa no está listo para mostrarse.
106	com.google.mediation.bidmachine	El SDK de Bid Machine devolvió un anuncio no nativo al método delegado `BidMachineAdProtocol didLoadAd` del anuncio nativo. Nunca debería ocurrir.
107	com.google.mediation.bidmachine	No se pudo cargar una de las fuentes de imágenes del anuncio nativo.

Registro de cambios del adaptador de mediación de BidMachine para iOS