Comprender los pares clave-valor

Objetivos de aprendizaje

Aprende qué son los pares clave-valor y cómo utilizarlos tanto con la notificación push estándar como con la silenciosa. Los pares clave-valor son datos personalizados incluidos en 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 pueden incluirse con las notificaciones push, tanto estándar (las que se muestran a los usuarios) como silenciosas (las que son invisibles para los usuarios). 

Tanto las notificaciones silenciosas como las estándar pueden utilizarse para actualizar el contenido de la app, activar tareas en segundo plano o etiquetar mensajes con fines de creación/elaboración de informes. 

Con las notificaciones push estándar, también se pueden utilizar para construir y rellenar plantillas de notificaciones push personalizadas.

Cómo utilizar los pares clave-valor

Para utilizar pares clave-valor, tu aplicación debe estar configurada para reconocer las claves y responder a sus valores, así que asegúrate de trabajar con tu desarrollador de aplicaciones para garantizar que tu aplicación está construida para tus casos de uso. Además, asegúrate de que has configurado la notificación push en tu cuenta de Klaviyo. 

Puedes encontrarlos en la pestaña Comportamientos al crear una notificación push. Para utilizarlos, 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 ecommerce:

• Queremos actualizar los puntos de recompensa de un cliente que aparecen en nuestra aplicación después de que realice una compra online. Lo haremos enviando una notificación push silenciosa con una recompensa de puntos propiedades del perfil como par clave-valor.
• Ya tenemos un flujo de agradecimiento activado por un evento dePedido realizado. Añadimos una notificación push silenciosa al final de este flujo para actualizar el valor de los puntos de recompensa mostrados en nuestra app.
• El push de notificación silenciosa 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 página Klaviyo propiedades del perfil donde compramos estos puntos se llama rewardspoints, y nuestra app está configurada correctamente para actualizarse basándose en este par clave-valor.
• En este ejemplo, nos aseguramos de que el valor de los puntos de recompensa se actualizara en Klaviyo antes de enviarlo a nuestra app a través de este flujo, para que se refleje con precisión .

Casos prácticos

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

• Personalizar el contenido de la app
  Puedes enviar una notificación push silenciosa para personalizar el contenido de la app en función de los atributos del destinatario (como en el ejemplo anterior de los puntos de recompensa).
• Crear etiqueta para creación/elaboración de informes
  Puedes incluir pares clave-valor en la notificación push (estándar o silenciosa) para "etiquetar" mensajes y luego extraer datos de cualquier mensaje con etiqueta específica para agregar. Por ejemplo, estas etiquetas podrían ser parámetro de UTM.
• Crea una plantilla de notificación push personalizada
  Puedes definir el tamaño y el color de la fuente del cuerpo de tu notificación push o establecer un sonido personalizado que se reproducirá cuando se envíe la notificación push. Las cuentas también pueden mostrar datos en tiempo real, como la ubicación de una entrega o una cuenta atrás hasta que caduque una oferta, en su notificación.

Te recomendamos que trabajes con el desarrollador de tu aplicación para crear un equipo de asistencia para tus casos de uso específicos. 

Recursos adicionales

Comprender la notificación silenciosa push

notificación push glosario