Servicio de paso de flujo flow-step-service

Pasos de flujo de autoservicio es un marco y un conjunto de funciones para la creación, publicación e integración de servicios web en campañas inteligentes de Adobe Marketo Engage. Esta guía está destinada a los usuarios finales Marketo Engage que desean instalar y utilizar servicios que ya se han creado y publicado. Para obtener información sobre cómo crear y publicar su propio servicio, consulte la Repositorio de GitHub para la interfaz de Service Provider. A Proof-of-Concept Lookup Table implementation may be found here.

Incorporación y administración de servicios onboarding-and-managing-services

La instalación de un paso de flujo personalizado requiere permisos de administración en Marketo. Aparte de la URL de instalación, todos los demás aspectos de un servicio atendido pueden editarse después de completar la incorporación inicial explorando en la pantalla de detalles del servicio desde la cuadrícula de los proveedores de servicios.

URL de instalación installation-url

Para comenzar la instalación, primero deberá obtener la URL del documento de OpenAPI que define su servicio. El proveedor de servicios debe poder proporcionárselo y, por lo general, tendrá una dirección URL que termina en /openapi.json. Las direcciones URL completas tendrán este aspecto https://www.example.com/OpenAPI.json. Una vez que tenga esta URL, vaya al menú Service Providers en la sección Admin.

Clic Siguiente para ir a la sección Introducir Credenciales de Servicio.

Introducir credenciales de servicio enter-service-credentials

Para acceder al servicio que se está instalando, Marketo debe tener credenciales de API válidas. El proveedor de servicios debe proporcionarle estas credenciales. Los servicios tienen tres opciones de autenticación diferentes, por lo que puede ver una de las tres solicitudes diferentes de credenciales: Clave de API que solo tiene un campo de entrada, Autenticación básica que requiere un nombre de usuario y una contraseña y también puede requerir un campo llamado Dominio, y OAuth2 uso del Credenciales del cliente subvención, que requiere una ID de cliente y Secreto del cliente.

Al guardar las credenciales, Marketo intentará llamar al extremo de estado del servicio para comprobar que son válidas. Si las credenciales proporcionadas no son válidas, aparecerá un error que lo indica.

Guía de incorporación (opcional) onboarding-guide

Algunos proveedores de servicios incluirán un paso opcional de la Guía de incorporación. Este paso incluirá cualquier instrucción adicional para completar la incorporación al servicio que sea específica de ese servicio.

Asignación de campos field-mapping

Para recibir o devolver datos de un campo de posible cliente específico, ese campo debe asignarse. Aunque la asignación es un paso necesario durante la incorporación, siempre puede volver para modificar las asignaciones más adelante. Existen dos tipos de asignaciones que se configuran en pantallas independientes: Campos salientes, que se envían al servicio cuando Marketo invoca el paso de flujo, y Campos entrantes que son campos que pueden recibir datos del servicio cuando devuelve datos a Marketo.

NOTE
Al asignar un campo saliente, se concede permiso a Marketo para transmitir datos de ese campo relacionados con los posibles clientes procesados por el servicio asociado. Asegúrese de que tiene la capacidad legal y la autoridad adecuadas para transmitir estos datos a su proveedor de servicios, ya que estos campos pueden incluir información de identificación personal cubierta por las leyes de privacidad de datos, protección y tenencia.

Las asignaciones de campos opcionales pueden deshabilitarse sin interrumpir el servicio, pero las asignaciones requeridas no pueden eliminarse ni desactivarse por completo.

Asignaciones gobernadas por servicio service-driven-mappings

Los servicios que tienen un conjunto fijo de entradas y salidas, como un paso del flujo de registro de eventos, utilizan Asignaciones gobernadas por servicio. Para este tipo de asignación, el proveedor de servicios proporcionará un tipo de datos y una sugerencia en forma de nombre de API. Si la sugerencia coincide con el nombre de la API de un campo de posible cliente existente, ese campo se rellenará automáticamente en la sección de asignación. Para los campos sin una sugerencia coincidente, deberá rellenar la asignación manualmente desde la lista de campos con el tipo de datos coincidente. Las asignaciones necesarias deben rellenarse para completar la incorporación.

Asignaciones Dirigidas Por El Usuario user-driven-mappings

Los servicios que no tienen un conjunto fijo de entradas y salidas, como un servicio de formato de fecha, utilizan Asignaciones Dirigidas Por El Usuario. Esto significa que cada campo entrante y saliente debe configurarlo un administrador.

Campos salientes outgoing-fields

Los campos de salida son aquellos que se envían al servicio de pasos de flujo cuando ese paso de flujo se utiliza en una campaña inteligente.

Campos entrantes incoming-fields

Los campos entrantes son aquellos en los que el servicio de pasos de flujo puede escribir datos.

Opciones de configuración (opcional) configuration-options

Algunos servicios tienen opciones de configuración global opcionales o requeridas. Si se requiere alguna opción, se debe establecer un valor para todas las opciones necesarias antes de guardar o completar la incorporación. Los parámetros cuyos nombres están en cursiva se envían al servicio invocado como encabezados.

Retirada de un servicio retiring-a-service

Para facilitar las transiciones a versiones nuevas o alternativas de un servicio, sin interrumpir el uso activo, los servicios se pueden retirar del menú Proveedores de servicios. Retirada de un servicio elimina el paso de flujo correspondiente de la paleta Flujo de campaña inteligente, de modo que no se puedan crear nuevos usos. En la mayoría de los casos, debe tener un servicio de reemplazo listo para reemplazar el existente cuando decida retirar un servicio.

Obsolescencia del servicio service-deprecation

A veces, los proveedores de servicios necesitarán dejar de utilizar los servicios de paso de flujo como parte normal del ciclo de vida del software. Cuando un proveedor de servicios lo anuncia, la fecha y el mensaje de obsolescencia se rellenan en la vista de cuadrícula de los proveedores de servicios. Si continúa utilizando un servicio que ha quedado obsoleto, puede causar interrupciones en el servicio si ya no responde de la manera esperada o deja de aceptar solicitudes de Marketo Smart Campaigns, por lo que debe prestar mucha atención a cualquier notificación de obsolescencia del servicio que reciba y tomar las medidas adecuadas para retirar o reemplazar cualquier paso del servicio que aún esté en uso.

Uso de pasos de flujo personalizados y de terceros using-third-party-and-custom-flow-steps

Los pasos de flujo instalados se pueden utilizar en gran medida del mismo modo que los pasos de flujo estándar. Todos los parámetros de flujo definidos por el servicio se presentan a los usuarios finales.

Actualización de listas de selección refreshing-picklists

Marketo actualizará las opciones de la lista de selección para los servicios todas las noches, pero hay ocasiones en que necesitará nuevas opciones disponibles, como la creación de campañas. Puede actualizarlas fácilmente desde cualquier instancia del paso de flujo con el botón Actualizar o accediendo al menú Administración > Proveedores de servicios y haciendo clic en Actualizar lista de selección una vez que haya seleccionado el servicio.

Comprobación de campos entrantes checking-incoming-fields

Puede comprobar qué campos entrantes están configurados para un paso de flujo determinado pasando el ratón por encima de su icono de información del objeto. Esto resulta útil para determinar qué campos podrían cambiar cuando un posible cliente fluye a través de ellos, de modo que puede configurar opciones en pasos posteriores utilizando esos campos.

Cambios en campos entrantes y valores de datos incoming-fields-and-data-value-changes

A diferencia de la mayoría de los demás pasos de flujo, los implementados con el marco SSFS pueden escribir datos en los campos de posible cliente asignados por un administrador y registrar esos cambios como actividades de cambio de valor de datos. Cuando un paso de flujo escribe los datos de esta manera, todos esos cambios se completarán antes de que la campaña inteligente avance en cualquier paso posterior, de modo que cualquier dato escrito pueda depender de las opciones de paso de flujo posteriores.

Registros de servicio y estadísticas service-logs-and-statistics

Cada servicio de paso de flujo tiene varios tipos de registro asociados para ayudar a monitorizar el estado y solucionar cualquier problema relacionado con la integración.

Estadísticas de servicio service-statistics

El registro de estadísticas del servicio agrega los resultados de las invocaciones y las llamadas de retorno de cada servicio. Se agrupan por tiempo, nivel (fragmento o registro) y código, y proporcionan recuentos y el mensaje de registro más reciente para cada código recibido. Este tablero está diseñado principalmente para ayudar a monitorizar el estado del servicio.

recommendation-more-help
94ec3174-1d6c-4f51-822d-5424bedeecac