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). La clave es un nombre que tu aplicación reconoce, y el valor es la información que envías para esa clave.
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, la aplicación debe estar configurada para reconocer claves y responder a sus valores, así que asegúrate de colaborar con el desarrollador de la aplicación para garantizar que se haya creado de forma que admita tus casos de uso. Además, asegúrate de haber configurado las notificaciones push para iOS o Android en la cuenta de Klaviyo.
Completa ambos campos de cada par y usa una clave diferente para cada par. Si repites una clave, solo se guarda el último valor.
- Al crear una notificación push, abre la pestaña Contenido y selecciona Standard o Silencioso en Tipo.
- Selecciona la pestaña Comportamientos y activa Datos personalizados si está desactivado. Al seleccionar Silencioso, se activa automáticamente.
- Introduce una clave y un valor. Haz clic en Añadir para incluir otro par. Puedes añadir hasta 10 pares clave-valor por notificación push.
- Guarda los cambios. En un flujo, haz clic en Guardar y continuar. En una campaña, haz clic en Siguiente o Guardar y volver, según el editor.

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.
- La notificación push 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 las propiedades de perfil de Klaviyo donde almacenamos estos puntos se llama rewardspoints, y nuestra aplicación está configurada correctamente para actualizarse en función de 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
- Comprender las notificaciones push silenciosas
Aprende qué son las notificaciones push silenciosas y cómo usarlas en tus campañas y flujos, junto con casos de uso específicos.
- Glosario de notificaciones push
El glosario que aparece a continuación define términos y siglas comunes para el marketing de notificaciones push.