Pares clave-valor

Esta página cubre cómo usar pares clave-valor para enviar cargas útiles de datos adicionales a los dispositivos de los usuarios. Esta característica está disponible en los canales de mensajería push, dentro de la aplicación, correo electrónico y tarjetas de contenido.

Usa pares clave-valor para agregar metadatos estructurados a los mensajes. Estas cargas útiles de datos adicionales pueden enriquecer los mensajes con información contextual adicional que puede influir en cómo se renderiza o procesa un mensaje.

Dado que los pares clave-valor son metadatos, estos datos no son necesariamente visibles para el destinatario, pero pueden ser utilizados por tus sistemas o procesos conectados para personalizar el manejo de mensajes.

Cada par consiste en:

• Clave: El identificador (Ejemplo: utm_source)
• Valor: Los datos asociados (Ejemplo: newsletter)

Casos de uso

Aquí tienes algunos ejemplos de casos de uso para agregar metadatos con pares clave-valor:

1. Parámetros de seguimiento: Adjuntar parámetros UTM con fines de análisis
   • Clave: utm_campaign
   • Valor: spring_sale
2. Etiquetas personalizadas: Agregar etiquetas para enrutamiento interno o categorización
   • Clave: priority
   • Valor: high
3. Desencadenadores de comportamiento: Metadatos utilizados para desencadenar o personalizar comportamientos dentro de la aplicación
   • Clave: deep_link
   • Valor: app://promo-page

Notificaciones push

Los pares clave-valor se pueden agregar a las notificaciones push de Android, iOS y web. Puedes usar pares clave-valor para actualizar métricas internas y contenido de la aplicación, o personalizar las propiedades de las notificaciones push, como la priorización de alertas, la localización y los sonidos.

En el creador de mensajes, selecciona la pestaña Settings, selecciona Add New Pair y especifica tus pares clave-valor.

iOS

El servicio de notificaciones push de Apple (APNs) admite la configuración de preferencias de alertas y el envío de datos personalizados mediante pares clave-valor. APNs utiliza la biblioteca reservada de Apple aps, que incluye claves y valores predeterminados que gobiernan las propiedades de las alertas.

Biblioteca APS

Biblioteca de propiedades de alertas

El creador de mensajes de Braze maneja automáticamente la creación de las siguientes claves: alert y sus propiedades, content-available, sound y category.

Estos valores se pueden ingresar en la pestaña Settings al crear un mensaje push. Selecciona Alert Options y selecciona una clave de diccionario de alertas para que la clave se complete automáticamente en una nueva entrada de par clave-valor.

Cuando Braze envía una notificación push a APNs, la carga útil se formateará como JSON.

Carga útil simple

1
2
3
{
    "aps" : { "alert" : "Message received from Spencer" },
}

Carga útil compleja

1
2
3
4
5
6
7
8
9
10
11
12
{
    "aps" : {
        "alert" : {
            "body" : "Hi, welcome to our app!",
            "loc-key" : "France",
            "loc-args" : ["Bonjour", "bienvenue"],
            "action-loc-key" : "Button_Type_1",
            "launch-image" : "Paris"
      },
        "content-available" : 1
    },
}

Pares clave-valor personalizados

Además de los valores de carga útil de la biblioteca aps, puedes enviar pares clave-valor personalizados al dispositivo de un usuario. Los valores en estos pares están restringidos a tipos primitivos: diccionario (objeto), matriz, cadena, número y booleano.

Los casos de uso para pares clave-valor personalizados incluyen, entre otros, el mantenimiento de métricas internas y la configuración del contexto para la interfaz de usuario. Braze te permite enviar pares clave-valor adicionales junto con una notificación push para ser utilizados a través de tu aplicación dentro de la clave extras. Si prefieres usar otra clave, confirma que tu aplicación pueda manejar esta clave personalizada.

Apple aconseja a los clientes evitar incluir información del cliente o cualquier dato sensible como datos de carga útil personalizada. Además, Apple recomienda que cualquier acción asociada con un mensaje de alerta no elimine datos en un dispositivo.

Campañas desencadenadas por API

Braze te permite enviar pares clave-valor de cadena definidos de forma personalizada, conocidos como extras. Para acceder a tus extras en campañas desencadenadas por API y campañas planificadas desencadenadas por API, en el dashboard establece una clave como “example_key” y un valor como "$json:{"foo": 1, "bar": 1}". Esto resultará en una salida de la consola para desarrolladores de "extras": { "test": { "foo": 1, "bar": 1 }

Android

Braze te permite enviar cargas útiles de datos adicionales en notificaciones push usando pares clave-valor.

Carga útil de datos

Similar a las notificaciones push de iOS, puedes enviar pares clave-valor personalizados al dispositivo de un usuario.

Algunos casos de uso para pares clave-valor personalizados incluyen el mantenimiento de métricas internas y la configuración del contexto para la interfaz de usuario, pero pueden usarse para cualquier propósito que elijas.

Campañas desencadenadas por API

Braze te permite enviar pares clave-valor de cadena definidos de forma personalizada, conocidos como extras. Para acceder a tus extras en campañas desencadenadas por API y campañas planificadas desencadenadas por API, en el dashboard establece una clave como “example_key” y un valor como "$json:{"foo": 1, "bar": 1}". Esto resultará en una salida de la consola para desarrolladores de "extras": { "test": { "foo": 1, "bar": 1 }.

Opciones de mensajería FCM

Las notificaciones push de Android se pueden personalizar aún más con las opciones de mensajes FCM. Estas incluyen prioridad de notificación, sonido, retraso, duración y colapsabilidad. Estos valores se pueden especificar en la pestaña Settings al crear un mensaje push. Consulta Configuración avanzada de notificaciones push para obtener más instrucciones sobre cómo configurar estas opciones en el creador de mensajes de Braze.

Notificaciones push silenciosas

Una notificación push silenciosa es una notificación push que no contiene mensaje de alerta ni sonido, y se usa para actualizar la interfaz o el contenido de tu aplicación en segundo plano. Estas notificaciones hacen uso de pares clave-valor para desencadenar estas acciones de la aplicación en segundo plano. Las notificaciones push silenciosas también potencian nuestro Uninstall Tracking.

Los especialistas en marketing deben probar que las notificaciones push silenciosas desencadenen el comportamiento esperado antes de enviarlas a los usuarios de su aplicación. Después de redactar tu notificación push silenciosa de iOS o Android, asegúrate de dirigirte solo a un usuario de prueba filtrando por ID de usuario externo o dirección de correo electrónico.

Al lanzar la campaña, debes verificar que no hayas recibido ninguna notificación push visible en tu dispositivo de prueba.

Mensajes dentro de la aplicación

Puedes agregar un par clave-valor a un mensaje dentro de la aplicación en el editor tradicional seleccionando la pestaña Settings, seleccionando Add New Pair y luego especificando tus pares clave-valor.

Campañas desencadenadas por API

Braze te permite enviar pares clave-valor de cadena definidos de forma personalizada, conocidos como extras. Para acceder a tus extras en campañas desencadenadas por API y campañas planificadas desencadenadas por API, en el dashboard establece una clave como “example_key” y un valor como "$json:{"foo": 1, "bar": 1}". Esto resultará en una salida de la consola para desarrolladores de "extras": { "test": { "foo": 1, "bar": 1 }.

Correos electrónicos

Tanto SparkPost como SendGrid admiten pares clave-valor en correos electrónicos. Si usas SendGrid, los pares clave-valor se enviarán como argumentos únicos. SendGrid te permite adjuntar un número ilimitado de pares clave-valor de hasta 10,000 bytes de datos. Estos pares clave-valor se pueden ver en las publicaciones del Event Webhook de SendGrid.

Content Cards

Para agregar un par clave-valor a una tarjeta de contenido, ve a la pestaña Settings en el creador de mensajes de Braze y selecciona Add New Pair.