Integrar Meta Audience Network con la licitación

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

  • La versión más reciente de GMA Next-Gen SDK.

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

  • Nivel de API 24 o posterior de Android

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

Consulta la guía 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 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 SDK

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.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

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.