Skip to content

Configurar la orquestación

BrazeAI Decisioning Studio™ Go necesita conectarse a tu plataforma de interacción con los clientes (CEP) para orquestar comunicaciones personalizadas. Este artículo explica cómo configurar la integración para cada CEP compatible.

CEP compatibles

Decisioning Studio Go es compatible con las siguientes plataformas de interacción con los clientes:

CEP Tipo de integración Características principales
Braze Campaigns desencadenadas por API Integración nativa, desencadenamiento en tiempo real
Salesforce Marketing Cloud Journey Builder con eventos API Automatización de consultas SQL, extensiones de datos

Selecciona tu CEP a continuación para comenzar con la configuración de la integración.

Configurar la integración con Braze

Para integrar Decisioning Studio Go con Braze, crearás una clave de API, configurarás una Campaign desencadenada por API y proporcionarás los identificadores necesarios al portal de Decisioning Studio Go.

Paso 1: Crear una clave de API REST

  1. En el dashboard de Braze, ve a Settings > APIs and Identifiers > API Keys.
  2. Selecciona Create API Key.
  3. Introduce un nombre para tu clave de API. Un ejemplo es “DecisioningStudioGoEmail”.
  4. Selecciona los permisos según las siguientes categorías:
    • User Data: selecciona users.track, users.delete, users.export.ids, users.export.segment
    • Messages: selecciona messages.send
    • Campaigns: selecciona todos los permisos enumerados
    • Canvas: selecciona todos los permisos enumerados
    • Segments: selecciona todos los permisos enumerados
    • Templates: selecciona todos los permisos enumerados
  1. Selecciona Create API Key.
  2. Copia la clave de API y pégala en tu portal BrazeAI Decisioning Studio™ Go.

Paso 2: Localiza tu nombre para mostrar de correo electrónico

  1. En el dashboard de Braze, ve a Settings > Email Preferences.
  2. Localiza el nombre para mostrar que se utilizará con BrazeAI Decisioning Studio™ Go.
  3. Copia y pega el From Display Name en el portal BrazeAI Decisioning Studio™ Go como Email Display Name.
  4. Copia y pega la dirección de correo electrónico asociada en tu portal BrazeAI Decisioning Studio™ Go como From email address, que combina la parte local y el dominio.

Paso 3: Encuentra tu URL de Braze y tu ID de aplicación

Para encontrar tu URL de Braze:

  1. Ve al dashboard de Braze.
  2. En la ventana de tu navegador, la URL de Braze comienza por https:// y termina por braze.com. Un ejemplo de URL de Braze es https://dashboard-01.braze.com.

Para encontrar tu ID de aplicación (clave de API):

  1. En el dashboard de Braze, ve a Settings > App Settings.
  2. Ve a la aplicación de la que deseas hacer seguimiento.
  3. Copia y pega la API Key en tu portal BrazeAI Decisioning Studio™ Go.

Paso 4: Crear una Campaign desencadenada por API

  1. En el dashboard de Braze, ve a Messaging > Campaigns.
  2. Selecciona Create Campaign.
  3. Para el tipo de campaña, selecciona API Campaign.
  4. Introduce un nombre para tu campaña. Un ejemplo es “Decisioning Studio Go Email”.

Una Campaign de API denominada "Decisioning Studio Go Email".

  1. Para tu canal de mensajería, selecciona Email.

Opción para seleccionar tu canal de mensajería para la Campaign de API.

  1. En Additional Options, selecciona la casilla Allow users to become re-eligible to receive campaign.
  2. Para el tiempo de reelegibilidad, introduce 1 y selecciona Hours en el menú desplegable.

Reelegibilidad para la Campaign de API seleccionada.

  1. Selecciona Save Campaign.

Paso 5: Copia los ID de tu Campaign y mensaje

  1. En tu Campaign de API, copia el Campaign ID. A continuación, ve al portal BrazeAI Decisioning Studio™ Go y pega el Campaign ID.

Un ejemplo de ID de variación de mensaje para copiar y pegar.

  1. Copia el Message Variation ID. A continuación, ve al portal BrazeAI Decisioning Studio™ Go y pega el Message Variation ID.

Paso 6: Localiza un ID de usuario de prueba

Para probar tu integración, necesitarás un ID de usuario:

Si tu espacio de trabajo utiliza cifrado a nivel de campo de identificadores, cualquier nuevo usuario de prueba que crees con el punto de conexión /users/track debe cumplir los requisitos de correo electrónico para espacios de trabajo cifrados. Envía el campo email como el hash HMAC-SHA256 codificado en Base64 del valor de correo electrónico en minúsculas, y envía email_encrypted como el valor de correo electrónico cifrado generado con tus claves de cifrado PII configuradas.

  1. En el dashboard de Braze, ve a Audience > Search Users.
  2. Busca al usuario por su ID de usuario externo, alias de usuario, correo electrónico, número de teléfono o token de notificaciones push.
  3. Copia el ID de usuario para referenciarlo en tu configuración.

Ejemplo de perfil de usuario obtenido al localizar un usuario con su ID.

Configurar la integración con SFMC

Para integrar Decisioning Studio Go con Salesforce Marketing Cloud, configurarás un paquete de aplicaciones, crearás una automatización de consultas de datos y construirás un recorrido para gestionar los envíos desencadenados.

Parte 1: Configurar un paquete de aplicaciones SFMC

  1. Ve a la página de inicio de Marketing Cloud.
  2. Abre el menú en el encabezado global y selecciona Setup.
  3. Ve a Apps en Platform Tools en el panel de navegación lateral y, a continuación, selecciona Installed Packages.
  4. Selecciona New para crear un paquete de aplicaciones.
  5. Asigna un nombre y una descripción al paquete de aplicaciones.

Un paquete de aplicaciones con el nombre "Experimenter 1 - Test 5".

  1. Selecciona Add Component.
  2. En Component Type, selecciona API Integration. A continuación, selecciona Next.
  3. Para el Integration Type, selecciona Server-to-server. A continuación, selecciona Next.
  4. Selecciona los siguientes ámbitos recomendados solo para tu paquete de aplicaciones:
    • Channels > Email > Read, Write, Send
    • Channels > OTT > Read
    • Channels > Push > Read
    • Channels > SMS > Read
    • Channels > Social > Read
    • Channels > Web > Read
    • Assets > Documents and Images > Read, Write
    • Assets > Saved Content > Read, Write
    • Automation > Automations > Read, Write, Execute
    • Automation > Journeys > Read, Write, Execute, Activate/Stop/Pause/Send/Schedule
    • Contacts > Audiences > Read
    • Contacts > List and Subscribers > Read, Write
    • Cross Cloud Platform > Market Audience > View
    • Cross Cloud Platform > Market Audience Member > View
    • Cross Cloud Platform > Marketing Cloud Connect > Read
    • Data > Data Extensions > Read, Write
    • Data > File Locations > Read
    • Data > Tracking Events > Read, Write
    • Event notifications > Callbacks > Read
    • Event notifications > Subscriptions > Read
Mostrar imagen de los ámbitos recomendados

Los ámbitos recomendados para el paquete de aplicaciones de Salesforce Marketing Cloud.

  1. Selecciona Save.
  2. Copia y pega los siguientes campos en el portal BrazeAI Decisioning Studio™ Go: Client Id, Client Secret, Authentication Base URI, REST Base URI, SOAP Base URI.

Parte 2: Configurar una automatización de consultas de datos

Paso 1: Crear una nueva automatización

  1. Desde la página de inicio de Salesforce Marketing Cloud, ve a Journey Builder y selecciona Automation Studio.

Opción de Automation Studio en la navegación de Journey Builder.

  1. Selecciona New Automation.
  2. Arrastra y suelta un nodo Schedule como Starting Source.

"Schedule" como origen inicial de un recorrido.

  1. En el nodo Schedule, selecciona Configure.
  2. Configura lo siguiente para la planificación:
    • Start Date: el día de mañana en el calendario
    • Time: 12:00 AM
    • Time Zone: (GMT-05:00) Eastern (US & Canada)
  3. Para Repeat, selecciona Daily.
  4. Configura esta planificación para que nunca termine.
  5. Selecciona Done para guardar la planificación.

Un ejemplo de planificación definida para el 25 de enero de 2024 a las 12 AM ET, que se repite todos los días.

Paso 2: Crea tus consultas SQL

A continuación, crea 2 consultas SQL: una consulta de suscriptores y una consulta de interacción. Estas consultas permiten a BrazeAI Decisioning Studio™ Go recuperar datos para completar la audiencia e incorporar eventos de interacción.

Consulta de suscriptores:

  1. Arrastra y suelta una SQL Query en el canvas.
  2. Selecciona Choose.
  3. Selecciona Create New Query Activity.
  4. Asigna un nombre y una clave externa a la consulta. Recomendamos utilizar el nombre y la clave externa sugeridos para la consulta de suscriptores que se proporcionan en tu portal BrazeAI Decisioning Studio™ Go.

Un ejemplo "OFE_Subscribers_query_Test5" y la clave externa.

  1. Selecciona Next.
  2. En tu portal BrazeAI Decisioning Studio™ Go, localiza la consulta SQL de datos del sistema en Subscriber Query Resources.
  3. Copia y pega la consulta en el cuadro de texto y selecciona Next.

Un ejemplo de consulta en la sección SQL Query.

  1. En tu portal BrazeAI Decisioning Studio™ Go, en la sección Resources to use, localiza la clave externa de la extensión de datos de destino. A continuación, pégala en la barra de búsqueda para buscar.

Una clave externa pegada en la barra de búsqueda.

  1. Selecciona la extensión de datos que coincida con la clave externa que buscaste. El nombre de la extensión de datos de destino también se proporciona en tu portal BrazeAI Decisioning Studio™ Go para que puedas consultarlo. La Data Extension para la consulta de suscriptores debe terminar con el sufijo BASE_AUDIENCE_DATA.

El nombre de la extensión de datos que coincide con la clave externa del ejemplo.

  1. Selecciona Overwrite y, a continuación, Next.

Consulta de interacción:

  1. Arrastra y suelta una SQL Query en el canvas.

"SQL Query" añadida como actividad en el recorrido.

  1. Selecciona Choose.
  2. Selecciona Create New Query Activity.
  3. Asigna un nombre y una clave externa a la consulta. Recomendamos utilizar el nombre y la clave externa sugeridos para la consulta de interacción que se proporcionan en tu portal BrazeAI Decisioning Studio™ Go.

Un ejemplo "OFE_Engagement_query" y la clave externa.

  1. Selecciona Next.
  2. En tu portal BrazeAI Decisioning Studio™ Go, localiza la consulta SQL de datos del sistema en Engagement Query Resources.
  3. Copia y pega la consulta en el cuadro de texto y selecciona Next.

Un ejemplo de consulta en la sección SQL Query.

  1. Localiza y selecciona la extensión de datos de destino para la consulta de interacción especificada en tu portal BrazeAI Decisioning Studio™ Go.
  1. Selecciona Overwrite y, a continuación, Next.

El nombre de la extensión de datos que coincide con la clave externa del ejemplo.

Paso 3: Ejecuta la automatización

  1. Asigna un nombre a la automatización y selecciona Save.

Un ejemplo de automatización "OFE_Experimenter_Test5_Automation".

  1. A continuación, selecciona Run Once para confirmar que todo funciona según lo esperado.
  2. Selecciona ambas consultas y selecciona Run.

Una automatización "OFE_Experimenter_Test5_Automation" con una lista de actividades de consultas SQL seleccionadas para ejecutar.

  1. Selecciona Run Now.

Una actividad de consulta SQL seleccionada.

Ahora puedes comprobar que la automatización se está ejecutando correctamente. Ponte en contacto con soporte de Braze para obtener más ayuda si tu automatización no funciona como se esperaba.

Parte 3: Crea tu recorrido SFMC

Paso 1: Configura el recorrido

  1. En Salesforce Marketing Cloud, ve a Journey Builder > Journey Builder.
  2. Selecciona Create New Journey.
  3. Para el tipo de recorrido, selecciona Multi-Step Journey y, a continuación, selecciona Create.

Una fuente de entrada de eventos API conectada a un nodo de división de decisiones y a varios nodos de correo electrónico.

Paso 2: Construye el recorrido

Crear una fuente de entrada:

  1. Para la fuente de entrada, arrastra API Event al Journey Builder.

"API Event" seleccionado como fuente de entrada.

  1. En el API Event, selecciona Create an event.

La opción "crear un evento" en el API Event.

  1. Selecciona Select Data Extension. Localiza y selecciona la extensión de datos en la que BrazeAI Decisioning Studio™ Go escribirá las recomendaciones.
  2. Selecciona Summary para guardar los cambios.
  3. Selecciona Done para guardar el evento API.

Resumen del evento API.

Añadir una división de decisiones:

  1. Arrastra y suelta una Decision Split después del API Entry Event.
  2. En los detalles de la Decision Split, selecciona Edit para la primera ruta.

Detalles de la división de decisiones con el botón "Edit".

  1. Actualiza la Decision Split para utilizar el ID de plantilla pasado por la extensión de datos de recomendaciones. Localiza el campo correspondiente en Journey Data.

La sección Journey Data en la ruta 1 de la división de decisiones.

  1. Selecciona tu evento de entrada y localiza el campo de ID de plantilla deseado, luego arrástralo al espacio de trabajo.

El ID de la plantilla de correo electrónico que se va a incluir.

  1. Introduce el ID de la plantilla de tu primera plantilla de correo electrónico y, a continuación, selecciona Done.
  2. Selecciona Summary para guardar esta ruta.
  3. Añade una ruta para cada una de tus plantillas de correo electrónico y, a continuación, repite los pasos 4 a 6 anteriores para establecer los criterios de filtrado de modo que el ID de la plantilla coincida con el valor de ID de cada plantilla.
  4. Selecciona Done para guardar el nodo de Decision Split.

Dos rutas en una división de decisiones para cada ID de plantilla de correo electrónico.

Añadir un correo electrónico para cada división de decisiones:

  1. Arrastra un nodo de Email a cada ruta de la Decision Split.
  2. Selecciona Email y, a continuación, selecciona la plantilla adecuada que debe ir en cada ruta (es decir, la plantilla con el valor de ID debe coincidir con la lógica de tu Decision Split).

Un nodo de correo electrónico añadido al recorrido.

Paso 3: Activa el recorrido

Después de configurar tu recorrido, actívalo y comparte los siguientes detalles con el equipo de BrazeAI Decisioning Studio™ Go:

  • ID del recorrido
  • Nombre del recorrido
  • Clave de definición de evento API
  • Clave externa de la extensión de datos de recomendaciones
  1. En el portal BrazeAI Decisioning Studio™ Go, copia el nombre del recorrido.
  2. A continuación, en Salesforce Marketing Cloud Journey Builder, pega el nombre del recorrido en la barra de búsqueda.
  3. Selecciona el nombre del recorrido. Ten en cuenta que el recorrido se encuentra actualmente en estado de borrador.
  4. Selecciona Validate.

El recorrido completado para activar.

  1. A continuación, revisa los resultados de la validación y selecciona Activate.

Recomendaciones enumeradas en la sección Reglas de validación.

  1. En el resumen Activate Journey, selecciona Activate de nuevo.

Resumen del recorrido.

¡Ya está todo listo! Ahora puedes comenzar a desencadenar envíos a través de BrazeAI Decisioning Studio™ Go.

Próximos pasos

Ahora que has configurado la orquestación, continúa con el diseño de tu agente:
New Stuff!