Notificações de reposição de estoque

Aprenda a configurar notificações de reposição de estoque usando seu catálogo e eventos personalizados, para que você possa inscrever automaticamente os clientes para receber notificações quando um item estiver de volta ao estoque. Lembre-se de que isso se aplica apenas a usuários que já optaram por receber notificações.

Como funciona

Você pode configurar um evento personalizado para usar como evento de inscrição, como um evento product_clicked. Esse evento deve conter uma propriedade com o ID do item (IDs de itens do catálogo). Sugerimos incluir o nome do catálogo, mas isso não é obrigatório. Você também fornecerá o nome de um campo de quantidade em estoque, que deve ser do tipo de dados numérico.

Note que o estoque de um item do catálogo deve estar zerado para que um usuário consiga se inscrever nele. Quando um item tem uma quantidade em estoque maior que zero, a Braze buscará todos os usuários inscritos naquele item e enviará um evento personalizado que você pode usar para disparar uma Campaign ou um Canvas.

As propriedades do evento são enviadas junto com o usuário, então você pode usar modelos para incluir os detalhes do item na Campaign ou no Canvas que será enviado.

Configurando notificações de volta ao estoque

Siga estas etapas para configurar notificações de volta ao estoque em um catálogo específico.

1. Acesse seu catálogo e selecione a guia Configurações.
2. Selecione o toggle Volta ao estoque.
3. Se as configurações globais de volta ao estoque não foram definidas, você será solicitado a configurar os eventos personalizados e as propriedades que serão usados para disparar notificações de volta ao estoque:
   
   • Catálogo de fallback É o catálogo usado para a inscrição de volta ao estoque quando não há uma propriedade catalog_name presente no evento personalizado.
   • Evento personalizado para inscrições é o evento personalizado da Braze usado para inscrever um usuário em notificações de volta ao estoque. Quando esse evento ocorre, o usuário que realizou o evento é inscrito.
   • Evento personalizado para cancelar inscrição é o evento personalizado da Braze usado para cancelar a inscrição de um usuário nas notificações de volta ao estoque. Esse evento é opcional. Se o usuário não realizar esse evento, a inscrição será cancelada após 90 dias ou quando o evento de volta ao estoque for disparado, o que ocorrer primeiro.

   • Propriedade de ID do item no evento é a propriedade no evento personalizado mencionado anteriormente nesta seção que é usada para determinar o item para uma inscrição ou cancelamento de inscrição de volta ao estoque. Essa propriedade no evento personalizado deve conter um ID de item (id) que esteja presente em um catálogo. O ID do item deve ser enviado como uma string para que corresponda ao tipo de dados id armazenado no catálogo de destino. O evento personalizado também deve conter uma propriedade catalog_name para especificar em qual catálogo esse item está.

   • Um exemplo de evento personalizado:

• rest api
• web sdk
• android sdk
• ios sdk

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
    "events": [
        {
            "external_id": "<external_id>",
            "name": "subscription",
            "time": "2024-04-15T19:22:28Z",
            "properties": {
                "id": "shirt-xl",
                "catalog_name": "on_sale_products",
                "type": ["back_in_stock"]
            }
        }
    ]
}

1
2
3
4
5

braze.logCustomEvent("subscription", {
  id: "shirt-xl",
  catalog_name: "on_sale_products",
  type: ["back_in_stock"]
});

1
2
3
4
5
6
7
8
9
10

// Kotlin
Braze.getInstance(context).logCustomEvent(
  "subscription",
  BrazeProperties(
    JSONObject()
      .put("id", "shirt-xl")
      .put("catalog_name", "on_sale_products")
      .put("type", JSONArray().put("back_in_stock"))
  )
)

1
2
3
4
5
6
7
8
9

// Java
Braze.getInstance(context).logCustomEvent(
  "subscription",
  new BrazeProperties(new JSONObject()
    .put("id", "shirt-xl")
    .put("catalog_name", "on_sale_products")
    .put("type", new JSONArray().put("back_in_stock"))
  )
);

1
2
3
4
5
6
7
8
9

// Swift
AppDelegate.braze?.logCustomEvent(
  name: "subscription",
  properties: [
    "id": "shirt-xl",
    "catalog_name": "on_sale_products",
    "type": ["back_in_stock"]
  ]
)

1
2
3
4
5
6
7

// Objective-C
[AppDelegate.braze logCustomEvent:@"subscription"
                       properties:@{
  @"id": @"shirt-xl",
  @"catalog_name": @"on_sale_products",
  @"type": @[@"back_in_stock"]
}];

Nota

Os disparadores de volta ao estoque e de queda de preço usam o mesmo evento para inscrever o usuário na notificação, então você pode usar a propriedade type para definir notificações de queda de preço e de volta ao estoque no mesmo evento. A propriedade type deve ser um array.

4. Selecione Salvar e continue para a página de Configurações do catálogo.
5. Defina sua regra de notificação. Existem duas opções:
   • Notificar todos os usuários inscritos notifica todos os clientes que estão aguardando quando o item volta ao estoque.
   • Definir limites de notificação notifica um número especificado de clientes a cada 10 minutos. A Braze notificará o número especificado de clientes em incrementos até que não haja mais clientes para notificar ou até que o item fique fora de estoque. Sua taxa de notificação não pode exceder 10.000 usuários por minuto.
6. Defina o Campo de estoque no catálogo. Esse campo do catálogo será usado para determinar se o item está fora de estoque. O campo deve ser do tipo número.
7. Selecione Salvar configurações.

Importante

As regras de notificação nessas configurações não substituem as configurações de notificação do Canvas, como o horário de silêncio.

Usando notificações de volta ao estoque em um Canvas

Depois de configurar o recurso de volta ao estoque em um catálogo, siga estas etapas para usá-lo com o Canvas.

1. Configure um Canvas baseado em ação.
2. Selecione Volta ao estoque como o disparador.
3. Selecione o nome do catálogo com as notificações de volta ao estoque.
4. Continue configurando seu Canvas normalmente.

Agora, seus clientes podem ser notificados quando um item estiver de volta ao estoque.

Usando Liquid

Para incluir detalhes sobre o item do catálogo que voltou ao estoque, você pode usar a Liquid tag context para acessar o item_id.

Usar {{context.${catalog_update}.item_id}} retornará o ID do item que voltou ao estoque. {{context.${catalog_update}.previous_value}} retornará o valor de inventário do item antes da atualização, e {{context.${catalog_update}.new_value}} retornará o novo valor de inventário após a atualização.

Use a Liquid tag {% catalog_items <name_of_your_catalog> {{context.${catalog_update}.item_id}} %} no topo da sua mensagem e, em seguida, use {{ items[0].<field_name> }} para acessar dados sobre esse item ao longo da mensagem.

Importante

As propriedades de entrada do Canvas fazem parte das variáveis de contexto do Canvas. Isso significa que canvas_entry_properties é referenciado como context. Cada variável context inclui um nome, tipo de dado e um valor que pode incluir Liquid. Atualmente, canvas_entry_properties são compatíveis com versões anteriores. Para mais detalhes, consulte Contexto e objeto de contexto do Canvas.

Dica

Para incluir imagens nos itens de disparo de catálogo, seu catálogo deve conter um campo chamado image_url. Você pode então referenciá-lo usando {{ items[0].image_url }}.

Considerações

• Os usuários ficam inscritos por apenas 90 dias. Se o item não voltar ao estoque em 90 dias, o usuário terá sua inscrição cancelada.
• Ao usar a regra de notificação Notify all subscribed users, a Braze notificará 100.000 usuários ao longo de 10 minutos.
• A Braze suporta até 50.000 itens atualizados diariamente que são elegíveis para disparar notificações de volta ao estoque. Você pode ter até 100 milhões de inscrições ativas a qualquer momento, onde cada inscrição representa um perfil de usuário inscrito para monitorar um item do catálogo.