Saltar a contenido

Integrar Meta Audience Network con las ofertas

Info

Importante: Facebook Audience Network ahora es Meta Audience Network. Ver El anuncio de Meta para más información.

Esta guía explica cómo utilizar el SDK de anuncios de Google para móviles para cargar y presentar anuncios de Meta Audience Network a través de mediación, con un enfoque en las integraciones de ofertas. Proporciona instrucciones sobre cómo integrar Meta Audience Network en la configuración de mediación de una aplicación Godot e integrar el SDK y el adaptador de Meta Audience Network en su aplicación Godot.

Este documento se basa en:

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas ✅
Cascada 1 ❌
Formatos
Banner ✅
Intersticial ✅
Recompensado ✅

Requisitos previos

Paso 1: Configurar la red Meta Audience

Recomendamos seguir el tutorial para Android o iOS, ya que será igual para ambos.

Paso 2: Configure los ajustes de mediación para su bloque de anuncios de AdMob

Recomendamos seguir el tutorial para Android o iOS, ya que será igual para ambos.

Paso 3: Importe el complemento Meta Audience Network

  1. Descargue el complemento para Android.
  2. Extraiga el archivo .zip. Dentro, encontrarás una carpeta meta.
  3. Copie el contenido de la carpeta meta y péguelo en la carpeta del complemento de Android en res://addons/admob/android/bin/.

android-meta

El adaptador Meta Audience Network ya está incluido en la descarga del complemento estándar de iOS. Si siguió la Guía de instalación de iOS, ya debería tener los archivos necesarios (poing-godot-admob-meta.gdip y marcos relacionados) en su directorio res://ios/plugins/.

Paso 4: Habilite el complemento

Asegúrese de habilitar Meta en Configuración del proyecto (en Admob > Android > Mediación > Meta).

Asegúrese de marcar Ad Mob y Ad Mob Meta en la lista de complementos en sus Preajustes de exportación de iOS (además de ingresar el ID de su aplicación AdMob en la configuración de Plists).

ios-meta-export

Paso 5: Se requiere código adicional

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

Integración SKAdNetwork Siga la Documentación de Meta Audience Network para agregar los identificadores SKAdNetwork al archivo Info.plist de su proyecto.

Errores de compilación

Debe seguir los pasos a continuación para agregar rutas de Swift a los Ajustes de compilación de su objetivo para evitar errores de compilación.

Agregue las siguientes rutas a los Build Settings del objetivo bajo Library Search Paths:

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

Agregue la siguiente ruta a los Build Settings del objetivo bajo Runpath Search Paths: 

/usr/lib/swift

Lea más sobre: https://developers.google.com/admob/ios/mediation/meta#step_4_additional_code_required

Seguimiento publicitario habilitado Si está compilando para iOS 14 o posterior, Meta Audience Network requiere que configure explícitamente su marca de Seguimiento de publicidad habilitado usando el siguiente código:

Info

Punto importante: Debe configurar esta marca antes de inicializar el SDK de anuncios móviles.

if OS.get_name() == "iOS":
    # FBAdSettings está disponible solo para iOS, Google no puso este método en el SDK de Android
    FBAdSettings.set_advertiser_tracking_enabled(true)

if (OS.GetName() == "iOS")
{
    // FBAdSettings está disponible solo para iOS, Google no puso este método en el SDK de Android
    FBAdSettings.SetAdvertiserTrackingEnabled(true);
}

Paso 6: Pruebe su implementación

Recomendamos seguir el tutorial para Android o iOS, ya que será igual para ambos.

Pasos opcionales

Info

Importante: Verifique que tiene permiso de Administración de cuentas para completar la configuración de Consentimiento de la UE y GDPR, CCPA y Plataforma de mensajería de usuario. Para obtener más información, consulte el siguiente artículo sobre nuevos roles de usuario.

Consentimiento de la UE y RGPD

Bajo la Política de consentimiento del usuario de la UE de Google, es obligatorio proporcionar ciertas divulgaciones y obtener consentimientos de los usuarios dentro del Espacio Económico Europeo (EEE) con respecto a la utilización de identificadores de dispositivos y datos personales. Esta política se alinea con la Directiva de privacidad electrónica de la UE y el Reglamento General de Protección de Datos (GDPR). Al solicitar el consentimiento, debe identificar explícitamente cada red publicitaria dentro de su cadena de mediación que pueda recopilar, recibir o utilizar datos personales. Además, debe proporcionar información sobre cómo cada red pretende utilizar estos datos. Es importante destacar que actualmente Google no puede transmitir automáticamente la elección de consentimiento del usuario a estas redes.

Por favor revise la guía de Meta para obtener información sobre GDPR y publicidad en Meta.

Agregue Facebook a la lista de socios publicitarios del RGPD

Siga los pasos en Configuración del RGPD para agregar Facebook a la lista de socios publicitarios del RGPD en la interfaz de usuario de AdMob.

CCPA

La Ley de Privacidad del Consumidor de California (CCPA) exige que los residentes del estado de California tengan derecho a optar por no participar en la "venta" de su "información personal", según lo define la ley. Esta opción de exclusión voluntaria debe mostrarse de manera destacada a través del enlace "No vender mi información personal" en la página de inicio de la parte que realiza la venta.

La guía de preparación de la CCPA ofrece una función para permitir el procesamiento de datos restringido para la publicación de anuncios de Google. Sin embargo, Google no puede aplicar esta configuración a todas las redes publicitarias dentro de su cadena de mediación. Por lo tanto, es esencial identificar cada red publicitaria en su cadena de mediación que podría estar involucrada en la venta de información personal y seguir la guía específica proporcionada por cada una de esas redes para garantizar el cumplimiento de la CCPA.

Por favor revise la documentación de Meta para opciones de procesamiento de datos para usuarios en California.

Agregue Facebook a la lista de socios publicitarios de CCPA

Siga los pasos en Configuración CCPA para agregar Facebook a la lista de socios publicitarios CCPA en la interfaz de usuario de AdMob.

Almacenamiento en caché

Android 9: A partir de Android 9 (nivel de API 28), la compatibilidad con texto sin cifrar está deshabilitada de forma predeterminada, lo que afectará la funcionalidad del almacenamiento en caché de medios del SDK de Meta Audience Network y podría afectar la experiencia del usuario y los ingresos por publicidad. Siga la documentación de Meta para actualizar la configuración de seguridad de red en su aplicación.

No aplicable.

Códigos de error

Si el adaptador no puede recibir un anuncio de Audience Network, los editores pueden verificar el error subyacente de la respuesta del anuncio usando ResponseInfo en las siguientes clases:

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

GADMAdapterFacebook
GADMediationAdapterFacebook

Estos son los códigos y los mensajes adjuntos que genera el adaptador de Meta Audience Network cuando un anuncio no se carga:

Código de error Razón
101 Parámetros del servidor no válidos (por ejemplo, falta el ID de ubicación).
102 El tamaño de anuncio solicitado no coincide con el tamaño de banner admitido por Meta Audience Network.
103 El editor debe solicitar anuncios con un contexto de Actividad.
104 El SDK de Meta Audience Network no se pudo inicializar.
105 El editor no solicitó anuncios nativos unificados.
106 El anuncio nativo cargado es un objeto diferente al esperado.
107 El objeto Context utilizado no es válido.
108 Al anuncio cargado le faltan los recursos publicitarios nativos necesarios.
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 presentar su anuncio intersticial/recompensado.
111 Se produce una excepción al crear un objeto AdView de Meta Audience Network.
1000-9999 Meta Audience Network devolvió un error específico del SDK. Ver la documentación de Meta Audience Network para más detalles.
Código de error Razón
101 Parámetros del servidor no válidos (por ejemplo, falta el ID de ubicación).
102 El tamaño de anuncio solicitado no coincide con el tamaño de banner admitido por Meta Audience Network.
103 El objeto publicitario de Meta Audience Network no pudo inicializarse.
104 El SDK de Meta Audience Network no pudo presentar su anuncio intersticial/recompensado.
105 El controlador de vista raíz del anuncio de banner es nulo.
106 El SDK de Meta Audience Network no se pudo inicializar.
1000-9999 Meta Audience Network devolvió un error específico del SDK. Ver la documentación de Meta Audience Network para más detalles.

  1. Meta Audience Network se convirtió en solo pujar en 2021. ↩