Caso de uso: Segmentar con atributos personalizados anidados

Estos casos de uso muestran cómo segmentar usuarios con atributos personalizados anidados en Braze, e incluyen ejemplos de JSON y flujos de trabajo del dashboard que puedes adaptar a tus propios datos.

Supongamos que formas parte de un equipo de marketing de una aplicación de streaming de música y quieres enviar mensajes basados en los atributos personalizados anidados de un usuario, como objetos de cuenta con saldos y tipos. Estos casos de uso demuestran diversas formas en que tu equipo puede usar atributos personalizados anidados en segmentos, y te enseñan a:

• Configurar un filtro de segmento con atributos personalizados anidados, validar rutas y elegir comparadores que coincidan con el tipo de datos de cada propiedad.
• Saber cuándo usar los operadores Day of Year frente a Time para valores de fecha anidados, y cómo la segmentación multicriterio coincide con usuarios cuando al menos un objeto en una matriz cumple todos los criterios listados.
• Generar un esquema para un objeto o una matriz de objetos, explorarlo en el dashboard y completar un segmento (por ejemplo, usuarios con saldo inferior a 100) usando el selector de rutas en lugar de escribir las rutas de memoria.

Filtrar por atributos personalizados anidados

Vamos a crear un segmento basado en un atributo personalizado anidado para dirigirnos a los usuarios que reprodujeron su canción más escuchada más de 300 veces.

Paso 1: Añadir el filtro

Selecciona el filtro Nested Custom Attributes para mostrar un menú desplegable desde el cual puedes seleccionar un atributo personalizado anidado específico. Seleccionaremos most_played_song, que contiene datos sobre la canción más reproducida de un usuario.

Paso 2: Seleccionar la propiedad

Selecciona la propiedad dentro del atributo personalizado anidado por la que quieres filtrar. Seleccionaremos play_analytics.count, que registra cuántas veces un usuario reprodujo su canción más escuchada.

Paso 3: Seleccionar una comparación y un valor de atributo personalizado anidado

Al filtrar por atributos personalizados anidados, el tipo de datos de tu propiedad determina los comparadores por los que puedes filtrar. Por ejemplo, como play_analytics.count es un número, puedes seleccionar un comparador en la categoría Number.

Para filtrar por usuarios que reprodujeron su canción más escuchada al menos 300 veces, selecciona la comparación More than y luego introduce “300” como valor.

Filtrar por tipos de datos de tiempo

Al filtrar un atributo personalizado anidado de tipo tiempo, puedes elegir filtrar con operadores en las categorías Day of Year o Time al comparar el valor de fecha.

Si seleccionas un operador en la categoría Day of Year, solo se comparan el mes y el día en lugar de la marca de tiempo completa del valor del atributo personalizado anidado. Seleccionar un operador en la categoría Time compara la marca de tiempo completa, incluido el año.

Usar segmentación multicriterio

Usa la segmentación multicriterio para crear un segmento que coincida con múltiples criterios dentro de un solo objeto. Esto califica al usuario en el segmento si tiene al menos un objeto en la matriz que cumple todos los criterios especificados. Por ejemplo, los usuarios solo coinciden con este segmento si su clave no está vacía y si su número es mayor que 0.

Copiar Liquid para segmento

También puedes usar la función Copy Liquid for segment para generar código Liquid para este segmento y usarlo en un mensaje. Por ejemplo, supongamos que tienes una matriz de objetos de cuenta y un segmento que se dirige a clientes con cuentas gravables activas. Para lograr que los clientes contribuyan al objetivo de cuenta asociado con una de sus cuentas activas y gravables, querrás crear un mensaje para motivarlos.

Cuando seleccionas Copy Liquid for segment, Braze genera automáticamente código Liquid que devuelve una matriz de objetos que solo contiene cuentas activas y gravables.

1
2
3
4
5
6
7
{% assign segmented_nested_objects = '' | split: '' %}
{% assign obj_array = {{custom_attribute.${accounts}}} %}
{% for obj in obj_array %}
  {% if obj["account_type"] == 'taxable' and obj["active"] == true %}
    {% assign segmented_nested_objects = obj_array | slice: forloop.index0 | concat: segmented_nested_objects | reverse %}
  {% endif %}
{% endfor %}

A partir de aquí, puedes usar segmented_nested_objects y personalizar tu mensaje. En este ejemplo, queremos tomar un objetivo de la primera cuenta gravable activa y personalizarlo:

1
Get to your {{segmented_nested_objects[0].goal}} goal faster, make a deposit using our new fast deposit feature!

Esto devuelve el siguiente mensaje a tu cliente: “Get to your retirement goal faster, make a deposit using our new fast deposit feature!”

Generar un esquema usando el explorador de objetos anidados

Puedes generar un esquema para tus objetos y crear filtros de segmento sin necesidad de memorizar las rutas de objetos anidados.

Paso 1: Generar un esquema

Por ejemplo, supongamos que tenemos una matriz de objetos accounts que acabamos de enviar a Braze:

1
2
3
4
5
6
7
8
{"accounts": [
  {"type": "taxable",
  "balance": 22500,
  "active": true},
  {"type": "non-taxable",
  "balance": 0,
  "active": true}
]}

En el dashboard de Braze, ve a Data Settings > Custom Attributes.

Busca tu objeto o matriz de objetos. En la columna Attribute Name, selecciona Generate Schema.

Después de que se haya generado el esquema, aparece un nuevo botón de más en lugar del botón Generate Schema. Puedes hacer clic en él para ver lo que Braze sabe sobre este atributo personalizado anidado.

Durante la generación del esquema, Braze examina los datos enviados anteriormente y construye una representación ideal de tus datos para este atributo. Braze también analiza y añade un tipo de datos para tus valores anidados. Esto se hace muestreando los datos enviados previamente a Braze para el atributo anidado dado.

Para nuestra matriz de objetos accounts, puedes ver que dentro de la matriz de objetos hay un objeto que contiene lo siguiente:

• Un tipo booleano con una clave de active (independientemente de si la cuenta está activa o no)
• Un tipo numérico con una clave de balance (monto del saldo en la cuenta)
• Un tipo cadena con una clave de type (cuenta no gravable o gravable)

Ahora que hemos analizado y construido una representación de los datos, vamos a crear un segmento.

Paso 2: Crear un segmento

Vamos a dirigirnos a clientes que tienen un saldo inferior a 100 para poder enviarles un mensaje motivándolos a hacer un depósito.

Crea un segmento y añade el filtro Nested Custom Attribute, luego busca y selecciona tu objeto o matriz de objetos. Aquí hemos añadido la matriz de objetos accounts.

Selecciona el botón de más en el campo de ruta. Esto abre una representación de tu objeto o matriz de objetos. Puedes seleccionar cualquiera de los elementos listados y Braze los inserta en el campo de ruta por ti. En este ejemplo, necesitamos obtener el saldo. Selecciona el saldo como ruta (en este caso, [].balance) que se completa automáticamente en el campo de ruta.

Selecciona less than como comparador y luego introduce “100” como valor de saldo.

¡Eso es todo! Acabas de crear un segmento usando un atributo personalizado anidado, todo sin necesidad de saber cómo están estructurados los datos. El explorador de objetos anidados en Braze generó una representación visual de tus datos y te permitió explorar y seleccionar exactamente lo que necesitabas para crear un segmento.