Skip to content

Atualização de usuário

O componente Atualização de usuário permite atualizar atributos, eventos e compras de um usuário em um editor JSON, sem a necessidade de incluir informações sensíveis como chaves de API.

Como este componente funciona

Uma etapa de Atualização de usuário chamada "Update loyalty" que atualiza o atributo "Is Premium Member" para "true".

Ao usar este componente no seu Canvas, as atualizações não contam para o limite de taxa de solicitações por minuto do /users/track. Em vez disso, essas atualizações são agrupadas em lotes para que a Braze possa processá-las de forma mais eficiente do que um webhook 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ções).

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

Criando 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 User Update.

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

Atualizando atributos personalizados

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

Etapa de Atualização de usuário que atualiza os dois atributos "Loyalty Member" e "Loyalty Program" para "true".

Removendo atributos personalizados

Para remover um atributo personalizado, selecione um nome de atributo usando o menu suspenso. Você pode alternar para o editor JSON avançado para edições adicionais.

Etapa de Atualização de usuário que remove o atributo "Loyalty Member".

Incrementando e decrementando valores

A etapa de Atualização de usuário pode incrementar ou decrementar o valor de um atributo. Selecione o atributo, selecione Increment By ou Decrement By e insira um número.

Acompanhar o progresso semanal

Ao incrementar um atributo personalizado que rastreia um evento, você pode acompanhar o número de aulas que um usuário fez em uma semana. Usando este componente, a contagem de aulas pode ser redefinida no início da semana e começar a rastrear novamente.

Etapa de Atualização de usuário que incrementa o atributo "class_count" em um.

Atualizando um array 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 lifetime value total.

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

Caso de uso: Atualizando a 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 nos 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 de usuário, selecione Advanced JSON Editor. Em seguida, na seção Redigir, use a operação $add para adicionar um item ou a operação $remove para remover um item por valor.

A seguir, um exemplo de adição de 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 a Braze possa encontrar e removê-lo.

Caso de uso: Calculando o total do carrinho de compras

Acompanhe quando um usuário tem itens no carrinho de compras, quando adiciona ou remove itens e qual é o valor total do carrinho.

  1. Crie um array de objetos personalizado chamado shopping_cart. O exemplo a seguir mostra como esse atributo pode ser. Cada item tem um product_id único que possui dados adicionais em seu próprio array de objetos aninhado, 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}}"},
       }
      ]
    }
  ]
}
  1. Crie um evento personalizado chamado add_item_to_cart que é registrado quando um usuário adiciona um item ao carrinho.
  2. Crie um Canvas direcionado a usuários que realizam esse evento personalizado. Agora, quando um usuário adiciona um item ao carrinho, esse Canvas é disparado. Você pode então direcionar mensagens diretamente a esse usuário, oferecendo códigos de cupom quando ele atingir um determinado valor de gasto, abandonar o carrinho por um certo período de tempo ou qualquer outra ação que se alinhe ao seu caso de uso.

O atributo shopping_cart carrega o total de muitos eventos personalizados: o custo total de todos os itens, o número total de itens no carrinho, se o carrinho contém um presente, e assim por diante. Isso pode ser algo como 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}}"},
       }
      ]
    }
  ]
}

Definindo a propriedade de entrada do Canvas como um atributo

Você pode usar a etapa de Atualização de usuário para persistir uma canvas_entry_property. Digamos que você tenha um evento que é disparado quando um item é adicionado ao carrinho. Você pode armazenar o ID do item mais recente adicionado ao carrinho e usá-lo para uma campanha de remarketing. Use o recurso de personalização para recuperar uma propriedade de entrada do Canvas e armazená-la em um atributo.

Etapa de Atualização de usuário que atualiza o atributo "most_recent_cart_item" com um ID de item.

Personalização

Para armazenar a propriedade do evento de gatilho de um Canvas como um atributo, use o modal de personalização para extrair e armazenar a propriedade de entrada do Canvas. A Atualização de usuário também suporta os seguintes recursos de personalização:

Editor JSON avançado

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

Usando o editor JSON, você também pode pré-visualizar e testar se o perfil do usuário é atualizado com suas alterações na guia Preview and test. Você pode selecionar um usuário aleatório ou pesquisar um usuário específico. Depois de enviar um teste para 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 da Braze
  • Campos relacionados a importações de token por push

Registrar eventos personalizados

Usando o editor JSON, você também pode registrar eventos personalizados. Observe que isso requer um timestamp no formato ISO, então é necessário atribuir uma data e hora com Liquid no início. Considere este exemplo que registra um evento com um horário.

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 estado de inscrição

No editor JSON, você também pode editar o estado de inscrição de um usuário. Por exemplo, o seguinte mostra o estado de 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 grupos de inscrições usando esta etapa do Canvas. O exemplo a seguir mostra como atualizar um ou mais grupos de inscrições.

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"
        }
      ]
    }
  ]
}
New Stuff!