Actualización de usuario

El componente Actualización de usuario te permite actualizar los atributos, eventos y compras de un usuario en un editor JSON, por lo que no es necesario incluir información sensible como claves de API.

Cómo funciona este componente

Cuando usas este componente en tu Canvas, las actualizaciones no cuentan para tu límite de velocidad de solicitudes por minuto de /users/track. En su lugar, estas actualizaciones se agrupan en lotes para que Braze pueda procesarlas de forma más eficiente que un webhook de Braze a Braze. Ten en cuenta que este componente no registra puntos de datos cuando se utiliza para actualizar puntos de datos no facturables (como los grupos de suscripción).

Después de que los usuarios entran en el paso de actualización de usuario y se completa el procesamiento, avanzan al siguiente paso. Esto significa que cualquier mensajería posterior que dependa de estas actualizaciones de usuario estará al día cuando se ejecute el siguiente paso.

Creación de una actualización de usuario

Arrastra y suelta el componente desde la barra lateral, o selecciona el botón de signo más en la parte inferior de la variante o paso y selecciona User Update.

Hay tres opciones que te permiten actualizar la información existente del perfil de usuario, añadir información nueva o eliminar información del perfil de usuario. En conjunto, los pasos de User Update en un espacio de trabajo pueden actualizar hasta 200 000 perfiles de usuario por minuto.

Consejo

También puedes probar los cambios realizados con este componente buscando un usuario y aplicándole el cambio. Esto actualizará al usuario.

Actualización de atributos personalizados

Para actualizar o eliminar un atributo personalizado, selecciona un nombre de atributo de tu lista de atributos e introduce el valor.

Eliminar atributos personalizados

Para eliminar un atributo personalizado, selecciona un nombre de atributo con el menú desplegable. Puedes cambiar al editor JSON avanzado para seguir editando.

Aumentar y disminuir valores

El paso de actualización de usuario puede aumentar o disminuir el valor de un atributo. Selecciona el atributo, selecciona Increment By o Decrement By e introduce un número.

Seguimiento del progreso semanal

Al incrementar un atributo personalizado que hace seguimiento de un evento, puedes rastrear el número de clases que un usuario ha tomado en una semana. Con este componente, el recuento de clases puede reiniciarse al inicio de la semana y comenzar a hacer seguimiento de nuevo.

Actualizar una matriz de objetos

Una matriz de objetos es un atributo personalizado rico en datos almacenado en el perfil de un usuario. Puedes usarla para crear un historial de las interacciones del usuario con tu marca y para crear segmentos basados en un campo calculado, como el historial de compras o el valor de duración del ciclo de vida total.

Con la opción Advanced JSON Editor, puedes insertar JSON para añadir o eliminar elementos de esta matriz de objetos.

Caso de uso: actualizar la lista de deseos de un usuario

Haz seguimiento de la lista de deseos de un usuario para que puedas segmentar o personalizar en función de sus artículos guardados.

1. Crea un atributo personalizado que sea una matriz de objetos, por ejemplo wishlist. Cada objeto puede incluir campos como product_id, product_name y added_at.
2. En el paso de actualización de usuario, selecciona Advanced JSON Editor. A continuación, en la sección Compose, usa la operación $add para añadir un elemento o la operación $remove para eliminar un elemento por valor.

El siguiente es un ejemplo de cómo añadir un elemento a la lista de deseos:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "attributes": [
    {
      "wishlist": {
        "$add": [
          {
            "product_id": "SKU-123",
            "product_name": "Wireless Headphones",
            "added_at": "{{$isoTimestamp}}"
          }
        ]
      }
    }
  ]
}

Para eliminar un elemento, usa "wishlist": { "$remove": [ { "product_id": "SKU-123", ... } ] } con la misma estructura de objeto para que Braze pueda encontrarlo y eliminarlo.

Caso de uso: calcular el total del carrito de compras

Haz seguimiento de cuándo un usuario tiene artículos en su carrito de compras, cuándo añade nuevos artículos o los elimina, y cuál es el valor total del carrito de compras.

1. Crea una matriz personalizada de objetos llamada shopping_cart. El siguiente ejemplo muestra cómo puede verse este atributo. Cada artículo tiene un product_id único que contiene datos adicionales en su propia matriz anidada de objetos, incluyendo price.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": number,
         "shipping": number,
         "items_in_cart": number,
         "product_id": array,
         "gift": boolean,
         "discount_code": "enum",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

2. Crea un evento personalizado llamado add_item_to_cart que se registre cuando un usuario añade un artículo a la cesta.
3. Crea un Canvas que se dirija a los usuarios que realizan este evento personalizado. Ahora, cuando un usuario añade un artículo a su carrito, este Canvas se activa. Luego puedes dirigir la mensajería directamente a ese usuario, ofreciendo códigos de cupón cuando alcance un gasto determinado, abandone su carrito durante cierto tiempo, o cualquier otra acción que se alinee con tu caso de uso.

El atributo shopping_cart contiene el total de muchos eventos personalizados: el coste total de todos los artículos, el número total de artículos en el carrito, si el carrito de compras contiene un regalo, y más. Esto puede verse algo así:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": 22.99,
         "shipping": 4.99,
         "items_in_cart": 2,
         "product_id": ["1001", "1002"],
         "gift": true,
         "discount_code": "flashsale1000",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

Configurar la propiedad de entrada de Canvas como un atributo

Puedes usar el paso de actualización de usuario para conservar una canvas_entry_property. Supongamos que tienes un evento que se desencadena cuando se añade un artículo al carrito. Puedes almacenar el ID del artículo más reciente añadido al carrito y utilizarlo para una campaña de remarketing. Usa la característica de personalización para recuperar una propiedad de entrada de Canvas y almacenarla en un atributo.

Personalización

Para almacenar la propiedad del evento desencadenante de un Canvas como un atributo, usa el modal de personalización para extraer y almacenar la propiedad de entrada de Canvas. La actualización de usuario también es compatible con las siguientes características de personalización:

• Contenido conectado
• Content Blocks
• Propiedades de entrada
• Lógica de Liquid (incluida la cancelación de mensajes)
• Múltiples actualizaciones de atributos o eventos por objeto

Advertencia

Recomendamos usar con precaución la personalización con Liquid de contenido conectado en los pasos de actualización de usuario, ya que este tipo de paso tiene un límite de velocidad de 200 000 solicitudes por minuto. Este límite de velocidad anula el límite de velocidad de Canvas.

Editor JSON avanzado

Añade un objeto JSON de atributo, evento o compra de hasta 65 536 caracteres al editor JSON. También se puede configurar el estado de la suscripción global y del grupo de suscripción de un usuario.

Con el editor JSON, también puedes previsualizar y probar que el perfil de usuario se actualice con tus cambios en la pestaña Vista previa y prueba. Puedes seleccionar un usuario aleatorio o buscar un usuario específico. Después de enviar una prueba a un usuario, consulta el perfil de usuario mediante el enlace generado.

Consideraciones

No necesitas incluir datos confidenciales como tu clave de API al usar el editor JSON, ya que la plataforma los proporciona automáticamente. Los siguientes campos no deben incluirse en el editor JSON:

• ID de usuario externo
• Clave de API
• URL del clúster de Braze
• Campos relacionados con la importación de tokens de notificaciones push

Importante

Las propiedades de Canvas (como las etiquetas de Liquid canvas_id, canvas_name y canvas_variant_name) no son compatibles con los pasos de actualización de usuario.

Registrar eventos personalizados

Con el editor JSON, también puedes registrar eventos personalizados. Ten en cuenta que esto requiere una marca de tiempo en formato ISO, por lo que es necesario asignar una hora y fecha con Liquid al principio. Considera este ejemplo que registra un evento con una hora.

1
2
3
4
5
6
7
8
9
{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "name": "logged_user_event",
      "time": "{{timestamp}}"
    }
  ]
}

El siguiente ejemplo vincula un evento a una aplicación específica mediante un evento personalizado con propiedades opcionales y el app_id.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "app_id": "insert_app_id",
      "name": "rented_movie",
      "time": "{{timestamp}}",
      "properties": {
        "release": {
          "studio": "FilmStudio",
          "year": "2022"
        },
        "cast": [
          {
            "name": "Actor1"
          },
          {
            "name": "Actor2"
          }
        ]
      }
    }
  ]
}

Editar el estado de suscripción

Dentro del editor JSON, también puedes editar el estado de suscripción de un usuario. Por ejemplo, a continuación se muestra el estado de suscripción de un usuario actualizado a opted_in.

1
2
3
4
5
6
7
{
  "attributes": [
    {
      "email_subscribe": "opted_in"
    }
  ]
}

Actualizar grupos de suscripción

También puedes actualizar grupos de suscripción con este paso en Canvas. El siguiente ejemplo muestra cómo actualizar uno o más grupos de suscripción.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "attributes": [
    {
      "subscription_groups": [
        {
          "subscription_group_id": "subscription_group_identifier_1",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_2",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_3",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}