Configuración de una acción personalizada configure-a-custom-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 la conexión a su 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 categoría Acción. 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 colecció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 este caso de uso.
Las acciones personalizadas solo admiten el formato JSON cuando se utilizan solicitudes 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 la sección Acciones, haga clic en Administrar. Haga clic en Crear acción para crear una nueva acción. 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 usa esta acción se muestra en el campo Utilizado en. Puede hacer clic en el botón Ver recorridos para mostrar la lista de recorridos con esta acción.
-
Defina los diferentes parámetros de configuración de URL. Consulte esta página.
-
Configure la sección Autenticación. Esta configuración es la misma que para las fuentes de datos. Consulte esta sección.
-
Defina los 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 los campos Name, Description, URL y la sección Authentication.
Configuración de extremo url-configuration
Al configurar una acción personalizada, debe definir los siguientes parámetros de configuración de extremo:
-
En el campo 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 Method: puede ser POST, GET o PUT.
note note NOTE No se admite el método DELETE. Si necesita actualizar un recurso existente, seleccione el método PUT. -
Defina los encabezados y los parámetros de consulta:
- En la sección Encabezados, haga clic en Agregar un campo de encabezado para definir los encabezados HTTP del mensaje de solicitud que se enviará al servicio externo. Los campos de encabezado Content-Type y Charset están establecidos de forma predeterminada. Estos campos no se pueden eliminar. Solo se puede modificar el encabezado Content-Type. Su valor debe respetar el formato JSON. Este es el valor predeterminado:
- En la sección Parámetros de consulta, haga clic en Agregar un campo de parámetro de consulta para definir los parámetros que desea agregar en la dirección URL.
-
Introduzca la etiqueta o el nombre del campo.
-
Seleccione el tipo: Constant o Variable. Si ha seleccionado Constante, introduzca el valor constante en el campo Valor. Si ha seleccionado Variable, deberá 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
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 ni en el recorrido para activar mTLS; se produce automáticamente cuando se detecta un extremo habilitado para mTLS. Más información.
Definición de los parámetros de carga útil define-the-message-parameters
Puede definir el parámetro de carga útil como se detalla a continuación:
-
En la sección 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.
Habilite la opción Permitir valores NULL para mantener los valores Null en la llamada externa. Tenga en cuenta que al enviar matrices de int, string, etc. con valores Null en no es totalmente compatible. Por ejemplo, la siguiente matriz de enteros
[1, null, 2, 3]se envía como[1, 2, 3]aunque se marque esta opción. Además, si dicha matriz es nula, se envía como una matriz vacía.
-
En la sección Response, 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.
. ni comenzar con un carácter $.
En la configuración del campo, debe:
-
Seleccione el tipo de parámetro, por ejemplo: cadena, entero, etc.
-
Defina una constante o un parámetro de variable:
-
Constant significa que el valor del parámetro lo define un técnico en el panel de configuración de la acción. El valor siempre será el mismo en todos los recorridos. No varía y el experto en marketing no puede verlo 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 valor constante se establece en el campo a la derecha de la constante/variable de alternancia.
-
Variable significa que el valor del parámetro puede variar. Los especialistas en marketing que utilizan esta acción personalizada en un recorrido pueden 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.
Para los parámetros opcionales, habilite la opción Is optional al final de la línea. Al marcar esta opción, marca el parámetro como no obligatorio y permite que los profesionales del recorrido elijan rellenarlo o no al crear esa acción personalizada en un recorrido.
-