Se usó la API de Cloud Translation para traducir esta página.

Integrar Meta Audience Network con la licitación

En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Meta Audience Network con la mediación y, que abarcan las integraciones de ofertas. En ella, se explica 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 Android app.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación para Meta Audience Network tiene las siguientes capacidades:

Integración
Ofertas
Cascada ¹
Formatos
Banner
Intersticial
Recompensado
Anuncio intersticial recompensado
Nativo

¹ Meta Audience Network se convirtió en solo ofertas en 2021.

Requisitos

SDK de anuncios de Google para dispositivos móviles más reciente
Completa la guía de introducción de mediación.

Android con nivel de API 21 o superior

Adaptador de Meta Audience Network 5.10.0.0 o versiones posteriores (se recomienda la versión más reciente)

Paso 1: Configura las opciones 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 una 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 requerida, se te solicitará que crees una propiedad para tu app. Ingresa el nombre que quieras para la propiedad de tu app y haz clic en Siguiente.

A continuación, selecciona la plataforma para monetizar.

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

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

Selecciona Google AdMob 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.

Activa el modo de prueba

Consulta la guía de prueba de la implementación de Audience Network para obtener instrucciones detalladas sobre cómo habilitar los anuncios de prueba de la red de público de Meta.

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

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.

Configura las ofertas de Meta

Ad Manager 360

Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Licitación mediante SDK.

Selecciona Meta como el ofertante.

Activa Agregar la biblioteca de indicadores de este ofertante a la lista de indicadores permitidos y Permitir que se compartan indicadores con este ofertante. Luego, haz clic en Continuar.

Haz clic en Continuar.

Haz clic en Listo.

Ad Manager

Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Licitación mediante SDK.

Selecciona Meta como el ofertante.

Haz clic en Integrar en línea ahora. Luego, haz clic en Sí, acepto en el diálogo para que se te redireccione al sitio de Facebook y comiences el proceso de integración.

Accede con tu cuenta de Administrador de Negocio.

Selecciona tu empresa.

Después de seleccionar tu empresa, aparecerá el siguiente diálogo. Haz clic en Volver a Ad Manager.

Haz clic en Continuar.

Haz clic en Listo.

Configura la asignación de unidades de anuncios

Navega a Publicación > Ofertantes y selecciona la empresa de Meta en la pestaña Licitación mediante SDK.

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 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. Por último, haz clic en Guardar.

Se agregó Meta a la lista de socios publicitarios del RGPD y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en la configuración del RGPD y en la configuración de las reglamentaciones estatales de EE.UU. para agregar Meta a la lista de socios publicitarios del RGPD y de 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 (recomendado)

En el archivo build.gradle.kts a nivel de la app, agrega las siguientes dependencias y configuraciones de implementación. Usa las versiones más recientes del SDK y el adaptador de la red de públicos de Meta:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:facebook:6.18.0.0")
}

Integración manual

Descarga la versión más reciente del SDK de Meta Audience Network para Android. Extrae AudienceNetwork.aar en 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 versión más reciente, descarga el archivo .aar del adaptador de la red de Meta Audience y agrégalo a tu proyecto.

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

Consentimiento de la UE y RGPD

Según la Política de Consentimiento de Usuarios de la UE de Google, debes asegurarte de que se realicen determinadas divulgaciones a los usuarios del Espacio Económico Europeo (EEE) y de obtener su consentimiento con respecto al uso de identificadores de dispositivos 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 (RGPD). Cuando solicites el consentimiento, debes identificar cada red de publicidad 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 automáticamente la elección de consentimiento del usuario a esas redes.

Sigue las instrucciones 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 de los estados de EE.UU. exigen que se les otorgue a los usuarios el derecho de inhabilitar la "venta" de su "información personal" (según la definición de esos términos que la ley establece). Para ello, se debe incluir un vínculo destacado con el texto "No vender mi información personal" en la página principal del "vendedor". La guía de cumplimiento de las leyes de privacidad de los estados 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 de 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 que se indican en la documentación de Meta para conocer las opciones de procesamiento de datos para los usuarios de California.

Paso 5: Agrega el código obligatorio

No se requiere 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 sola fuente del anuncio en el inspector de anuncios con las fuentes de anuncios de Meta Audience Network (ofertas).

Pasos opcionales

Anuncios nativos

Algunos recursos de anuncios nativos de la red de público de Meta no se asignan uno a uno a los recursos de anuncios nativos de Google. Estos activos se vuelven a pasar al publicador en un paquete a través del método getExtras() en NativeAd. El adaptador admite pasar los siguientes recursos:

Parámetros y valores de la solicitud
`FacebookMediationAdapter.KEY_ID`	Cadena. Un ID único del anuncio nativo
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	Cadena. El contexto social del anuncio

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

Ejemplo:

Java

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

Kotlin

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

Cómo utilizar anuncios nativos de Meta Audience Network sin un MediaView

El formato de anuncio nativo de la red de público de Meta requiere la renderización del recurso MediaView . Si planeas renderizar anuncios nativos sin ese recurso, asegúrate de usar el formato de anuncio 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 muestra sus anuncios nativos como objetos, NativeAd,. Se completan los siguientespara un NativeAd.

Campo	Lo completa el adaptador de Meta Audience Network
Título
Imagen	1
Cuerpo
Ícono de la aplicación
Llamado a la acción
Nombre del anunciante
Calificación por estrellas
Tienda
Precio

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

Seguimiento de impresiones y clics

En la siguiente tabla, se destaca cuándo el SDK de anuncios de Google para dispositivos móviles registra las impresiones y los clics de anuncios nativos.

Grabación de impresiones	Haz clic en la grabación.
1 px de recurso de anuncio nativo de Meta Audience Network en pantalla + requisitos de renderización de recursos	Llamada de devolución de llamada del SDK de Meta Audience Network

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.

Formato nativo de Meta Audience Network	Recurso obligatorio	Clase de renderización obligatoria
Nativo	Vista del contenido multimedia	`MediaView`
Banner nativo	Ícono de la aplicación	`ImageView`

Almacenamiento en caché en Android 9

A partir de Android 9 (nivel de API 28), la compatibilidad con texto simple 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 publicitarios. 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 de la respuesta del anuncio con ResponseInfo.getAdapterResponses() en las siguientes clases:

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

Estos son los códigos y los mensajes que genera el adaptador de Audience Network cuando no se puede cargar un anuncio:

Código de error	Motivo
101	Parámetros de servidor no válidos (p. ej., falta el ID de posición)
102	El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con la Red de público de Meta.
103	El editor debe solicitar anuncios con un contexto `Activity`.
104	No se pudo inicializar el SDK de Meta Audience Network.
105	El publicador no solicitó anuncios nativos unificados.
106	El anuncio nativo cargado es un objeto diferente del esperado.
107	El objeto `Context` que se usó no es válido.
108	Al anuncio cargado le faltan los recursos de anuncios nativos obligatorios.
109	No se pudo crear un anuncio nativo a partir de la carga útil de la oferta.
110	El SDK de Meta Audience Network no pudo presentar su anuncio intersticial o recompensado.
111	Se genera una excepción cuando se crea un objeto `AdView` de la red de público de Meta.
1000-9999	Meta Audience Network mostró un error específico del SDK. Consulta la documentación de Meta Audience Network para obtener más detalles.