Skip to content

Personalize o comportamento dos Content Cards

Este guia de implementação aborda a alteração do comportamento dos Content Cards, a adição de extras como pares de chave-valor à sua carga útil e receitas de personalizações comuns. Para a lista completa de tipos de cartões de conteúdo, consulte Sobre os Content Cards.

Pares de chave-valor

A Braze permite que você envie cargas úteis de dados extras por meio de Content Cards para os dispositivos dos usuários usando pares de chave-valor. Eles podem ajudar a rastrear métricas internas, atualizar o conteúdo do app e personalizar propriedades. Adicione pares de chave-valor usando o dashboard.

Os pares de chave-valor são armazenados em objetos card como extras. Eles podem ser usados para enviar dados junto com um cartão para tratamento posterior pelo aplicativo. Chame card.extras para acessar esses valores.

Os pares de chave-valor são armazenados em objetos card como extras. Eles podem ser usados para enviar dados junto com um cartão para tratamento posterior pelo aplicativo. Chame card.extras para acessar esses valores.

Os pares de chave-valor são armazenados em objetos card como extras. Eles podem ser usados para enviar dados junto com um cartão para tratamento posterior pelo aplicativo. Chame card.extras para acessar esses valores.

Content Cards como conteúdo suplementar

Você pode combinar perfeitamente os Content Cards em um feed existente, permitindo que os dados de vários feeds sejam carregados simultaneamente. Isso cria uma experiência coesa e harmoniosa com os Content Cards da Braze e o conteúdo de feed existente.

O exemplo à direita mostra um feed com uma lista híbrida de itens que são preenchidos por meio de dados locais e Content Cards fornecidos pela Braze. Com isso, os Content Cards podem ser indistinguíveis do conteúdo existente.

Pares de chave-valor disparados por API

As Campaigns disparadas por API são uma boa estratégia a ser empregada quando os valores de um cartão dependem de fatores externos para determinar o conteúdo a ser exibido para o usuário. Por exemplo, para exibir conteúdo suplementar, defina pares de chave-valor usando Liquid. Note que o class_type deve ser conhecido no momento da configuração.

Os pares de chave-valor para o caso de uso de Content Cards suplementares. Neste exemplo, diferentes aspectos do cartão, como "tile_id", "tile_deeplink" e "tile_title", são definidos usando Liquid.

Content Cards como conteúdo interativo

Um Content Card interativo mostrando uma promoção de 50% aparece no canto inferior esquerdo da tela. Depois de clicado, a promoção será aplicada ao carrinho.

Os Content Cards podem ser aproveitados para criar experiências dinâmicas e interativas para seus usuários. No exemplo à direita, temos um pop-up de Content Card que aparece no checkout, oferecendo aos usuários promoções de última hora. Cartões bem posicionados como esse são uma ótima maneira de dar aos usuários um “empurrãozinho” em direção a ações específicas.

Os pares de chave-valor para esse caso de uso incluem discount_percentage definido como o valor do desconto desejado e class_type definido como coupon_code. Esses pares de chave-valor permitem filtrar e exibir Content Cards específicos por tipo na tela de checkout. Para saber mais sobre o uso de pares de chave-valor para gerenciar vários feeds, consulte Personalização do feed padrão de Content Cards.

Emblemas de Content Cards

Tela inicial de um iPhone mostrando um app de exemplo da Braze chamado Swifty com um emblema vermelho exibindo o número 7

Os emblemas são ícones pequenos, ideais para chamar a atenção do usuário. O uso de emblemas para alertar o usuário sobre novos conteúdos de Content Cards pode atrair os usuários de volta ao seu app e aumentar as sessões.

Exibir o número de Content Cards não lidos como um emblema

Você pode exibir o número de Content Cards não lidos que seu usuário tem como um emblema no ícone do seu app.

Você pode solicitar o número de cartões não lidos a qualquer momento chamando:

1
braze.getCachedContentCards().getUnviewedCardCount();

Em seguida, você pode usar essas informações para exibir um emblema que indica quantos Content Cards não lidos existem. Para saber mais, consulte a documentação de referência do SDK.

Você pode solicitar o número de cartões não lidos a qualquer momento chamando:

1
Braze.getInstance(context).getContentCardUnviewedCount();
1
Braze.getInstance(context).contentCardUnviewedCount

Em seguida, você pode usar essas informações para exibir um emblema que indica quantos Content Cards não lidos existem. Para saber mais, consulte a documentação de referência do SDK.

O exemplo a seguir usa braze.contentCards para solicitar e exibir o número de Content Cards não lidos. Depois que o app é fechado e a sessão do usuário termina, esse código solicita uma contagem de cartões, filtrando o número de cartões com base na propriedade viewed.

1
func applicationDidEnterBackground(_ application: UIApplication)

Nesse método, implemente o seguinte código, que atualiza ativamente a contagem de emblemas enquanto o usuário visualiza os cartões durante uma determinada sessão:

1
2
let unreadCards = AppDelegate.braze?.contentCards.cards.filter { $0.viewed == false }
UIApplication.shared.applicationIconBadgeNumber = unreadCards?.count ?? 0
1
(void)applicationDidEnterBackground:(UIApplication *)application

Nesse método, implemente o seguinte código, que atualiza ativamente a contagem de emblemas enquanto o usuário visualiza os cartões durante uma determinada sessão:

1
2
3
4
5
6
7
NSInteger unreadCardCount = 0;
for (BRZContentCardRaw *card in AppDelegate.braze.contentCards.cards) {
  if (card.viewed == NO) {
    unreadCardCount += 1;
  }
}
[UIApplication sharedApplication].applicationIconBadgeNumber = unreadCardCount;
New Stuff!