Recomendando produtos aos usuários

Use a API REST da Braze junto com catálogos ou Conteúdo conectado para exibir recomendações personalizadas de produtos nas suas mensagens. Essa abordagem permite que você conecte seu próprio mecanismo de recomendação ao ecossistema de envio de mensagens da Braze, para que usuários não técnicos possam gerenciar o conteúdo e as mensagens relacionadas a cada recomendação.

Com essa abordagem, você pode:

• Armazenar recomendações de produtos nos perfis de usuário a partir do seu backend usando a API REST.
• Recuperar metadados de produtos no momento do envio usando catálogos ou Conteúdo conectado.
• Exibir recomendações personalizadas em qualquer canal de envio de mensagens, incluindo e-mail, push, mensagens no app e muito mais.

Pré-requisitos

Para concluir este guia, você precisa de:

Etapa 1: Armazenar recomendações nos perfis de usuário

Para começar, armazene as recomendações de produtos geradas pelo seu mecanismo de recomendação nos perfis de usuário da Braze como atributos personalizados. Isso permite que você faça referência aos produtos recomendados de cada usuário no momento do envio da mensagem.

1. Determine quais dados de recomendação armazenar, como IDs de produtos ou categorias preferidas.
2. Use o endpoint /users/track para gravar a recomendação como um atributo personalizado no perfil de usuário.

Exemplo de requisição

1
2
3
POST YOUR_REST_ENDPOINT/users/track
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

Substitua YOUR_REST_ENDPOINT pela URL do endpoint REST do seu espaço de trabalho.

1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user123",
      "recommended_product_id": "1001"
    }
  ]
}

Use nomes de atributos significativos (como recommended_product_id) para que sejam fáceis de referenciar nos modelos Liquid posteriormente. Mantenha as recomendações precisas atualizando-as regularmente conforme seu mecanismo de recomendação produz novos resultados.

Etapa 2: Recuperar metadados de produtos

Após armazenar um identificador de recomendação em cada perfil de usuário, você precisa recuperar os metadados completos do produto (nome, preço, imagem etc.) para incluir na sua mensagem. Você tem duas opções:

• Opção A: Catálogos da Braze — armazene informações de produtos diretamente na Braze para consultas rápidas e integradas.
• Opção B: Conteúdo conectado — busque informações de produtos de uma API externa no momento do envio.

Opção A: Catálogos da Braze

Se você criou um catálogo com seu inventário de produtos, pode consultar itens diretamente na sua mensagem usando Liquid. Para um passo a passo completo, consulte Usando catálogos.

Recomendar um item específico do catálogo

Para referenciar um produto específico por ID, use a Liquid tag catalog_items. Por exemplo, para recomendar o produto 1001 de um catálogo chamado retail_products:

1
2
3
4
5
6
{% catalog_items retail_products 1001 %}

We have a new item we think you'll like:
Category: {{ items[0].category }}
Name: {{ items[0].name }}
Price: ${{ items[0].price }}

Recomendar múltiplos itens do catálogo

Você também pode referenciar múltiplos itens em uma única tag. Por exemplo, para destacar três produtos:

1
2
3
4
5
6
7
8
{% catalog_items retail_products 1001 1003 1005 %}

New items added in:
- {{ items[0].category }}
- {{ items[1].category }}
- {{ items[2].category }}

Visit our store to learn more!

Criar modelos de itens usando a recomendação do usuário

Combine o atributo personalizado da Etapa 1 com uma consulta ao catálogo para personalizar a recomendação para cada usuário:

1
2
3
4
{% catalog_items retail_products {{custom_attribute.${recommended_product_id}}} %}

Hi {{${first_name}}}, check out our pick for you:
{{ items[0].name }} — ${{ items[0].price }}

Opção B: Conteúdo conectado

Se os metadados dos seus produtos estão em um serviço externo em vez de um catálogo da Braze, use Conteúdo conectado para buscá-los no momento do envio.

Por exemplo, se sua API interna retorna detalhes do produto por ID:

1
2
3
4
{% connected_content https://api.yourcompany.com/products/{{custom_attribute.${recommended_product_id}}} :save product %}

Hi {{${first_name}}}, we think you'll love:
{{ product.name }} — ${{ product.price }}

Para mais detalhes sobre como fazer chamadas de API a partir das suas mensagens, consulte Fazendo uma chamada de API.

Etapa 3: Verificar sua integração

Após concluir a configuração, verifique sua integração:

1. Use o endpoint /users/track para gravar uma recomendação de teste no seu próprio perfil de usuário.
2. Envie uma mensagem de teste que faça referência ao produto recomendado usando Catálogos ou Conteúdo conectado.
3. Confirme que os detalhes do produto são renderizados corretamente na mensagem entregue.
4. No dashboard da Braze, acesse a página de resultados da campanha ou do Canvas e confirme que o envio foi registrado.

Considerações

• Mantenha os dados de recomendação precisos atualizando os atributos personalizados regularmente conforme seu mecanismo de recomendação produz novos resultados.
• Use os recursos de personalização da Braze para personalizar ainda mais as mensagens, como incorporar dados específicos do usuário junto com os detalhes do produto.
• Considere usar entrega disparada por API para disparar mensagens a partir do seu backend usando modelos definidos no dashboard da Braze.