Pruebas de integración de SDK para marketers

En resumen: Prueba la integración de tu aplicación Android o iOS con AppsFlyer. 

General

Una vez completada la integración del SDK, puedes verificar que el SDK se esté comunicando correctamente con los servidores de AppsFlyer. Los marketers pueden elegir entre dos métodos de prueba:

Los desarrolladores pueden realizar pruebas de integración en su entorno de desarrollo. Consulta los artículos sobre pruebas de integración del Dev Hub.

Las aplicaciones CTV también se pueden probar, consulta Pruebas CTV.

Probando mediante la página de Pruebas de Integración del SDK

Utiliza la página de Pruebas de integración del SDK para ver eventos en vivo, instalaciones y eventos in-app en tiempo real a medida que ocurren en tu aplicación, probar instalaciones no orgánicas, eventos in-app y deep linking (retargeting), y localizar cualquier problema de integración en tu proyecto. La visualización de eventos en vivo reemplaza la herramienta de prueba de eventos in-app.

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

Prepara un dispositivo de prueba

  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.

Realizar las pruebas de integración

La página de Pruebas de integración del SDK proporciona las siguientes tres pruebas:

Ver eventos en vivo

La visualización de eventos en vivo es una herramienta de prueba que muestra datos en tiempo real enviados desde el SDK a AppsFlyer, como eventos de instalación y otros eventos in-app. Para cada evento capturado, puedes ver el registro y los detalles del evento.

Para ver eventos en el Live Event Viewer:

  1. En AppsFlyer, desde el menú lateral, selecciona Configuración > Pruebas de integración de SDK.

  2. Haz clic en Eventos en vivo.

  3. En la lista de la aplicación, selecciona la aplicación que deseas probar.
  4. En la lista de dispositivos de prueba, selecciona el dispositivo que deseas utilizar para probar tu aplicación. Si no tiene un dispositivo de prueba, puedes registrar uno haciendo clic en el enlace Agregar un dispositivo de prueba.
  5. Haz clic en Continuar para comenzar a grabar los eventos de tu aplicación.
  6. Abre la aplicación e interactúa con ella para generar sesiones y eventos in-app.

  7. Haz clic en un elemento de evento para ver los detalles del evento en el panel derecho.
  8. Si deseas detener la grabación de los eventos haz clic en Detener. Haz clic en Iniciar nuevamente cuando desees continuar.

Probar instalaciones no orgánicas

Para probar instalaciones no orgánicas:

  1. En AppsFlyer, desde el menú lateral, selecciona Configuración > Pruebas de integración de SDK

  2. Haz clic en la prueba deInstalaciones no orgánicas.

  3. En la lista de la aplicación, selecciona la aplicación que deseas probar.
  4. En la lista de dispositivos de prueba, selecciona el dispositivo que deseas utilizar para probar tu aplicación. Si no tiene un dispositivo de prueba, puedes registrar uno haciendo clic en el enlace Agregar un dispositivo de prueba.
  5. Si la aplicación probada está instalada en tu dispositivo de prueba, debes eliminarla.
  6. Selecciona la casilla de verificación Eliminé la aplicación del dispositivo de prueba.
  7. Haz clic en Continuar y sigue los pasos del asistente.

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.

Probar deep links (retargeting)

Antes de empezar:

  • Abre la aplicación de prueba al menos 3 veces.
  • Para probar deep linking (retargeting), se debes definir OneLink para tu aplicación. Para obtener más información, consulta la guía de configuración de OneLink
  • Verificar que el retargeting está encendido.

Para probar deep links:

  1. En AppsFlyer, desde el menú lateral, selecciona Configuración > Pruebas de integración de SDK.

    Keyboard Maestro Engine 2024-10-06 10.00.47.png

  2. Haz clic en Retargeting.

  3. En la lista de la aplicación, selecciona la aplicación que deseas probar.
  4. En la lista de dispositivos de prueba, selecciona el dispositivo que deseas utilizar para probar tu aplicación. Si no tiene un dispositivo de prueba, puedes registrar uno haciendo clic en el enlace Agregar un dispositivo de prueba.
  5. Haz clic en Continuar y sigue los pasos del asistente.

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 : Añade el ID de tu 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á probando una aplicación disponible a través de una tienda Android de terceros, debes agregar el parámetro af_r al enlace de atribución. 
    5. Reemplaza el GAID, IDFA o IDFV con tu identificador de dispositivo específico.
    Android iOS
    https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

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

     Nota

    Si estás probando una aplicación iOS sin registrar un dispositivo de prueba, Fraud360 puedes marcar tu clic de prueba como fraudulento.

    Para evitar que este evento se detecte como fraude, agrega el siguiente parámetro de consulta a tu enlace: pid=”ios_testing”

  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 Notas de iOS y hagas 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, se muestra 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 conduce 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 Prueba. Espere hasta 30 minutos para que la instalación aparezca en el dashboard 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 AppsFlyer, en el menú lateral, selecciona Reporte > Exportación de Raw Data.
    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 debug, 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 dashboard 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 dashboard.

    Testing_InAppEvents_Attribution

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

Para descargar el reporte:

  1. En AppsFlyer, desde el menú lateral, selecciona Reporte >Exportación de raw data.
  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 e iOS. OneLink reconoce el dispositivo del usuario y lo redirecciona a la tienda de aplicaciones correspondiente.

Además, OneLink permite deep linking. Deep linking te permiten abrir la aplicación en una actividad de aplicación específica y al mismo tiempo ofrecer contenido personalizado.

Para obtener más información, consulta 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 dashboard que se registró una instalación.
  • Para el re-engagement: Hacer clic en un enlace de atribución de retargeting o en un deep link y luego verificar que la nueva interacción 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 dashboard de la aplicación, haz clic en Configuración de la app 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=truey el ID de publicidad. Para ver el GAID, IDFA o IDFV, sigue las instrucciones de Registro de un dispositivo de prueba.
      El siguiente es un ejemplo de un enlace de atribución que incluye un parámetro específico de Android como el 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 reengagement.

Probar la reatribución

Antes de empezar:

  • 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 Notas de iOS y hagas 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: Instalar desde Android Studio o un archivo APK.
      • Para iOS: Instalar desde TestFlight.
  4. Abre el dashboard 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 dashboard.

    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 AppsFlyer, en el menú lateral, selecciona Reporte > Exportación de Raw Data.
    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 debug, 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 empezar:

  • Sigue las instrucciones para configurar pruebas de retargeting. 
  • Para fines de prueba, define el tiempo mínimo entre conversiones en None. Esto permite que todas las conversiones de reactivación se registren y atribuyan 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 (deep linking directos):

Asegúrate de que tu aplicación esté configurada para deep linking y, luego, sigue este procedimiento para realizar pruebas.

Para probar el re-engagement (deep linking 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 dashboard, 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 la reactivación se haya atribuido a la fuente de medios correcta. Este reporte tarda varios minutos en descargarse.

Para descargar el reporte:

  1. En AppsFlyer, en el menú lateral, selecciona Reporte > Exportación de Raw Data.
  2. En la sección Retargeting, descarga el reporte de Conversiones (re-engagements y reatribuciones).

Pruebas de 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 dashboard de la aplicación muestra una instalación orgánica nueva. Espera hasta 30 minutos para que aparezca la instalación.

Prueba CTV

Entre los casos de prueba especiales se incluyen los siguientes:

  • Android TV: El SDK es compatible con smart TVs 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 tvOS no publicadas: Requieren que un marketer y un desarrollador trabajen juntos (consulta Probando 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 dashboard de AppsFlyer. (Saber más sobre la atribución de Amazon Fire TV).
  • Eventos web de PBA: Requieren que un marketer y un desarrollador trabajen juntos (consulta Probando de integración del SDK web de PBA).

Ver también