Integra Bidmachine con la mediación

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

En esta guía, se muestra cómo usar GMA Next-Gen 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 Android.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas	^1
Cascada	^3
Formatos
Inicio de aplicación
Banner
Intersticial
Recompensado
Intersticial recompensado
Nativo	^2

¹ 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

• Nivel de API 24 o posterior de Android

• [Para la licitación]: Para integrar todos los formatos de anuncios admitidos en la licitación, usa el adaptador de BidMachine 3.4.0.1 o una versión posterior (se recomienda la versión más reciente).

• Lo más reciente de GMA Next-Gen 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.

Nota: BidMachine crea automáticamente una fuente para ti. Si quieres crear una nueva fuente, comunícate con tu administrador de cuentas.

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.

Completa el formulario y haz clic en Guardar.

Por último, toma nota del ID de posició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.

Importante: El ID de fuente se debe asociar a la app objetivo tal como se indica en la IU de BidMachine.

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.

Nota: Solo tienes que configurar la optimización de la fuente de anuncios una vez por red.

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.

Importante: El ID de fuente se debe asociar a la app objetivo tal como se indica en la IU de BidMachine.

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

Importante: Verifica que tengas permiso de administración de la cuenta para completar la configuración en relación con el RGPD y el consentimiento de usuarios de la UE; las reglamentaciones estatales de EE.UU., y User Messaging Platform. Para obtener más detalles, consulta Cómo administrar el acceso de los usuarios a tu cuenta.

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

Nota: Si no se integran las versiones compatibles del SDK de BidMachine y del SDK de anuncios de Google para dispositivos móviles, es posible que se produzcan problemas de compilación.

Integración de Android Studio (recomendada)

En el archivo Gradle a nivel de la app, agrega las siguientes dependencias de implementación y configuraciones:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.23.0-beta01")
    implementation("com.google.ads.mediation:bidmachine:3.5.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.23.0-beta01'
    implementation 'com.google.ads.mediation:bidmachine:3.5.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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 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 del 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 de los estados de EE.UU. exigen otorgar a los usuarios el derecho a rechazar la "venta" de su "información personal" (según la definición de esos términos en la ley), con la opción de rechazo ofrecida a través de un vínculo destacado con la leyenda "No vender mi 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 procesamiento 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 RGPP 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

No se requiere código adicional para la integración de BidMachine.

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 Android y habilita el modo de prueba de BidMachine.

Importante: Inhabilita el modo de prueba para AdMob y BidMachine antes de lanzar tu app.

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 NativeAd. Específicamente, completa los siguientes campos para un NativeAd.

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 ResponseInfo.getAdSourceResponses() en las siguientes clases:

io.bidmachine
com.google.ads.mediation.bidmachine

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
100	com.google.ads.mediation.bidmachine	Se recibió un ID de posición no válido o vacío.
101	com.google.ads.mediation.bidmachine	Error durante la recopilación de señales: No se encontró ninguna configuración de datos de señales.
102	com.google.ads.mediation.bidmachine	Se recibió un formato de anuncio no válido durante la recopilación de señales.
103	com.google.ads.mediation.bidmachine	No se pudo asignar el tamaño de anuncio solicitado a bidmachine.BannerSize
104	com.google.ads.mediation.bidmachine	Venció la solicitud de anuncio de BidMachine cargada.
105	com.google.ads.mediation.bidmachine	No se pudo mostrar el anuncio de pantalla completa.
106	com.google.ads.mediation.bidmachine	El SDK de BidMachine devolvió una devolución de llamada onAdLoaded() con datos del anuncio null.

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

Versión 3.5.1.1

• Se agregó compatibilidad para reenviar el parámetro tagForUnderAgeOfConsent del SDK de anuncios de Google para dispositivos móviles al SDK de BidMachine.

Se compiló y probó con lo siguiente:

• Versión 24.9.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 3.5.1 del SDK de BidMachine

Versión 3.5.1.0

• Se verificó la compatibilidad con la versión 3.5.1 del SDK de BidMachine.

Se compiló y probó con lo siguiente:

• Versión 24.9.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 3.5.1 del SDK de BidMachine

Versión 3.5.0.0

• Se verificó la compatibilidad con la versión 3.5.0 del SDK de BidMachine.

Se compiló y probó con lo siguiente:

• Versión 24.7.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 3.5.0 del SDK de BidMachine

Versión 3.4.0.1

• Se quitaron las referencias a nivel de la clase para los objetos Context para ayudar con los problemas de pérdida de memoria.
• Se actualizó el adaptador para admitir solicitudes de anuncios de banner que tengan un tamaño similar a sus formatos admitidos, en lugar de requerir una coincidencia exacta de tamaño.

Se compiló y probó con lo siguiente:

• Versión 24.7.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 3.4.0 del SDK de BidMachine

Versión 3.4.0.0

• Se agregó compatibilidad con la cascada para los formatos de anuncios de banner, intersticiales, recompensados y nativos.
• Ahora el adaptador reenvía onAdOpened() con onAdImpression() para los anuncios de pantalla completa.
• Se verificó la compatibilidad con la versión 3.4.0 del SDK de BidMachine.

Se compiló y probó con lo siguiente:

• Versión 24.6.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 3.4.0 del SDK de BidMachine

Versión 3.3.0.0

• Versión inicial

Se compiló y probó con lo siguiente:

• Versión 24.5.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 3.3.0 del SDK de BidMachine