Comprender los pares clave-valor

Objetivos del artículo

Descubre qué son los pares clave-valor y cómo usarlos con notificaciones push estándar y silenciosas. Los pares clave-valor son datos personalizados que se incluyen con las notificaciones push y que permiten activar comportamientos de la app, etiquetar mensajes, personalizar notificaciones y más.

¿Qué son los pares clave-valor?

Los pares clave-valor son datos personalizados que se pueden incluir con notificaciones push, tanto estándar (las que se muestran a los usuarios) como silenciosas (las que son invisibles para los usuarios).

Con notificaciones silenciosas y estándar, se pueden usar para actualizar el contenido de la app, activar tareas en segundo plano o etiquetar mensajes con fines de elaboración de informes.

Con la notificación push estándar, también se pueden usar para crear y completar plantillas de notificación push personalizadas.

Cómo usar pares clave-valor

Para poder usar pares clave-valor, la app debe estar configurada para reconocer claves y responder a sus valores, así que asegúrate de trabajar con el desarrollador de la app para garantizar que la app esté diseñada para admitir tus casos de uso. Además, asegúrate de que hayas configurado las notificaciones push en tu cuenta de Klaviyo.

Puedes encontrarlos en la pestaña Comportamientos al crear una notificación push. Para usarlos, activa Datos personalizados y luego agrega claves y valores. Puedes agregar hasta 10 pares clave-valor por notificación push.

Veamos un ejemplo para una app de ecommerce:

• Queremos actualizar los puntos de recompensa de un cliente que se muestran en nuestra app después de que haga una compra en línea. Haremos esto enviando una notificación push silenciosa con una propiedad del perfil de puntos como un par clave-valor.
• Ya tenemos un flujo de agradecimiento activado por un evento Placed Order. Agregamos un push silencioso al final de este flujo para actualizar el valor de puntos de recompensas que se muestra en nuestra app.
• La notificación push silenciosa incluye un par clave-valor donde la clave es igual a rewardspoints y el valor se establece en {{ person.rewardspoints }}. El nombre de la propiedad del perfil de Klaviyo donde almacenamos estos puntos se llama rewardspoints, y nuestra app está configurada correctamente para actualizarse según este par clave-valor.
• En este ejemplo, nos aseguramos de que el valor de rewardspoints se actualizara en Klaviyo antes de enviarse a nuestra app mediante este flujo, para que se refleje con precisión.

Casos de uso

Hay muchos casos de uso para los pares clave-valor, por ejemplo:

• Personaliza el contenido de la app
  Puedes enviar una notificación push silenciosa para personalizar el contenido de la app según los atributos del destinatario (como el ejemplo de puntos de recompensas anterior).
• Crea etiquetas para la elaboración de informes
  Puedes incluir pares clave-valor en notificaciones push (estándar o silenciosas) para “etiquetar” mensajes y luego extraer datos de cualquier mensaje con etiquetas específicas para agregarlos. Por ejemplo, estas etiquetas podrían ser parámetros de UTM.
• Crea plantillas de notificación push personalizadas
  Puedes definir el tamaño y el color de la fuente para el cuerpo de la notificación push o establecer un sonido personalizado que se reproducirá cuando se entregue la notificación push. Las cuentas también pueden mostrar datos en tiempo real, como la ubicación de una entrega o una cuenta regresiva hasta que venza una oferta, en su notificación.

Recomendamos trabajar con el desarrollador de la app para crear compatibilidad con tus casos de uso específicos.

Recursos adicionales