Probar la implementación de Audience Network

Cuando integres Facebook Audience Network en tu aplicación o sitio web para móviles, es recomendable probar la implementación en dispositivos físicos con anuncios de producción antes de poner el producto a disposición del público. Usa el SDK más reciente de Audience Network en tu integración para incorporar las últimas mejoras y correcciones de errores. En las siguientes secciones se ofrece información detallada para probar tu aplicación o sitio web para móviles con la integración de los anuncios de Audience Network.

Paso 1: realizar pruebas con anuncios de producción

Paso 2: comprobar la existencia de códigos de error en las solicitudes de anuncios de producción

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

Paso 4: realizar pruebas con anuncios de prueba

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

Paso 1: realizar pruebas con anuncios de producción

Para hacer pruebas con anuncios de producción, debe seguirse un proceso que consta de dos pasos. El primero consiste en añadir personas a la página de configuración del negocio para que puedan ver anuncios de producción antes de que se apruebe la aplicación. En el segundo paso, los evaluadores asignados pueden utilizar la aplicación o el sitio web para móviles con la sesión iniciada en Facebook.

Añadir evaluadores a la aplicación

Para probar la aplicación o el sitio web para móviles en dispositivos físicos con anuncios de producción, asegúrate de añadir a la persona encargada de la prueba a tu aplicación de Facebook (con cualquier rol). Este es el método recomendado para añadir evaluadores a una aplicación:

  1. Accede a la configuración del negocio.
  2. En la pestaña Personas de la parte izquierda, haz clic en +Añadir.
  3. Escribe la dirección de correo electrónico de la persona que quieres añadir a tu cuenta de Business Manager. Puedes añadir a varias personas en este paso.
  4. Tienes la opción de asignar roles a las personas o de hacer clic en Omitir para añadirlas únicamente a tu cuenta de Business Manager.

Si utilizas una capa de mediación, asegúrate de que envíe solicitudes a Audience Network. Si activas las pruebas en la capa de mediación, es posible que no envíe solicitudes a nuestros servidores.

Probar aplicaciones para móviles

  1. Usa el método de distribución que prefieras para poner tu aplicación a disposición de los evaluadores en sus dispositivos y comprueba que estas personas figuren en la página de configuración de tu Business Manager.
  2. Cada persona que hayas añadido debe tener la aplicación de Facebook instalada en su dispositivo e iniciar sesión en ella con el identificador de usuario de Facebook que hayas añadido al rol de evaluador. Este paso es obligatorio porque Facebook debe identificar al usuario como miembro de tu negocio para poder mostrarle anuncios.
  3. Una vez completado este paso, el evaluador puede iniciar tu aplicación y activar las ubicaciones que quieras probar. Asimismo, debería poder ver un anuncio de producción.

Cuando pruebes las ubicaciones del anuncio que te interesan, Facebook devolverá intencionadamente un error “No Fill” para aproximadamente el 20 % de las solicitudes. Esto te permitirá probar cómo tu aplicación o sitio web para móviles gestiona los casos en los que no se pueda completar una solicitud debido a este error.

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 solucionar este problema, puedes activar el modo de prueba para que se muestre el anuncio de prueba.



Paso 2: comprobar la existencia de códigos de error en las solicitudes de anuncios de producción

Cuando pruebes la implementación de Facebook Audience Network, es posible que obtengas alguno de los códigos de error que pueden aparecer al realizar una solicitud. Estos códigos 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 puede acceder a facebook.com (http://facebook.com/).
  • Tu aplicación debe intentar realizar otra solicitud hasta que se pueda acceder a la red. Recomendamos realizar cada vez más solicitudes hasta que se vuelva a establecer una conexión o se agote el tiempo de espera.

1001 - No Fill

Este es un error habitual cuando se realizan pruebas y está asociado a una respuesta “No Fill”. Este error normalmente se produce porque el usuario no tiene sesión iniciada en la aplicación de Facebook mientras prueba tu aplicación para móviles o, en el caso de probar tu sitio web, porque no ha iniciado sesión en el sitio web para móviles de Facebook.

Respuesta del servidor Documentación del SDK

Code=1001 “No Fill”

  • Error 1001 - No Fill. Este error puede producirse por una o varias de estas razones:
  • El usuario no ha iniciado sesión en la aplicación de Facebook nativa en el dispositivo móvil.
  • Se ha activado la opción “Limitar el seguimiento de anuncios” (iOS).
  • Se ha activado la opción “Inhabilitar anuncios basados en intereses” (Android).
  • No existe un inventario de anuncios para el usuario actual.
  • El dispositivo para realizar las pruebas debe tener instalada la aplicación de Facebook nativa.
  • Tu aplicación debería intentar hacer otra solicitud cuando pasen 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 debería intentar hacer otra solicitud cuando pasen 30 minutos. También te recomendamos ajustar la frecuencia de solicitudes o la de actualización.

1011 - Display Format Mismatch

Respuesta del servidor Documentación del SDK

Code=1011 “Display Format Mismatch”

  • Error 1011 - Display Format Mismatch debido a lo siguiente:
  • El formato de visualización de la solicitud de anuncio no es el que se ha especificado para esta ubicación.
  • A cada ubicación le corresponde un único formato de visualización.
  • Si deseas usar formatos de visualización diferentes, puedes crear varias ubicaciones.

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 la debe realizar 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. Las posibles causas de este error son:
  • Identificador de ubicación no válido: cada ubicación y tipo tiene un identificador único.
  • Versión obsoleta o no compatible del SDK: descarga la versión más reciente o actualiza tu Pod si utilizas Cocoa Pods.
  • Llamada inadecuada al método loadAd o uso inapropiado de dicho método. Recomendamos colocar puntos de interrupción en loadAd y en los métodos o devoluciones de llamada asociados.
  • Tu aplicación debería intentar hacer otra solicitud cuando pasen 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 ha podido procesar una respuesta procedente de facebook.com.
  • Tu aplicación debería intentar hacer otra solicitud cuando pasen 30 segundos.
  • Si esto ocurre con regularidad, rellena y envíanos un informe de error.


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

Cuando hayas implementado las ubicaciones en tu aplicación, podrás usar la herramienta de depuración de solicitudes de Audience Network para comprobar que Facebook recibe las solicitudes de tu aplicación.

  1. Ve al administrador de monetización.
  2. Haz clic en Administrar propiedad.
  3. Haz clic en Configuración de propiedades > Depurador de solicitudes en la parte superior derecha.
  4. Haz clic en Iniciar para comenzar a supervisar las solicitudes de tu aplicación o sitio web.

Utilizando tu dispositivo de prueba para iOS o Android, activa las ubicaciones de anuncio de Audience Network desde la aplicación. De esta manera, las solicitudes de anuncios aparecerán en la herramienta. Comprueba que las solicitudes se envían con el identificador de ubicación, el nombre del paquete y demás datos correctos.

Este proceso requiere un dispositivo físico y no funcionará ni en el simulador de iOS ni en el emulador de Android.

Debes iniciar sesión en la aplicación de Facebook desde el mismo dispositivo de prueba que quieres que la herramienta supervise.

Si las solicitudes de anuncios no aparecen en la herramienta, es porque Facebook no recibe las solicitudes como debería. Para realizar la depuración, haz las siguientes comprobaciones:

  1. Asegúrate de usar 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. Comprueba que el evaluador que haya iniciado sesión en Facebook desde su dispositivo de prueba también cuente con un rol en tu negocio.
  4. Si usas mediación, asegúrate de que la capa correspondiente envíe las solicitudes a Facebook Audience Network.


Paso 4: Pruebas con anuncios de prueba

Asegúrate de que el usuario encargado de realizar las pruebas tenga asignado un rol en el Business Manager de tu aplicación. Este es el método recomendado para realizar pruebas, ya que te permite ver anuncios de producción en dispositivos físicos. Consulta la sección Pruebas con anuncios de producción para obtener más información sobre el método recomendado para hacer pruebas.

Sin embargo, tal como se ha indicado en la sección anterior, es probable que no siempre puedas 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 podrás saber con seguridad si el anuncio que recibirá la aplicación será un anuncio con imagen, con vídeo o por secuencia. Solicitar anuncios de producción no te asegura saber cuál será el contenido o el formato del anuncio que recibirá la aplicación. ¿Qué pasa si quieres probar con un anuncio con contenido de vídeo vertical para asegurarte de que se vea 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 pongas la aplicación a disposición del 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, a continuación, #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 compatible

VID_HD_16_9_46S_APP_INSTALL

Anuncio de 16 x 9 con vídeo HD de 46 segundos con botón de llamada a la acción para la descarga de la aplicación

Intersticial, vídeo con premio, nativo

VID_HD_16_9_46S_LINK

Anuncio de 16 x 9 con vídeo HD de 46 segundos con llamada a la acción en forma de enlace

Intersticial, vídeo con premio, nativo

VID_HD_16_9_15S_APP_INSTALL

Anuncio de 16 x 9 con vídeo HD de 15 segundos con botón de llamada a la acción para la descarga de la aplicación

Intersticial, vídeo con premio, nativo

VID_HD_16_9_15S_LINK

Anuncio de 16 x 9 con vídeo HD de 15 segundos con llamada a la acción en forma de enlace

Intersticial, vídeo con premio, nativo

VID_HD_9_16_39S_APP_INSTALL

Anuncio de 16 x 9 con vídeo HD de 39 segundos con botón de llamada a la acción para la descarga de la aplicación

Intersticial, vídeo con premio, nativo

VID_HD_9_16_39S_LINK

Anuncio de 16 x 9 con vídeo HD de 39 segundos con llamada a la acción en forma de enlace

Intersticial, vídeo con premio, nativo

IMG_16_9_APP_INSTALL

Anuncio con foto de 16 x 9 con botón de llamada a la acción para la descarga de la aplicación

Banner, intersticial, nativo

IMG_16_9_LINK

Anuncio con foto de 16 x 9 con llamada a la acción en forma de enlace

Banner, intersticial, nativo

CAROUSEL_IMG_SQUARE_APP_INSTALL

Anuncio por secuencia con foto cuadrada y botón de llamada a la acción para la descarga de la aplicación

Intersticial, nativo

CAROUSEL_IMG_SQUARE_LINK

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

Intersticial, nativo

Cuando realices pruebas de tus 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 un vídeo con premio para solicitar un anuncio con el tipo de anuncio de prueba IMG_16_9_APP_INSTALL, se mostrará un error de visualización.

Ejemplo de solicitud de anuncios de prueba en el código en dispositivos iOS

Por ejemplo, para solicitar un anuncio de prueba con vídeo con una relación de aspecto de 9:16 y el botón de llamada a la acción de descarga de la aplicación en una aplicación para iOS, debes inicializar un objeto FBNativeAd añadiendo 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 ejemplo 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 Android físico:

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

Debería aparecer este 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

Sustituye HASHED_ID por el hash del dispositivo en modo de prueba que figura en el registro anterior.

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

[FBAdSettings clearTestDevice:[FBAdSettings testDeviceHash]]; 

Ejemplo de solicitud de anuncios de prueba en el código en dispositivos Android

Para solicitar un anuncio de prueba con vídeo con una relación de aspecto de 9:16 y el botón de llamada a la acción de descarga de la aplicación en una aplicación para Android, debes inicializar un objeto NativeAd añadiendo 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 Android físico:

Log: Test mode device hash: HASHED_ID Log: Cuando pruebes tu aplicación con anuncios de Facebook, debes indicar el identificador con hash del dispositivo para asegurar la entrega de los anuncios de prueba. Para ello, añade este código antes de cargar un anuncio: AdSettings.addTestDevice("HASHED ID");.

Puedes activar los anuncios de prueba en un dispositivo añadiendo la siguiente línea de código antes de subir un anuncio:

AdSettings.addTestDevice("HASHED ID");

Si quieres añadir varios dispositivos de prueba, solo tienes que crear una lista de cadenas y añadirla 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 borrar la configuración del dispositivo de prueba con esta línea de código:

AdSettings.clearTestDevices();

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

Además de solicitar el anuncio de prueba desde el 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 la usa). 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 vídeo con una relación de aspecto de 9:16 y el botón de llamada a la acción de descarga 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 tu dispositivo de prueba e inicia sesión.
  2. Añade a las personas que estén probando tus anuncios de Audience Network a tu cuenta de Business Manager.
  3. Asegúrate de inicializar la instancia de anuncio con el identificador de ubicación creado desde esta herramienta. Consulta la sección Primeros pasos.
  4. Comprueba si tu aplicación ha solicitado correctamente los anuncios de producción de Audience Network. Usa los códigos de error y el depurador de solicitudes de Audience Network para realizar diagnósticos.
  5. Comprueba si tu aplicación muestra claramente los anuncios a los usuarios.
  6. Evalúa la experiencia de usuario de la integración de los anuncios mediante anuncios de prueba. 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.