Integración de Skills a Dashbot Analytics

Para desarrollar skills o aplicaciones de voz que generen experiencias extraordinarias necesitamos conocer a nuestros usuarios. En Amazon hemos identificado algunos parámetros para determinar si una skill es exitosa, siendo uno de ellos el número de usuarios que interactúan con tu skill y otro la retención, es decir, cuántas veces el usuario regresa a usar tu skill. Para saber qué es lo que lleva a un usuario a activar tu skill y repetir su uso, es importante analizar los datos que generan las interacciones en tu skill. Existen algunas plataformas de análisis de datos que tradicionalmente se usan para aplicaciones móviles, pero estas no tienen las capacidades para obtener, procesar y medir las nuevas formas de interacción por voz.

Buscando opciones, me encontré una solución de análisis de datos conversacionales llamada Dashbot, la cual nos permite analizar la manera en que interactúa el usuario dentro de una skill y el motivo para dejar de usarla. Dashbot registra la información generada por el usuario y el analizar estos patrones de conducta nos permite aplicar mejoras para ayudar a incrementar la retención y el número de usuarios que utilizan la skill.

_Beneficios:

• Te permite optimizar la efectividad en la respuesta de la skill de Alexa
• Puedes identificar intents “unhandled” y “mishandled”
• Entenderás el comportamiento del usuario y los flujos de voz
• Podrás comparar el comportamiento de tu skill contra otras skills
• La versión estándard es gratis, solamente necesitas registrarte como usuario
• Es centralizado: puedes agregar varias skills a tus dashboards y monitorear todas desde una sola cuenta.
• La plataforma está optimizada para analizar las skills de Alexa, por lo que la integración a tu skill es muy sencilla

_{Tableros de Datos disponibles en Dashbot}

Estos son algunos ejemplos de gráficas que muestra la plataforma:

Tablero Principal

Transcripciones

Países que usan la skill

Intents

_{Rastreo de Eventos Personalizados}

Dashbot rastrea eventos personalizados (Custom Events) para identificar una actividad específica dentro de tu skill, por ejemplo, puede registrar cuando un usuario entra a la skill (LaunchRequest),  sale de la skill o incluso puede definir puntos de registro en cualquier parte de los flujos conversacionales. También podrás monitorear en tiempo real el comportamiento de los eventos (transcripts) y revisar el histórico de los mismos a través de la sección Behavior>Events.

Transcripciones de Eventos Personalizados

Datos históricos de eventos

_{Intregración de tu skill a Dashbot Analytics}

Sigue estos pasos para integrar tu skill a la plataforma de Dashbot:

1.- Regístrate como usuario en la plataforma de Dashbot: dashbot.io 

2.- Una vez registrado, agrega la skill a tu consola para generar una API KEY y así ligar la skill a tu cuenta de Dashbot, como se muestra a continuación:

3.- Obtén el API Key:

4.- Integra el código de Dashbot a tu skill:

• Instala Dashbot en el directorio donde tienes tu proyecto utilizando NPM:
  npm install —save dashbot
• Define la constante Dashbot en tu código, junto con el API Key que generaste anteriormente:
  const dashbot = require('dashbot')(process.env.DASHBOT_API_KEY).alexa;
• Agrega Dashbot en el “export handler” de tu código:
  exports.handler = dashbot.handler(skillBuilder
  .addRequestHandlers(
  LaunchRequestHandler,
  ...
  HelpIntentHandler,
  CancelAndStopIntentHandler,
  SessionEndedRequestHandler
  )
  .addErrorHandlers(ErrorHandler)
  .lambda());

Ejemplo de integración de Dashbot a una Lambda de Alexa con SDK v2:

Importante: asegúrate de declarar el servicio de Dashbot en los archivos de configuración (package.js) de tu proyecto antes de poner en producción los cambios de tu skill:

5.- ¡Listo!, a partir de este momento vas a poder recibir analíticas de uso de tu skill en la consola de Dashbot.

_{Rastreo de Eventos Personalizados}

También es posible agregar eventos para registrar actividades específicas de tu skill, como Clicks a URLs externas, Redes Sociales, Ingresos, customIntents, etc. Para integrar esta funcionalidad necesitas enviar la petición a tu endPoint (POST) utilizando un archivo JSON.

1.- El archivo JSON está formado por los siguientes parámetros:

• name – string (required)
• userId – string (required)
• conversationId – string (optional)
• type – enum (required)
  • customEvent
  • revenueEvent
  • shareEvent
  • pageLaunchEvent

2.- Dependiendo del tipo de evento, puedes agregar propiedades adicionales para obtener mayor información del mismo:

customEvent

• extraInfo – object (optional)

revenueEvent

• amount – number (required)
• referenceNumber – string (optional)
• metadata – object (optional)

pageLaunchEvent

• extraInfo – object (optional)

shareEvent

• sharedMessage – object (optional)

referralEvent

• name – string (required)
• ref – string the referral tag (optional)
• source – string the referral source (eg. ADS, WEB) (optional)
• ad_id – string an ID to identify the ad (optional)
• referer_uri – string the URI that sent the referer(optional)

3.- Este es un ejemplo de una petición al endPoint (POST):

https://tracker.dashbot.io/track?platform=alexa&v=11.1.0-rest&type=event&apiKey=API_KEY_HERE

De esta manera, la información enviada a través del “POST” tendrá el siguiente formato:

{
"name": "trackMeEvent",
"type": "customEvent",
"userId": "967295313370594",
"extraInfo": {
"start": 1500504070512,
"difference": 374,
"end": 1500504070886
}
}

4.- Una vez que incorpores eventos al código de tu backend, comenzarás a visualizar la información en Dashbot.

Ejemplo:

Para más detalles sobre la integración de eventos, revisa este enlace: https://www.dashbot.io/docs/alexa/events/

Conclusión

Como pudiste observar, las analíticas que recoge la plataforma Dashbot te ayudarán a analizar y detectar patrones de comportamiento de los usuarios y las transcripciones en tiempo real te permitirán conocer el desempeño de tu skill y detectar problemas a tiempo. Todo esto nos ayudará a optimizar la efectividad en la respuesta de nuestra skill, incrementando la satisfacción de la experiencia de uso y atrayendo más usuarios a tu skill.

Recursos

• Dashbot: dashbot.io
• Alexa Skills: https://developer.amazon.com/es-MX/alexa/alexa-skills-kit