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 anuncios de Google para dispositivos móviles para cargar y mostrar anuncios de Meta Audience Network que utilicen Mediación de AdMob, que abarcan integraciones de ofertas. Aquí se explica cómo agregar Meta Audience Network a una la configuración de mediación de la unidad de anuncios y cómo integrar el MetaAudience El SDK de Network y el adaptador se conectan a una Android app.

Integraciones y formatos de anuncios admitidos

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

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
Cómo completar la mediación Guía de introducción

Nivel de API 21 o versiones posteriores de Android

Adaptador de Meta Audience Network 5.10.0.0 o una versión posterior (versión recomendada más reciente)

Paso 1: Establece la configuración en la IU de Meta Audience Network

Click Get started then Create new account.

Fill out the required fields with your business details and click Next.

Create a property

After you've filled out the required information, you're prompted to create a property for your app. Enter the desired name of the property for your app and click Next.

Next, select your platform to monetize.

Add your app details and click Next.

Set up your payment account by clicking Add a new payment account. You will be redirected to a new page to enter your payment information. Fill out the necessary details, then click Next.

Select Google AdMob as the Mediation platform, then click Create placement.

Select a format, fill out the form and click Create.

Take note of the Placement ID.

Click Done.

Turn on test mode

See the Testing Audience Network Implementation guide for detailed instructions on how to enable Meta Audience Network test ads.

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

Cómo configurar la mediación para tu unidad de anuncios

Debes agregar Meta Audience Network a la configuración de mediación para tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. A continuación, ve a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en el nombre de ese grupo para editarlo y ve a Agregar Meta Audience Network como fuente del anuncio.

Para crear un grupo de mediación nuevo, selecciona Crear grupo de mediación.

Ingresa el formato del anuncio y la plataforma y, luego, haz clic en Continuar.

Asígnale un nombre a tu grupo de mediación y selecciona las ubicaciones para la que deseas segmentar tus anuncios. A continuación, establece el estado del grupo de mediación en Habilitado y haz clic en Agregar bloques de anuncios.

Asocia este grupo de mediación a una o más de tusAdMob unidades de anuncios existentes. Luego, haga clic en Listo.

Ahora deberías ver la tarjeta Bloques de anuncios propagada con las unidades de anuncios que seleccionaste:

Agregar Meta Audience Network como fuente del anuncio

En la tarjeta Ofertas de la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. Luego, selecciona Meta Audience Network.

Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de licitación conMeta Audience Network.

Haz clic en Confirmar 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 IDobtenido en la sección anterior. Luego, haga clic en Listo.

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 AdMob 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 la siguiente implementación las dependencias y configuraciones. Utiliza las versiones más recientes del público meta SDK de red y adaptador:

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

Integración manual

Descargue la última versión del SDK de Meta Audience Network para Android Extrae el archivo AudienceNetwork.aar de la carpeta AudienceNetwork/bin. y agregarla a tu proyecto.
Navegue hasta el adaptador de Meta Audience Network. artefactos en el repositorio Maven de Google. Selecciona la versión más reciente y descarga Meta el archivo .aar del adaptador de 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 el Consentimiento de Usuarios de la UE de Google política, debe asegurarse de que se proporcionen ciertas divulgaciones los consentimientos obtenidos 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 el requisitos de la Directiva de Privacidad Electrónica y de la Protección General de Datos Reglamento General de Protección de Datos (RGPD). Cuando solicite el consentimiento, debe identificar cada red de publicidad de tu cadena de mediación que recopilen, reciban o usen 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 RGPD y de Meta.

Leyes de privacidad estatales de EE.UU.

EE.UU. leyes de privacidad estatales deben brindar a los usuarios los permisos para inhabilitar la "oferta" de su "información personal" (como lo define la ley condiciones), con la opción de inhabilitación ofrecida por medio de un mensaje destacado "No vender Información" el vínculo en la página la página de inicio del grupo. El EE.UU. privacidad de estados en la guía de cumplimiento de leyes ofrece la posibilidad de habilitar procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada anuncio en tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad de su cadena de mediación que puedan participar en la venta de información y seguir las indicaciones de cada una de esas redes para garantizar y cumplimiento.

Sigue las instrucciones en Documentación de Meta sobre las opciones de procesamiento de datos para 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 AdMob 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 Anuncio nativo de Meta Audience Network no se asignan uno a uno con los recursos del anuncio nativo de Google. Esos recursos se aprueban Vuelve al publicador en un paquete mediante el 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 el renderizado MediaView activo. Si planeas renderizar anuncios nativos sin ese recurso, asegúrate de usar de Meta Audience Network banner nativo formato del anuncio.

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

Renderización de anuncios

El adaptador de Audience Network muestra los anuncios nativos como NativeAd objetos. Propaga los siguientes elementos Descripciones de los campos de los anuncios nativos durante un NativeAd.

Campo	Propagado por 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 cambio, el adaptador propaga MediaView con un video o una imagen.

Seguimiento de impresiones y clics

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

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 para la renderización de recursos: una impresión se considere válida, en función de si seleccionaste Los formatos nativos o de banners nativos cuando configuras públicos objetivo Red.

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 público meta Network SDK y podría afectar la experiencia del usuario y los ingresos publicitarios. Seguir Documentación de Meta para actualizar la configuración de seguridad de red de tu app.

Códigos de error

Si el adaptador no recibe un anuncio de Audience Network, puedes verificar el subyacente de la respuesta del anuncio mediante 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 adjuntos que arroja Audience Network. cuando un anuncio no se carga:

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 arroja 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 Documentación de Meta Audience Network para obtener más información.