Recomendar productos a los usuarios

Usa la REST API de Braze junto con los catálogos o el contenido conectado para mostrar recomendaciones de productos personalizadas en tus mensajes. Este enfoque te permite conectar tu propia herramienta de recomendaciones al ecosistema de mensajería de Braze, para que los usuarios no técnicos puedan gestionar el contenido y la mensajería en torno a cada recomendación.

Con este enfoque, puedes:

• Almacenar recomendaciones de productos en los perfiles de usuario desde tu backend usando la REST API.
• Recuperar metadatos de productos en el momento del envío usando catálogos o contenido conectado.
• Mostrar recomendaciones personalizadas en cualquier canal de mensajería, incluyendo correo electrónico, push, mensajes dentro de la aplicación y más.

Requisitos previos

Para completar esta guía, necesitas:

Paso 1: Almacenar recomendaciones en perfiles de usuario

Para comenzar, almacena las recomendaciones de productos generadas por tu herramienta de recomendaciones en los perfiles de usuario de Braze como atributos personalizados. Esto te permite hacer referencia a los productos recomendados de cada usuario en el momento del envío del mensaje.

1. Determina qué datos de recomendación almacenar, como los ID de productos o las categorías preferidas.
2. Usa el endpoint /users/track para escribir la recomendación como un atributo personalizado en el perfil de usuario.

Ejemplo de solicitud

1
2
3
POST YOUR_REST_ENDPOINT/users/track
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

Sustituye YOUR_REST_ENDPOINT con la URL del endpoint REST de tu espacio de trabajo.

1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user123",
      "recommended_product_id": "1001"
    }
  ]
}

Usa nombres de atributos significativos (como recommended_product_id) para que sean fáciles de referenciar en plantillas de Liquid más adelante. Mantén las recomendaciones precisas actualizándolas regularmente a medida que tu herramienta de recomendaciones genere nuevos resultados.

Paso 2: Recuperar los metadatos del producto

Después de almacenar un identificador de recomendación en cada perfil de usuario, necesitas recuperar los metadatos completos del producto (nombre, precio, imagen, etc.) para incluirlos en tu mensaje. Tienes dos opciones:

• Opción A: Catálogos de Braze — almacena la información del producto directamente en Braze para consultas rápidas e integradas.
• Opción B: Contenido conectado — obtiene la información del producto desde una API externa en el momento del envío.

Opción A: Catálogos de Braze

Si has creado un catálogo con tu inventario de productos, puedes buscar artículos directamente en tu mensaje usando Liquid. Para un recorrido completo, consulta Uso de catálogos.

Recomendar un artículo de catálogo específico

Para hacer referencia a un producto específico por ID, usa la etiqueta de Liquid catalog_items. Por ejemplo, para recomendar el producto 1001 de un catálogo llamado retail_products:

1
2
3
4
5
6
{% catalog_items retail_products 1001 %}

We have a new item we think you'll like:
Category: {{ items[0].category }}
Name: {{ items[0].name }}
Price: ${{ items[0].price }}

Recomendar múltiples artículos de catálogo

También puedes hacer referencia a múltiples artículos en una sola etiqueta. Por ejemplo, para destacar tres productos:

1
2
3
4
5
6
7
8
{% catalog_items retail_products 1001 1003 1005 %}

New items added in:
- {{ items[0].category }}
- {{ items[1].category }}
- {{ items[2].category }}

Visit our store to learn more!

Crear plantillas de artículos usando la recomendación de un usuario

Combina el atributo personalizado del Paso 1 con una consulta de catálogo para personalizar la recomendación para cada usuario:

1
2
3
4
{% catalog_items retail_products {{custom_attribute.${recommended_product_id}}} %}

Hi {{${first_name}}}, check out our pick for you:
{{ items[0].name }} — ${{ items[0].price }}

Opción B: Contenido conectado

Si los metadatos de tus productos se encuentran en un servicio externo en lugar de un catálogo de Braze, usa contenido conectado para obtenerlos en el momento del envío.

Por ejemplo, si tu API interna devuelve detalles del producto por ID:

1
2
3
4
{% connected_content https://api.yourcompany.com/products/{{custom_attribute.${recommended_product_id}}} :save product %}

Hi {{${first_name}}}, we think you'll love:
{{ product.name }} — ${{ product.price }}

Para más detalles sobre cómo realizar llamadas a la API desde tus mensajes, consulta Realizar una llamada a la API.

Advertencia

Evita usar contenido conectado para obtener una lista grande de productos y luego iterar a través de esa lista en Liquid en el momento del envío. Las cargas útiles de respuesta grandes aumentan la latencia del envío y pueden causar tiempos de espera en los mensajes o fallos en la entrega a gran escala. En su lugar, almacena solo los ID de producto específicos que un usuario necesita en su perfil (consulta el Paso 1), y obtén los metadatos de esos artículos individuales o usa catálogos, que están optimizados para consultas rápidas.

Paso 3: Verifica tu integración

Después de completar la configuración, verifica tu integración:

1. Usa el endpoint /users/track para escribir una recomendación de prueba en tu propio perfil de usuario.
2. Envía un mensaje de prueba que haga referencia al producto recomendado usando Catalogs o contenido conectado.
3. Confirma que los detalles del producto se muestren correctamente en el mensaje entregado.
4. En el panel de Braze, ve a la página de resultados de la Campaign o Canvas y confirma que el envío se haya registrado.

Consideraciones

• Mantén actualizados los datos de recomendaciones actualizando regularmente los atributos personalizados a medida que tu herramienta de recomendaciones produce nuevos resultados.
• Usa las características de personalización de Braze para adaptar aún más los mensajes, como incorporar datos específicos del usuario junto con los detalles del producto.
• Considera usar la entrega activada por API para desencadenar mensajes desde tu backend utilizando plantillas definidas en el panel de Braze.