En esta página: Aprenda a utilizar acciones personalizadas para conectar un recorrido a un sistema de terceros a través de una llamada de API de REST con una carga útil JSON, mientras aplica políticas de gobernanza de datos y consentimiento.
Utilice acciones personalizadas para habilitar la conexión a un sistema de terceros para enviar mensajes o llamadas API. Se puede configurar una acción con cualquier servicio de cualquier proveedor al que se pueda llamar mediante una API REST con carga útil en formato JSON.
Obtenga más información acerca de las acciones personalizadas en esta sección.
Aprenda a crear y configurar una acción personalizada en esta página.
Aprenda a utilizar las respuestas de llamadas de API de acciones personalizadas para personalizar esta página.
Consentimiento y control de datos privacy
En Journey Optimizer, puede aplicar políticas de gobernanza de datos y consentimiento a sus acciones personalizadas para evitar que campos específicos se exporten a sistemas de terceros o excluyan a los clientes que no hayan aceptado recibir comunicaciones por correo electrónico, push o SMS. Para obtener más información, consulte las siguientes páginas:
Configuración de URL
El panel de configuración de la actividad Acción personalizada muestra los parámetros de configuración de la URL y los parámetros de autenticación que están configurados para la acción personalizada. No se puede configurar la parte estática de la URL en la recorrido, sino en la configuración global de la acción personalizada. Más información.
Ruta dinámica
Si la dirección URL incluye una ruta dinámica, especifique la ruta en el campo Ruta.
Para concatenar campos y cadenas de texto sin formato, utilice las funciones Cadena o el signo Más (+) en el editor de expresiones avanzadas. Escriba las cadenas de texto sin formato entre comillas simples (') o dobles ("). Más información.
Esta tabla muestra un ejemplo de configuración:
https://xxx.yyy.com:8080/somethingstatic/The _id + '/messages'La URL concatenada tiene este formulario:
https://xxx.yyy.com:8080/somethingstatic/<ID>/messages
Encabezados y parámetros de consulta headers
La sección Configuración de URL muestra los campos de encabezado dinámico y parámetro de consulta, pero no los campos de constantes. Los campos de encabezado dinámico y parámetro de consulta se definen como variables en la pantalla de configuración de acciones. Más información
Para especificar el valor de los campos de encabezado dinámico y parámetro de consulta, haga clic dentro del campo o en el icono de lápiz y seleccione el campo deseado.
Parámetros de acción
En la sección Parámetros de acción, verá los parámetros de mensaje definidos como “Variable”. Para estos parámetros, puede definir de dónde obtener esta información (por ejemplo: eventos, fuentes de datos), pasar valores manualmente o utilizar el editor de expresiones avanzadas para casos de uso avanzados. Los casos de uso avanzados pueden ser manipulación de datos y otro uso de funciones. Consulte esta página.
Esta sección contiene conocimientos estructurados destinados a apoyar la interpretación, la recuperación y la respuesta a preguntas relacionadas con este tema.
Para una comprensión completa, esta información debe combinarse con la documentación de esta página. Ninguna de las fuentes pretende ser independiente; la página describe la función, mientras que esta sección proporciona contexto adicional que ayuda a desambiguar la terminología, la intención, la aplicabilidad y las restricciones.
- TL;DR: En esta página se explica cómo agregar y configurar una actividad de acción personalizada en un recorrido para llamar a una API de REST de terceros con una carga útil JSON, incluida la configuración de URL, la asignación de parámetros de encabezado/consulta, la asignación de parámetros de acción y la aplicación de directivas de gobernanza y consentimiento de datos.
Intenciones:
- Añada una actividad de acción personalizada a un recorrido para enviar datos a un sistema de terceros mediante la API de REST
- Configure una ruta de URL dinámica concatenando campos y texto estático en el editor de expresiones
- Asignar valores de encabezado dinámico y parámetros de consulta desde eventos de recorrido o fuentes de datos
- Asignar parámetros de acción (definidos como variables) a campos de evento, campos de fuente de datos o valores estáticos
- Aplique políticas de gobernanza de datos y consentimiento para controlar qué datos se exportan mediante acciones personalizadas
Glosario:
- Acción personalizada: una actividad de acción de recorrido que llama a un extremo externo de API REST con una carga en formato JSON para integrar sistemas de terceros (específicos del producto)
- Ruta dinámica: La parte variable de la URL de acción personalizada que se define por ejecución usando campos del contexto de recorrido (específico del producto)
- Parámetros de acción: los campos de carga útil del mensaje definidos como “Variable” en la configuración de acción personalizada, asignados a los datos de recorrido en el nivel de recorrido (específico del producto)
Protecciones:
- La parte estática de la dirección URL no se puede modificar en la recorrido; debe establecerse en la configuración de acción personalizada global.
- Los campos de encabezado dinámico y parámetro de consulta se definen como variables en la pantalla de configuración de acciones, no en el recorrido.
- Las políticas de gobernanza de datos y consentimiento se pueden aplicar para evitar que se exporten campos específicos o para excluir a los clientes no consentidos.
Terminología:
- Nombre canónico: Acción personalizada — Acrónimo: none — variantes: acciones personalizadas, acción de terceros
- Sinónimos: “parámetros de acción” = “parámetros de mensaje definidos como variables”
- No confunda: “parte de URL estática” (establecida en la configuración de acción global, no editable en el recorrido) ≠ “ruta dinámica” (establecida en el recorrido por ejecución)
PREGUNTAS MÁS FRECUENTES:
- Q: ¿Puedo cambiar la dirección URL base de una acción personalizada dentro del recorrido? — No, solo se puede establecer la parte de ruta dinámica en la recorrido; la parte estática de la dirección URL se configura en la configuración de acción personalizada global.
- Q: ¿Cómo creo una ruta de URL dinámica que incluya un identificador de perfil? — Utilice el campo Ruta con el editor de expresiones avanzadas para concatenar el campo Id. con cadenas estáticas, por ejemplo:
_id + '/messages'. - Q: ¿Cómo se aplican las reglas de consentimiento a una acción personalizada? — Configure políticas de consentimiento en la acción personalizada para excluir a los clientes que no hayan aceptado recibir la comunicación relevante; consulte la página Consentimiento para obtener más detalles.
- Q: ¿Dónde se asignan los valores para los encabezados dinámicos? — En la sección Configuración de URL del panel de actividad, haga clic dentro del campo de encabezado dinámico o utilice el icono de lápiz para seleccionar el campo deseado entre eventos o fuentes de datos.
- Q: ¿Qué tipos de valores puedo asignar a parámetros de acción? — Puede asignar parámetros a campos de evento, campos de fuente de datos, pasar valores manualmente o utilizar el editor de expresiones avanzadas para la manipulación de datos.