Comprender pares clave-valor

Qué aprenderás

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 incluidos con las notificaciones push que te permiten activar comportamientos de la aplicación, etiquetar mensajes, personalizar notificaciones y mucho más.

¿Qué son los pares clave-valor?

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

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

Con el push estándar, también se pueden usar para crear y rellenar plantillas de push personalizadas.

Cómo usar pares clave-valor

Para poder usar pares clave-valor, tu aplicación debe estar configurada para reconocer claves y responder a sus valores, así que asegúrate de trabajar con el desarrollador de tu aplicación para garantizar que tu aplicación esté diseñada para admitir tus casos de uso. Además, asegúrate de haber 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, a continuación, añade claves y valores. Puedes añadir hasta 10 pares clave-valor por notificación push.

Veamos un ejemplo para una aplicación de comercio electrónico:

• Queremos actualizar los puntos de recompensa de un cliente que se muestran en nuestra aplicación después de que haga una compra online. Lo haremos enviando un push silencioso con una propiedad de perfil de puntos de recompensa como par clave-valor.
• Ya tenemos un flujo de agradecimiento activado por un evento de Pedido realizado. Añadimos una notificación push silenciosa al final de este flujo para actualizar el valor de los puntos de recompensas que se muestra en nuestra aplicación.
• El push silencioso incluye un par clave-valor en el que la Clave es igual a rewardspoints y el Valor se establece en {{ person.rewardspoints }}. El nombre de la propiedades de perfil de Klaviyo donde almacenamos estos puntos se llama rewardspoints, y nuestra aplicación 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 enviarlo a nuestra aplicación mediante este flujo, para que se refleje con precisión.

Casos de uso

Hay muchos casos de uso para los pares clave-valor, entre ellos:

• Personaliza el contenido de la aplicación
  Puedes enviar una notificación push silenciosa para personalizar el contenido de la aplicación en función de 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, a continuación, extraer datos de cualquier mensaje con etiquetas específicas para agregarlos. Por ejemplo, estas etiquetas podrían ser parámetros UTM.
• Crea plantillas de notificación push personalizadas
  Puedes definir el tamaño y el color de la fuente del cuerpo de la notificación push o configurar un sonido personalizado que se reproducirá cuando se entregue la notificación push. Las cuentas también pueden mostrar datos en directo, como la ubicación de una entrega o una cuenta atrás hasta que caduque una oferta, en su notificación.

Recomendamos trabajar con el desarrollador de tu aplicación para crear compatibilidad con tus casos de uso específicos.

Recursos adicionales