Skip to content

Puxar dados do perfil do usuário em chamadas de conteúdo conectado

Esta página aborda como puxar perfis de usuário para suas chamadas de conteúdo conectado e as melhores práticas envolvendo a modelagem Liquid.

Pré-requisitos

Se uma resposta de Conteúdo Conectado contiver campos do perfil de usuário (dentro de uma tag de personalização Liquid), esses valores devem ser definidos anteriormente na mensagem com Liquid, antes da chamada de Conteúdo Conectado, para que o retorno do Liquid seja renderizado corretamente. Da mesma forma, a flag :rerender deve ser incluída na requisição. A flag :rerender funciona apenas em um nível de profundidade, ou seja, ela não se aplica a tags de Conteúdo Conectado aninhadas.

Modelagem Liquid em chamadas de conteúdo conectado

Para personalização, a Braze obtém os campos do perfil de usuário antes de passá-los para o Liquid. Portanto, se a resposta do Conteúdo Conectado contiver campos do perfil de usuário, eles devem ser definidos previamente.

Por exemplo, se esta fosse a chamada de Conteúdo Conectado:

1
2

Hi ${first_name},
{% connected_content https://examplewebsite.com :rerender %}

A resposta do Conteúdo Conectado é Your language is ${language}. O conteúdo exibido neste exemplo é Hi Jon, your language is.

O idioma em si não será processado pelo modelo. Isso acontece porque a Braze precisa saber quais campos recuperar do usuário antes de fazer a chamada de Conteúdo Conectado.

Para renderizar o retorno do Liquid corretamente, você deve incluir a tag ${language} em qualquer lugar da requisição, conforme mostrado no trecho de código a seguir. O pré-processador Liquid saberá que deve buscar o atributo “language” do usuário para tê-lo pronto para a modelagem da resposta.

1

Hi ${first_name}, {% connected_content https://examplewebsite.com?language=${language} :rerender %}

Melhores práticas

Use json_escape com tags Liquid que possam quebrar o formato JSON

Ao usar :rerender, adicione o filtro json_escape a qualquer tag Liquid que possa potencialmente quebrar o formato JSON. Se suas tags Liquid contiverem caracteres que quebram o formato JSON, toda a resposta do Conteúdo Conectado será interpretada como texto e inserida na mensagem, e nenhuma das variáveis será salva.

Por exemplo, se a propriedade de evento message no exemplo abaixo contiver caracteres que possam quebrar o formato JSON, adicione o filtro json_escape como neste exemplo:

1
2
3

[{
"message":"{{event_properties.${message} | json_escape}}"
}]
New Stuff!