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.
Não recomendamos o envio de valores JSON aninhados como pares de chave-valor. Em vez disso, achate o JSON antes de enviá-lo.
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.
É importante que suas equipes de marketing e de desenvolvimento coordenem quais pares de chave-valor serão usados (por exemplo, feed_type = brand_homepage), pois todos os pares de chave-valor que os profissionais de marketing inserirem no dashboard da Braze devem corresponder exatamente aos pares de chave-valor que os desenvolvedores criam na lógica do app.
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.

Content Cards como conteúdo interativo

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

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;