(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 insight 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 utiliza Authentication básicos para comunicarse con la API de Oracle Eloqua REST. 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 de en línea quiere transmitir un campaña de marketing basado en correo electrónico a un audiencia curado de clientes potenciales. Los equipo marketing de la plataforma pueden actualizar la información de posible cliente existente a través de Adobe Experience Platform, versión 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 campaña de marketing.

Requisitos previos prerequisites

Requisitos previos de 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 de 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 Experience Platform a su cuenta de Oracle Eloqua, necesita tener una cuenta de Oracle Eloqua.

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

Recopilar Oracle Eloqua credenciales gather-credentials

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

Credencial
Descripción
Company Name
Nombre compañía asociado a su Oracle Eloqua cuenta.
Más adelante utilizará el Company Name y Oracle Eloqua Username como una cadena concatenada que se utilizará como Username al ​ autenticarse en el destino.
Username
Nombre de usuario de su Oracle Eloqua cuenta.
Password
El contraseña de su Oracle Eloqua cuenta.
Pod
Oracle Eloqua Admite varios centros de datos, cada uno con un nombre de dominio único. Oracle Eloqua Se refiere a estos como "pods", actualmente hay siete en total: P01, P02, P03, P04, P06, P07 y P08. Para obtener en qué POD se encuentra, inicio de sesión y Oracle Eloqua anote el URL en su explorador después de haber iniciado sesión correctamente. Por ejemplo, si la dirección URL de su explorador es secure.p01.eloqua.com, su pod es p01. Consulte la página determinar su POD para obtener más información.

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

Mecanismos de protección guardrails

NOTE
  • Oracle Eloqua campos de contacto personalizados se crean automáticamente con los nombres de las audiencias seleccionadas durante el paso Select segments.
  • 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 Experience Platform y el número de audiencias existentes dentro de Oracle Eloqua no superen este límite.

  • Si se supera este límite, se producirá un error al Experience Platform. Esto se debe a que la Oracle Eloqua API no valida el solicitud y responde con un - 400: Hubo un 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 página Oracle Eloqua Creando campos de contacto para obtener información sobre los límites adicionales.

Identidades admitidas supported-identities

Oracle Eloqua Admite la actualización de identidades descrita en la tabla siguiente. Obtenga más información sobre las identidades.

Target Identidad
Descripción
Obligatorio
EloquaId
Identificador único del contacto.

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.

Elemento
Tipo
Notas
Tipo de exportación
Profile-based
  • Va a exportar todos los miembros de un segmento, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), según la asignación de campos.
  • Para cada audiencia seleccionada en Experience Platform, el estado del segmento Oracle Eloqua correspondiente se actualiza con su estado de audiencia de Experience Platform.
Frecuencia de exportación
Streaming
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform basado en la evaluación de audiencias, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.

Conectar con el destino connect

IMPORTANT
Para conectarse al destino, necesita los View Destinations y Manage Destinations permisos de control de acceso. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

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 Destinations > Catalog buscar (API) Oracle Eloqua. También puede ubicarlo en la categoría Email Marketing.

Autenticarse en el destino authenticate

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

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

Para autenticarse en el destino, seleccione Connect to destination.
Experience Platform IU captura de pantalla muestra cómo autenticarse.

Si los detalles proporcionados son válidos, el IU muestra un Connected estado 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.
Experience Platform IU captura de pantalla mostrar los detalles del destino.

  • Name: nombre con el que reconocerá este destino en el futuro.
  • Description: una descripción que le ayudará a identificar este destino en el futuro.
  • Pod: para obtener en qué pod se encuentra, inicie sesión en Oracle Eloqua y anote la dirección URL en su explorador después de haber iniciado sesión correctamente. Por ejemplo, si la dirección URL del explorador es secure.p01.eloqua.com, el valor pod que debe seleccionar es p01. Consulte la sección Recopilar Oracle Eloqua credenciales para obtener instrucciones adicionales.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos hacia su destino. Seleccione una alerta de la lista a 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 haya terminado de proporcionar detalles para la conexión de destino, seleccione Next.

Activar públicos en este destino activate

IMPORTANT
  • Para activar los datos, necesita los View Destinations permisos Activate Destinations , View Profiles, View Segments, y ​ ​control de acceso. Lea la control de acceso descripción general​ o póngase en contacto con el ​administrador del producto para obtener los permisos necesarios.
  • Para exportar identidades, necesita el View Identity Graph permiso de control de acceso.
    Seleccione el área de nombres de identidad resaltada en el flujo de trabajo para activar audiencias en los destinos. {width="100" modal="regular"}

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 vincular entre el Modelo de datos de experiencia (XDM) esquema los campos del cuenta de Experience Platform y sus equivalentes correspondientes del destino destino.

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

  1. En el paso Mapping, seleccione Add new mapping. Verá una nueva fila de asignación en la pantalla.

  2. En la ventana Select source field, elija la categoría Select attributes y seleccione el atributo XDM o elija Select identity namespace y seleccione una identidad.

  3. En la ventana Select target field, elija Select identity namespace y seleccione una identidad, o bien elija Select custom attributes y escriba el nombre de atributo deseado en el campo Attribute name. El nombre de atributo que proporcione debe coincidir con un atributo de contacto existente en Oracle Eloqua. Consulte create a contact los nombres de atributo exactos que puede utilizar en Oracle Eloqua.

    • Repita estos pasos para agregar las asignaciones de atributos necesarias y las deseadas entre su esquema de perfil XDM y :Oracle Eloqua

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3
      Campo de origen Campo de destino Obligatorio
      IdentityMap: Eid Identity: EloquaId
      xdm: personalEmail.address Attribute: emailAddress
      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:
      Ejemplo de captura de pantalla de IU de Experience Platform con asignaciones de atributos.

IMPORTANT
  • Los atributos especificados en Target field deben tener exactamente el nombre especificado en Create a contact, ya que formarán el cuerpo de la solicitud.
  • Los atributos especificados en Source field no siguen ninguna restricción de este tipo. Puede asignarlo según sus necesidades. Sin embargo, si el formato de datos no es correcto cuando se inserta en Oracle Eloqua, se producirá un error. Por ejemplo, puede asignar el área de nombres de identidad Source field contact key, ABC ID, etc. a Target field : EloquaId después de asegurarse de que los valores de ID coinciden con el formato aceptado por Oracle Eloqua.
  • La asignación EloquaID es obligatoria para actualizar los atributos correspondientes a la identidad.
  • Se requiere la asignación emailAddress. Sin ella, la API genera un error como se muestra a continuación:
code language-json
{
     "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 Next.

NOTE
El destino sufijo automáticamente un identificador único a los nombres de audiencia seleccionados en cada ejecución al enviar la información del campo de contacto a Oracle Eloqua. Esto garantiza que los nombres de los campos de contacto correspondientes a sus nombres de audiencia no se superpongan. Consulte el ejemplo de captura de pantalla de la sección Validar exportación de datos de una página de detalles de contacto de Oracle Eloqua con un campo de contacto personalizado creado con los nombres de audiencia.

Validar exportación de datos exported-data

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

  1. Seleccione Destinations > Browse y vaya a la lista de destinos.

  2. A continuación, seleccione el destino y cambie a la pestaña Activation data; luego, seleccione un nombre de audiencia.
    Ejemplo de captura de pantalla de la IU de Experience Platform que muestra datos de activación de destinos.

  3. Monitorice el resumen de audiencia y asegúrese de que el recuento de perfiles corresponde al recuento dentro del segmento.
    Ejemplo de captura de pantalla de la IU de Experience Platform que muestra el segmento.

  4. Inicie sesión en el sitio web de Oracle Eloqua y luego vaya a la página de Contacts Overview para comprobar si se han agregado los perfiles de la audiencia. Para ver el estado de la audiencia, explore en profundidad una página de Contact Detail y compruebe si se ha creado el campo de contacto con el nombre de audiencia seleccionado como prefijo.

Captura de pantalla de la interfaz de usuario de Oracle Eloqua que muestra la página Detalles de contacto con el campo de contacto personalizado creado con el nombre de la audiencia.

Uso de datos y gobernanza data-usage-governance

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

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

Al crear el destino, es posible que reciba uno de los siguientes mensajes de error: 400: There was a validation error o 400 BAD_REQUEST. Esto sucede cuando excede el límite de 250 campos de contacto personalizados, como se describe en la sección de barandillas. Para solucionar este error, asegúrese de que no está superando el límite del campo de contacto personalizado en Oracle Eloqua.
Experience Platform IU captura de pantalla mostrando un error.

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.

Ver registro de cambios
table 0-row-3 1-row-3 2-row-3 layout-auto
Mes de lanzamiento Tipo de actualización Descripción
Abril de 2023 Actualización de documentación
  • Actualizamos la sección de casos de uso con un ejemplo más claro de cuándo los clientes se beneficiarían del uso de este destino.
  • Actualizamos la sección de mapeo con ejemplos claros de mapeos obligatorios y opcionales.
  • Hemos actualizado la sección Conectar al destino con un ejemplo sobre cómo construir el valor concatenado para el Username campo mediante el nombre de empresa Oracle Eloqua y el nombre de Oracle Eloqua usuario. (PLATIR-28343)
  • Actualizamos las secciones Recopilar Oracle Eloqua credenciales y Rellenar detalles de destino con instrucciones sobre la selección de Oracle Eloqua Pod. El valor "Pod" lo usa el destino para construir la dirección URL base para las llamadas a la API. La sección Oracle Eloqua requisitos previos también se actualizó con instrucciones para asignar "Usuarios avanzados - Permisos de marketing" como "Grupos de seguridad" necesarios para su instancia de Oracle Eloqua.
Marzo de 2023 Versión inicial Versión de destino inicial y publicación de documentación.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6