Configuración de acciones externas
Las acciones externas permiten que los recorridos de cuenta de Journey Optimizer B2B edition se conecten con sistemas externos directamente desde el lienzo de recorrido. Cuando una audiencia de cuenta llega a un nodo de acción externa, el sistema realiza una llamada saliente asincrónica a un servicio externo configurado y pasa los datos de atributos de audiencia para cuentas, personas o ambos. El servicio externo procesa los datos y responde con una llamada de retorno, devolviendo datos de audiencia y metadatos que se pueden utilizar como guía para la ejecución del recorrido.
Esta función admite dos tipos de nodos de recorrido:
- Acción externa: llama a un servicio externo y continúa en una sola ruta de salida. Ideal para activar y olvidar integraciones, como actualizar un registro CRM o activar una notificación descendente.
- Rutas divididas externas: llama a un servicio externo y evalúa la respuesta para enrutar cuentas a lo largo de una de varias rutas definidas.
Resumen de implementación
La configuración de acciones externas requiere una coordinación entre tres funciones en secuencia:
Implementación del servicio externo implement-service
El desarrollador debe crear y publicar un servicio web público que cumpla con la Interfaz de proveedor de servicios de acciones externas de Adobe Journey Optimizer B2B edition.
Una vez que el servicio esté activo, proporcione la URL de la especificación OpenAPI y las credenciales de autenticación al administrador del producto responsable de configurar la acción.
Configurar la acción configure-action
Se debe configurar y activar una acción antes de que los especialistas en marketing puedan utilizarla en un recorrido. Las acciones se crean en estado Borrador y los cambios se guardan automáticamente. Permanece como borrador hasta que lo activa.
-
Vaya a Administración > Configuraciones.
-
Haga clic en Acciones externas en el panel intermedio.
{width="800" modal="regular"}
-
Haga clic en Crear acción en la parte superior derecha.
-
Escriba la dirección URL de la especificación OpenAPI para el servicio externo y haga clic en Crear.
{width="500"}
note note NOTE El servicio externo debe estar activo y accesible para que este paso se realice correctamente. -
Cuando la dirección URL se resuelva correctamente, revise Detalles del servicio.
Los detalles del servicio se leen directamente desde la especificación OpenAPI cuando se crea la acción. Estas propiedades no se pueden cambiar en la configuración después de la creación.
table 0-row-3 1-row-3 2-row-3 3-row-3 Propiedad Descripción Propiedad de especificación OpenAPI Nombre Nombre de la acción info.titleDescripción Descripción de la acción info.descriptionDirección URL URL de la especificación OpenAPI que define el servicio externo servers.url -
Escriba las credenciales de Authentication para el servicio externo (
components.securitySchemes).note note NOTE Los campos de credenciales mostrados dependen del mecanismo de autenticación definido en el servicio externo. Los tipos compatibles son Clave de API, OAuth2 y Autenticación básica HTTP. {width="600" modal="regular"}
Puede cambiar las credenciales según sea necesario cuando la acción configurada esté en estado Borrador o Activo.
-
Haga clic en Next.
-
Establezca las propiedades Configurations para definir cómo la acción intercambia datos con el servicio externo.
note note NOTE Las propiedades marcadas como Estáticas no se pueden actualizar en el momento de la configuración y se basan en la definición del servicio. -
Tipo de acción (Estática): el tipo de nodo de recorrido admitido:
- Acción externa (
enableSplitPath= false) - Ruta dividida de acción externa (
enableSplitPath= true)
No se puede cambiar el tipo de acción después de crear la configuración de acción.
- Acción externa (
-
Descriptores de acceso (Estáticos) - (Solo ruta de acceso dividida de acción externa) Las variables devueltas por el servicio externo para que estén disponibles como condiciones de ruta de acceso en un nodo de ruta de acceso dividida externa. (
invocationPayloadDef.accessorsMetadata) -
Contexto de Recorrido (Estático): el ámbito de los datos de audiencia enviados en la solicitud (
supportedEntityType):-
Cuenta - Envía solamente cuentas
-
Personas: envía solamente personas
-
Personas en la cuenta: envía cuentas y personas relacionadas con la cuenta
-
-
Campos de salida: asigne cada campo de la tabla a un campo XDM. Estos campos se envían en el cuerpo de la solicitud al servicio externo. Propiedades de definición de servicio:
invocationPayloadDef.accountFields,invocationPayloadDef.fields.
{width="600" modal="regular"}
-
Campos entrantes: asigne cada campo de la tabla a un campo XDM actualizable. Estos campos se rellenan desde la respuesta del servicio externo. Propiedades de definición de servicio:
callbackPayloadDef.accountFields,callbackPayloadDef.fields. Actualizable después de la creación. -
Parámetros de encabezado: escriba un valor para cada fila para pasarla como un encabezado HTTP en la solicitud. Propiedad de definición de servicio:
invocationPayloadDef.headers. -
Tiempo de espera: escriba el número de minutos que esperar para que el servicio externo invoque la devolución de llamada antes de que la solicitud se considere errónea. Propiedad de definición de servicio:
timeout. -
Atributos globales: escriba un valor para cada fila para incluirlo como campo estático en el cuerpo de la solicitud. Propiedad de definición de servicio:
invocationPayloadDef.globalAttributes.
{width="600" modal="regular"}
-
-
Haga clic en la flecha hacia atrás para regresar a la lista y mantener la acción en estado Borrador.
O haga clic en Activar para cambiar la configuración de la acción al estado Activo. La acción externa configurada debe estar activa para que esté disponible para su uso en recorridos de cuenta.
Añadir un nodo externo a un recorrido add-journey-node
Una vez activada una acción, los especialistas en marketing pueden agregar un nodo External action o External split path a cualquier recorrido de cuenta. Para obtener información sobre cómo agregar y utilizar estos nodos en el lienzo de recorrido de la cuenta, consulte Nodos externos.