Recomendando produtos aos usuários

Use a REST API 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 REST API.
• 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 produto 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 atributo significativos (como recommended_product_id) para que sejam fáceis de referenciar em modelos Liquid posteriormente. Mantenha as recomendações precisas atualizando-as regularmente à medida que seu mecanismo de recomendação produz novos resultados.

Etapa 2: Recuperar metadados do produto

Depois de armazenar um identificador de recomendação em cada perfil de usuário, você precisa recuperar os metadados completos do produto (nome, preço, imagem e assim por diante) 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: Connected Content — 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 de um usuário

Combine o atributo personalizado da Etapa 1 com uma consulta de 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: Connected Content

Se os metadados do seu produto estão em um serviço externo em vez de um catálogo da Braze, use o Connected Content 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.

Aviso

Evite usar Connected Content para buscar uma lista grande de produtos e depois iterar por essa lista em Liquid no momento do envio. Cargas úteis de resposta grandes aumentam a latência de envio e podem causar timeouts de mensagem ou falhas na entrega em escala. Em vez disso, armazene apenas os IDs de produtos específicos que um usuário precisa no perfil dele (consulte a Etapa 1) e busque os metadados desses itens individuais ou use catálogos, que são otimizados para consultas rápidas.

Etapa 3: Verifique 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 Catalogs ou Connected Content.
3. Confirme se os detalhes do produto são renderizados corretamente na mensagem entregue.
4. No dashboard da Braze, acesse a página de resultados da Campaign ou do Canvas e confirme se o envio foi registrado.

Considerações

• Mantenha os dados de recomendação precisos atualizando os atributos personalizados regularmente à medida que 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 a entrega disparada por API para disparar mensagens a partir do seu backend usando modelos definidos no dashboard da Braze.