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 chave-valor

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

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

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

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

Content Cards como conteúdo complementar

Feed com uma lista híbrida combinando dados locais e Content Cards da Braze.

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

O exemplo ao lado mostra um feed com uma lista híbrida de itens preenchidos com dados locais e Content Cards da Braze. Dessa forma, os Content Cards podem se tornar indistinguíveis do conteúdo existente.

Pares chave-valor disparados por API

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

Os pares chave-valor para o caso de uso de Content Cards complementares. 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 exibindo uma promoção de 50% aparece no canto inferior esquerdo da tela. Ao clicar, a promoção será aplicada ao carrinho.

Os Content Cards podem ser usados para criar experiências dinâmicas e interativas para seus usuários. No exemplo ao lado, um pop-up de Content Card aparece na finalização da compra para oferecer promoções de última hora aos usuários. Cartões bem posicionados como esse são uma ótima forma de dar um “empurrãozinho” para ações específicas do usuário.

Os pares chave-valor para esse caso de uso incluem discount_percentage definido como o valor de desconto desejado e class_type definido como coupon_code. Esses pares chave-valor permitem filtrar e exibir Content Cards de tipos específicos na tela de finalização de compra. Para saber mais sobre o uso de pares chave-valor para gerenciar múltiplos feeds, consulte Personalização do feed padrão de Content Cards.

Content Card interativo exibindo uma promoção na finalização de compra.

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

Emblemas são pequenos ícones ideais para chamar a atenção do usuário. Usar emblemas para alertar o usuário sobre novos conteúdos de Content Cards pode atraí-los de volta ao seu app e aumentar as sessões.

Exibindo 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 possui como um emblema no ícone do seu app.

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

braze.getCachedContentCards().getUnviewedCardCount();

Em seguida, você pode usar essa informação para exibir um emblema indicando quantos Content Cards não lidos existem. Consulte a documentação de referência do SDK para saber mais.

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

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

Em seguida, você pode usar essa informação para exibir um emblema indicando quantos Content Cards não lidos existem. Consulte a documentação de referência do SDK para saber mais.

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, este código solicita uma contagem de cartões, filtrando o número de cartões com base na propriedade viewed.

Apps que adotaram o ciclo de vida UIScene (obrigatório para apps compilados com o Xcode 27 e versões posteriores) devem implementar isso no sceneDidEnterBackground(_:) do SceneDelegate.swift em vez do applicationDidEnterBackground(_:) do AppDelegate.swift.

func sceneDidEnterBackground(_ scene: UIScene)

Dentro deste método, implemente o seguinte código, que atualiza ativamente a contagem do emblema enquanto o usuário visualiza cartões durante uma sessão:

let unreadCards = AppDelegate.braze?.contentCards.cards.filter { $0.viewed == false }
UIApplication.shared.applicationIconBadgeNumber = unreadCards?.count ?? 0
(void)sceneDidEnterBackground:(UIScene *)scene

Dentro deste método, implemente o seguinte código, que atualiza ativamente a contagem do emblema enquanto o usuário visualiza cartões durante uma sessão:

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