Pruebas de integración de SDK para marketers

Para:
Marketers
Última actualización:

De un vistazo: Prueba la integración de tu aplicación Android o iOS con AppsFlyer. 

Lectura relacionada para las redes de publicidad: Prueba de integración con redes de publicidad

Información general

La integración probada de manera exhaustiva garantiza que la recopilación de los datos sea precisa y completa. Al probar la integración del SDK, puedes verificar que el SDK se está comunicando correctamente con los servidores de AppsFlyer y que las instalaciones, los eventos in-app y el retargeting se registran y atribuyen correctamente. 

Una vez que se completa la integración de SDK, cualquier miembro del equipo con acceso al panel de control de AppsFlyer puede realizar pruebas básicas. Los desarrolladores pueden utilizar registros de depuración en el entorno de desarrollo.

En este artículo se describen los procedimientos de prueba desde el panel de control y se proporcionan enlaces a la documentación que el marketer debe proporcionar al desarrollador. 

Métodos de prueba

Las siguientes secciones describen las diversas pruebas a realizar y los métodos disponibles.

Pruebas desde el panel de control

Para probar la integración de SDK desde el panel de control, primero debes registrar un dispositivo de prueba (Android o iOS). Esto te permite utilizar el mismo dispositivo repetidamente y evita que las instalaciones se registren como reinstalaciones.  

Debes hacer lo siguiente:

  • Prueba las instalaciones orgánicas.
  • Prueba la funcionalidad de integración básica (instalaciones no orgánicas, eventos in-app y retargeting).
    Los métodos disponibles incluyen:
    • Página de prueba de la integración de SDK: un asistente en el panel de control de AppsFlyer que te guía a través del proceso de ejecución de cada prueba.
    • Pruebas que utilizan enlaces de atribución: todas las redes de publicidad no SRN y las fuentes de medios de propiedad se basan en los enlaces de atribución de AppsFlyer; por lo tanto, se recomienda encarecidamente realizar pruebas utilizando enlaces de atribución. Debes crear enlaces de atribución y luego ejecutar pruebas para verificar que el SDK atribuya las instalaciones no orgánicas y los eventos in-app a las fuentes de medios correctas. Además, debes ejecutar pruebas para verificar que el retargeting (reatribución y re-engagement) se registre y se atribuya a las fuentes de medios correctas.

Consideración sobre las pruebas de iOS 14+

A partir de iOS 14.5, el identificador de anunciante (IDFA) solo está disponible si el usuario da su consentimiento a través del aviso de seguimiento de la transparencia de aplicaciones (ATT). Si la solicitud de ATT se implementó en tu aplicación, puedes ejecutar pruebas como un usuario con consentimiento o sin consentimiento.  Para obtener más información, consulta los lineamientos para registrar tu dispositivo de prueba con el identificador de anunciante (IDFA) o el identificador de proveedor (IDFV).

Pruebas en el entorno de desarrollo

Un desarrollador puede hacer lo siguiente:

  • Habilitar e inspeccionar los registros de depuración y probar escenarios como validación de compras, datos de conversión y enlaces profundos.

     Nota

    Si tu desarrollador recibe una respuesta 403 en los registros, podría deberse a que tiene el paquete Zero. Este paquete no incluye datos de atribución, solo datos sobre clics e impresiones. Para obtener más información sobre nuestros paquetes, comunícate con el equipo de CEM a hello@appsflyer.com o visita Precios de AppsFlyer.

  • Crear una aplicación de depuración para probar la integración de SDK. Al realizar pruebas, los datos se registran y se muestran en el panel de control. Una vez que se registran los datos, no se pueden eliminar. Si no quieres que los datos de prueba se registren como parte de una aplicación de producción, puedes pedirle a tu desarrollador que pruebe la integración de SDK utilizando aplicaciones de depuración. Una aplicación de depuración se diferencia de una aplicación de producción en que tiene un ID de aplicación de AppsFlyer diferente, su propio panel de control y no está publicada en las tiendas de aplicaciones.

Agregar aplicaciones de depuración al panel de control

Si tu desarrollador crea una aplicación de depuración, debes agregar la aplicación al panel de control. Una vez que tu desarrollador comience a realizar pruebas usando la aplicación, los datos se mostrarán en el panel de control de la aplicación.

Realiza uno de los siguientes procedimientos para agregar la aplicación de depuración:

Agregar aplicaciones de depuración (Android) Agregar aplicaciones de depuración (iOS)

Para agregar una aplicación de depuración al panel de control:

  1. Obtén el nombre del paquete de la aplicación de depuración de tu desarrollador y agrega la aplicación a tu panel de control de AppsFlyer.
  2. Establece el estado de la aplicación en uno de los siguientes:
    • Pendiente de aprobación
    • Sin publicar

Casos de prueba especiales

Entre los casos de prueba especiales se incluyen los siguientes:

  • Android TV: el SDK es compatible con Smart TV basados en Android. Un marketer o cualquier miembro del equipo pueden probar estas aplicaciones de TV siguiendo los procedimientos descritos en este artículo.
  • Apple TV (tvOS): el SDK es compatible con Apple TV (tvOS). Un marketer o cualquier miembro del equipo pueden probar estas aplicaciones de TV siguiendo los procedimientos descritos en este artículo.
  • Aplicaciones de tvOS no publicadas: requiere que un marketer y un desarrollador trabajen juntos (consulta Probar la integración de tvOS antes de publicar).
  • Amazon Fire TV: un marketer puede probar la integración utilizando el método de prueba del SDK de Android en el panel de control de AppsFlyer. (Aprender más sobre la atribución de Amazon Fire TV).
  • Eventos web de la PBA: requieren que un marketer y un desarrollador trabajen juntos (consulta Prueba de la integración de SDK web de la PBA).

Cómo probar la funcionalidad básica del SDK

La siguiente sección describe los procedimientos que debes seguir para probar la integración básica del SDK.

Probar las instalaciones orgánicas

Te recomendamos que comiences probando una instalación orgánica.

Para probar una instalación orgánica:

  1. Instala la aplicación en un dispositivo de prueba registrado.
  2. Inicia la aplicación.

El panel de control de la aplicación muestra una instalación orgánica nueva. Espera hasta 30 minutos para que aparezca la instalación.

Test_SDK_Organic_install

Probar el uso de la página de pruebas de integración de SDK

Usa la página de pruebas de integración del SDK para probar instalaciones no orgánicas, eventos in-app y enlaces profundos (retargeting), y para localizar cualquier problema de integración en tu proyecto.

Solo iOS: La página de prueba de integración de SDK solo es compatible para aplicaciones iOS que implementan ATT. Puedes probar aplicaciones sin ATT utilizando el procedimiento especificado aquí.

Antes de comenzar:

  1. Prepara un dispositivo (Android o iOS) que no tenga instalada la aplicación. Si es necesario, desinstala la aplicación del dispositivo.
  2. Registra el dispositivo como un dispositivo de prueba.

Paso 1: Probar las instalaciones no orgánicas

  1. En el dashboard, selecciona la aplicación.
  2. Ve a Integración Pruebas de integración de SDK. 
    Se abre la página de pruebas de integración de SDK. 
  3. Ejecuta la prueba de Instalación no orgánica.
  4. Selecciona un dispositivo de prueba de la lista. 
  5. Selecciona la tienda desde la cual instalar la aplicación:
    • Para Android: 
      • Google Play
      • Otra (por ejemplo, fuera de la tienda, Android Studio, archivo APK) 
    • Para iOS:
      • App Store
      • Otra (por ejemplo, XCode, TestFlight)
  6. Escanea el código QR con tu dispositivo de prueba registrado y sigue las instrucciones que aparecen en tu dispositivo.

    Ten en cuenta que para los dispositivos Android, esta prueba utiliza el método de referente de instalación y, por lo tanto, el enlace de atribución no incluye el ID de publicidad de Google (GAID).

  7. Si seleccionaste Otra, instala la aplicación desde tu entorno de desarrollo.
  8. Espera a que la instalación no orgánica se registre en la página Pruebas de integración de SDK en la cual se indique que la prueba se ha completado con éxito. Este paso puede llevar hasta dos minutos.

    NonOrganic_install

    Si la aplicación no registra una instalación no orgánica, las posibles razones pueden ser:

Para errores de integración, comunícate con tu desarrollador.

Paso 2: Probar los eventos in-app

Antes de comenzar:

  • Asegúrate de utilizar el mismo dispositivo de prueba que se utilizó para registrar una instalación no orgánica.
  1. Ejecuta la prueba de Eventos in-app.
  2. Selecciona un dispositivo de prueba de la lista y luego haz clic en Siguiente. 
  3. Inicia tu aplicación y comienza a generar eventos in-app.
  4. Verás un registro de estos eventos a medida que se van registrando en tiempo real.

    Test_SDK_Integration_Inapp_events

Paso 3: Probar los enlaces profundos (retargeting)

Antes de comenzar:

  • Asegúrate de utilizar el mismo dispositivo de prueba que se utilizó para registrar una instalación no orgánica. 
  • Inicia la aplicación de prueba al menos 3 veces.
  • Para probar los enlaces profundos (retargeting), se debe definir OneLink para tu aplicación. Para obtener más información, consulta la guía de configuración de OneLink. 
  • Verifica que el retargeting esté activado.
  1. Ejecuta la prueba de Enlaces profundos.
  2. Selecciona un dispositivo de prueba de la lista.
  3. Selecciona un tipo de prueba:
    • OneLink: Selecciona el OneLink. 
    • Esquema URI: introduce el esquema URI (por ejemplo, greatapps://cars).
  4. Haz clic en Siguiente.
  5. Escanea el código QR con tu dispositivo de prueba registrado y sigue las instrucciones de tu dispositivo. Una vez finalizada la prueba, la prueba de enlaces profundos se registra como exitosa.

    TestSDK_DeepLinks_en-us.png

Pruebas mediante enlaces de atribución

La siguiente sección describe los procedimientos que debes seguir para probar las instalaciones con enlaces de atribución. Puedes realizar estas pruebas incluso si la app aún está pendiente (es decir, no aparece en Google Play Store ni en Apple App Store).

Probar la atribución de instalaciones

Probar las instalaciones te permite verificar que el SDK de AppsFlyer atribuya las instalaciones correctamente a varias fuentes de medios.

Para probar la atribución de instalaciones:

  1. Copia el siguiente enlace (Android o iOS) y realiza estos cambios:
    1. Valor app_id: agrega tu ID de aplicación en AppsFlyer. 
    2. Parámetro pid: especifica el nombre de la fuente de medios a la que se atribuye la instalación.
    3. Parámetro c: especifica el nombre de la campaña.
    4. Si estás probando una aplicación disponible a través de una tienda Android de terceros: agrega af_r parameter al enlace de atribución. 
    5. Reemplaza el ID de publicidad de Google (GAID), identificador de anunciante (IDFA) o identificador de proveedor (IDFV) con tu identificador de dispositivo específico.
    Android iOS 
    https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

    A continuación, se muestran ejemplos de enlaces de atribución con valores específicos:

    Android iOS 

    https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*
  2. Copia el enlace actualizado, envíalo al dispositivo de prueba y, a continuación, haz clic en el enlace.

     Nota

    En iOS, usa iMessage o el correo electrónico para enviar el enlace al dispositivo. No pegues el enlace en la aplicación Notes de iOS y haz clic en el enlace. Esta acción puede provocar que el enlace se rompa.

  3. Realiza una de las siguientes acciones:
    • Si la aplicación está activa, procede a instalarla.
    • Si la aplicación está pendiente, aparece el siguiente mensaje: "La aplicación que estás buscando aún no está disponible en el mercado". Este es el resultado esperado. Dado que la aplicación no está activa, el enlace de atribución no lleva a ninguna tienda de aplicaciones. Sin embargo, el enlace de atribución sigue siendo válido para fines de atribución y debes instalar la aplicación de la siguiente manera:
      • Para Android: desde un archivo APK (o Android Studio para desarrolladores)
      • Para iOS: desde TestFlight (o Xcode para desarrolladores)

    Deberías ver una instalación atribuida a la campaña de prueba bajo la fuente de medios llamada Test (Prueba). Espera hasta 30 minutos para que la instalación aparezca en el panel de control de la aplicación. Test_Install_Attribution_Link

 Consejo

A continuación se describen formas alternativas de verificar los resultados de las pruebas:

  • Si tienes acceso a reportes de raw data, descarga el reporte de raw data de instalaciones. Este reporte tarda varios minutos en descargarse.

    Para descargar el reporte:

    1. En el panel de control, ve a Reportes > Exportar datos. 
    2. En la lista Adquisición de usuarios (no orgánicos), haz clic en Instalaciones y luego descarga el reporte. 
  • Si tienes acceso a los registros de depuración, puedes usar la API de prueba de integración de SDK para recuperar los resultados de atribución de una instalación específica.

Probar la atribución de eventos in-app

Probar eventos in-app te permite verificar que se muestran los ingresos asociados con un evento y que los eventos in-app se atribuyen a la fuente de medios que genera la instalación.

Para probar la atribución de eventos in-app:

  1. Inicia la aplicación y luego genera algunos eventos in-app.
  2. Abre el panel de control de la aplicación y haz clic en Eventos.

    Deberías ver los eventos, los ingresos (si están asociados a los eventos) y la fuente de medios con la cual están relacionados. Es posible que debas esperar hasta 60-70 minutos para que los eventos aparezcan en el panel de control.

    Testing_InAppEvents_Attribution

¡Consejo! Considera descargar el reporte de raw data de eventos in-app para verificar que los eventos se atribuyen correctamente. Este reporte tarda varios minutos en descargarse.

Para descargar el reporte:

  1. En el panel, ve a Reportes > Datos exportados.
  2. En la sección Reportes de raw data, descarga el reporte de raw data de eventos in-app.

Probar OneLink

OneLink te permite definir un enlace de atribución único para Android y iOS. OneLink reconoce el dispositivo del usuario y lo redirige a la tienda de aplicaciones correspondiente.

Además, OneLink permite establecer enlaces profundos. Los enlaces profundos le permiten abrir la aplicación en una actividad específica de la aplicación mientras ofrece contenido personalizado.

Para obtener más información, consulte nuestra guía sobre pruebas de URL de OneLink.

Cómo probar el retargeting mediante enlaces de atribución

Las siguientes secciones describen los procedimientos que debes seguir para probar la atribución de retargeting.

Acerca de las pruebas de retargeting

La atribución de retargeting se produce cuando un usuario se involucra con una campaña de retargeting haciendo clic en un enlace de atribución de retargeting. Esto da como resultado un evento de reatribución o de re-engagement. Para obtener más información, consulta la guía de atribución de retargeting.

Las pruebas de retargeting incluyen lo siguiente:

  • Para la reatribución: desinstalar y reinstalar la aplicación. Luego, verificar en el panel de control que se registró una instalación.
  • Para el re-engagement: hacer clic en un enlace de atribución de retargeting o en un enlace profundo, y luego verificar que un re-engagement se atribuya a la fuente de medios correcta.

Requisitos previos para ejecutar pruebas de retargeting

Antes de ejecutar las pruebas de retargeting, se requiere la siguiente configuración:

  • El retargeting debe estar activado para la aplicación que estás probando.
  • Crea un enlace específico de la aplicación o recupera un enlace personalizado de OneLink. Estos enlaces deben incluir el parámetro de retargeting.

Para configurar pruebas de retargeting:

  1. Habilita la función de retargeting en la página de configuración de la aplicación.

    En el panel de control de la aplicación, haz clic en Configuración de la aplicación y activa Habilitar atribución de retargeting.

    Set_Reattribution_window

  2. Realiza una de las siguientes acciones: 
    • Crea un enlace de atribución específico para la aplicación. Asegúrate de incluir el parámetro de retargeting, is_retargeting=true y el ID de publicidad. Para ver el ID de publicidad de Google (GAID), el identificador de anunciante (IDFA) o el identificador de proveedor (IDFV), sigue las instrucciones para registrar un dispositivo de prueba.
      A continuación, se muestra un ejemplo de un enlace de atribución que incluye un parámetro específico de Android como identificador del dispositivo (GAID). Para obtener más información sobre cómo agregar otros parámetros de identificador de dispositivo, como el IDFA o IDFV, consulta Estructura y parámetros de enlaces de atribución.  

      https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>
    • Recupera la URL larga del enlace personalizado de una plantilla de OneLink. Asegúrate de activar la campaña de retargeting. La siguiente imagen muestra un ejemplo de una URL larga personalizada:

      Testing_LongLink_en-us.png

Ahora puedes seguir probando la reatribución y el re-engagement.

Probar la reatribución

Antes de comenzar:

  • Sigue las instrucciones para configurar pruebas de retargeting.
  • Asegúrate de que tu dispositivo de prueba no esté registrado.

Para probar la reatribución:

  1. Desinstala la aplicación del dispositivo. Si acabas de instalar la aplicación, espera unos minutos.
  2. Copia el enlace de atribución que creaste anteriormente, ya sea el enlace de atribución específico de la aplicación o el enlace largo personalizado de la plantilla de OneLink, envíalo al dispositivo de prueba y luego haz clic en el enlace.

     Nota

    En iOS, usa iMessage o el correo electrónico para enviar el enlace al dispositivo. No pegues el enlace en la aplicación Notes de iOS y haz clic en el enlace. Esta acción puede provocar que el enlace se rompa.

  3. Realiza una de las siguientes acciones:
    • Si la aplicación está activa, procede a instalarla.
    • Si la aplicación está pendiente, instálala de la siguiente manera:
      • Para Android: instálala desde Android Studio o un archivo APK.
      • Para iOS: instálala desde TestFlight.
  4. Abre el panel de control de la aplicación y, en el cuadro Tipo de vista, selecciona Retargeting.
  5. En el cuadro Tipo de atribución, selecciona Reatribuciones.

    Deberías ver la instalación atribuida a la fuente de medios y la campaña. Es posible que debas esperar hasta 30 minutos para que la instalación con retargeting aparezca en el panel de control.

    Testing_SDK_Reattribution

 Consejo

A continuación se describen formas alternativas de verificar los resultados de las pruebas:

  • Si tienes acceso a reportes de raw data, descarga el reporte de raw data de conversiones. Este reporte tarda varios minutos en descargarse.

    Para descargar el reporte:

    1. En el panel de control, ve a Reportes > Exportar datos. 
    2. En la lista Retargeting, haz clic en Conversiones (re-engagements y reatribuciones) y, a continuación, descarga el reporte. 
  • Si tienes acceso a los registros de depuración, puedes usar la API de prueba de integración de SDK para recuperar los resultados de atribución de una instalación específica.

Probar el re-engagement

Antes de comenzar:

  • Sigue las instrucciones para configurar pruebas de retargeting. 
  • Para fines de prueba, define el tiempo mínimo entre conversiones en Ninguno. Esto permite registrar y atribuir todas las conversiones de re-engagement durante las pruebas.

    Testing_Reattribution_window

  • Asegúrate de tener la aplicación instalada en tu dispositivo de prueba y de haberla iniciado varias veces. Si acabas de instalar la aplicación, espera unos minutos.

Para probar el re-engagement (enlaces profundos directos):

Asegúrate de que tu aplicación esté configurada para enlaces profundos y, a continuación, sigue este procedimiento para realizar pruebas.

Para probar el re-engagement (enlaces profundos indirectos):

  1. Copia el enlace de atribución que creaste anteriormente, ya sea el enlace de atribución específico de la aplicación o el enlace largo personalizado de la plantilla de OneLink.
  2. Envía el enlace a tu dispositivo de prueba y luego haz clic en el enlace.
  3. Para abrir la aplicación, realiza una de las siguientes acciones:
    • En la tienda de aplicaciones, haz clic en Abrir.
    • Inicia la aplicación desde tu dispositivo.

    En el panel de control, deberías ver un re-engagement atribuido a la fuente de medios y la campaña. Espera hasta 30 minutos para que aparezca el re-engagement.

    Testing_SDK_Re-engagement

¡Consejo! Considera descargar el reporte de raw data de conversiones para verificar que el re-engagement se atribuyó a la fuente de medios correcta. Este reporte tarda varios minutos en descargarse.

Para descargar el reporte:

  1. En el panel, ve a Reportes > Datos exportados.
  2. En la sección Retargeting, descarga el reporte de Conversiones (re-engagements y reatribuciones).