Utilización de catálogos en un mensaje

Después de crear un catálogo, puede hacer referencia a datos de no usuarios en sus campañas Braze a través de Liquid. Puede utilizar catálogos en todos sus canales de mensajería, incluso en cualquier parte del editor de arrastrar y soltar donde se admita Liquid.

Paso 1: Añadir tipo de personalización

En el compositor de mensajes de su elección, seleccione el icono más para abrir el modal Añadir Personalización y seleccione Elementos de Catálogos para el Tipo de Personalización. A continuación, selecciona el Nombre del catálogo. Utilizando nuestro ejemplo anterior, seleccionaremos el catálogo “Juegos”.

Podemos ver inmediatamente la siguiente vista previa de Liquid:

1
{% catalog_items Games %}

Paso 2: Elige elementos del catálogo

A continuación, ¡es hora de añadir los artículos de tu catálogo! Utilice el menú desplegable para seleccionar los artículos del catálogo y la información que desea mostrar. Esta información corresponde a las columnas del archivo CSV cargado para generar el catálogo.

Por ejemplo, para consultar el título y el precio de nuestro juego Tales, podríamos seleccionar id para Tales (1234) como elemento del catálogo y solicitar title y price para la información mostrada.

1
2
3
{% catalog_items Games 1234 %}
 
Get {{ items[0].title }} for just {{ items[0].price }}!

Esto se traduce en lo siguiente:

¡Consigue Tales por solo 7,49!

Exportar catálogos

Hay dos formas de exportar catálogos desde el panel:

• Pasa el ratón por encima de la fila del catálogo en la sección Catálogos. A continuación, selecciona el botón Exportar catálogo.
• Selecciona tu catálogo. A continuación, selecciona el botón Exportar catálogo en la pestaña Vista previa del catálogo.

Recibirás un correo electrónico para descargar el archivo CSV después de iniciar la exportación. Tendrás hasta cuatro horas para recuperar este archivo.

Casos de uso adicionales

Varios artículos

No estás limitado a un solo elemento en un solo mensaje. Puedes utilizar el modal Añadir personalización para añadir hasta tres elementos del catálogo a la vez. Para añadir más elementos a tu mensaje, selecciona Añadir personalización en el creador de mensajes y selecciona los elementos adicionales del catálogo y la información que quieres mostrar.

Eche un vistazo a este ejemplo en el que añadimos id de tres juegos, Tales, Teslagrad y Acaratus, para Catalog Items y seleccionamos title para Information to Display.

Podemos personalizar aún más nuestro mensaje añadiendo algún texto alrededor de nuestro Líquido:

1
2
Get the ultimate trio {% catalog_items games 1234 1235 1236 %}
{{ items[0].title }}, {{ items[1].title }}, and {{ items[2].title }} today!

El resultado es el siguiente:

Get the ultimate trio Tales, Teslagrad, and Acaratus today!

Utilizar declaraciones de Liquid if

Puede utilizar elementos de catálogo para crear sentencias condicionales. Por ejemplo, puede hacer que se muestre un mensaje determinado cuando se selecciona un artículo específico en su campaña.

Para ello, utilizarás una declaración Liquid if, como en este ejemplo:

1
2
3
4
5
6
7
8
{% catalog_selection_items item-list selections %} 
{% if items[0].venue_name.size > 10 %}
Message if the venue name's size is more than 10 characters. 
{% elsif items[0].venue_name.size < 10 %}
Message if the venue name's size is less than 10 characters. 
{% else %} 
{% abort_message(no venue_name) %} 
{% endif %}

En este ejemplo, se mostrarán mensajes diferentes si el atributo personalizado venue_name tiene más de 10 caracteres o menos de 10 caracteres. Si venue_name es blank, no se mostrará nada.

Ten en cuenta que debes declarar la lista de catálogos y, si procede, la selección antes de utilizar las declaraciones if. En el ejemplo, item-list es la lista del catálogo, y selections es el nombre de la selección.

Utilizar imágenes

También puede hacer referencia a imágenes del catálogo para utilizarlas en sus mensajes. Para ello, utilice la etiqueta catalogs y el objeto item en el campo Liquid para imágenes.

Por ejemplo, para añadir el image_link de nuestro catálogo de Juegos a nuestro mensaje promocional para Cuentos, seleccione el id para el campo Artículos de catálogo y image_link para el campo Información a mostrar. Esto añade las siguientes etiquetas Liquid a nuestro campo de imagen:

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

Esto es lo que parece cuando se representa en Liquid:

Plantillas de elementos de catálogo

También puede utilizar plantillas para extraer dinámicamente elementos del catálogo en función de atributos personalizados. Por ejemplo, supongamos que un usuario tiene el atributo personalizado wishlist, que contiene una matriz de ID de juegos de su catálogo.

1
2
3
4
5
6
7
8
{
    "attributes": [
        {
            "external_id": "user_id",
            "wishlist": ["1234", "1235"]
        }
    ]
}

Utilizando la plantilla Liquid, puede extraer dinámicamente los ID de la lista de deseos y utilizarlos en su mensaje. Para ello, asigne una variable a su atributo personalizado y, a continuación, utilice el modal Añadir personalización para extraer un elemento específico de la matriz.

Por ejemplo, para avisar a un usuario de que Tales (un artículo de nuestro catálogo que ha deseado) está de oferta, podemos añadir lo siguiente a nuestro compositor de mensajes:

1
2
3
4
{% assign wishlist = {{custom_attribute.${wishlist}}}%}
{% catalog_items Games {{ wishlist[0] }} %}

Get {{ items[0].title }} now, for just {{ items[0].price }}!

Que se mostrará de la siguiente manera:

Consigue Tales ahora, ¡por sólo 7,49!

Con las plantillas, puede generar un elemento de catálogo diferente para cada usuario en función de sus atributos personalizados, propiedades de eventos o cualquier otro campo que se pueda planificar.

Cargar un CSV

Puede cargar un CSV de nuevos elementos de catálogo para añadir o elementos de catálogo para actualizar. Para eliminar una lista de artículos, puedes subir un CSV con los ID de los artículos para eliminarlos.

Utilizar Liquid

También puedes unir manualmente los catálogos de lógica Liquid. Sin embargo, tenga en cuenta que si escribe un ID que no existe, Braze seguirá devolviendo una matriz de elementos sin objetos. Le recomendamos que incluya la gestión de errores, como la comprobación del tamaño de la matriz y el uso de una sentencia if para tener en cuenta un caso de matriz vacía.

Elementos del catálogo de plantillas, incluido Liquid

De forma similar al Contenido conectado, debes utilizar la bandera :rerender en una etiqueta de Liquid para representar el contenido Liquid de un elemento del catálogo. Ten en cuenta que la flag :rerender solo tiene un nivel de profundidad, lo que significa que no se aplicará a ninguna llamada anidada a la etiqueta de Liquid.

Si un elemento del catálogo contiene campos de perfil de usuario (dentro de una etiqueta de personalización de Liquid), estos valores deben definirse en Liquid antes en el mensaje y antes de la plantilla para que Liquid se muestre correctamente. Si no se indica la bandera :rerender, se mostrará el contenido sin procesar de Liquid.

Por ejemplo, si un catálogo llamado “Mensajes” tiene un elemento con este Liquid:

Para representar el siguiente contenido Liquid:

1
2
3
4
Hi ${first_name}

{% catalog_items Messages greet_msg :rerender %}
{{ items[0].Welcome_Message }}

Aparecerá lo siguiente:

1
2
3
Hi Peter,

Welcome to our store, Peter!