Skip to main content

Mejores prácticas para la experiencia de los clientes con las apps

Lineamientos para crear una app que sea fácil de utilizar y entender.

Nota: Este artículo se aplica solo a las aplicaciones de publicación en GitHub Marketplace. Para más información sobre la publicación de GitHub Actions en GitHub Marketplace, consulta "Publicar acciones en GitHub Marketplace".

El seguir estas mejores prácticas te ayudará a proporcionar una buena experiencia del cliente.

Comunicación al cliente

  • Los materiales de marketing para la app deberán representar adecuadamente le comportamiento de la misma.
  • Las apps deberán incluir enlaces a los documentos de cara al cliente que describan cómo configurarla y utilizarla.
  • Los clientes deberán poder ver qué tipo de plan tienen en la sección de facturación, perfil, o configuración de cuenta de la app.
  • Los clientes deberán poder instalar y utilizar tu app tanto en una cuenta personal como en una cuenta de organización. Deberán poder ver y administrar la app en estas cuentas por separado.
  • Las apps deben proporcionar a los clientes una forma de borrar su cuenta, sin tener que enviar un correo electrónico o llamar a una persona de soporte. Las aplicaciones deben borrar todos los datos de usuario de GitHub dentro de los 30 días posteriores a la recepción de una solicitud del usuario para hacerlo, o dentro de los 30 días posteriores al final de la relación legal del usuario con GitHub.

Administración de planes

  • Los clientes que cancelan un plan de pago que se haya comprado en GitHub Marketplace deben degradar su versión automáticamente al plan gratuito de la app en caso de que éste exista. Se recomienda ampliamente la Cuando un cliente cancela una suscripción de GitHub Marketplace, GitHub no desinstala la app automáticamente, así que el cliente puede esperar que las características gratuitas sigan funcionando. para permitir a los usuarios el rehabilitar su plan previo.
  • Los clientes deben poder realizar la actualización de desde la interfaz de usuario de la aplicación si proporciona una dirección URL de actualización en este formato: https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>
  • Los clientes deben poder modificar qué usuarios tienen acceso a tu app desde el sitio web de la misma si compraron plazas (plan de precios por unidad) o si el plan ofrece colaboradores ilimitados.
  • Los clientes deben poder ver los siguientes cambios a su cuenta inmediatamente en la sección de facturación, perfil, o configuración de cuenta del sitio web de la app:
    • Plan y precios actuales.
    • Nuevos planes comprados.
    • Mejoras, degradaciones, cancelaciones y la cantidad de días restantes del periodo de prueba gratuito.
    • Cambios en los ciclos de facturación (mensual o anual).
    • Uso y recursos restantes para los planes por unidad y de tasa fija. Por ejemplo, si el plan de precios es por unidad, el sitio de tu app debería mostrar las unidades que se utilizan y las que quedan disponibles.

Información adicional