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 físicos con anuncios de producción antes de incorporarla en la fase de producción. Asegúrate de usar el SDK de Audience Network más reciente en tu integración para que incluya las últimas mejoras y correcciones de errores. En las siguientes secciones, se ofrece información detallada para probar tu aplicación con la integración de los anuncios de Audience Network.

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

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 evaluadores a la configuración de tu aplicación a fin de activarlos para que vean 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. 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 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. Ve al sitio para desarrolladores 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. 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.

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.

En la sección "Audience Network" del sitio 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. 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 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.


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 sitio para desarrolladores de tu aplicación en Facebook. 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

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

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

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, 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 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 físico:

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.



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 identificadores de usuario de evaluadores a tu sitio para desarrolladores de Audience Network.
  3. Asegúrate de inicializar la instancia del anuncio con el identificador de ubicación que creaste desde tu sitio para desarrolladores de Audience Network. Consulta los Primeros pasos.
  4. Comprueba que tu aplicación solicitó 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.