integração de Cartões de Conteúdo

Este artigo de referência cobre a integração do cartão de conteúdo e os diferentes modelos de dados e propriedades específicas do cartão disponíveis para seu aplicativo Android ou FireOS.

No Android, o feed de Cartões de Conteúdo é implementado como um fragmento disponível no projeto de UI do Braze para Android. Consulte a documentação do FragmentsAndroid do Google para obter informações sobre como adicionar um fragmento a uma atividade.

A classe ContentCardsFragment será atualizada automaticamente e exibirá o conteúdo dos cartões de conteúdo e a análise de dados de uso do registro. Os cartões que podem aparecer no ContentCards de um usuário são criados no dashboard do Braze.

Modelo de dados do cartão de conteúdo

O modelo de dados dos cartões de conteúdo está disponível no SDK para Android. Para obter uma referência completa do modelo de dados do cartão de conteúdo, consulte a documentação de referência do SDK.

A Braze tem quatro tipos únicos de cartões de conteúdo que compartilham um modelo base: imagem apenas, imagem legendada, clássico (anúncio em texto) e clássico (notícia curta). Cada tipo herda propriedades comuns de um modelo base e possui as seguintes propriedades adicionais.

Para saber mais sobre a inscrição de dados dos cartões, consulte análise de dados de registro.

Propriedades do modelo de cartão de conteúdo base

O modelo de cartão base fornece comportamento fundamental para todos os cartões.

Propriedade	Descrição
getId()	Retorna o ID do cartão definido pelo Braze.
getViewed()	Retorna um booleano que reflete se o cartão está lido ou não lido pelo usuário.
getExtras()	Retorna um mapa de extras de valor-chave para esse cartão.
getCreated()	Retorna o timestamp unix do horário de criação do cartão do Braze.
getIsPinned	Retorna um booleano que reflete se o cartão está fixado.
getOpenUriInWebView()	Retorna um booleano que reflete se os Uris para este cartão devem ser abertos no WebView do Braze ou não.
getExpiredAt()	Obtém a data de expiração do cartão.
getIsRemoved()	Retorna um booleano que reflete se o usuário final descartou este cartão.
getIsDismissible()	Retorna um booleano que reflete se o cartão está fixado.

Propriedades do cartão de apenas imagem

Cartões apenas com imagem são imagens de tamanho completo clicáveis.

Propriedade	Descrição
getImageUrl()	Retorna o URL da imagem do cartão.
getUrl()	Retorna a URL que será aberta após o cartão ser clicado. Pode ser um URL HTTP(s) ou um URL de protocolo.
getDomain()	Retorna o texto do link para o URL da propriedade.

Propriedades do cartão de imagem legendada

Cartões de imagem legendados são imagens em tamanho real clicáveis com texto descritivo acompanhante.

Propriedade	Descrição
getImageUrl()	Retorna o URL da imagem do cartão.
getTitle()	Retorna o texto do título do cartão.
getDescription()	Retorna o texto do corpo do cartão.
getUrl()	Retorna a URL que será aberta após o cartão ser clicado. Pode ser um URL HTTP(s) ou um URL de protocolo.
getDomain()	Retorna o texto do link para o URL da propriedade.

Propriedades clássicas do cartão

Um cartão de anúncio de texto clássico sem uma imagem incluída resultará em um cartão de anúncio de texto. Se uma imagem for incluída, você receberá um cartão de notícias curto.

Propriedade	Descrição
getTitle()	Retorna o texto do título do cartão.
getDescription()	Retorna o texto do corpo do cartão.
getUrl()	Retorna a URL que será aberta após o cartão ser clicado. Pode ser um URL HTTP(s) ou um URL de protocolo.
getDomain()	Retorna o texto do link para o URL da propriedade.
getImageUrl()	Retorna a URL da imagem do cartão, aplica-se apenas ao cartão de Notícias Curtas clássico.

Métodos do cartão

Todos os Card objetos do modelo de dados oferecem os seguintes métodos de análise de dados para registrar eventos de usuários nos servidores da Braze.

Método	Descrição
logImpression()	Registre manualmente uma impressão no Braze para um determinado cartão.
logClick()	Registre manualmente um clique no Braze para um cartão específico.
setIsDismissed()	Registre manualmente uma dispensa no Braze para um cartão específico. Se um cartão já estiver marcado como descartado, não poderá ser marcado como descartado novamente.