Probar la implementación de Audience Network

Cuando integres Facebook Audience Network en la aplicación o el sitio web para celulares, debes probar la implementación en dispositivos físicos con anuncios de producción antes de incorporarla. Usa el SDK de Audience Network más reciente en la integración para que incluya las últimas mejoras y correcciones de errores. En las siguientes secciones, se ofrece información detallada para probar la integración de los anuncios de Audience Network con la aplicación o el sitio web para celulares.

Paso 1: Probar con los anuncios de producción

Paso 2: Comprobar los códigos de error de las solicitudes de anuncios de producción

Paso 3: Usar el depurador de solicitudes de Audience Network para el diagnóstico de las solicitudes de anuncios

Paso 4: Probar con anuncios de prueba

Paso 5: Lista de comprobación de la integración de anuncios de Audience Network

Usar dispositivos de prueba

Paso 1: Probar con los anuncios de producción

Probar la implementación con anuncios de producción es un proceso de dos pasos. El primer paso es agregar personas a la página de configuración del negocio para permitirles ver anuncios de producción antes de que se apruebe la aplicación. El segundo paso consiste en que evaluadores designados usen tu aplicación o sitio web para celulares una vez que inicien sesión en Facebook.

Agregar evaluadores a tu aplicación

Puedes probar tu aplicación o sitio web para celulares con anuncios de producción y en dispositivos físicos agregando a quien lleve a cabo las pruebas a tu aplicación de Facebook con cualquier rol. Este es el método recomendado para agregar evaluadores a tu aplicación:

  1. Accede a la configuración del negocio.
  2. En la pestaña Personas de la parte izquierda, haz clic en +Agregar.
  3. Escribe la dirección de correo electrónico de la persona que quieres agregar a la cuenta del administrador comercial. Aquí puedes ingresar varias personas.
  4. Si quieres, puedes asignar roles a las personas o haz clic en Omitir solo para agregarlas a la cuenta del administrador comercial.

Si estás usando alguna capa de mediación, asegúrate de que la capa esté enviando solicitudes a Audience Network. Si tienes activadas las pruebas en la capa de mediación, tal vez no esté enviando ninguna solicitud a nuestros servidores.

Probar aplicaciones para celulares

  1. Distribuye la aplicación a los dispositivos de los evaluadores mediante tu método favorito de distribución y asegúrate de agregarlos a la página de configuración del administrador comercial.
  2. Cada una de las personas que agregaste debe tener instalada la aplicación de Facebook en su dispositivo e iniciar sesión en ella con el identificador de usuario de Facebook que agregaste al rol de evaluador. Esto es obligatorio, ya que Facebook debe reconocer al usuario como una persona del negocio para devolver un anuncio.
  3. La persona que realiza la prueba ahora puede iniciar la aplicación y activar las ubicaciones que quieres probar. Debe ver un anuncio de producción.

Cuando pruebes tus ubicaciones de anuncios, Facebook enviará de forma intencionada una opción sin relleno para aproximadamente el 20% de las solicitudes a fin de que puedas probar cómo maneja tu aplicación o sitio web para celulares un caso de este tipo.

Si usas Testflight para distribuir y probar tu aplicación, no podrás ver anuncios reales en esas compilaciones de prueba. En su lugar, tendrás que establecer el modo de prueba como se muestra a continuación para obtener anuncios de Audience Network. Cada vez que una aplicación distribuida por Testflight solicite el identificador para anunciantes (IDFA), obtendrá un IDFA diferente. Por lo general, el IDFA permanece constante para un dispositivo hasta que el usuario lo restablezca manualmente. Sin embargo, cuando una compilación de Testflight solicita el IDFA al sistema operativo, no obtiene el IDFA "real". En su lugar, obtiene un IDFA "ficticio" que cambia cada vez que la aplicación lo solicita.

Para resolver este problema, puedes activar el modo de prueba para que se muestre el anuncio de prueba.



Paso 2: Comprobar los códigos de error de las solicitudes de anuncios de producción

Cuando pruebes tu implementación de Facebook Audience Network, puede que experimentes uno de varios códigos de error posibles cuando hagas una solicitud. Estos códigos de error se describen a continuación.

1000 - Network Error

Respuesta del servidor Documentación del SDK

Code=1000 “Network Error"

  • Error 1000 - Network Error. El SDK de Audience Network no pudo establecer conexión con la red facebook.com (http://facebook.com/).
  • Tu aplicación debe intentar hacer otra solicitud hasta que sea posible establecer conexión con la red. Te recomendamos hacer solicitudes incrementales hasta que se restablezca una conexión o declares que se agotó el tiempo de espera.

1001 - No Fill

Este es un error común durante las pruebas y se relaciona con una respuesta que indica que no hay relleno. La razón más común es que el usuario no inició sesión en la aplicación de Facebook cuando probó tu aplicación para celulares o no inició sesión en el sitio web para celulares de Facebook cuando probó tu sitio web para celulares.

Respuesta del servidor Documentación del SDK

Code=1001 “No Fill”

  • Error 1001 - No Fill. Se puede deber a uno o varios de los siguientes motivos:
  • El usuario no inició sesión en la aplicación de Facebook nativa en el dispositivo móvil.
  • La opción para limitar el seguimiento de los anuncios está activada (iOS).
  • La opción para desactivar los anuncios basados en intereses (Android) está activada.
  • No existe un inventario de anuncios para el usuario actual.
  • Tu dispositivo de pruebas debe tener instalada la aplicación de Facebook nativa.
  • Tu aplicación debe intentar hacer otra solicitud después de 30 segundos.

1002 - Ad Load Too Frequently

Respuesta del servidor Documentación del SDK

Code=1002 “Load Too Frequently”

  • Las solicitudes de anuncios se basan en una combinación de:
  • Identificador de dispositivo
  • Identificador de ubicación
  • Formato de visualización (banner, intersticial, nativo)
  • Tu aplicación debe intentar hacer otra solicitud después de 30 minutos. También te sugerimos modificar tu frecuencia de actualización o de solicitud.

1011 - Display Format Mismatch

Respuesta del servidor Documentación del SDK

Code=1011 “Display Format Mismatch”

  • Error 1011 - Display Format Mismatch debido a:
  • El formato de visualización de la solicitud de anuncio no coincide con el formato de visualización especificado para esta ubicación.
  • Cada ubicación se puede usar con un solo formato de visualización.
  • Puedes crear varias ubicaciones para usar diferentes formatos de visualización.

1203 - Not An App Admin, Developer or Tester

Respuesta del servidor Documentación del SDK

Code=1203 “Not An App Admin, Developer or Tester”

  • La solicitud inicial de un paquete debe provenir de un administrador, desarrollador o evaluador de la aplicación.

2000 - Server Error

Respuesta del servidor Documentación del SDK

Code=2000 “Server Error"

  • Error 2000 - Server Error. Posiblemente se debe a:
  • Identificador de ubicación no válido: cada ubicación y cada tipo tienen un identificador único.
  • Versión no compatible u obsoleta del SDK: descarga la versión más reciente o actualiza tu Pod si usas CocoaPods.
  • Uso o llamada incorrecta del método loadAd. Te sugerimos colocar puntos de interrupción en loadAd y cualquier método o devolución de llamada asociada.
  • Tu aplicación debe intentar hacer otra solicitud después de 30 segundos.

2001 - Internal Error

Respuesta del servidor Documentación del SDK

Code=2001 “Internal Error”

  • Error 2001 - Internal Error. El SDK de Audience Network no pudo procesar una respuesta de facebook.com.
  • Tu aplicación debe intentar hacer otra solicitud después de 30 segundos.
  • Si esto sucede constantemente, envíanos un informe de error.


Paso 3: Usar el depurador de solicitudes de Audience Network para el diagnóstico de las solicitudes de anuncios

Después de implementar las ubicaciones en la aplicación, puedes usar el depurador de solicitudes de Audience Network para verificar que Facebook esté recibiendo las solicitudes de tu aplicación.

  1. Ve al administrador de monetización.
  2. Haz clic en Administrar propiedad.
  3. En la parte superior derecha, haz clic en Configuración de propiedades > Depurador de solicitudes.
  4. Para supervisar las solicitudes desde la aplicación o el sitio web, haz clic en Iniciar.

En tu dispositivo de prueba real para iOS o Android, o en iOS o Android, usa tu aplicación para activar las ubicaciones de anuncios con Audience Network. De esta manera, las solicitudes de anuncios aparecerán en la herramienta. Verifica que las solicitudes enviadas tengan la información correcta de identificador de la ubicación, nombre del paquete, etc.

Para esto, debes usar un dispositivo físico, ya que no funcionará en el simulador de iOS o el emulador de Android.

Debes tener una sesión iniciada en la aplicación de Facebook en el mismo dispositivo de prueba que estés usando para que la herramienta realice la supervisión.

Si las solicitudes de anuncios no se muestran en la herramienta, significa que Facebook no las está recibiendo como debería. Puedes comprobar los siguientes elementos para hacer la depuración:

  1. Asegúrate de que estás usando un dispositivo físico y no el simulador o emulador.
  2. Asegúrate de que la aplicación de Facebook esté instalada en tu dispositivo de prueba.
  3. Asegúrate de que el evaluador haya iniciado sesión en Facebook en su dispositivo de prueba y que, además, tenga un rol en el negocio.
  4. Si estás usando mediación, comprueba que la capa de mediación esté enviando solicitudes a Facebook Audience Network.


Paso 4: Probar con anuncios de prueba

Debes asegurarte de que el usuario que prueba la aplicación se agregue a un rol en el administrador comercial de la aplicación. Este es el método de prueba recomendado, ya que te permite ver anuncios de producción en dispositivos físicos. Consulta la sección Probar con anuncios de producción para obtener más información sobre el método de prueba recomendado.

Sin embargo, tal como se indicó en la sección anterior, probablemente te des cuenta de que no siempre es posible probar la interfaz de usuario de los anuncios de producción con las visualizaciones de la interfaz de usuario de la aplicación. Además, no puedes garantizar que el anuncio que reciba la aplicación sea un anuncio con imagen, con video o por secuencia. Solicitar anuncios de producción no garantizará el contenido ni el formato del anuncio devuelto. ¿Qué pasa si quieres probar con un anuncio con contenido de video vertical para confirmar que se verá bien con la visualización de la interfaz de usuario de la aplicación?

Para solicitar un anuncio de prueba, debes usar la siguiente cadena de tipo de anuncio de prueba para concatenar el identificador de ubicación con "#" al inicializar cualquier objeto de anuncio de Facebook. La plantilla de identificador de ubicación para solicitar anuncios de prueba es TEST_AD_TYPE#YOUR_PLACEMENT_ID.

No envíes la aplicación al público con el código de prueba anterior, ya que esto hará que solo se muestren los anuncios de prueba. En su lugar, usa una macro de preprocesador como DEBUG o TESTING y, luego, #ifdef para distinguir una compilación de prueba de una compilación de versión.

Tabla de tipos de anuncio de prueba

Tipo de anuncio de prueba Descripción Formato de anuncio admitido

VID_HD_16_9_46S_APP_INSTALL

Anuncio de 46 segundos con video HD de 16×9 con opción de llamada a la acción de instalación de la aplicación

Intersticial, video con premio, nativo

VID_HD_16_9_46S_LINK

Anuncio de 46 segundos con video HD de 16×9 con opción de enlace de llamada a la acción

Intersticial, video con premio, nativo

VID_HD_16_9_15S_APP_INSTALL

Anuncio de 15 segundos con video HD de 16×9 con opción de llamada a la acción de instalación de la aplicación

Intersticial, video con premio, nativo

VID_HD_16_9_15S_LINK

Anuncio de 15 segundos con video HD de 16×9 con opción de enlace de llamada a la acción

Intersticial, video con premio, nativo

VID_HD_9_16_39S_APP_INSTALL

Anuncio de 39 segundos con video HD de 9×16 con opción de llamada a la acción de instalación de la aplicación

Intersticial, video con premio, nativo

VID_HD_9_16_39S_LINK

Anuncio de 39 segundos con video HD de 9×16 con opción de enlace de llamada a la acción

Intersticial, video con premio, nativo

IMG_16_9_APP_INSTALL

Anuncio con foto de 16×9 con opción de llamada a la acción de instalación de la aplicación

Banner, intersticial, nativo

IMG_16_9_LINK

Anuncio con foto de 16× 9 con opción de enlace de llamada a la acción

Banner, intersticial, nativo

CAROUSEL_IMG_SQUARE_APP_INSTALL

Anuncio por secuencia con imagen cuadrada y opción de llamada a la acción de instalación de la aplicación

Intersticial, nativo

CAROUSEL_IMG_SQUARE_LINK

Anuncio por secuencia con foto cuadrada y opción de enlace de llamada a la acción

Intersticial, nativo

Al probar las ubicaciones de anuncios con el tipo de anuncio de prueba, presta atención al formato de anuncio admitido. Por ejemplo, si creas una instancia de video con premio para solicitar un anuncio con el tipo de anuncio de prueba IMG_16_9_APP_INSTALL, recibirás un error de visualización.

Código de ejemplo para solicitar anuncios de prueba en dispositivos iOS

Por ejemplo, para solicitar un anuncio de prueba con video con una relación de aspecto 9:16 y el botón de llamada a la acción de instalación de la aplicación en la aplicación de iOS, debes inicializar un objeto FBNativeAd. Para eso, agrega la siguiente línea de código:

[FBNativeAd *nativeAd = [[FBNativeAd alloc] initWithPlacementID:@"VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID"];

Puedes ejecutar el código anterior para solicitar un anuncio de prueba en el proyecto "NativeAdSample" de la carpeta de muestra del SDK de Audience Network.

Si necesitas solicitar anuncios de prueba con un formato de contenido aleatorio, verás un mensaje como este impreso en el Logcat al hacer la prueba en un dispositivo de Android físico:

#ifdef DEBUG
[FBAdSettings setLogLevel:FBAdLogLevelLog];
[FBAdSettings addTestDevice:@"HASHED_ID"];
#endif

Deberías ver el siguiente mensaje de registro:

[FBAudienceNetworkLog/FBAdSettings:94] 
When testing your app with Facebook ad units,  
you must specify the device hashed ID to ensure the delivery of test ads, 
add the following code before loading an ad: `[FBAdSettings addTestDevice:@"HASHED_ID"]`
Test mode device hash: bd675f960298a92003630d76fa612b1706b745ab

Reemplaza HASHED_ID con el identificador de dispositivo de modo de prueba que figura en el registro anterior.

Cuando finalices la prueba, debes eliminar la configuración del dispositivo de prueba con esta línea de código:

[FBAdSettings clearTestDevice:[FBAdSettings testDeviceHash]]; 

Código de ejemplo para solicitar anuncios de prueba en dispositivos Android

Para solicitar un anuncio de prueba con video con una relación de aspecto 9:16 y el botón de llamada a la acción de instalación de la aplicación en la aplicación de Android, debes inicializar un objeto NativeAd. Para eso, agrega la siguiente línea de código:

nativeAd = new NativeAd(this, "VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID");

Si necesitas solicitar anuncios de prueba con un formato de contenido aleatorio, verás un mensaje como este impreso en el Logcat al hacer la prueba en un dispositivo de Android físico:

Registro: identificador del dispositivo en modo de prueba: HASHED_ID Registro: Al probar tu aplicación con anuncios de Facebook, debes especificar el identificador con hash del dispositivo para garantizar la entrega de los anuncios de prueba y agregar el siguiente código antes de cargar un anuncio: AdSettings.addTestDevice("HASHED ID");

Puedes activar los anuncios de prueba en un dispositivo agregando la siguiente línea de código antes de cargar un anuncio:

AdSettings.addTestDevice("HASHED ID");

Si quieres agregar varios dispositivos de prueba, simplemente crea una lista de cadenas para agregar antes de cargar un anuncio:

List<String> testDevices = new ArrayList<>();
testDevices.add("HASHED_ID_1");
testDevices.add("HASHED_ID_2");
AdSettings.addTestDevices(testDevices);

Cuando finalices la prueba, debes eliminar la configuración del dispositivo de prueba con esta línea de código:

AdSettings.clearTestDevices();

Ejemplos de solicitud de anuncios de prueba en el panel de mediación

Además de solicitar el anuncio de prueba mediante código, puedes configurar el valor del identificador de ubicación con el tipo de anuncio de prueba en el panel de mediación si la aplicación usa esta última. Por ejemplo, si la aplicación usa MoPub, puedes editar la red de Facebook y definir el valor del identificador de ubicación para el anuncio nativo como VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID. La aplicación recibirá un anuncio de prueba con video con una relación de aspecto de 9:16 y el botón de llamada a la acción de instalación de la aplicación.



Paso 5: Lista de comprobación de la integración de anuncios de Audience Network

  1. Instala la aplicación de Facebook en el dispositivo de prueba e inicia sesión en ella.
  2. Agrega a tu cuenta las personas que realizan las pruebas de los anuncios de Audience Network en el administrador comercial.
  3. Asegúrate de inicializar la instancia del anuncio con el identificador de ubicación que creaste en el administrador comercial. Consulta los Primeros pasos.
  4. Comprueba que tu aplicación haya solicitado correctamente anuncios de producción de Audience Network. Para fines de diagnóstico, usa los códigos de error de Audience Network y el depurador de solicitudes de Audience Network.
  5. Comprueba que los anuncios puedan verse completos y claramente.
  6. Comprueba la experiencia del usuario de la integración de los anuncios al probar los anuncios. Asegúrate de eliminar el fragmento de código del anuncio de prueba antes de publicar la aplicación en la tienda de aplicaciones. De lo contrario, la aplicación de producción solo mostrará anuncios de prueba.

Usar dispositivos de prueba

Si tu equipo utiliza dispositivos de prueba designados para probar las integraciones de Audience Network, puedes utilizar la función de dispositivos de prueba que es útil en el proceso de prueba. Para usar la función:

  1. Asegúrate de iniciar sesión como administrador en el administrador comercial.
  2. Ve a la página de información general sobre el negocio en el administrador de monetización.
  3. Haz clic en el menú desplegable de configuración de monetización en la esquina superior derecha.
  4. Haz clic en test device settings para ir a la página de configuración de dispositivos de prueba.

Verás la siguiente página:

En esta página, puedes agregar una lista de dispositivos al grupo de dispositivos de prueba y configurar sus opciones. Existen dos opciones:

  • Testing enabled: esta opción activa o desactiva el grupo de dispositivos de prueba. Si se desactiva, no se aplica ninguna opción de la configuración de dispositivos de prueba y el sistema de anuncios trata a los dispositivos de prueba como dispositivos de usuario normales.
  • Use real advertiser content: esta opción permite ver anuncios de Audience Network reales durante la prueba en los dispositivos de prueba, pero no genera ingresos de las impresiones o los clics. Nuestro sistema mostrará una lista de ejemplo con anuncios de tipos de contenido diferentes (por ejemplo, videos, imágenes, secuencias) o incluso configuraciones regionales diferentes para poder ver el aspecto de los anuncios reales en la integración.

Para agregar dispositivos a la lista de dispositivos de prueba, puedes usar la entrada manual o seguir la plantilla CSV para cargar varios dispositivos al mismo tiempo.

Las identificaciones utilizadas para los dispositivos de prueba son Identifier for Advertising (IDFA) for iOS devices y Google Advertising ID (AAID) for Android devices. Los nombres de los dispositivos son para uso personal. Estas son varias maneras de buscar identificadores para un dispositivo móvil:

  • Usa utilidades donde se muestren IDFA o AAID que se puedan encontrar en Play Store o App Store.
  • Usa la API para recuperar estos identificadores mediante programación en Android o iOS.
  • En la mayoría de los sistemas Android, se puede ir a Settings -> Google -> Ads para visualizar AAID.

Después de agregar los dispositivos a la lista y habilitar las pruebas para la lista de dispositivos de prueba, cuando envíes una solicitud de anuncio desde el dispositivo de prueba, te devolveremos el anuncio de prueba correspondiente para facilitar la prueba de la integración.