(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 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 se puede utilizar 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 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 prerequisites-destination

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 gather-credentials

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

Credencial
Descripción
Company Name
El nombre de la empresa asociada con su Oracle Eloqua cuenta.
Más adelante utilizará la variable Company Name y Oracle Eloqua Username como una cadena concatenada que se utilizará como Nombre de usuario cuando autenticación en el destino.
Username
El nombre de usuario de su Oracle Eloqua cuenta.
Password
La 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, 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 su pod es p01. Consulte la determinación del POD página para obtener más información.

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

Mecanismos de protección guardrails

NOTE
  • Oracle Eloqua los campos de contacto personalizados se crean automáticamente con los nombres de las audiencias seleccionadas durante la Seleccionar segmentos paso.
  • 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 supported-identities

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

Identidad de destino
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
Basado en perfiles
  • Está exportando 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 campo.
  • Para cada audiencia seleccionada en Platform, la correspondiente Oracle Eloqua El estado del segmento se actualiza con su estado de audiencia de Platform.
Frecuencia de exportación
Transmisión
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según 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.

Conexión al destino connect

IMPORTANT
Para conectarse al destino, necesita el Ver destinos y Administrar destinos permisos de control de acceso. Lea el información general de 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 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 authenticate

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.
Captura de pantalla de la IU de Platform que muestra cómo autenticarse.

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 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.
Captura de pantalla de la IU de Platform que muestra los detalles del destino.

  • 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 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 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 activate

IMPORTANT

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 mapping-considerations-example

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:

      Ejemplo de captura de pantalla de la IU de Platform con asignaciones de atributos.

IMPORTANT
  • Atributos especificados en la variable Campo de destino debe tener exactamente el nombre especificado en la variable Create a contact ya que estos atributos forman el cuerpo de la solicitud.
  • Atributos especificados en la variable Campo de origen no siga ninguna de estas restricciones. Puede asignarlo según sus necesidades, pero si el formato de datos no es correcto cuando se inserta en Oracle Eloqua se producirá un error. Por ejemplo, puede asignar el Campo de origen área de nombres de identidad contact key, ABC ID etc. hasta Campo de destino : EloquaId después de asegurarse de que los valores de ID coinciden con el formato aceptado por Oracle Eloqua.
  • El EloquaID la asignación es obligatoria para actualizar los atributos correspondientes a la identidad.
  • El emailAddress se requiere la asignación. 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 haya terminado de proporcionar las asignaciones para la conexión de destino, seleccione Siguiente.

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 la Validar exportación de datos captura de pantalla de sección ejemplo de un Oracle Eloqua Página de detalles del contacto con campo de contacto personalizado creado con los nombres de las audiencias.

Validar exportación de datos exported-data

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.
    Captura de pantalla de la IU de Platform que muestra los 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.
    Captura de pantalla de la IU de Platform que muestra el 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.

Captura de pantalla de la IU de Eloqua de oracle 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

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 errors-and-troubleshooting

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.
Captura de pantalla de la IU de Platform que muestra un error.

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 additional-resources

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

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
  • Hemos actualizado la casos de uso con un ejemplo más claro de cuándo se beneficiarían los clientes de utilizar este destino.
  • Hemos actualizado la asignación con ejemplos claros de asignaciones obligatorias y opcionales.
  • Hemos actualizado la Conectar con el destino con un ejemplo sobre cómo construir el valor concatenado para la variable Nombre de usuario mediante el campo Oracle Eloqua Nombre de la empresa y Oracle Eloqua Nombre de usuario. (PLATIR-28343)
  • Hemos actualizado la Reunir Oracle Eloqua credenciales y el Rellenar detalles de destino secciones con directrices sobre Oracle Eloqua Pod selección. El "Pod" El valor lo utiliza el destino para construir la dirección URL base para las llamadas de API. El Oracle Eloqua requisitos previos También se ha actualizado esta sección con directrices sobre la asignación de "Usuarios avanzados: permisos de marketing" como obligatorio "Grupos de seguridad" para su Oracle Eloqua ejemplo.
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