Configurar una acción personalizada configure-an-action
Si utiliza un sistema de terceros para enviar mensajes o si desea que los recorridos envíen llamadas de API a un sistema de terceros, utilice acciones personalizadas para configurar su conexión con el recorrido. Por ejemplo, puede conectarse a los siguientes sistemas con acciones personalizadas: Epsilon, Slack, Adobe Developer, Firebase, etc.
Las acciones personalizadas son acciones adicionales definidas por usuarios técnicos y que se ponen a disposición de los expertos en marketing. Una vez configuradas, aparecen en la paleta izquierda del recorrido, en la Acción categoría. Obtenga más información en esta página.
Limitaciones custom-actions-limitations
Las acciones personalizadas incluyen algunas limitaciones enumeradas en esta página.
En los parámetros de acción personalizados, puede pasar una colección simple, así como una colección de objetos. Obtenga más información acerca de las limitaciones de recopilación en esta página.
Tenga en cuenta también que los parámetros de acciones personalizadas tienen un formato esperado (por ejemplo: cadena, decimal, etc.). Debe tener cuidado de respetar estos formatos esperados. Obtenga más información en esta caso de uso.
Las acciones personalizadas solo admiten el formato JSON al utilizar solicitud o cargas de respuesta.
Prácticas recomendadas custom-action-enhancements-best-practices
Al elegir un extremo como destino mediante una acción personalizada, asegúrese de lo siguiente:
- Este extremo puede admitir el rendimiento del recorrido mediante las configuraciones de la API de límite o la API de cierre para limitarlo. Tenga cuidado ya que una configuración de limitación no puede estar por debajo de 200 TPS. Cualquier extremo segmentado deberá admitir al menos 200 TPS.
- Este extremo necesita tener un tiempo de respuesta lo más bajo posible. Según el rendimiento esperado, tener un tiempo de respuesta alto podría afectar al rendimiento real.
Se define un límite de 300 000 llamadas durante un minuto para todas las acciones personalizadas. Además, el límite predeterminado se realiza por host y por zona protegida. Por ejemplo, en una zona protegida, si tiene dos puntos finales con el mismo host (p. ej., https://www.adobe.com/endpoint1 y https://www.adobe.com/endpoint2), la restricción se aplicará a todos los extremos del host adobe.com. "endpoint1" y "endpoint2" compartirán la misma configuración de límite y hacer que un extremo alcance el límite tendrá un impacto en el otro extremo.
Este límite se ha establecido en función del uso de los clientes para proteger los extremos externos dirigidos por acciones personalizadas. Debe tener esto en cuenta en los recorridos basados en públicos definiendo una tasa de lectura adecuada (5000 perfiles/s cuando se utilizan acciones personalizadas). Si es necesario, puede anular esta configuración definiendo un límite o restricción mayor mediante nuestras API de límite/restricción. Consulte esta página.
No debe segmentar los extremos públicos con acciones personalizadas por varios motivos:
- Sin un límite o una restricción adecuados, existe el riesgo de enviar demasiadas llamadas a un punto final público que puede no admitir ese volumen.
- Los datos de perfil se pueden enviar mediante acciones personalizadas, por lo que la segmentación de un extremo público podría llevar a compartir información personal de forma involuntaria de forma externa.
- No tiene control sobre los datos que devuelven los extremos públicos. Si un extremo cambia su API o comienza a enviar información incorrecta, esta estará disponible en las comunicaciones enviadas, con posibles impactos negativos.
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:
Pasos de configuración configuration-steps
Estos son los pasos principales necesarios para configurar una acción personalizada:
-
En la sección del menú ADMINISTRACIÓN, seleccione Configuraciones. En el Acciones , haga clic en Administrar. Clic Crear acción para crear una acción nueva. El panel de configuración de acción se abre en el lado derecho de la pantalla.
-
Escriba un nombre para la acción.
note note NOTE Solo se permiten caracteres alfanuméricos y guiones bajos. La longitud máxima es de 30 caracteres. -
Añada una descripción a la acción. Este paso es opcional.
-
El número de recorridos que utilizan esta acción se muestra en la variable Utilizado en field. Puede hacer clic en Ver recorridos para mostrar la lista de recorridos con esta acción.
-
Defina los diferentes Configuración de URL parámetros. Consulte esta página.
-
Configure las variables Autenticación sección. Esta configuración es la misma que para las fuentes de datos. Consulte esta sección.
-
Defina el Parámetros de acción. Consulte esta página.
-
Haga clic en Guardar.
La acción personalizada ahora está configurada y lista para utilizarse en sus recorridos. Consulte esta página.
note note NOTE Cuando se utiliza una acción personalizada en un recorrido, la mayoría de los parámetros son de solo lectura. Solo puede modificar la variable Nombre, Descripción, URL y el Autenticación sección.
Configuración de extremo url-configuration
Al configurar una acción personalizada, debe definir lo siguiente Configuración de extremo parámetros:
-
En el URL , especifique la URL del servicio externo:
-
Si la dirección URL es estática, introduzca la dirección URL en este campo.
-
Si la dirección URL incluye una ruta dinámica, introduzca solo la parte estática de la dirección URL, es decir, el esquema, el host, el puerto y, opcionalmente, una parte estática de la ruta.
Ejemplo:
https://xxx.yyy.com/somethingstatic/Especifique la ruta dinámica de la URL al agregar la acción personalizada a un recorrido. Más información.
note note NOTE Por motivos de seguridad, le recomendamos encarecidamente que utilice el esquema HTTPS para la dirección URL. No permitimos el uso de direcciones de Adobe que no sean públicas ni de direcciones IP. Solo se permiten los puertos predeterminados al definir una acción personalizada: 80 para http y 443 para https. -
-
Seleccione la llamada Método: puede ser cualquiera de las siguientes POST, GET o PUT.
note note NOTE El DELETE no se admite el método. Si necesita actualizar un recurso existente, seleccione la PUT método. -
Defina los encabezados y los parámetros de consulta:
- En el Encabezados , haga clic en Añadir un campo de encabezado para definir los encabezados HTTP del mensaje de solicitud que se va a enviar al servicio externo. El Content-Type y Charset los campos de encabezado están configurados de forma predeterminada. Estos campos no se pueden eliminar. Solo el Content-Type puede por modificación. Su valor debe respetar el formato JSON. Este es el valor predeterminado:
- En el Parámetros de consulta , haga clic en Agregar un campo de parámetro de consulta para definir los parámetros que desea añadir en la dirección URL.
-
Introduzca la etiqueta o el nombre del campo.
-
Seleccione el tipo: Constante o Variable. Si ha seleccionado Constante, luego introduzca el valor constante en Valor field. Si ha seleccionado Variable, entonces especificará esta variable al agregar la acción personalizada a un recorrido. Más información.
note note NOTE Después de agregar la acción personalizada a un recorrido, aún puede agregarle campos de encabezado o de parámetros de consulta si el recorrido está en estado de borrador. Si no desea que los cambios de configuración afecten al recorrido, duplique la acción personalizada y agregue los campos a la nueva acción personalizada. Los encabezados se validan según las reglas de análisis de campos. Obtenga más información en esta documentación.
Compatibilidad con el protocolo mTLS mtls-protocol-support
Ahora puede utilizar Mutual Transport Layer Security (mTLS) para garantizar una seguridad mejorada en las conexiones salientes a acciones personalizadas de Adobe Journey Optimizer. mTLS es un método de seguridad de extremo a extremo para la autenticación mutua que garantiza que ambas partes que comparten información son quienes dicen ser antes de que se compartan los datos. mTLS incluye un paso adicional en comparación con TLS, en el que el servidor también solicita el certificado del cliente y lo verifica al final.
La autenticación TLS mutua (mTLS) se admite en acciones personalizadas. No se requiere ninguna configuración adicional en la acción personalizada o en el recorrido para activar mTLS; se produce automáticamente cuando se detecta un punto de conexión habilitado para mTLS. Más información.
Definición de los parámetros de carga útil define-the-message-parameters
-
En el Solicitud , pegue un ejemplo de la carga útil JSON para enviar al servicio externo. Este campo es opcional y solo está disponible para los métodos de llamada de POST y PUT.
-
En el Respuesta , pegue un ejemplo de la carga útil devuelta por la llamada. Este campo es opcional y está disponible para todos los métodos de llamada. Para obtener información detallada sobre cómo aprovechar las respuestas de llamadas de API en acciones personalizadas, consulte esta página.
Podrá definir el tipo de parámetro (por ejemplo, cadena, entero, etc.).
También puede elegir entre especificar si un parámetro es una constante o una variable:
- Constante significa que el valor del parámetro lo define una persona técnica en el panel de configuración de acciones. El valor siempre será el mismo en todos los recorridos. No variará y el experto en marketing no lo verá al utilizar la acción personalizada en el recorrido. Podría ser, por ejemplo, un ID que espere el sistema de terceros. En ese caso, el campo a la derecha de la constante/variable de alternancia es el valor pasado.
- Variable significa que el valor del parámetro variará. Los especialistas en marketing que utilicen esta acción personalizada en un recorrido podrán transferir el valor que deseen o especificar dónde recuperar el valor de este parámetro (por ejemplo, desde el evento, desde Adobe Experience Platform, etc.). En ese caso, el campo a la derecha de la constante/variable de alternancia es el que los especialistas en marketing verán en el recorrido para asignar un nombre a este parámetro.
