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 de AdMob, la, 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 iOS 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.

Objetivo de implementación de iOS 10.0 o versiones posteriores
Adaptador de Meta Audience Network 5.10.0.0 o una versión posterior (se recomienda la versión más reciente)
Por lo general, el SDK de Meta Audience Network más reciente requiere la versión más reciente de Xcode.

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 AdMob IU

Configura la configuración de mediación para tu unidad de anuncios

Debes agregar la red de público de Meta a la configuración de mediación de tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. Luego, navega a la pestaña Mediation. Si tienes un grupo de mediación existente que deseas modificar, haz clic en el nombre de ese grupo de mediación para editarlo y avanza al apartado Cómo agregar Meta Audience Network como fuente de anuncios.

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

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

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones para segmentar. A continuación, establece el estado del grupo de mediación en Habilitado y, luego, haz clic en Agregar unidades de anuncios.

Asocia este grupo de mediación con una o más de tus unidades de anuncios existentes de AdMob. Luego, haz clic en Listo.

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

Cómo agregar Meta Audience Network como fuente del anuncio

En la tarjeta Ofertas 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 ofertas con Meta Audience Network.

Haz clic en Reconocer y aceptar y, luego, en Continuar.

Si ya tienes una asignación para la red de público de Meta, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el ID de posición que obtuviste en la sección anterior. Luego, haz clic en Listo.

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

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

Con CocoaPods (recomendado)

Agrega la siguiente línea al Podfile de tu proyecto:
```
pod 'GoogleMobileAdsMediationFacebook'
```
Desde la línea de comandos, ejecuta lo siguiente:
```
pod install --repo-update
```

Integración manual

Descarga la versión más reciente del SDK de Meta Audience Network para iOS y vincula FBAudienceNetwork.framework en tu proyecto.
Descarga la versión más reciente del adaptador de Meta Audience Network desde el vínculo de descarga en el registro de cambios y vincula MetaAdapter.framework en 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.

Leyes de privacidad de los estados de EE.UU. exigen otorgar 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 de la documentación de Meta para conocer las opciones de procesamiento de datos de los usuarios en California.

Paso 5: Agrega el código obligatorio

Errores de compilación

Swift

No se requiere código adicional para la integración de Swift.

Objective-C

Para el adaptador de Meta Audience Network 6.9.0.0 o versiones posteriores, debes seguir los pasos que se indican a continuación para agregar rutas de acceso de Swift a la configuración de compilación de tu destino y evitar errores de compilación.

Agrega las siguientes rutas de acceso a la configuración de compilación del destino en Rutas de acceso de búsqueda de bibliotecas:

$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
$(SDKROOT)/usr/lib/swift

Agrega la siguiente ruta de acceso a la configuración de compilación del destino en Runpath Search Paths:

/usr/lib/swift

Seguimiento de publicidad habilitado

Si compilas para iOS 14 o versiones posteriores, Meta Audience Network requiere que configures de forma explícita su marca Advertising Tracking Enabled con el siguiente código:

Swift

// Set the flag as true
FBAdSettings.setAdvertiserTrackingEnabled(true)

Objective-C

// Set the flag as true.
[FBAdSettings setAdvertiserTrackingEnabled:YES];

Integración de SKAdNetwork

Sigue la documentación de Meta Audience Network para agregar los identificadores de SKAdNetwork al archivo Info.plist de tu proyecto.

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 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 recursos se vuelven a pasar al publicador en la propiedad extraAssets de GADNativeAd. El adaptador admite pasar los siguientes recursos:

Parámetros y valores de la solicitud
`GADFBSubtitle`	Cadena. El subtítulo del anuncio
`GADFBSocialContext`	Cadena. El contexto social del anuncio

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

Swift

let socialContext: String = nativeAd.extraAssets[GADFBSocialContext]

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];

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 GADMediaView . 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, GADNativeAd y. Se completan los siguientes campos de descripciones de los campos de anuncios nativospara un GADNativeAd.

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 GADMediaView 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	`GADMediaView`
Banner nativo	Ícono de la aplicación	`UIImageView`

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 GADResponseInfo.adNetworkInfoArray en las siguientes clases:

GADMAdapterFacebook
GADMediationAdapterFacebook

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	No se pudo inicializar el objeto de anuncio de Meta Audience Network.
104	El SDK de Meta Audience Network no pudo presentar 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 detalles.

Registro de cambios del adaptador de mediación para iOS de Meta Audience Network