Probar la implementación de Audience Network

Cuando integres Facebook Audience Network en tu aplicación o sitio web para celulares, debes probar la implementación en dispositivos reales con anuncios reales antes de incorporarla en la fase de producción. Asegúrate de usar los SDK de Audience Network más recientes en tu integración para que incluyan las últimas mejoras y soluciones a errores. En las siguientes secciones, se proporciona información sobre cómo probar tu aplicación y sitio web.

Puedes mostrar anuncios de prueba en un simulador de iOS o Android activando el modo de prueba y especificando el identificador con hash del dispositivo. Esta es una forma inicial de probar tu implementación. Te recomendamos también probarla en dispositivos reales con anuncios reales siguiendo estos pasos.

1. Probar con anuncios reales

2. Códigos de error de las solicitudes de anuncios reales

3. Probar con anuncios de prueba

Probar solicitudes con el depurador de solicitudes de Audience Network

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.

En la sección "Audience Network" del panel para desarrolladores: https://developers.facebook.com/apps/<your_app_id>/audience-network/

Ve a la sección "Aplicaciones" a la izquierda del panel en "Audience Network" y desplázate hasta ver "Depurador de solicitudes de Audience Network". Haz clic en el botón Start y la herramienta comenzará a supervisar las solicitudes de la aplicación hechas por ti.

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 y 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 un simulador o emulador.
  2. Asegúrate de que la aplicación de Facebook esté instalada en tu dispositivo de prueba.
  3. Asegúrate de tener una sesión iniciada en Facebook en tu dispositivo de prueba, con un usuario que sea administrador, desarrollador o evaluador de la aplicación de Facebook Audience Network.
  4. Si estás usando mediación, comprueba que la capa de mediación esté enviando solicitudes a Facebook Audience Network.

Probar con anuncios reales

Probar la implementación con anuncios reales es un proceso de dos pasos. El primer paso es agregar evaluadores a la configuración de tu aplicación a fin de activarlos para que vean anuncios reales antes de que se apruebe la aplicación. El segundo paso consiste en que esos evaluadores usen tu aplicación o sitio web para celulares una vez que inicien sesión en Facebook. Estos son los detalles sobre cómo realizar ambos pasos.

Agregar evaluadores a tu aplicación

Puedes probar tu aplicación o sitio web para celulares con anuncios reales y en dispositivos reales 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. Ve al panel de tu aplicación y haz clic en la pestaña "Roles" en el lado izquierdo.
  2. En la sección "Evaluadores", haz clic en el botón "Agregar evaluadores". Los usuarios también pueden tener los roles de administrador o desarrollador. Recomendamos el rol de evaluador para los usuarios que necesitan probar la aplicación o el sitio web, pero no tienen permiso para ver su configuración en Facebook.
  3. Escribe el nombre, el identificador de Facebook o nombre de usuario de la persona que quieres agregar como evaluador y haz clic en "Enviar". Aquí puedes ingresar varias personas.
  4. Ahora deberías ver a las personas que ingresaste como evaluadores.

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 tus evaluadores mediante tu método de distribución preferido.
  2. Cada uno de los evaluadores que agregaste necesita 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 porque Facebook necesita reconocer al usuario como un evaluador de la aplicación para poder devolver un anuncio independientemente del estado de revisión de la aplicación.
  3. El evaluador ahora puede iniciar tu aplicación y realizar los pasos necesarios para activar las ubicaciones que quieres probar. Debería ver un anuncio real.

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.

Códigos de error de las solicitudes de anuncios reales

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

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.

Probar con anuncios de prueba

Debes asegurarte de que el usuario que prueba la aplicación se agregue a un rol en el panel de tu aplicación en Facebook. Este es el método de prueba recomendado ya que te permite ver anuncios reales en dispositivos reales. Consulta la sección Probar con anuncios reales 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 apariencia de los anuncios reales 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 reales 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.

Tabla de tipos de anuncio de prueba

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

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

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

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

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.

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 agregando 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, también puedes agregar la siguiente línea de código antes de cargar la solicitud del anuncio:

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

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.

Cuando termines 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 agregando 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 real:

Registro: identificador del dispositivo en modo de prueba: HASHED_ID Registro: cuando pruebes 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 termines 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.