Atualização de usuário

O componente de Atualização do Usuário permite que você atualize os atributos, eventos e compras de um usuário em um editor JSON, portanto, não há necessidade de incluir informações sensíveis, como chaves de API.

Como este componente funciona

Ao usar este componente em seu Canva, as atualizações não contam para o seu /users/track limite de frequência de solicitações por minuto. Em vez disso, essas atualizações são agrupadas para que o Braze possa processá-las com mais eficiência do que um webhook de Braze para Braze. Observe que este componente não registra pontos de dados quando usado para atualizar pontos de dados não faturáveis (como grupos de inscrição).

Depois que os usuários entram na etapa de Atualização do Usuário e ela conclui o processamento, eles avançam para a próxima etapa. Isso significa que qualquer envio de mensagens subsequente que dependa dessas atualizações de usuário está atualizado quando a próxima etapa é executada.

Criação de uma atualização de usuário

Arraste e solte o componente da barra lateral, ou selecione o botão de mais na parte inferior da variante ou etapa e selecione Atualização do Usuário.

Existem três opções que permitem que você atualize informações de perfil de usuário existentes, adicione novas informações ou remova informações do perfil do usuário. Combinadas, as etapas de atualização de usuários em um espaço de trabalho podem atualizar até 200.000 perfis de usuários por minuto.

Atualização de atributos personalizados

Para atualizar ou remover um atributo personalizado, selecione um nome de atributo da sua lista de atributos e insira o valor.

Remoção de atributos personalizados

Para remover um atributo personalizado, selecione o nome do atributo usando o menu suspenso. Você pode mudar para o editor JSON avançado para editar ainda mais.

Valores crescentes e decrescentes

A etapa de Atualização do Usuário pode aumentar ou diminuir o valor de um atributo. Selecione a atribuição, selecione Increment By (Aumentar por ) ou Decrement By (Diminuir por) e digite um número.

Rastreamento do progresso semanal

Ao incrementar um atributo personalizado que rastreia um evento, é possível rastrear o número de aulas que um usuário teve em uma semana. Usando esse componente, a contagem de classes pode ser redefinida no início da semana e começar o rastreamento novamente.

Atualização de um vetor de objetos

Um array de objetos é um atributo personalizado rico em dados armazenado no perfil de um usuário. Você pode usá-lo para criar um histórico das interações do usuário com sua marca e para criar segmentos com base em um campo calculado, como histórico de compras ou valor total do tempo de vida.

Usando a opção Editor JSON Avançado, você pode inserir JSON para adicionar itens a ou remover itens deste array de objetos.

Caso de uso: Atualização da lista de desejos de um usuário

Acompanhe a lista de desejos de um usuário para que você possa segmentar ou personalizar com base em seus itens salvos.

1. Crie um atributo personalizado que seja um array de objetos, por exemplo wishlist. Cada objeto pode incluir campos como product_id, product_name e added_at.
2. Na etapa de Atualização do Usuário, selecione Editor JSON Avançado. Em seguida, na seção Compor, use a operação $add para adicionar um item ou a operação $remove para remover um item por valor.

O seguinte é um exemplo de adicionar um item à lista de desejos:

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 remover um item, use "wishlist": { "$remove": [ { "product_id": "SKU-123", ... } ] } com a mesma estrutura de objeto para que o Braze possa corresponder e removê-lo.

Caso de uso: Cálculo do total do carrinho de compras

Rastreie quando um usuário tem itens em seu carrinho de compras, quando adiciona novos itens ou remove itens e qual é o valor total do carrinho de compras.

1. Crie um array personalizado de objetos chamado shopping_cart. O exemplo a seguir mostra a aparência desse atributo. Cada item tem um product_id único que possui dados adicionais em seu próprio array aninhado de objetos, incluindo 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. Crie um evento personalizado chamado add_item_to_cart que é registrado quando um usuário adiciona um item à cesta. 3. Crie um Canva que tenha como alvo usuários que realizam este evento personalizado. Agora, quando um usuário adiciona um item ao carrinho, esse Canva é disparado. Em seguida, é possível direcionar o envio de mensagens diretamente para esse usuário, oferecendo códigos de cupom quando ele atingir um determinado gasto, abandonar o carrinho por um determinado período de tempo ou qualquer outra coisa que se alinhe ao seu caso de uso.

O atributo shopping_cart contém o total de muitos eventos personalizados: o custo total de todos os itens, o número total de itens no carrinho, se o carrinho de compras contém um presente e assim por diante. Isso pode ser parecido com o seguinte:

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}}"},
       }
      ]
    }
  ]
}

Definição da propriedade de entrada do Canva como uma atribuição

É possível usar a etapa de atualização do usuário para manter um canvas_entry_property. Digamos que você tenha um evento que dispara quando um item é adicionado a um carrinho. Você pode armazenar o ID do item mais recente adicionado ao carrinho e usá-lo em uma campanha de remarketing. Use o recurso de personalização para recuperar uma propriedade de entrada do Canva e armazená-la em uma atribuição.

Personalização

Para armazenar a propriedade do evento de gatilho de um Canvas como uma atribuição, use o modal de personalização para extrair e armazenar a propriedade de entrada do Canvas. O User Update também oferece suporte aos seguintes recursos de personalização:

• Conteúdo conectado
• Blocos de conteúdo
• Propriedades de entrada
• Lógica Liquid (incluindo mensagens de aborto)
• Várias atualizações de atribuições ou eventos por objeto

Editor JSON Avançado

Adicione um atributo, evento ou objeto JSON de compra de até 65.536 caracteres ao editor JSON. A inscrição global de um usuário e o estado do grupo de inscrições também podem ser definidos.

Usando o editor JSON, você também pode prévia e testar se o perfil do usuário é atualizado com suas alterações na guia Prévia e teste. Você pode selecionar um usuário aleatório ou procurar um usuário específico. Em seguida, depois de enviar um teste a um usuário, visualize o perfil do usuário usando o link gerado.

Considerações

Você não precisa incluir dados sensíveis como sua chave de API ao usar o editor JSON, pois isso é fornecido automaticamente pela plataforma. Os seguintes campos não devem ser incluídos no editor JSON:

• ID de usuário externo
• Chave de API
• URL do cluster do Braze
• Campos relacionados a importações de token por push

Registre eventos personalizados

Usando o editor JSON, você também pode registrar eventos personalizados. Observe que isso requer um timestamp em formato ISO, portanto, é necessário atribuir um horário e data com Liquid no início. Considere este exemplo que registra um evento com uma 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}}"
    }
  ]
}

O próximo exemplo vincula um evento a um app específico usando um evento personalizado com propriedades opcionais e o 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 o estado da inscrição

Dentro do editor JSON, você também pode editar o estado de assinatura de um usuário. Por exemplo, veja a seguir o estado da inscrição de um usuário atualizado para opted_in.

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

Atualizar grupos de inscrições

Você também pode atualizar os grupos de inscrições usando essa etapa do canva. O seguinte exemplo mostra como atualizar um ou mais grupos de assinatura.

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"
        }
      ]
    }
  ]
}