Skip to content

Actualización de usuario

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

Con la actualización de usuarios, las actualizaciones no cuentan para el límite de solicitudes por minuto de /users/track. En su lugar, estas actualizaciones se agrupan por lotes para que Braze pueda procesarlas con mayor eficacia que un webhook de Braze a Braze. Tenga en cuenta que este componente no consume puntos de datos cuando se utiliza para actualizar puntos de datos no facturables (como grupos de suscripción).

Los usuarios sólo avanzarán a los siguientes pasos de Canvas una vez que hayan completado las actualizaciones de usuario pertinentes. Esto significa que cualquier mensajería posterior que dependa de estas actualizaciones del usuario estará actualizada cuando se ejecute el siguiente paso.

Creación de una actualización de usuario

Arrastre y suelte el componente desde la barra lateral, o haga clic en el botón más en la parte inferior de la variante o paso y seleccione Actualización de usuario.

Hay tres opciones que le permiten actualizar la información del perfil de usuario existente, añadir nueva o eliminarla. En conjunto, los pasos de actualización de usuarios en un espacio de trabajo pueden actualizar hasta 200.000 perfiles de usuario por minuto.

Actualización de atributos personalizados

Para añadir o actualizar un atributo personalizado, seleccione un nombre de atributo de su lista de atributos e introduzca el valor clave.

Eliminar atributos personalizados

Para eliminar un atributo personalizado, seleccione un nombre de atributo utilizando el desplegable. Puede cambiar al compositor JSON avanzado para seguir editando.

Valores crecientes y decrecientes

El paso de actualización del usuario puede aumentar o disminuir el valor de un atributo. Seleccione el atributo, elija Incrementar por o Disminuir por e introduzca un número.

Hacer un seguimiento semanal

Incrementando un atributo personalizado que rastrea un evento, puede rastrear el número de clases que un usuario ha tomado en una semana. Utilizando este componente, el recuento de clases puede reiniciarse al comienzo de la semana y comenzar el seguimiento de nuevo.

Actualizar una matriz de objetos

Un array de objetos es un atributo personalizado almacenado en el perfil de un usuario que es rico en datos. Esto le permite crear un historial de las interacciones del usuario con su marca. Esto le permite crear segmentos basados en un atributo personalizado que es un campo calculado, como el historial de compras o el valor total del tiempo de vida.

El paso de actualización de usuario puede añadir o eliminar atributos a esta matriz de objetos. Para actualizar una matriz, seleccione el nombre del atributo de la matriz en su lista de atributos e introduzca el valor de la clave.

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

Al añadir o eliminar un elemento de una matriz se actualiza la lista de deseos del usuario.

Caso de uso: Calcular el total de la cesta de la compra

Realice un seguimiento de cuándo un usuario tiene artículos en su cesta de la compra, cuándo añade nuevos artículos o los elimina, y cuál es el valor total de la cesta de la compra.

  1. Cree una matriz personalizada de objetos llamada shopping_cart. El siguiente ejemplo muestra el aspecto que puede tener este atributo. Cada elemento tiene un único product_id que tiene datos más complejos 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. Crear un evento personalizado llamado add_item_to_cart que se registra cuando un usuario añade un artículo a la cesta. 3. Crea un Canvas con un público objetivo de usuarios con este evento personalizado. Ahora, cuando un usuario añade un artículo a su cesta, se activa este Canvas. A continuación, puede dirigir mensajes directamente a ese usuario, ofreciéndole códigos de cupón cuando haya alcanzado un determinado nivel de gasto, haya abandonado su cesta durante un determinado periodo de tiempo o cualquier otra cosa que se ajuste a su caso de uso.

El atributo shopping_cart lleva 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 contiene un regalo, etc. Esto puede parecerse a lo siguiente:

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": yes,
         "discount_code": "flashsale1000",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

Establecer la propiedad de entrada Canvas como atributo

Puedes utilizar el paso de actualización de usuario para persistir un canvas_entry_property. Digamos que tienes un evento que se dispara cuando se añade un artículo al carrito. Puede almacenar el ID del último artículo añadido al carrito y utilizarlo para una campaña de remarketing. Utilice la función 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 atributo, utilice el modal de personalización para extraer y almacenar la propiedad de entrada del Canvas. La actualización de usuarios también admite las siguientes funciones de personalización:

Compositor JSON avanzado

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

Mediante el compositor avanzado, también puede previsualizar y probar que el perfil de usuario se actualiza con los cambios con la pestaña Previsualizar y probar. Puede seleccionar un usuario al azar o buscar un usuario concreto. A continuación, tras enviar una prueba a un usuario, visualice el perfil del usuario utilizando el enlace generado.

Consideraciones

No es necesario que incluyas datos confidenciales como tu clave de API al utilizar el compositor JSON, ya que la plataforma los proporciona automáticamente. Por lo tanto, los siguientes campos no son necesarios y no deben utilizarse en el compositor JSON:

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

Registrar eventos personalizados

Utilizando el compositor JSON, también puedes registrar eventos personalizados. Tenga en cuenta que esto requiere una marca de tiempo en formato ISO, por lo que es necesario asignar una hora y una fecha con Liquid al principio. Considere 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 utilizando un evento personalizado con propiedades opcionales y la dirección 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 la suscripción

Dentro del compositor JSON, también puede editar el estado de suscripción de su 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 los grupos de suscripción

También puede actualizar los grupos de suscripción mediante este paso de Canvas. El siguiente ejemplo muestra una actualización de los grupos de suscripción. Puede realizar una o varias actualizaciones de 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"
        }
      ]
    }
  ]
}
Github   Editar esta página en GitHub
¿QUÉ TAN ÚTIL FUE ESTA PÁGINA?
New Stuff!