Obtención de datos del perfil del usuario

Esta página explica cómo introducir perfiles de usuario en tus llamadas de contenido conectado y las mejores prácticas de plantillas Liquid.

Requisitos previos

Si una respuesta de contenido conectado contiene campos de perfil de usuario (dentro de una etiqueta de personalización de Liquid), estos valores deben definirse antes en el mensaje con Liquid, antes de la llamada de contenido conectado para que el passback de Liquid se represente correctamente. Del mismo modo, la bandera :rerender debe incluirse en la solicitud. Tenga en cuenta que el indicador :rerender sólo tiene un nivel de profundidad, lo que significa que no se aplicará a ninguna etiqueta de contenido conectado anidada.

Plantilla líquida en llamadas de contenido conectado

Para la personalización, Braze extrae los campos de perfil de usuario antes de pasar ese campo a Liquid, de modo que si la respuesta de Connected Content tiene campos de perfil de usuario, debe definirse de antemano.

Por ejemplo, si esta fuera la llamada de Contenido Conectado:

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

La respuesta del Contenido conectado es Your language is ${language}. El contenido mostrado en este ejemplo es Hi Jon, your language is.

La lengua en sí no tendrá plantilla. Esto se debe a que Braze necesita saber qué campos recuperar del usuario antes de realizar la llamada a Contenido Conectado.

Para representar correctamente el passback de Liquid, debes incluir la etiqueta ${language} en cualquier parte de la solicitud, como se muestra en el siguiente fragmento de código. El preprocesador Liquid sabrá tomar el atributo “idioma” del usuario para tenerlo listo para la plantilla de la respuesta.

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

Buenas prácticas

Utiliza json_escape con etiquetas de Liquid que podrían romper el formato JSON

Cuando utilices :rerender, añade el filtro json_escape a cualquier etiqueta de Liquid que pudiera romper el formato JSON. Si tus etiquetas de Liquid contienen caracteres que rompen el formato JSON, toda la respuesta de Contenido conectado se interpretará como texto y se incluirá en la plantilla del mensaje, y no se guardará ninguna de las variables.

Por ejemplo, si la propiedad del evento message del ejemplo siguiente contiene caracteres que podrían romper el formato JSON, añade el filtro json_escape como en este ejemplo:

1
2
3
[{
"message":"{{event_properties.${message} | json_escape}}"
}]