integração do cartão de conteúdo
Aprenda a configurar cartões de conteúdo iOS, Android e FireOS para a plataforma Xamarin.
O SDK da Braze inclui um feed de cartão padrão para você começar com os Cartões de Conteúdo. O feed de cartão padrão incluído com o SDK da Braze lidará com toda a análise de dados, rastreamento, dispensas e renderização para os Cartões de Conteúdo de um usuário.
Para obter informações sobre como integrar os cartões de conteúdo no seu app Xamarin, consulte nosso guia de integração do Android e guia de integração do iOS.
Pré-requisitos
Para usar este recurso, você precisará integrar o SDK da Braze para a plataforma Xamarin.
métodos do cartão de conteúdo
Você pode usar esses métodos adicionais para criar um feed de Cartões de Conteúdo personalizado dentro do seu app:
Método | Descrição |
---|---|
requestContentCardsRefresh() |
Solicita os cartões de conteúdo mais recentes do servidor SDK da Braze. |
getContentCards() |
Recupera os Cartões de Conteúdo do SDK da Braze. Isso retornará a lista mais recente de cartões do servidor. |
logContentCardClicked(cardId) |
Registra um clique para o ID do cartão de conteúdo fornecido. Este método é usado apenas para análise de dados. |
logContentCardImpression(cardId) |
Registra uma impressão para o ID do cartão de conteúdo fornecido. |
logContentCardDismissed(cardId) |
Registra uma dispensa para o ID do cartão de conteúdo fornecido. |
modelo de dados do cartão de conteúdo
O SDK do Xamarin da Braze possui três tipos exclusivos de cartões de Conteúdo que compartilham um modelo base: banner, imagem legendada e clássico. Cada tipo herda propriedades comuns de um modelo base e possui as seguintes propriedades adicionais.
Propriedades do modelo de cartão de conteúdo base
Propriedade | Descrição |
---|---|
idString |
O ID do cartão definido pela Braze. |
created |
O registro de data e hora UNIX da hora de criação do cartão na Braze. |
expiresAt |
O registro de data e hora UNIX do tempo de expiração do cartão. Quando o valor é menor que 0, isso significa que o cartão nunca expira. |
viewed |
Se o cartão foi lido ou não pelo usuário. Isso não registra análise de dados. |
clicked |
Se o cartão foi clicado pelo usuário. |
pinned |
Se o cartão está fixado. |
dismissed |
Se o usuário dispensou este cartão. Marcar um cartão como dispensado que já foi dispensado será uma operação nula. |
dismissible |
Se o cartão é descartável pelo usuário. |
urlString |
(Opcional) A string de URL associada à ação de clique do cartão. |
openUrlInWebView |
Se os URLs para este cartão devem ser abertos no WebView do Braze ou não. |
isControlCard |
Se este cartão é um cartão de controle. Os cartões de controle não devem ser exibidos ao usuário. |
extras |
O mapa de extras de chave-valor para este cartão. |
isTest |
Se este cartão é um cartão de teste. |
Para uma referência completa do cartão base, consulte a documentação do Android e iOS.
propriedades do modelo do cartão de conteúdo de banner
Os cartões de banner são imagens clicáveis e de tamanho completo.
Propriedade | Descrição |
---|---|
image |
A URL da imagem do cartão. |
imageAspectRatio |
A proporção da imagem do cartão. Destina-se a servir como uma dica antes que o carregamento da imagem seja concluído. Nota que a propriedade pode não ser fornecida em certas circunstâncias. |
Para uma referência completa do cartão de banner, consulte a documentação do Android e iOS (agora renomeada para apenas imagem).
Propriedades do modelo de cartão de conteúdo de imagem legendada
Cartões de imagem legendados são imagens em tamanho real clicáveis com texto descritivo acompanhante.
Propriedade | Descrição |
---|---|
image |
A URL da imagem do cartão. |
imageAspectRatio |
A proporção da imagem do cartão. Destina-se a servir como uma dica antes que o carregamento da imagem seja concluído. Nota que a propriedade pode não ser fornecida em certas circunstâncias. |
title |
O texto do título do cartão. |
cardDescription |
O texto de descrição do cartão. |
domain |
(Opcional) O texto do link para a URL da propriedade, por exemplo, "braze.com/resources/" . Pode ser exibido na interface do usuário do cartão para indicar a ação/direção de clicar no cartão. |
Para uma referência completa do cartão de imagem legendada, consulte a documentação do Android e iOS.
propriedades do modelo de cartão de conteúdo clássico
Os cartões clássicos têm um título, descrição e uma imagem opcional à esquerda do texto.
Propriedade | Descrição |
---|---|
image |
(Opcional) A URL da imagem do cartão. |
title |
O texto do título do cartão. |
cardDescription |
O texto de descrição do cartão. |
domain |
(Opcional) O texto do link para a URL da propriedade, por exemplo, "braze.com/resources/" . Pode ser exibido na interface do usuário do cartão para indicar a ação/direção de clicar no cartão. |
Para uma referência completa do clássico (anúncio de texto) cartão de conteúdo, consulte a documentação do Android e iOS. Para uma referência completa do cartão de imagem clássico (notícia curta), consulte a documentação do Android e iOS.
Suporte a GIF
By default, the native Braze Android SDK does not provide animated GIF support for Content Cards—however, you can use a third-party image library to display GIFs instead. For more information, see Android Content Cards: GIFs.
By default, the Braze Swift SDK does not provide animated GIF support for Content Cards—however, you can wrap your own view or a third-party view in an instance of GIFViewProvider
. For a full walkthrough, see Tutorial: GIF Support for Swift Content Cards.