Matt zamudio

0%

Writing better alerts

What I've learned over years of writing them.

October 9, 2020

English
Spanish

Like any conversation we’d have with a person, in digital products our dialogue should be conversational and free of misunderstandings.
‍

When the user is misunderstood, our relationship with the user is damaged, and our success metrics are negatively affected: things like trust, comprehension, conversions, and more.
‍

Usually, user misunderstandings are caused by issues with the writing in the product. Whether it’s weak use of language, bad terminology, strange framing, or overly-complex sentences, bad writing leads to bad experiences, no matter how gorgeous the UI.
‍

I’m here to tell you something important: Brevity is not always the answer.
‍

To avoid creating misunderstandings with users, here are 6 tips for writing better alerts in digital products.


‍
1) Determine the type of alert‍
‍

Is the alert an error (read: a blocker)? Is the alert a warning (read: possible future blocker)? Or is the alert informational (read: FYI)?
‍
‍

2) Identify the what, the how, and the why 
‍

Here's an example: Can't create your account (the what). Add your name and email (the how) to start tweeting (the why).
‍

3) Mix up the "what how why" pattern depending on the type of alert
‍

For errors: what + how + why

For warnings: what + how + why

For info: why + how


4) For errors, tell the user the problem plainly (not abstractly)
‍

Do:
Can't call an Uber
Turn on your device's location services to request an Uber.
‍

Don't:
Can't call an Uber
Your location can't be found.
‍
‍

5) For warnings, guide users away from missteps and future problems (and don't cause panic)
‍

Do:
To avoid late fees, set up auto-pay
Auto-pay ensures your bill is paid in full and on time.
‍

Don't:
You should set up auto-pay now
If your bill isn't paid on time, a late fee will be charged to your account.
‍

6) For informational alerts, make sure the information is valuable
‍

Do:
Based on your campaign type, 3 days is the best length of time for accurate attribution.
‍

Don't:
3 days is recommended.

‍

You can view a carousel version of this article (with graphics) on my Instagram.

Como cualquier conversación que tengamos con una persona, en los productos digitales nuestro diálogo debe ser conversacional y libre de malentendidos.


Cuando se malinterpreta al usuario, nuestra relación con el usuario se daña y nuestras métricas de éxito se ven afectadas negativamente: cosas como la confianza, comprensión, conversiones y más.


Por lo general, los malentendidos del usuario son causados ​​por problemas con la escritura en el producto. Ya sea que se trate de un uso débil del lenguaje, una mala terminología, un encuadre extraño u oraciones demasiado complejas, la mala redacción conduce a malas experiencias, sin importar cuán hermosa sea la interfaz de usuario.


Estoy aquí para decirle algo importante: la brevedad no siempre es la respuesta.‍


Para evitar crear malentendidos con los usuarios, aquí en 6 consejos para escribir mejores alertas en productos digitales.
‍


1) Determine el tipo de alerta‍
‍

¿Es la alerta un error (léase: un bloqueador)? ¿Es la alerta una advertencia (léase: posible futuro bloqueador)? ¿O la alerta es informativa (lea: FYI)?‍
‍


2) Identifique el qué, el cómo y el por qué‍
‍

Aquí hay un ejemplo: No puede crear su cuenta (el qué). Agregue su nombre y correo electrónico (el cómo) para comenzar a twittear (el por qué).
‍


3) Mezcle el patrón "qué, cómo, por qué" según el tipo de alerta‍
‍

Para errores: qué + cómo + por qué

Para advertencias: qué + cómo + por qué

Para información: por qué + cómo
‍


4) En caso de errores, dígale al usuario el problema claramente (no de manera abstracta)
‍

Sí:
No se puede llamar a un Uber
Activar los servicios de ubicación de su dispositivo para solicitar un Uber
‍

No:
No se puede llamar a un Uber
Su ubicación no puede ser
‍


5) Para las advertencias, guíe a los usuarios lejos de pasos en falso y problemas futuros (y no provoques pánico)
‍

Sí:
Para evitar recargos, configure el pago automático
El pago automático garantiza que su factura se pague en su totalidad y a tiempo.
‍

No:
Debe configurar el pago automático ahora
Si su factura no se paga a tiempo, se cargará un cargo por pago atrasado a su cuenta.
‍


6) Para recibir alertas informativas, asegúrese de que la información sea valiosa
‍

Sí:
Según el tipo de campaña, 3 días es el mejor período de tiempo para una atribución precisa.
‍

No:
Se recomienda 3 días.
‍


Puedes ver una versión en carrusel de este artículo (con gráficos) en mi Instagram.