(API) Oracle Eloqua conexión

Oracle Eloqua permite a los especialistas en marketing planificar y ejecutar campañas a la vez que ofrecen una experiencia de cliente personalizada para sus posibles clientes. Con una administración de posibles clientes integrada y una creación de campañas sencilla, ayuda a los especialistas en marketing a atraer a la audiencia adecuada en el momento adecuado en el recorrido del comprador y se escala de forma elegante para llegar a audiencias de varios canales, incluidos correo electrónico, búsqueda en pantalla, vídeo y móvil. Los equipos de ventas pueden cerrar más acuerdos a una velocidad más rápida, lo que aumenta el retorno de la inversión de marketing a través de una perspectiva en tiempo real.

Este Adobe Experience Platform destino aprovecha la operación Actualizar un contacto de la API de REST Oracle Eloqua, que le permite actualizar identidades dentro de una audiencia en Oracle Eloqua.

Oracle Eloqua usa autenticación básica para comunicarse con la API de REST Oracle Eloqua. Las instrucciones para autenticarse en su instancia de Oracle Eloqua se encuentran más abajo, en la sección Autenticar en destino.

Casos de uso use-cases

El departamento de marketing de una plataforma en línea desea difundir una campaña de marketing basada en correo electrónico a una audiencia seleccionada de posibles clientes. El equipo de marketing de la plataforma puede actualizar la información de posibles clientes existente a través de Adobe Experience Platform, crear audiencias a partir de sus propios datos sin conexión y enviar estas audiencias a Oracle Eloqua, que luego se pueden usar para enviar el correo electrónico de la campaña de marketing.

Requisitos previos prerequisites

Requisitos previos del Experience Platform prerequisites-in-experience-platform

Antes de activar datos en el destino Oracle Eloqua, debe tener un esquema, un conjunto de datos y segmentos creados en Experience Platform.

Consulte la documentación del Experience Platform para el grupo de campos de esquema Detalles de pertenencia a audiencias si necesita instrucciones sobre los estados de audiencia.

Oracle Eloqua requisitos previos prerequisites-destination

Para exportar datos de Platform a su cuenta de Oracle Eloqua, necesita tener una cuenta de Oracle Eloqua.

Además, necesita, como mínimo, los "Usuarios avanzados - Permisos de marketing" para su instancia de Oracle Eloqua. Consulte la sección "Grupos de seguridad" en la página Acceso seguro de usuarios para obtener instrucciones. El destino requiere acceso para determinar mediante programación la dirección URL base al invocar la API Oracle Eloqua.

Recopilar Oracle Eloqua credenciales gather-credentials

Observe los elementos siguientes antes de autenticarse en el destino Oracle Eloqua:

Consulte Iniciar sesión en Oracle Eloqua para obtener instrucciones.

Mecanismos de protección guardrails

Identidades admitidas supported-identities

Oracle Eloqua admite la actualización de las identidades descritas en la tabla siguiente. Más información sobre identidades.

Tipo y frecuencia de exportación export-type-frequency

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Conexión al destino connect

Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.

En destinos > catálogo, busque (API) Oracle Eloqua. También puede encontrarlo en la categoría Marketing por correo electrónico.

Autenticarse en el destino authenticate

Rellene los campos obligatorios siguientes. Consulte la sección Recopilar Oracle Eloqua credenciales para obtener instrucciones.

Para autenticarse en el destino, seleccione Conectarse al destino.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Conectado con una marca de verificación verde. A continuación, puede continuar con el paso siguiente.

Rellenar detalles de destino destination-details

Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.

Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar públicos en este destino activate

Lea Activar perfiles y audiencias en destinos de exportación de audiencias de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.

Consideraciones sobre asignación y ejemplo mapping-considerations-example

Para enviar correctamente los datos de audiencia de Adobe Experience Platform al destino Oracle Eloqua, debe pasar por el paso de asignación de campos. La asignación consiste en crear un vínculo entre los campos de esquema del Modelo de datos de experiencia (XDM) en la cuenta de Platform y sus equivalentes correspondientes desde el destino de destino.

Para asignar los campos XDM a los campos de destino Oracle Eloqua, siga estos pasos:

{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

Cuando termine de proporcionar las asignaciones para la conexión de destino, seleccione Siguiente.

Validar exportación de datos exported-data

Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:

Uso de datos y gobernanza data-usage-governance

Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, consulte la Información general sobre el control de datos.

Errores y solución de problemas errors-and-troubleshooting

Al crear el destino, podría recibir uno de los siguientes mensajes de error: 400: There was a validation error o 400 BAD_REQUEST. Esto sucede cuando se supera el límite de 250 campos de contacto personalizados, tal como se describe en la sección protecciones. Para corregir este error, asegúrese de no exceder el límite del campo de contacto personalizado en Oracle Eloqua.

Consulte las páginas Oracle Eloqua Códigos de estado HTTP y Oracle Eloqua Errores de validación para obtener una lista completa del estado y los códigos de error con explicaciones.

Recursos adicionales additional-resources

Para obtener más información, consulte la documentación de Oracle Eloqua:

Changelog

Esta sección recoge la funcionalidad y las actualizaciones significativas de la documentación realizadas en este conector de destino.