Passar para o conteúdo principal

Criação de Vitrines Synerise

b
Escrito por bruno bulso

Criação de Vitrines Synerise

1. Visão Geral da Integração

A integração da Synerise no aplicativo permite a exibição de conteúdos dinâmicos, como vitrines de recomendação. O aplicativo atua como um consumidor desses conteúdos, o que significa que a inteligência de recomendação, regras de exibição e os itens retornados são gerenciados diretamente na plataforma da Synerise.

O papel do CMS VTEX neste fluxo é determinar onde e quando essas campanhas da Synerise serão exibidas no aplicativo (ex: Home, Carrinho, Página de Produto).

Nota importante: Para que as configurações realizadas no CMS VTEX sejam exibidas no app, a integração com a Synerise precisa ter sido solicitada previamente ao suporte da Kobe.

2. Como Cadastrar uma Vitrine Synerise no CMS VTEX

Com a padronização recente das vitrines Synerise, o processo de cadastro no CMS foi simplificado.

Passo a Passo para Configuração:

  1. Acesse o painel do CMS VTEX

  2. Navegue até a seção de gerenciamento de conteúdo do aplicativo (App CMS).

  3. Selecione a página onde deseja inserir a vitrine (ex: Home, Carrinho, Produto).

  4. Adicione um novo componente do tipo Campanha.

  1. No formulário de configuração do componente, preencha os seguintes campos:

    1. Tipo de Campanha: Selecione Synerise (ou synerise-recommendation).

    2. Título: Nome de identificação da campanha.

    3. Como funciona: O título que você configurar no campo Título do CMS VTEX será o título exibido no aplicativo.

    4. Fallback: Caso nenhum título seja configurado no CMS, o aplicativo tentará utilizar o nome proveniente da Synerise ou ocultará o título para evitar a exibição de termos técnicos ao usuário final.

    5. ID da Campanha (campaignId): Campo obrigatório e mais importante. É o ID da campanha cadastrada na plataforma da Synerise. O app usa esse valor diretamente na chamada à API da Synerise para buscar os produtos/conteúdos a serem exibidos. Sem esse campo preenchido corretamente, o componente não é renderizado.

      1. O ID da campanha deve ter o mesmo valor que o ID presente em um dos modelos cadastrados em AI Hub > AI Recommendations > Models no painel da Synerise.

    6. Ativo: Marcar para ativar a exibição do componente no app. Se desmarcado, o componente é ignorado completamente pelo app, mesmo que os demais campos estejam preenchidos.

3. Locais Disponíveis para Exibição (Content Containers)

As vitrines da Synerise podem ser posicionadas em diversos locais estratégicos do aplicativo. O aplicativo utiliza "Content Containers" para mapear onde o conteúdo do CMS deve ser renderizado.

Ao configurar sua campanha no CMS, você pode direcioná-la para os seguintes locais (Location IDs):

| Local no App | Location ID no CMS | Descrição | | ------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- | | Home | offersHomeTop, offersHome | Áreas de destaque na tela inicial do aplicativo. | | Página de Produto (PDP) | pdpTop, pdpBelowProductImage, pdpBelowDescription, pdpBottom | Diferentes posições na página de detalhes de um produto específico. | | Página de Categoria/Busca (PLP) | plpHeader, plpTop, plpAppBanner, plpEmptyState | Topo das listagens de produtos ou na tela de "Nenhum resultado encontrado". | | Carrinho | cartBottom, emptyCartBottom | Fundo da tela do carrinho, ideal para cross-sell ou upsell, inclusive quando o carrinho está vazio. | | Checkout | preCheckout | Etapa anterior à finalização da compra. | | Outros | categories, productStoryPage, custom | Telas de navegação de categorias ou páginas de histórias de produtos. |

3.1. Visibilidade e Contexto

Ao configurar vitrines em páginas específicas como a Página de Produto (PDP) ou Carrinho, o aplicativo envia automaticamente o contexto (como o ID do produto visualizado ou os itens no carrinho) para a Synerise.

A Synerise utiliza esse contexto (enviado via parâmetro itemId na API) para retornar recomendações altamente personalizadas e relacionadas ao item em questão.

4. Resolução de Problemas Comuns

Se a vitrine configurada não estiver aparecendo no aplicativo, verifique os seguintes pontos:

  1. ID da Campanha Incorreto: Certifique-se de que o campaignId inserido no CMS é exatamente o mesmo gerado na plataforma da Synerise. Espaços em branco extras podem causar falhas.

  2. Campanha Inativa na Synerise: Verifique se a campanha está ativa e publicando recomendações no painel da Synerise.

  3. Falta de Retorno da Synerise: Se a Synerise não retornar produtos para aquele usuário específico (por falta de histórico ou regras de segmentação muito restritas), a vitrine não será renderizada no app (o aplicativo oculta vitrines vazias automaticamente).

  4. Cache do CMS: Após publicar a alteração no CMS VTEX, pode levar alguns minutos para que o cache seja atualizado e a mudança reflita no aplicativo.

5. Próximos Passos

  1. Acesse o painel da Synerise e crie/identifique as campanhas de recomendação que deseja exibir.

  2. Copie os IDs dessas campanhas.

  3. Acesse o CMS VTEX e cadastre os componentes de Campanha conforme as instruções da Seção 2, utilizando os IDs copiados.

  4. Abra o aplicativo e navegue até as telas configuradas para validar a exibição

Respondeu à sua pergunta?