Comprender los pares clave-valor

Qué aprenderás

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 elaboración de informes. 

Con Push estándar, también pueden utilizarse para construir y poblar plantillas 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 atender 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/desactiva en Datos personalizados, luego 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 aparecen en nuestra aplicación después de que realice una compra online. Lo haremos enviando un Push silencioso con una recompensa Propiedades de perfil como par clave-valor.
• Ya tenemos un flujo de agradecimiento activado por un evento dePedido realizado. Añadimos un Push silencioso al final de este flujo para actualizar el valor de los puntos de recompensa mostrados en nuestra app.
• 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 Klaviyo Propiedades de perfil donde almacenamos estos puntos se llama rewardspoints, y nuestra app está configurada correctamente para actualizarse en función de 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 de uso

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 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 UTM.
• Construye plantillas Push personalizadas
  Puedes definir el tamaño y el color de la fuente para el 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 una asistencia para tus casos de uso específicos. 

Recursos adicionales

Comprender la notificación silenciosa push

notificación push glosario