Esta es una guía general para instalar Appcues Mobile en sus aplicaciones móviles. A continuación, se destacan los componentes compartidos de la instalación entre nuestros frameworks compatibles: iOS , Android, ReactNative, Flutter e Ionic. Para obtener información técnica más detallada, consulte los repositorios de GitHub enlazados.

La instalación requiere aproximadamente una hora de trabajo por parte de un desarrollador con conocimientos sobre cómo tu aplicación rastrea las propiedades del usuario, las pantallas y los eventos. Necesitarás acceso a la cuenta de Appcues de tu equipo para completar la instalación.

¿Le interesan nuestras medidas de seguridad de datos? Consulte nuestro Centro de Confianza para obtener más información.

Antes de empezar

• Identifique quién en su equipo instalará Appcues
• Complete un plan de instalación para delinear los componentes de instalación personalizados

¿Qué queremos decir con “instalar”?

Hay algunos componentes clave que, en conjunto, contribuyen a una instalación exitosa Appcues . Si bien esta guía los abordará con más detalle, a continuación se presenta una breve descripción de lo que constituye una instalación Appcues :

• Agregue el script SDK Appcues a su producto: Appcues se agrega a su aplicación para conectarse a su cuenta Appcues y mostrar el contenido que ha creado.
• Identificar usuarios y grupos: Informa Appcues cuando un usuario está presente y envía información sobre su identidad. Esto se utiliza para la segmentación y la personalización de experiencias.
• Seguimiento de pantallas: Reconoce la ubicación del usuario en tu aplicación. Esto se utiliza para segmentación por pantalla.
• Seguimiento de eventos: el seguimiento de eventos con Appcues te permite medir la interacción de tus usuarios con tu aplicación. Estos eventos también se pueden usar para segmentación y segmentación.
• Componentes adicionales
  • Compatibilidad con enlaces profundos: se utiliza para depuración, vista previa, captura de pantalla y navegación en su aplicación.
  • Reconocimiento de elementos*: se utiliza con información sobre herramientas anclada para conectar una tooltip a un elemento específico en la pantalla
  • FrameViews* - Crea un contenedor designado dentro de su aplicación para mostrar Appcues Embeds

Todos los componentes son necesarios para la funcionalidad completa y el uso de las funciones de Appcues Mobile

*No compatible con aplicaciones Ionic

Descripción general del video

¿Listo para instalar? ¡Sigue esta guía para los siguientes pasos!

Instalación de Appcues Mobile

Cómo conectar Appcues a su aplicación móvil

Requerido

1. Registra tu(s) aplicación(es) en Studio
   • Esto crea sus AppID, que se utilizan para conectar su aplicación a su cuenta de Appcues para crear y publicar experiencias Appcues
   • Si desea administrar instancias independientes, puede registrar un AppID para cada una y luego configurarlo para cada inicialización. Esto le permite tener flujos y métricas aislados entre una instancia de aplicación de desarrollo y una de producción.
     ¿No tienes varias instancias o no quieres administrarlas en Appcues ? ¡No te preocupes! Los flujos se pueden dirigir a usuarios específicos durante las pruebas en vivo.
2. Agregue el SDK Appcues e inicialícelo
   • Necesitarás lo siguiente:
     • Su ID de cuenta Appcues , que se encuentra en la página de Configuración de cuenta , y
     • Sus AppID registrados, que se encuentran en la página de Configuración de instalación
   • Seleccione su marco a continuación para obtener más detalles:
     • iOS
     • Androide
     • ReactNative
     • Aleteo
     • Iónico

Identificar usuarios y grupos

Requerido

• Appcues requiere que los usuarios se identifiquen para mostrar experiencias y rastrear eventos. Appcues solo utiliza los datos que envías explícitamente mediante las integraciones de identify(), group() y select.
  Tenga en cuenta: Todos los usuarios únicos identificados por Appcues dentro de un período consecutivo de 30 días se consideran usuarios activos mensuales (MAU), independientemente de si ven una experiencia o no.
• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo
  • Iónico
• Ya sea que realice la instalación en nombre de alguien o trabaje directamente dentro de su equipo, lo alentamos a colaborar y seguir un Plan de instalación para delinear qué propiedades incluir.
• Para una identificación de usuario consistente, es mejor llamar identify() cuando el usuario inicia sesión y, posteriormente, a cualquier llamada group() si se utilizan datos de grupo.
  

Identificación de usuarios

Requerido

• Identificar a usuarios individuales mediante identify()
• Componentes de identify()
  • ID de usuario único (obligatorio)
    • Appcues recomienda elegir IDs de usuario opacos y difíciles de adivinar, como un UUID. Consulta las Preguntas frecuentes para desarrolladores para obtener más información sobre cómo elegir un ID de usuario.

      Si se instala en dispositivos móviles y web, es recomendable usar el mismo valor de UserID para las llamadas identify() en ambas implementaciones. Esto garantizará que el mismo usuario en dispositivos móviles sea coherente con su actividad web y mantendrá una mejor reflexión del recuento de MAU.

      Si utiliza nuestras integraciones, es posible que existan requisitos adicionales sobre el ID de usuario para una integración exitosa. Más detalles en la sección "Información adicional".
  • Propiedades de usuario personalizadas (opcional)
    • Aunque técnicamente es opcional, le recomendamos encarecidamente que envíe datos adicionales a Appcues para ofrecer más opciones de segmentación para la experiencia del usuario. La falta de propiedades personalizadas limita considerablemente sus casos de uso Appcues .
    • Si no es fácil identificar a ese usuario con sus ID de usuario, puede configurar un identificador de visualización en Studio basado en una propiedad de usuario personalizada. Esto no afecta a su ID de usuario, ni es necesario que este valor sea único para cada usuario; recomendamos usar correo electrónico, nombre completo o una propiedad similar que su equipo pueda reconocer fácilmente.
      
      Si se instala en la web y en dispositivos móviles, solo se puede configurar un Identificador de pantalla para todos los usuarios, así que asegúrese de que se incluya la misma propiedad en todas las instalaciones.

Identificación de grupos

Opcional

• Identificar grupos o cuentas a través de group()
• Componentes del group()
  • ID de grupo (obligatorio)
    • El ID de grupo debe ser el valor único entre cada grupo o cuenta para distinguirlos. Puede ser un ID de cuenta, un nombre de cuenta, etc.

      Si utiliza nuestras integraciones para datos de grupo, es posible que haya requisitos diferentes en cuanto al ID de grupo para una integración exitosa. Más detalles en la sección "Información adicional".
  • Propiedades de grupo personalizadas
    • Las mejores propiedades de grupo personalizadas son propiedades que se comparten entre usuarios dentro de ese grupo/cuenta y que no cambian de usuario a usuario dentro de la cuenta (los datos del usuario deben enviarse mediante identify() ).
    • Si no es fácil identificar la cuenta con los ID de grupo, puede configurar un identificador de visualización en Studio basado en una propiedad de grupo personalizada. Esto no afecta a su ID de grupo, ni es necesario que este valor sea único para cada cuenta; recomendamos usar el nombre de la empresa, el nombre de la cuenta o una propiedad similar que su equipo pueda reconocer fácilmente.
      
      Si se instala en la web y en dispositivos móviles, solo se puede configurar un Identificador de pantalla para todas las cuentas, así que asegúrese de que se incluya la misma propiedad en todas las instalaciones.

Pantallas de seguimiento

Requerido

• Identifica en qué pantalla se encuentra el usuario a través de screen() lo cual es crucial para una experiencia adecuada.
• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo
  • Iónico

Eventos de pista

Requerido

• Realice un seguimiento de las interacciones de sus usuarios con su aplicación mediante track()
• Estos eventos se pueden utilizar para segmentación, activación (complemento) , segmentación y análisis.
• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo
  • Iónico

Configurar URL/Enlaces profundos

Requerido

• Se requieren enlaces profundos para la depuración, la vista previa y la captura de pantalla . La aplicación también debe estar configurada para admitir esquemas de URL y enlaces profundos.
• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo
  • Iónico

Reconocer elementos de la pantalla

Requerido para información sobre herramientas anclada (excluye Ionic)

• Al usar información sobre herramientas anclada , los elementos de la pantalla deben ser reconocibles en la captura. Esto permite una ubicación segura que se mantiene en diferentes tamaños de pantalla o en diferentes ubicaciones de los elementos.
  
  ¿No puedes usar las descripciones emergentes ancladas? ¡Descubre las descripciones emergentes flotantes !
  
  
• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo

Construir FrameViews

Requerido para incrustaciones (excluye Ionic)

• Para publicar un elemento incrustado Appcues Mobile , se deben configurar FrameViews para almacenarlo. Estos son contenedores predefinidos que se añaden a toda la aplicación donde se desea alojar un elemento incrustado.
• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo

información adicional

Especificaciones técnicas

iOS

Androide

• SDK de Kotlin, utilizando Jetpack Compose para renderizar flujos
• Admite aplicaciones orientadas a API 21 (Android 5.0 Lollipop)
• Compatible con targetSDK 34+
• Compatible con aplicaciones escritas en Kotlin o Java, utilizando Android Views o Jetpack Compose para la interfaz de usuario
• Se distribuye a través de Maven Central y se puede integrar a través de scripts de compilación de Gradle
• Utiliza dependencias comunes de Android: bibliotecas Jetpack android X, Retrofit, Moshi, Coil (lista completa de dependencias disponible en el paquete Maven Central: com.appcues:appcues)
• <5 MB de tamaño adicional para la descarga de la aplicación; probablemente mucho menos si las dependencias comunes anteriores ya están en la aplicación
  Para obtener más información sobre el desarrollo nativo de Android, visita android

Envío de eventos Appcues a herramientas de análisis

Agregue el Event Listener a su aplicación para pasar eventos Appcues a herramientas conectadas a dispositivos móviles (Segment, Heap, Amplitude, Google Analytics, etc.)

• Envía los siguientes eventos:

• Seleccione su marco a continuación para obtener más detalles:
  • iOS
  • Androide
  • ReactNative
  • Aleteo
  • Iónico

Identificaciones de usuarios y grupos con integraciones de datos entrantes

Algunas integraciones Appcues tienen requisitos específicos para conectarse correctamente. En muchos casos, el ID de usuario Appcues debe existir como valor en el registro/perfil de la integración. Tenga esto en cuenta al seleccionar el ID de usuario/grupo que desea enviar a Appcues . A continuación, se detallan algunos de los requisitos comunes de las integraciones de Appcues :

• Fuerza de ventas
  • Salesforce <> Appcues : el ID de usuario Appcues debe existir como valor en el objeto de Salesforce (contactos, clientes potenciales, etc.)
• HubSpot
  • HubSpot >> Appcues : el ID de usuario Appcues debe existir como un valor en el registro de HubSpot.
  • Appcues >> HubSpot: El VID de HubSpot o el correo electrónico correspondiente debe existir como una propiedad de usuario Appcues (el correo electrónico se puede enviar mediante identificación, desde la sincronización de HubSpot >> Appcues o desde una conexión de fuente de datos)
• Marketo
  • Marketo >> Appcues : el ID de usuario Appcues debe existir como valor en el registro de Marketo.
  • Appcues >> Marketo: el ID del cliente potencial de Marketo o el correo electrónico correspondiente debe existir como una propiedad de usuario Appcues (el correo electrónico se puede enviar a través de la identificación, desde la sincronización de Marketo >> Appcues o desde una conexión de fuente de datos).
• Montón
  • Heap >> Appcues : el ID de usuario Appcues debe existir como un valor en el perfil de usuario de Heap.
• Amplitud
  • Amplitud >> Appcues : el ID de usuario Appcues debe existir como una propiedad de usuario en Amplitud.
• Panel de mezcla
  • Mixpanel >> Appcues : El ID de usuario Appcues debe coincidir con el ID distinto del usuario en Mixpanel.
• Alto contacto
  • Hightouch >> Appcues : el ID de usuario de su modelo Hightouch debe coincidir con el ID de usuario Appcues enviado en identify().
• Censo
  • Censo >> Appcues : La clave de sincronización de su modelo de censo debe coincidir con el ID de usuario Appcues enviado en identify().

¿Tiene problemas durante la instalación?

Si tiene alguna pregunta o problema con respecto a la instalación de su dispositivo móvil, contáctenos a support@appcues.com.