Caso de uso: Visualização do carrossel

Esta seção aborda como implementar um feed de carrossel com vários cartões, em que o usuário pode deslizar horizontalmente para ver os cartões adicionais em destaque. Para integrar uma exibição de carrossel, você precisará usar uma implementação de cartão de conteúdo totalmente personalizado - a fase de “execução” da abordagem crawl, walk, run.

Com essa abordagem, você não usará as exibições do Braze e a lógica padrão, mas, em vez disso, exibirá os cartões de conteúdo de maneira totalmente personalizada, usando suas próprias exibições preenchidas com dados dos modelos do Braze.

Em termos de nível de esforço de desenvolvimento, as principais diferenças entre a implementação básica e a implementação do carrossel incluem:

• Criando suas próprias visualizações
• Registro da análise de dados do cartão de conteúdo
• Introdução de lógica adicional no lado do cliente para determinar quantos e quais cartões serão exibidos no carrossel

Implementação

Etapa 1: Criar um controlador de visualizações personalizado

Para criar o carrossel de cartões de conteúdo, crie seu próprio controlador de visualização personalizado (como UICollectionViewController) e assine as atualizações de dados. Note que você não poderá estender ou criar uma subclasse do nosso ABKContentCardTableViewController padrão, pois ele só é capaz de lidar com nossos tipos de cartão de conteúdo padrão.

Etapa 2: Implementar análise de dados

Ao criar um controlador de visualização totalmente personalizado, as impressões, os cliques e os descartes de cartão de conteúdo não são registrados automaticamente. É necessário implementar os respectivos métodos de análise de dados para garantir que as impressões, os eventos de demissão e os cliques sejam registrados corretamente na análise do dashboard do Braze.

Para obter informações sobre os métodos de análise de dados, consulte Métodos de cartão.

Etapa 3: Criar um observador de cartão de conteúdo

Crie um observador de cartão de conteúdo que seja responsável por lidar com a chegada de cartões de conteúdo e implemente a lógica condicional para exibir um número específico de cartões no carrossel a qualquer momento. Por padrão, os cartões de conteúdo são classificados por data de criação (o mais recente primeiro), e o usuário vê todos os cartões para os quais é elegível.

Dito isso, você pode solicitar e aplicar lógica de exibição adicional de várias maneiras. Por exemplo, você pode selecionar os cinco primeiros objetos do cartão de conteúdo do vetor ou introduzir pares de valores-chave (a propriedade extras no modelo de dados) para criar uma lógica condicional.

Se estiver implementando um carrossel como um feed secundário de cartões de conteúdo, consulte Uso de vários feeds de cartão de conteúdo para garantir que você classifique os cartões no feed correto com base em pares de valores-chave.

Para obter a documentação do desenvolvedor específica do iOS sobre a classe, os métodos e as atribuições dos cartões de conteúdo, consulte a referência de classe do iOS ABKContentCard.

Considerações

• Ao usar exibições totalmente personalizadas, você não poderá estender ou criar subclasses dos métodos usados em ABKContentCardsController. Em vez disso, você mesmo precisará integrar os métodos e as propriedades do modelo de dados.
• A lógica e a implementação da visualização de carrossel não são um tipo padrão de cartão de conteúdo no Braze e, portanto, a lógica para alcançar o caso de uso deve ser fornecida e suportada pela sua equipe de desenvolvimento.
• Você precisará implementar a lógica do lado do cliente para exibir um número específico de cartões no carrossel a qualquer momento.