Configurar la orquestación
Los agentes de toma de decisiones necesitan conectarse a una plataforma de interacción con los clientes (CEP) para orquestar las comunicaciones una vez que han ingerido los datos de clientes y personalizado a nivel 1:1. Este artículo cubre lo que necesitas preparar y cómo configurar la integración para cada CEP compatible.
¿Qué es la orquestación?
La orquestación es la conexión entre Decisioning Studio y tu plataforma de interacción con los clientes (CEP). Una vez que tu agente de toma de decisiones determina la acción óptima para cada cliente, la orquestación ejecuta esas decisiones desencadenando comunicaciones personalizadas a través de tu CEP.
Piénsalo de esta manera:
- Decisioning Studio decide qué enviar y cuándo enviarlo
- Tu CEP se encarga de cómo enviarlo
Elige tu CEP
El primer paso es elegir qué CEP usar con Decisioning Studio. Tu elección afecta la complejidad de la configuración y las características disponibles.
CEP compatibles
| CEP | Tipo de integración | Complejidad de configuración |
|---|---|---|
| Braze | Integración nativa con API (recomendada) | Baja |
| Salesforce Marketing Cloud | Eventos de API + Journey Builder | Media |
| Otras CEP | Personalizada (archivo de recomendaciones) | Alta |
Si ya estás usando Braze como tu CEP, te recomendamos usar la integración nativa de Braze para la experiencia de configuración más fluida.
Requisitos previos
Antes de configurar la orquestación, reúne los siguientes elementos según la CEP que hayas elegido.
| Requisito | Descripción |
|---|---|
| Clave de API REST | Una nueva clave de API con permisos para datos de usuario, mensajes, Campaigns, Canvas, Segments y plantillas. |
| URL del panel de Braze | La URL de tu instancia de Braze (por ejemplo, https://dashboard-01.braze.com). |
| ID de la aplicación | La clave de API asociada con la aplicación que deseas rastrear (se encuentra en Settings > App Settings). |
| Nombre y dirección del remitente de correo electrónico | La información del remitente que se usará para tus campañas (se encuentra en Settings > Email Preferences). |
| Plantillas base | Las plantillas de mensaje que tu agente usará para la orquestación. Crearás Campaigns activadas por API para cada plantilla. |
| ID de usuario de prueba | Un ID de usuario para probar la integración antes del lanzamiento. |
| Requisito | Descripción |
|---|---|
| Credenciales del paquete de aplicación | Client ID, Client Secret, Authentication Base URI, REST Base URI y SOAP Base URI de un paquete instalado con integración de API servidor a servidor. |
| Permisos de API | Alcances para canales, activos, automatizaciones, journeys, contactos, extensiones de datos y eventos de seguimiento. |
| Extensiones de datos | Necesitarás extensiones de datos para datos de suscriptores, datos de interacción y recomendaciones. |
| Plantillas de correo electrónico | Las plantillas que deseas que Decisioning Studio use, con los ID de plantilla para cada una. |
| Acceso a Journey Builder | Acceso para crear y activar journeys de múltiples pasos con fuentes de entrada de eventos de API. |
Si estás usando una CEP distinta a Braze o Salesforce Marketing Cloud, Decisioning Studio puede integrarse mediante un enfoque de archivo de recomendaciones:
| Elemento | Descripción |
|---|---|
| Capacidad de ingesta de datos | Tu CEP debe poder ingerir archivos de recomendaciones (normalmente CSV o JSON) que contengan decisiones personalizadas para cada cliente. |
| Soporte de contenido dinámico | Tus campañas deben admitir la población de campos de forma dinámica basándose en los datos de recomendaciones. |
| Recursos de ingeniería personalizados | Tu equipo necesitará construir la integración para leer los archivos de recomendaciones y desencadenar las comunicaciones. |
Planifica tus campañas
Antes de configurar la orquestación, considera los siguientes detalles:
Plantillas base
Una plantilla base es cualquier plantilla de mensaje que tu agente de toma de decisiones podría usar. Considera:
- ¿Cuántas plantillas? Tu agente puede trabajar con una plantilla o con varias. Si son varias, el agente puede personalizar qué plantilla recibe cada cliente.
- ¿Qué canales? Correo electrónico, push, SMS o una combinación. Cada canal puede requerir plantillas y campañas separadas.
- ¿Qué elementos dinámicos? Identifica qué partes de tu mensaje personalizará el agente (líneas del asunto, CTA, ofertas, horarios, etc.). Estos se convertirán en propiedades de activación de API o marcadores de posición dinámicos.
Configuración de reelegibilidad
Tus campañas deben permitir que los usuarios reciban mensajes varias veces:
- Para pruebas, querrás enviar la misma campaña al mismo usuario repetidamente
- En producción, el agente puede determinar que la misma campaña es óptima para un usuario en días consecutivos
Aunque configures la reelegibilidad para pruebas, los agentes de Decisioning Studio están diseñados para respetar los límites de frecuencia y no enviarán la misma campaña a un usuario más de una vez al día en producción.
Propiedades de activación de API
Para integraciones con Braze, planifica qué dimensiones optimizará tu agente. Estas se convierten en propiedades de activación de API que pasan valores dinámicos a tus campañas:
| Dimensión de ejemplo | Propiedad de activación de API |
|---|---|
| Línea del asunto | {{api_trigger_properties.${subject_line}}} |
| Llamada a la acción | {{api_trigger_properties.${cta_message}}} |
| Oferta | {{api_trigger_properties.${offer_id}}} |
| Monto de descuento | {{api_trigger_properties.${discount}}} |
Configuración de la integración
Selecciona tu CEP a continuación para comenzar con la configuración de la integración.
Configurar la integración con Braze
Sigue estos pasos para integrar un agente de Decisioning Studio con las capacidades de orquestación de Braze (el equipo de servicios de Braze estará disponible para ayudarte):
Paso 1: Crear una clave de API
Ve a Settings > API Keys y crea una nueva clave con los siguientes permisos:
| Permiso | Propósito | ¿Es necesario? |
|---|---|---|
/users/track |
Actualiza los atributos personalizados de los perfiles de usuario, además de crear perfiles de usuario temporales cuando se utilizan envíos de prueba. | ✓ |
/users/delete |
Elimina los perfiles de usuario temporales que se crearon mientras se utilizaban los envíos de prueba. | Solo para envíos de prueba |
/users/export/segment |
Actualiza las comunicaciones de audiencia disponibles cada mañana exportando la lista de usuarios de cada segmento seleccionado. | ✓ |
/users/export/ids |
Recupera una lista de identificadores cuando te diriges a los usuarios utilizando un external_id en lugar de un segmento. Dado que Decisioning Studio no acepta información de identificación personal (PII), deberás asegurarte de que tu parámetro fields_to_export solo devuelva campos que no sean PII. |
Solo si utilizas external_ids |
/messages/send |
Envía las variantes recomendadas en el momento recomendado utilizando Campaigns de API configuradas para el experimentador de Decisioning Studio. | ✓ |
/campaigns/list |
Recupera la lista de campañas activas y extrae el contenido de correo electrónico disponible para la experimentación. | ✓ |
/campaigns/data_series |
Exporta datos agregados de la campaña para habilitar la generación de informes, la validación y la solución de problemas en Decisioning Studio, de modo que puedas comparar los valores de los informes y analizar el rendimiento de referencia. Aunque no es obligatorio, este permiso es recomendable. |
|
/campaigns/details |
Recupera el contenido HTML, la línea del asunto y los recursos de imagen de las Campaigns existentes para la experimentación. | ✓ |
/canvas/list |
Recupera la lista de Canvas activos para extraer el contenido de correo electrónico disponible para la experimentación. | ✓ |
/canvas/data_series |
Exporta datos agregados de Canvas para informes y validación, especialmente cuando el BAU se orquesta mediante Canvas. Aunque no es obligatorio, este permiso es recomendable. |
|
/canvas/details |
Recupera el contenido HTML, la línea del asunto y los recursos de imagen de los Canvas existentes para la experimentación. | ✓ |
/segments/list |
Recupera todos los segmentos existentes como audiencias objetivo potenciales para el experimentador de Decisioning Studio. | ✓ |
/segments/data_series |
Exporta información sobre el tamaño del segmento, que se muestra en Decisioning Studio al seleccionar una audiencia. | ✓ |
/segments/details |
Recupera los detalles de los segmentos, como los criterios de entrada y salida, para ayudar a comprender los cambios en el tamaño o el rendimiento de la audiencia. | |
/templates/email/create |
Crea copias de plantillas HTML base seleccionadas con marcadores de posición dinámicos (etiquetas de Liquid de Braze) para la experimentación, evitando cambios en las originales. | ✓ |
/templates/email/update |
Envía actualizaciones a las copias de plantillas creadas en Decisioning Studio cuando cambian los criterios de experimentación, como las llamadas a la acción. | ✓ |
/templates/email/info |
Recupera información sobre las plantillas creadas con Decisioning Studio en tu instancia de Braze. | ✓ |
/templates/email/list |
Valida que las plantillas se han copiado correctamente en tu instancia de Braze. | ✓ |
Paso 2: Configurar Campaigns activadas por API
Configura una Campaign activada por API para cada plantilla base con propiedades de activación de API para todas las dimensiones optimizadas.
Una plantilla base es cualquier plantilla que el agente de toma de decisiones podría usar para orquestar mensajes. Un agente de toma de decisiones puede tener 1 plantilla base o varias, en cuyo caso elegir la plantilla base correcta para cada cliente será una de las decisiones que el agente personaliza.
Paso 3: Configurar la reelegibilidad
Asegúrate de que todas las Campaigns activadas por API permitan que los usuarios vuelvan a ser elegibles en un plazo de 15 minutos.
Aunque el agente de Decisioning Studio nunca enviará la misma campaña más de una vez al día, querrás tener la capacidad de enviar las mismas campañas varias veces al día con fines de prueba.
Paso 4: Agregar marcadores de posición dinámicos
Estos sirven como marcadores de posición dinámicos para las decisiones que el agente de Decisioning Studio está optimizando.
Ejemplo 1: Campaign de correo electrónico
Supongamos que el agente de Decisioning Studio está optimizando una Campaign de correo electrónico. Esto podría configurarse así:
Suponiendo que el agente está optimizando la elección de plantillas y el mensaje de llamada a la acción (CTA), se debería crear una Campaign activada por API para cada plantilla, y la sección de CTA de una plantilla podría verse así:
Ejemplo 2: Campaign de push
Supongamos que un agente de Decisioning Studio está optimizando el mensaje de una Campaign de push. Esto podría configurarse así:
Resultando en el siguiente mensaje:
Ejemplo 3: Campaign de SMS
Supongamos que el agente de Decisioning Studio está optimizando campos en una Campaign de SMS. Esto podría configurarse así:
Resultando en el siguiente mensaje:
Configurar la integración con SFMC
Decisioning Studio admite integración nativa con Salesforce Marketing Cloud. Decisioning Studio desencadena eventos de API en un journey con los datos necesarios para poblar los elementos dinámicos.
Para conocer los pasos detallados para configurar la integración con SFMC, sigue las instrucciones de SFMC en la documentación de Decisioning Studio Go.
Configurar integraciones con otras CEP
Decisioning Studio puede integrarse con cualquier plataforma de interacción con los clientes. Sin embargo, esto puede requerir algo de trabajo de ingeniería personalizado por parte de tu equipo, ya que Decisioning Studio no puede desencadenar comunicaciones directamente.
En este escenario, el agente entregará un “archivo de recomendaciones”. Este archivo contiene filas para cada cliente, con columnas que indican todas las decisiones personalizadas para ese cliente.
Por ejemplo, el siguiente archivo de recomendaciones:
Podría usarse para optimizar una Campaign de correo electrónico que se vea así:
Mejores prácticas
Ten en cuenta estas mejores prácticas mientras te preparas para la orquestación:
- Comienza con un alcance reducido. Usa un canal y una o dos plantillas al principio. Puedes expandir después a medida que aprendas qué funciona.
- Prueba a fondo. Antes de lanzar, prueba tu integración con un conjunto pequeño de usuarios para verificar que el contenido dinámico se rellena correctamente.
- Documenta tu configuración. Lleva un registro de los ID de Campaign, ID de plantilla, claves de API y otros identificadores. Necesitarás consultarlos en el portal de Decisioning Studio.
- Coordina con tu equipo. La configuración de la orquestación puede involucrar a los equipos de marketing, ingeniería y datos. Asegúrate de que todos entiendan su rol en el proceso.
- Planifica para los datos de retroalimentación. La orquestación incluye enviar mensajes y recopilar los datos de interacción y conversión que ayudan a tu agente a aprender. Consulta Prepara tus datos para más detalles.
Próximos pasos
Después de configurar la orquestación, procede a diseñar tu agente: