Herramienta Salida de Marketo
Herramienta Salida de Marketo
Utiliza Salida de Marketo para hacer una llamada al punto de conexión de la API de REST de Marketo: Crear/actualizar clientes potenciales. Los datos se envían a Marketo según la acción seleccionada en la configuración.
Importante
Esta herramienta no se instala automáticamente con Alteryx Designer. Para utilizar esta herramienta, descárgala de la Comunidad de Alteryx .
Configurar la herramienta
Credenciales de Marketo
URL : la Instancia REST de Marketo desde la que recuperar los registros. Esta información se encuentra en Marketo (Administración > Integración > Servicios web > API de REST).
Id. de cliente: el Id. de cliente para la función del usuario de la API. Esta información se puede encontrar en Marketo (Administración > Integración > LaunchPoint).
Secreto de cliente: el secreto de cliente para el rol del usuario de la API. Esta información se puede encontrar en Marketo (Administración > Integración > LaunchPoint).
En el sitio de documentación de REST de Marketo , puedes encontrar más información sobre la configuración del servicio web y los roles de los usuarios para acceder a la API de REST de Marketo.
Opciones
Campo clave: En este menú desplegable, se muestra la lista de campos que has utilizado como entrada para la herramienta. Marketo utiliza este campo para buscar registros duplicados. Si no se especifican campos, se utilizará el correo electrónico de forma predeterminada.
Si el campo “id” está incluido en tus registros, debes seleccionar “id” como campo clave.
Selecciona una Acción de salida .
Crear o actualizar (de forma predeterminada) : Según el campo clave, crea un cliente potencial si no existe o actualiza el cliente potencial si existe.
Crear duplicado : Crea otro cliente potencial incluso si ya existe uno.
Solo actualizar : Actualiza el cliente potencial si ya existe; si no existe, no hace nada.
Solo crear : Crea un nuevo cliente potencial si no existe; si existe, lo omite.
Nombre de la partición : Si la instancia de Marketo a la que estás accediendo tiene particiones configuradas, estas se muestran en el menú desplegable. Esta selección de campo es obligatoria si la instancia en la que se está escribiendo tiene particiones de clientes potenciales configuradas. Si no hay particiones disponibles, se utiliza “Predeterminado”.
Consideraciones de datos
En la ventana de resultados, aparece un resumen de los registros enviados en forma de mensaje.
Según los registros que enviaste, se omitieron tres registros y se crearon dos.
Los mensajes de error, como las fallas de autenticación, etc., se muestran en la ventana de configuración. Los mensajes de error, como la falta de selecciones de configuración, se muestran sobre la herramienta en el flujo de trabajo.
La herramienta envía registros en lotes de 300 registros o menos; cada lote cuenta como una llamada a la API separada con respecto al límite diario establecido por Marketo. Consulta la documentación de la API de REST de Marketo para obtener información sobre los límites diarios. Las solicitudes a la API de REST no cuentan para las limitaciones diarias de la API de SOAP.
Debes asegurarte de mantener las estructuras de los campos de Marketo en Alteryx antes de volver a escribir en Marketo, para evitar errores. El conector de Marketo convertirá los datos a los tipos de datos adecuados antes de enviarlos a Marketo, siempre que los nombres de los campos sean válidos. Si los nombres de los campos no se encuentran en Marketo, se producirá un error en la salida.
Campos de fecha y hora
Todas las fechas en Marketo se almacenan con una diferencia horaria con UTC. Este formato se compone de la hora local con una diferencia horaria adicional que puede ser positiva o negativa. Por ejemplo, un valor de fecha y hora en Marketo podría tener este aspecto si la fecha insertada en Marketo es de una zona horaria que es 6 horas antes de la hora UTC (Hora de verano de las Montañas):
2012-02-28T14:00:00-06:00
Lectura de datos de Marketo
Para facilitarle el trabajo a los creadores de Alteryx con estos valores de fecha y hora, Alteryx convierte el valor de fecha y hora leído de Marketo en un valor de fecha y hora local de la máquina. Esto permite a los creadores trabajar con los valores de la fecha y hora en sus horas locales. Por ejemplo, el valor de fecha y hora anterior tendría este aspecto en un flujo de trabajo o aplicación de Alteryx, suponiendo que también se encuentra 6 horas antes de la hora UTC:
2012-02-28 14:00:00
O si solo se encontrara 4 horas antes de la hora UTC, se devolvería así:
2012-02-28 16:00:00
Escritura de fecha en Marketo
Cuando los valores de hora y fecha se escriben en Marketo mediante una operación de inserción o actualización, Alteryx convierte los valores al formato que Marketo espera. Esto se realiza calculando la diferencia horaria con UTC de la máquina local y agregándola al final del valor de hora y fecha. Alteryx colocará una “T” entre las partes de la hora y la fecha del valor de hora y fecha como se muestra en los ejemplos anteriores.
Con los ejemplos anteriores, si un valor de fecha y hora se escribió desde una zona horaria con una diferencia horaria de -6:00, como esta:
2012-02-28T14:00:00-06:00
Y, luego, se escribió de nuevo en Marketo (sin modificar), desde una computadora con una diferencia horaria con UTC de -4:00 horas, se escribiría de nuevo en Marketo de la siguiente manera:
2012-02-28T16:00:00-04:00
Ambas horas son idénticas y representan el mismo momento en el tiempo.