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

Integre Meta Audience Network con las ofertas

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles para cargar y mostrar anuncios de Meta Audience Network mediante la mediación, que abarca las integraciones de ofertas. Aquí 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 a una Android app.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas
Cascada ¹
Formatos
Banner
Intersticial
Recompensado
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 sobre la mediación.

Nivel de API 21 o versiones posteriores de Android

Adaptador de Meta Audience Network 5.10.0.0 o una versión posterior (se recomienda la última versión)

Paso 1: Establece la 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 una cuenta nueva.

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

Cómo crear una propiedad

Una vez que hayas completado la información obligatoria, se te solicitará que crees una propiedad para tu app. Ingresa el nombre deseado de la propiedad para tu app y haz clic en Next.

Luego, selecciona la plataforma que quieres monetizar.

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

Para configurar tu cuenta de pagos, haz clic en Agregar una nueva cuenta de pagos. 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.

Anota el ID de posición.

Haz clic en Listo.

Activar el modo de prueba

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

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

Accede a tu cuenta de Ad Manager.

Habilitar 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 y activa el Uso compartido de indicadores seguros. Haz clic en Guardar.

Configura las Meta ofertas

Ad Manager 360

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

Selecciona Meta como ofertante.

Activa las opciones 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 de SDK.

Selecciona Meta como 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 para iniciar 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 para Meta en la pestaña Ofertas de SDK.

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

Elige Unidad de anuncios específica. Selecciona un bloque de anuncios y un formato, App para dispositivos móviles como Tipo de inventario y Aplicación para dispositivos móviles. Luego, ingresa el que obtuviste en la sección anterior. Por último, haz clic en Guardar.

Agregar Facebook a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración del GDPR y Configuración de las reglamentaciones estatales de EE.UU. para agregar Facebook a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la Ad Manager IU.

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

Integración de Android Studio (recomendada)

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 Meta Audience Network:

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

Integración manual

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

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

Consentimiento para la UE y GDPR

Según la Política de Consentimiento de Usuarios de la UE de Google, debes asegurarte de proporcionar ciertas divulgaciones y el consentimiento de los usuarios del Espacio Económico Europeo (EEE) en relación con el uso de identificadores de dispositivos y datos personales. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y el Reglamento General de Protección de Datos (GDPR) de la UE. Cuando solicites consentimiento, debes identificar cada red de publicidad en tu cadena de mediación que pueda recopilar, recibir o usar datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.

Sigue las instrucciones en la documentación de Meta para la publicidad del GDPR y de Meta.

Leyes de privacidad estatales de EE.UU.

Leyes de privacidad estatales de EE.UU. exigen que los usuarios tengan el derecho de rechazar la "venta" de su "información personal" (según la definición de esos términos), a través de un vínculo destacado "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 capacidad de habilitar el procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada red de publicidad en 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 los lineamientos de cada una de esas redes para garantizar el cumplimiento.

Sigue las instrucciones 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 requerido

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

Paso 6: Prueba tu implementación

Habilitar anuncios de prueba

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

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba deMeta Audience Network, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la Meta Audience Network (Bidding) fuente de anuncios.

Pasos opcionales

Anuncios nativos

Algunos recursos de anuncios nativos de Meta Audience Network no asignan uno a uno con los recursos de anuncios nativos de Google. Esos elementos se pasan de vuelta 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 solicitud
`FacebookMediationAdapter.KEY_ID`	Cadena. Es 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 en el que se 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 usar anuncios nativos de Meta Audience Network sin un elemento MediaView

El formato del anuncio nativo de Meta Audience Network requiere renderizar el 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 del anuncio nativo correspondiente.

Renderización de anuncios

El adaptador de Audience Network muestra sus anuncios nativos como objetos NativeAd . Propaga los siguientes campos para una NativeAd.

Campo	Propagado por el adaptador de Meta Audience Network
Encabezado
Imagen	1
Cuerpo
Ícono de la app
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 de sus anuncios nativos. En cambio, el adaptador propaga el objeto 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.

Registro de impresiones	Haz clic en Grabación.
1 px de recursos de anuncios nativos de Meta Audience Network en pantalla y requisitos de renderización de recursos	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, en función de 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 app	`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.getAdapterResponse() en las siguientes clases:

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

A continuación, se muestran los códigos y los mensajes que los acompañan que arroja el adaptador de red de público cuando no se carga 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 Meta Audience Network.
103	El publicador debe solicitar anuncios con un contexto `Activity`.
104	No se pudo inicializar el SDK de Meta Audience Network.
105	El publicador no solicitó los anuncios nativos unificados.
106	El anuncio nativo cargado es un objeto diferente del que se esperaba.
107	El objeto `Context` que se usó no es válido.
108	Al anuncio cargado le faltan los recursos necesarios del anuncio nativo.
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 presentó su anuncio intersticial o recompensado.
111	Se produjo una excepción cuando se crea un objeto `AdView` de Meta Audience Network.
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 Meta Audience Network.
103	No se pudo inicializar el objeto de anuncio de Meta Audience Network.
104	El SDK de Meta Audience Network no presentó su anuncio intersticial o recompensado.
105	El controlador de vista raíz del anuncio de banner es `nil`.
106	No se pudo inicializar el SDK de Meta Audience Network.
1000-9999	Meta Audience Network mostró un error específico del SDK. Consulta la documentación de Meta Audience Network para obtener más información.