Objetos anidados en eventos personalizados
Esta página explica cómo enviar datos JSON anidados como propiedades de eventos personalizados y compras, y cómo utilizar esos objetos anidados en tu mensajería.
Puede utilizar objetos anidados -objetos que están dentro de otro objeto- para enviar datos JSON anidados como propiedades de eventos y compras personalizados. Estos datos anidados pueden utilizarse para plantillas de información personalizada en los mensajes, desencadenar envíos de mensajes y segmentar a los usuarios.
Limitaciones
- Los datos anidados son compatibles con los eventos personalizados y los eventos de compra, pero no con otros tipos de eventos.
- Los objetos de propiedades del evento que contienen valores de matrices u objetos pueden tener una carga útil de propiedades del evento de hasta 100 KB.
- No se pueden generar esquemas de propiedades de eventos para eventos de compra.
- Los esquemas de propiedades de eventos se generan mediante el muestreo de eventos personalizados de las últimas 24 horas.
Versiones mínimas del SDK
Las siguientes versiones del SDK admiten objetos anidados:
Paso 1: Generar un esquema
Puedes acceder a los datos anidados de tu evento personalizado generando un esquema para cada evento con propiedades de eventos anidados. Para generar un esquema:
- Vaya a Configuración de datos > Eventos personalizados.
- Seleccione Gestionar propiedades para los eventos con propiedades anidadas.
- Seleccione el botón para generar el esquema. Para ver el esquema, seleccione el botón plus.
Si se envían nuevas propiedades en el futuro, no estarán en el esquema hasta que se regenere. Los esquemas pueden regenerarse cada 24 horas.
Paso 2: Utilizar el objeto anidado
Puedes hacer referencia a los datos anidados durante la segmentación y la personalización. Nota que no es necesario un esquema. Consulte los siguientes apartados para ver ejemplos de uso:
- Cuerpo de la solicitud API
- Plantillas de Liquid
- Desencadenamiento de mensajes
- Segmentación
- Personalización
Cuerpo de la solicitud API
A continuación se muestra un ejemplo de /users/track con un evento personalizado “Lista de reproducción creada”. Una vez creada una lista de reproducción, captura las propiedades de la lista enviando:
- Una solicitud a la API que incluye “canciones” como propiedad
- Una matriz de las propiedades anidadas de las canciones
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
...
"properties": {
"songs": [
{
"title": "Smells Like Teen Spirit",
"artist": "Nirvana",
"album": {
"name": "Nevermind",
"yearReleased": "1991"
}
},
{
"title": "While My Guitar Gently Weeps",
"artist": "the Beatles",
"album": {
"name": "The Beatles",
"yearReleased": "1968"
}
}
]
}
...
A continuación se muestra un ejemplo de /users/track con un evento personalizado “Ordenado”. Una vez completado un pedido, captura las propiedades de ese pedido enviando:
- Una solicitud a la API que incluye “r_detalles” como propiedad
- Las propiedades anidadas de ese orden
1
2
3
4
5
6
7
8
9
10
11
12
...
"properties": {
"r_details": {
"name": "McDonalds",
"identifier": "12345678",
"location" : {
"city": "Montclair",
"state": "NJ"
}
}
}
...
Para las propiedades de eventos personalizados anidados, si el año es menor que 0 o mayor que 3000, Braze no almacena estos valores en el usuario.
Plantillas de Liquid
A continuación se muestra cómo crear una plantilla Liquid que haga referencia a las propiedades anidadas solicitadas en la petición API anterior.
Plantillas en Liquid en un mensaje activado por el evento “Lista de reproducción creada”:
{{event_properties.${songs}[0].album.name}}: “Nevermind”
{{event_properties.${songs}[1].title}}: “Mientras mi guitarra llora suavemente”
Plantillas en Liquid en un mensaje activado por el evento “Ordenado”:
{{event_properties.${r_details}.location.city}}: “Montclair”
Desencadenamiento de mensajes
Para utilizar estas propiedades para desencadenar una campaña, selecciona tu evento personalizado o compra y, a continuación, añade un filtro de propiedades anidadas. Tenga en cuenta que la activación de mensajes aún no es compatible con los mensajes dentro de la aplicación, pero las propiedades anidadas en la personalización de Liquid en los mensajes seguirán mostrándose.
Lanzamiento de una campaña con propiedades anidadas desde el evento “Lista de reproducción creada”:
La condición de activación songs[].album.yearReleased “is” “1968” coincidirá con un evento en el que cualquiera de las canciones tenga un álbum publicado en 1968. Utilizamos la notación de corchetes [] para recorrer matrices y comprobar si algún elemento de la matriz recorrida coincide con la propiedad del evento.
El filtro no es igual sólo coincide si ninguna de las propiedades de tu matriz es igual al valor proporcionado.
Por ejemplo, digamos que el Canvas A tiene el filtro de propiedades anidadas evento personalizado basado en acciones igual a “smartwatch”, y el Canvas B tiene el filtro de propiedades anidadas evento personalizado basado en acciones no igual a “simphone”. Si tienes “smartwatch” y “simphone” en tus propiedades, se desencadenarán ambos Lienzos. Pero si tienes “simphone” o “sólo sim” en alguna propiedad, no se desencadenará ningún Canvas.
Lanzamiento de una campaña con propiedades anidadas desde el evento “Ordenado”:
r_details.name: “Mcdonalds”
r_details.location.city: “Montclair”
Si su propiedad de evento contiene los caracteres [] o ., escápelos envolviendo el trozo entre comillas dobles. Por ejemplo, "songs[].album".yearReleased coincidirá con un evento con la propiedad literal "songs[].album".
Segmentación
Para segmentar usuarios basándose en propiedades de eventos anidados, debe utilizar Extensiones de Segmento. Una vez generado el esquema, aparecerá el explorador de objetos anidados en la sección de segmentación.
La segmentación utiliza la misma notación que la activación (véase Activación de mensajes).
Para editar o crear extensiones de segmento, necesitarás el permiso “Editar segmentos”.
Personalización
Utilizando el modal Añadir Personalización, seleccione Propiedades Avanzadas de Eventos como tipo de personalización. Permite añadir propiedades de eventos anidados después de generar un esquema.
Preguntas más frecuentes
¿El uso de objetos anidados consume puntos de datos adicionales?
No hay ningún cambio en la forma de cobrar los puntos de datos como resultado de añadir esta capacidad. La segmentación basada en objetos anidados utiliza extensiones de segmento, que no incurren en un uso de punto de datos adicional.
¿Cuántos datos anidados se pueden enviar?
Si una o más de las propiedades del evento contienen datos anidados, la carga útil máxima para todas las propiedades combinadas de un evento es de 100 KB. Cualquier solicitud que supere ese límite de tamaño será rechazada.
Editar esta página en GitHub