Integrar Meta Audience Network con la licitació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 Meta Audience Network con la mediación, lo que incluye la integración de licitaciones. Además, indica cómo agregar Meta Audience Network a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Meta Audience Network en una app para Android.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de Meta Audience Network ofrece las siguientes funciones:

¹ En 2021, Meta Audience Network se convirtió en una red de ofertas únicamente.
² Meta Audience Network no admite banners adaptables fijos ni intercalados.

Requisitos

• Última versión de GMA Next-Gen SDK

• Completar la guía de introducción a la mediación

• Nivel de API 24 o posterior de Android

• Adaptador de Meta Audience Network 5.10.0.0 o una versión posterior (se recomienda la versión más reciente)

Paso 1: Establece los parámetros de configuración en la IU de Meta Audience Network

Regístrate y accede a la página de inicio del Administrador de Negocio.

Haz clic en Comenzar y, luego, en Crear cuenta nueva.

Completa los campos obligatorios con los detalles de tu empresa y haz clic en Siguiente.

Crea una propiedad

Después de completar la información obligatoria, se te solicitará que crees una propiedad para tu aplicación. Ingresa el nombre deseado de la propiedad para tu aplicación y haz clic en Siguiente.

A continuación, selecciona la plataforma en la que deseas monetizar tu contenido.

Agrega los detalles de tu app y haz clic en Siguiente.

Haz clic en Agregar una cuenta de pagos nueva para configurar tu cuenta de pagos. Se te redireccionará a una nueva página para que ingreses tu información de pago. Completa los detalles necesarios y, luego, haz clic en Siguiente.

Selecciona Google Ad Manager como la Plataforma de mediación y, luego, haz clic en Crear posición.

Selecciona un formato, completa el formulario y haz clic en Crear.

Toma nota del ID de posición.

Haz clic en Listo.

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, crea un archivo app-ads.txt para Ad Manager.

Para implementar app-ads.txt en Meta Audience Network, consulta Cómo identificar vendedores autorizados con app-ads.txt.

Activa el modo de prueba

Consulta la guía para probar la implementación de Audience Network si necesitas instrucciones detalladas para habilitar los anuncios de prueba de Meta Audience Network.

Paso 2: Configura la demanda de Meta Audience Network en la IU de Ad Manager

Accede a tu cuenta de Ad Manager.

Habilita el uso compartido de indicadores seguros

Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange, revisa la opción Uso compartido de indicadores seguros y actívala. Haz clic en Guardar.

Comparte indicadores seguros en las solicitudes de oferta

Navega a Inventario > Indicadores seguros. En Indicadores seguros, busca Facebook y activa Habilitar integración para apps.

Haz clic en Guardar.

Permite el uso compartido de indicadores seguros para la Licitación mediante SDK

Navega a Publicación > Configuración del canal de demanda. En la pestaña Configuración predeterminada, activa Permitir el uso compartido de indicadores seguros para la Licitación mediante SDK.

Haz clic en Guardar.

Configura la Licitación de Meta

Navega a Publicación > Ofertantes y haz clic en Ir a la Licitación mediante SDK.

Haz clic en Nuevo ofertante.

Selecciona Meta como ofertante.

Haz clic en Continuar para habilitar la Licitación mediante SDK para este ofertante.

Haz clic en Listo.

Configura la asignación de unidades de anuncios

Navega a Publicación > Ofertantes y haz clic en Ir a la Licitación mediante SDK.

Selecciona la empresa para Meta Audience Network.

Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidad de anuncios.

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa el ID de posición que obtuviste en la sección anterior.

Si configuras la asignación de unidades de anuncios para un anuncio intersticial recompensado en la IU de Ad Manager, elige el formato Recompensado y usa el ID de posición intersticial recompensado.

Por último, haz clic en Guardar.

Se agregó Meta 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 conforme a los reglamentos europeos y Configuración de las reglamentaciones estatales de EE.UU. para agregar Meta a la lista de socios publicitarios que cumplen con los reglamentos europeos y las reglamentaciones estatales de EE.UU. en la IU de Ad Manager.

Paso 3: Importa el SDK y el adaptador de Meta Audience Network

Integración de Android Studio (recomendada)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

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

Integración manual

• Descarga la versión más reciente del SDK de Meta Audience Network para Android. Extrae el archivo AudienceNetwork.aar de la carpeta AudienceNetwork/bin y agrégalo a tu proyecto.

• Navega a los artefactos del adaptador de Meta Audience Network en el repositorio de Maven de Google. Selecciona la última versión, descarga el archivo .aar del adaptador de Meta Audience Network y agrégalo a tu proyecto.

Paso 4: Implementa la configuración de privacidad en el SDK de Meta Audience Network

RGPD y consentimiento de usuarios de la UE

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.

Meta no está registrado en la Lista de proveedores globales (GVL) de IAB Europe. En su lugar, debes usar la especificación técnica de Consentimiento adicional. Para obtener más detalles, consulta Componentes del Consentimiento adicional. La especificación de Consentimiento adicional funciona en conjunto con la versión 2 del Marco de trabajo de transparencia y consentimiento (MTC) de IAB Europe. Esta especificación te permite, junto con tus plataformas de administración de consentimiento (CMP) y socios, recopilar y transmitir indicadores de consentimiento complementarios para las empresas que figuran en la lista de proveedores de tecnología publicitaria (ATP) de Google, pero que aún no forman parte de la GVL de IAB Europe.

Sigue las orientaciones de la documentación de Meta sobre el RGPD y la publicidad de Meta.

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.

Sigue las instrucciones de la documentación de Meta sobre las opciones de procesamiento de datos para los usuarios de California.

Paso 5: Agrega el código requerido

No se requiere ningún código adicional para la integración de Meta Audience Network.

Paso 6: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para Ad Manager y habilitar el modo de prueba en la IU de Meta Audience Network.

Verifica los anuncios de prueba

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

Pasos opcionales

Anuncios nativos

Algunos recursos de los anuncios nativos de Meta Audience Network no se asignan de forma directa a los recursos de los anuncios nativos de Google. Estos recursos se envían de vuelta al publicador en un paquete a través del método getExtras() en NativeAd. El adaptador admite el paso de los siguientes recursos:

A continuación, se incluye un ejemplo de código que muestra cómo extraer estos recursos:

Ejemplo:

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Uso de anuncios nativos de Meta Audience Network sin un objeto MediaView

El formato de anuncio nativo de Meta Audience Network requiere la renderización del recurso MediaView. Si planeas renderizar anuncios nativos sin ese recurso, asegúrate de usar el formato de anuncio de banner nativo de Meta Audience Network.

Para usar los anuncios de banner nativos de Meta Audience Network, debes seleccionar el formato Native Banner cuando configures Meta Audience Network, y el adaptador cargará automáticamente el formato de anuncio nativo correspondiente.

Renderización de anuncios

El adaptador de Audience Network devuelve sus anuncios nativos como objetos NativeAd. Específicamente, completa los siguientes campos para un NativeAd.

¹ El adaptador de Meta Audience Network no proporciona acceso directo al recurso de imagen principal de sus anuncios nativos. En cambio, el adaptador completa la clase MediaView con un video o una imagen.

Seguimiento de impresiones y clics

En la siguiente tabla, se destaca cuándo GMA Next-Gen SDK registra las impresiones y los clics de los anuncios nativos.

Meta Audience Network tiene requisitos específicos de renderización de recursos para que una impresión se considere válida, según si seleccionaste el formato Nativo o Banner nativo cuando configuraste Meta Audience Network.

Almacenamiento en caché en Android 9

A partir de Android 9 (nivel de API 28), la compatibilidad con texto no encriptado está inhabilitada de forma predeterminada, lo que afectará la funcionalidad del almacenamiento en caché de contenido multimedia del SDK de Meta Audience Network y podría afectar la experiencia del usuario y los ingresos por anuncios. Sigue la documentación de Meta para actualizar la configuración de seguridad de red en tu app.

Códigos de error

Si el adaptador no recibe un anuncio de Audience Network, puedes verificar el error subyacente en la respuesta de solicitud de anuncio con ResponseInfo.getAdSourceResponses() en las siguientes clases:

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

A continuación, se indican los códigos y los correspondientes mensajes que arroja el adaptador de Audience Network cuando se produce un error al cargar un anuncio: