(API) Oracle Eloqua conexión

Oracle Eloqua permite a los especialistas en marketing planificar y ejecutar campañas al tiempo que ofrecen una experiencia del 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.

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

Oracle Eloqua utiliza Autenticación básica para comunicarse con el Oracle Eloqua API DE REST. Instrucciones para autenticarse en su Oracle Eloqua más abajo, en la sección Autenticar en el destino sección.

Casos de uso

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 se puede utilizar para enviar el correo electrónico de la campaña de marketing.

Requisitos previos

Requisitos previos del Experience Platform

Antes de activar los datos en Oracle Eloqua destino, debe tener un esquema, a conjunto de datos, y segmentos creado en Experience Platform.

Consulte la documentación del Experience Platform para Grupo de campos de esquema Detalles de pertenencia a audiencia si necesita orientación sobre los estados de audiencia.

Oracle Eloqua requisitos previos

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

Además, necesita, como mínimo, el "Usuarios avanzados: permisos de marketing" para su Oracle Eloqua ejemplo. Consulte la "Grupos de seguridad" en la sección Acceso seguro del usuario página para obtener instrucciones. El destino requiere el acceso para programar determinar la dirección URL base al invocar el Oracle Eloqua API.

Reunir Oracle Eloqua credenciales

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

Consulte la Iniciando sesión en Oracle Eloqua para obtener orientación.

Mecanismos de protección

• Oracle Eloqua tiene un límite máximo de 250 campos de contacto personalizados.

• Antes de exportar nuevas audiencias, asegúrese de que el número de audiencias de Platform y el número de audiencias existentes dentro de Oracle Eloqua no supere este límite.

• Si se supera este límite, se producirá un error en el Experience Platform. Esto se debe a que Oracle Eloqua La API no puede validar la solicitud y responde con un - 400: Error de validación - mensaje de error que describe el problema.

• Si ha alcanzado el límite especificado anteriormente, debe eliminar las asignaciones existentes de su destino y eliminar los campos de contacto personalizados correspondientes en su Oracle Eloqua cuenta antes de poder exportar más segmentos.

• Consulte la Oracle Eloqua Creación de campos de contacto para obtener información sobre los límites adicionales.

Identidades admitidas

Oracle Eloqua admite la actualización de identidades que se describe en la tabla siguiente. Más información sobre identidades.

Tipo y frecuencia de exportación

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

Conexión al destino

Para conectarse a este destino, siga los pasos descritos en la sección 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 buscar (API) Oracle Eloqua. También puede encontrarlo en la sección Marketing por correo electrónico categoría.

Autenticarse en el destino

Rellene los campos obligatorios siguientes. Consulte la Reunir Oracle Eloqua credenciales para obtener cualquier guía.

• Contraseña: La contraseña de su Oracle Eloqua cuenta.
• Nombre de usuario: una cadena concatenada compuesta por su Oracle Eloqua Nombre de la empresa y Oracle Eloqua Nombre de usuario.
  El valor concatenado adopta la forma de {COMPANY_NAME}\{USERNAME}.
  Tenga en cuenta que no utilice llaves ni espacios y conserve \.
  Por ejemplo, si su Oracle Eloqua El nombre de empresa es MyCompany y Oracle Eloqua Nombre de usuario: Username, el valor concatenado que utilizará en el Nombre de usuario el campo es MyCompany\Username.

Para autenticarse en el destino, seleccione Conectar con destino.

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

Rellenar detalles de destino

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.

• Nombre: Un nombre con el que reconocerá este destino en el futuro.
• Descripción: Una descripción que le ayudará a identificar este destino en el futuro.
• Pod: para obtener qué pod está en, inicie sesión en Oracle Eloqua y anote la URL en el navegador después de haber iniciado sesión correctamente. Por ejemplo, si la dirección URL del explorador es secure.p01.eloqua.com el pod el valor que debe seleccionar es p01. Consulte la Reunir Oracle Eloqua credenciales para obtener más información.

Habilitar alertas

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 de suscripción a alertas de destinos mediante la IU.

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

Activar públicos en este destino

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

Consideraciones sobre asignación y ejemplo

Para enviar correctamente los datos de audiencia de Adobe Experience Platform a Oracle Eloqua destino, debe ir a través del 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 Oracle Eloqua campos de destino, siga estos pasos:

1. En el Asignación paso, seleccione Añadir nueva asignación. Verá una nueva fila de asignación en la pantalla.
2. En el Seleccionar campo de origen , seleccione la Seleccionar atributos y seleccione el atributo XDM o elija el Seleccionar área de nombres de identidad y seleccione una identidad.
3. En el Seleccionar campo de destino ventana, elija Seleccionar área de nombres de identidad y seleccione una identidad o elija Seleccionar atributos personalizados y escriba el nombre de atributo deseado en la Nombre de atributo field. El nombre de atributo que proporcione debe coincidir con un atributo de contacto existente en Oracle Eloqua. Consulte create a contact para los nombres de atributo exactos que puede utilizar en Oracle Eloqua.

   • Repita estos pasos para agregar las asignaciones de atributos necesarias y deseadas entre el esquema de perfil XDM y Oracle Eloqua: | Campo de origen | Campo de destino | Obligatorio | |—|—|—| |IdentityMap: Eid|Identity: EloquaId| Sí | |xdm: personalEmail.address|Attribute: emailAddress| Sí | |xdm: personName.firstName|Attribute: firstName| | |xdm: personName.lastName|Attribute: lastName| | |xdm: workAddress.street1|Attribute: address1| | |xdm: workAddress.street2|Attribute: address2| | |xdm: workAddress.street3|Attribute: address3| | |xdm: workAddress.postalCode|Attribute: postalCode| | |xdm: workAddress.country|Attribute: country| | |xdm: workAddress.city|Attribute: city| |

   • A continuación, se muestra un ejemplo con las asignaciones anteriores:

     

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

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

Validar exportación de datos

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

1. Seleccionar Destinos > Examinar y vaya a la lista de destinos.

2. A continuación, seleccione el destino y cambie a Datos de activación y, a continuación, seleccione un nombre de audiencia.
   

3. Monitorice el resumen de audiencia y asegúrese de que el recuento de perfiles corresponde al recuento dentro del segmento.
   

4. Inicie sesión en Oracle Eloqua sitio web y, a continuación, vaya al Información general de contactos para comprobar si se han añadido los perfiles de la audiencia. Para ver el estado de la audiencia, explore en profundidad un Detalles de contacto y compruebe si se ha creado el campo de contacto con el nombre de audiencia seleccionado como prefijo.

Uso de datos y gobernanza

Todo Adobe Experience Platform Los destinos de cumplen con las políticas de uso de datos al gestionar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica la gobernanza de datos. Consulte la Resumen de gobernanza de datos.

Errores y solución de problemas

Al crear el destino, puede 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 barandas sección. Para corregir este error, asegúrese de que no supera el límite del campo de contacto personalizado en Oracle Eloqua.

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

Recursos adicionales

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

• Oracle Eloqua Marketing Automation
• API de REST para el servicio de Marketing Cloud de Oracle Eloqua

Changelog

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