Skip to content

Extraer datos de perfil de usuario en llamadas de contenido conectado

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. De igual forma, la bandera :rerender debe incluirse en la solicitud. Ten en cuenta que el indicador :rerender solo tiene un nivel de profundidad, lo que significa que no se aplicará a ninguna etiqueta de contenido conectado anidada.

Plantillas Liquid en llamadas de contenido conectado

Para la personalización, Braze obtiene los campos de perfil de usuario antes de pasar ese campo a Liquid, por lo que si la respuesta de contenido conectado contiene campos de perfil de usuario, estos deben 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 de contenido conectado es Your language is ${language}. El contenido mostrado en este ejemplo es Hi Jon, your language is.

El idioma en sí no se procesará como plantilla. Esto se debe a que Braze necesita saber qué campos recuperar del usuario antes de realizar la llamada de contenido conectado.

Para renderizar 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 de Liquid sabrá que debe obtener el atributo “language” del usuario para tenerlo listo para procesar la plantilla de la respuesta.

1

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

Mejores prácticas

Usa json_escape con etiquetas de Liquid que puedan romper el formato JSON

Al usar :rerender, agrega el filtro json_escape a cualquier etiqueta de Liquid que pueda potencialmente 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 procesará como plantilla en el mensaje, y ninguna de las variables se guardará.

Por ejemplo, si la propiedad de evento message en el ejemplo a continuación contiene caracteres que podrían romper el formato JSON, agrega el filtro json_escape como en este ejemplo:

1
2
3

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