Personalização do comportamento do cartão de conteúdo
Este guia de implementação aborda a alteração do comportamento dos cartões de conteúdo, a adição de extras como pares de chave/valor à sua carga útil e receitas de personalizações comuns. Para obter uma visão geral básica dos tipos de opções de personalização que você tem com os cartões de conteúdo, consulte Visão geral da personalização.
Pares chave-valor
O Braze o capacita a enviar cargas úteis de dados extras por meio de cartões de conteúdo para dispositivos de usuários usando pares de valores-chave. Eles podem ajudá-lo a rastrear métricas internas, atualizar o conteúdo do app e personalizar propriedades. Adicione pares de valores-chave usando o dashboard.
Não recomendamos o envio de valores JSON aninhados como pares de valores-chave. Em vez disso, achate o JSON antes de enviá-lo.
Os pares de valores-chave são armazenados em objetos card
como extras
. Eles podem ser usados para enviar dados para baixo junto com um cartão para tratamento posterior pelo aplicativo. Chamada card.extras
para acessar esses valores.
Os pares de valores-chave são armazenados em objetos card
como extras
. Eles podem ser usados para enviar dados para baixo junto com um cartão para tratamento posterior pelo aplicativo. Chamada card.extras
para acessar esses valores.
Os pares de valores-chave são armazenados em objetos card
como extras
. Eles podem ser usados para enviar dados para baixo junto com um cartão para tratamento posterior pelo aplicativo. Ligue para card.extras
para acessar esses valores.
É importante que suas equipes de marketing e de desenvolvimento coordenem quais pares de valores-chave serão usados (por exemplo, feed_type = brand_homepage
), pois todos os pares de valores-chave que os profissionais de marketing inserirem no dashboard do Braze devem corresponder exatamente aos pares de valores-chave que os desenvolvedores criam na lógica do app.
Cartões de conteúdo como conteúdo suplementar
Você pode combinar perfeitamente os cartões de conteúdo 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 cartões de conteúdo 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 de localização e cartões de conteúdo fornecidos pelo Braze. Com isso, talvez não seja possível distinguir os cartões de conteúdo mesclados ao conteúdo existente.
Pares de valores-chave disparados pela API
As campanhas 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 valores-chave usando o Liquid. É preciso saber qual é o class_type
no momento da configuração.
Cartões de conteúdo como conteúdo interativo
Os cartões de conteúdo podem ser aproveitados para criar experiências dinâmicas e interativas para seus usuários. No exemplo à direita, temos um pop-up de cartão de conteúdo 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 valores-chave 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 valores-chave permitem filtrar e exibir cartões de conteúdo específicos do tipo na tela de checkout. Para saber mais sobre o uso de pares de valores-chave para gerenciar vários feeds, consulte Personalização do feed padrão do cartão de conteúdo.
Emblemas de cartões de conteúdo
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 o novo conteúdo do Content Card pode atrair os usuários de volta ao seu app e aumentar as sessões.
Exibir o número de cartões de conteúdo não lidos como um emblema
Você pode exibir o número de cartões de conteúdo 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, ligando para o telefone:
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 cartões de conteúdo 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 cartões de conteúdo 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;
Você pode solicitar o número de cartões não lidos a qualquer momento, ligando para o telefone:
1
braze.getCachedContentCards().getUnviewedCardCount();
Em seguida, você pode usar essas informações para exibir um emblema que indica quantos cartões de conteúdo não lidos existem. Para saber mais, consulte a documentação de referência do SDK.