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 de AdMob, 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:
| Integración | |
|---|---|
| Ofertas | |
| Cascada 1 | |
| Formatos | |
| Banner 2 | |
| Intersticial | |
| Recompensado | |
| Intersticial recompensado | |
| Nativo | |
1
Meta Audience Network
solo comenzó a usar ofertas
en 2021.
2
Meta Audience Network
no admite banners adaptables anclados ni intercalados.
Requisitos
- 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 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 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 pedirá que crees una propiedad para tu app. Ingresa el nombre que desees para la propiedad de tu app y haz clic en Siguiente.

A continuación, selecciona la plataforma que deseas 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 nueva página para ingresar tu información de pagos. 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.

Presta atención al Placement ID (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 todavía no lo hiciste,
configura un archivo app-ads.txt para tu app.
Para implementar app-ads.txt en Meta Audience Network, consulta
Cómo identificar vendedores autorizados con app-ads.txt.
Activa el modo de prueba
Paso 2: Configura la demanda de Meta Audience Network en la IU de AdMob
Configura los parámetros de la mediación para tu unidad de anuncios
Debes agregar Meta Audience Network 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 ya tienes un grupo de mediación y deseas modificarlo, haz clic en el nombre de ese grupo para editarlo y pasa directamente a la sección Agrega Meta Audience Network 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 Meta Audience Network como fuente de anuncios
En la tarjeta Licitación de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona Meta Audience Network.
Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de licitación con Meta Audience Network.
Haz clic en Reconocer y aceptar y, luego, en Continuar.
Si ya tienes una asignación para Meta Audience Network, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.
A continuación, ingresa el Placement ID que obtuviste en la sección anterior. Luego, haz clic en Listo.
Agrega 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 AdMob.
Paso 3: Importa el SDK y el adaptador de Meta Audience Network
GMA Next-Gen SDKIntegración de Android Studio (recomendada)
En el archivo gradle a nivel de la app, agrega las dependencias de implementación y las configuraciones que se indican a continuación:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") 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") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' 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
AudienceNetwork.aarde la carpetaAudienceNetwork/biny 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
.aardel 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á registrada en la Lista de proveedores globales (GVL) de IAB Europe. En cambio, 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 el Marco de trabajo de transparencia y consentimiento (TCF) de IAB Europe, versión 2. Esta especificación te permite, junto con sus 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 instrucciones de la documentación de Meta para 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 para conocer las opciones de tratamiento 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 AdMob 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 en el inspector de anuncios seleccionando Meta Audience Network (Licitación) como fuente de anuncios.
Pasos opcionales
Anuncios nativos
Algunos
recursos de anuncios nativos de Meta Audience Network
no se asignan de forma directa a los recursos de anuncios nativos de Google. Esos recursos se devuelven al publicador en un paquete a través del método getExtras() en NativeAd.
El adaptador admite el paso de 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. Es el contexto social del anuncio. |
A continuación, se muestra un ejemplo de código que muestra cómo extraer estos recursos:
Ejemplo:
Kotlin
val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
// ...
}
Java
Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
// ...
}
Usa anuncios nativos de Meta Audience Network sin MediaView
El formato de anuncio nativo de Meta Audience Network requiere la renderización del
MediaView
recurso. 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 anuncios de banner nativos de Meta Audience Network, debes seleccionar el
Native Banner formato 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 anuncios nativos como
NativeAd
objetos. Completa las siguientes
descripciones de los campos de los anuncios nativos
para un
NativeAd.
| Campo | Completado por el adaptador de Meta Audience Network |
|---|---|
| Título | |
| Imagen | 1 |
| Cuerpo | |
| Ícono de la app | |
| Llamado a la acción | |
| Nombre del anunciante | |
| Calificación por estrellas | |
| Tienda | |
| Precio |
1 El adaptador de Meta Audience Network
no proporciona acceso directo al recurso de imagen principal
de los anuncios nativos. Por el contrario, el adaptador completa la
MediaView
con un video o una imagen.
Seguimiento de impresiones y clics
En la siguiente tabla, se destaca cuándo se registran las impresiones y los clics de los anuncios nativos en GMA Next-Gen SDK.
| Registro de impresiones | Registro de clics |
|---|---|
| 1 px del recurso de anuncio nativo de Meta Audience Network en la pantalla + 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, según si seleccionaste el Nativo o Banner nativo formato 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 de Cleartext 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 la 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:
| Código de error | Motivo |
|---|---|
| 101 | Parámetros del servidor no válidos (p.ej., falta el ID de posición). |
| 102 | El tamaño del anuncio solicitado no coincide con un tamaño de banner admitido por 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ó anuncios nativos unificados. |
| 106 | El anuncio nativo cargado es un objeto diferente del esperado. |
| 107 | El objeto Context utilizado 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 mostrar su anuncio intersticial o recompensado. |
| 111 | Se arrojó una excepción cuando se creó un objeto AdView de Meta Audience Network. |
| 1000-9999 | Meta Audience Network devolvió un error específico del SDK. Consulta la documentación de Meta Audience Network para obtener más detalles. |