Como o conteúdo técnico bruto não foi fornecido, criarei um exemplo prático baseado em um cenário comum: a implementação de um banner promocional na home do aplicativo, que é gerenciado por meio de uma coleção de produtos na VTEX. Usarei esta premissa para gerar a documentação no formato solicitado.---

Esta funcionalidade permite exibir um banner promocional customizável na página inicial do seu aplicativo. O gerenciamento do banner, incluindo os produtos que são exibidos ao clicar nele, é feito de forma integrada e direta a partir do seu painel de e-commerce, sem a necessidade de solicitar alterações ao time técnico para cada nova campanha.

Sistemas envolvidos: A lógica de exibição e o conteúdo dos banners são controlados por meio de Coleções de Produtos. A documentação original detalha a implementação para a plataforma VTEX. O princípio pode ser aplicado a outras plataformas que utilizam um sistema de coleções, mas a ativação depende de uma validação técnica para cada caso.

Como eu defino qual banner e quais produtos aparecem no aplicativo?

O controle é feito através de uma Coleção de Produtos específica em sua plataforma VTEX. Você cria uma coleção (por exemplo, "Banner-Home-App") e anexa a ela a imagem do banner e os SKUs dos produtos que fazem parte daquela campanha. O aplicativo irá ler essa coleção e exibir o banner correspondente.

Posso ter mais de um banner ativo ao mesmo tempo?

Não. O sistema foi desenhado para ler uma única coleção pré-determinada para o banner principal da home. Para trocar a campanha, você deve alterar os produtos e a imagem associada à coleção designada, ou criar uma nova coleção e solicitar ao suporte da Kobe Apps que atualize a configuração interna para apontar para o novo ID da coleção.

O que acontece se a coleção estiver vazia ou sem uma imagem de banner configurada?

Se a coleção de produtos configurada para o banner não tiver uma imagem de banner associada ou estiver sem produtos, o espaço do banner simplesmente não será exibido no aplicativo. A área ficará oculta, evitando que um banner quebrado ou vazio apareça para seus clientes.

A imagem do banner precisa ter um tamanho específico?

Sim, para garantir a melhor experiência visual em diferentes dispositivos, é crucial seguir as diretrizes de dimensão e proporção de imagem fornecidas pela equipe da Kobe Apps durante a ativação. Usar uma imagem fora do padrão pode resultar em cortes ou distorções.

A ativação desta funcionalidade requer uma configuração inicial em sua plataforma de e-commerce e uma ativação técnica interna. Primeiro, você deve criar a Coleção de Produtos na VTEX que será usada para o banner e nos informar o ID desta coleção. Após receber essa informação, você deve abrir um chamado com a equipe de suporte técnico da Kobe Apps solicitando a habilitação do componente de banner. Nossa equipe realizará a ativação técnica interna no aplicativo para que ele passe a ler as informações da coleção que você preparou.

---

Link Original do GitBook: [O link da documentação original será inserido aqui]

Data de Publicação: [A data de publicação será inserida aqui]