Microsoft Dynamics 365 conexión

Información general

Microsoft Dynamics 365 es una plataforma de aplicaciones empresariales basada en la nube que combina Planificación de recursos empresariales (ERP) y Gestión de relaciones con el cliente (CRM) junto con aplicaciones de productividad y herramientas de IA, para ofrecer operaciones de extremo a extremo más suaves y controladas, un mejor potencial de crecimiento y costes reducidos.

Esta Adobe Experience Platform destino aprovecha el Contact Entity Reference API, que le permite actualizar identidades dentro de un segmento en Dynamics 365.

Dynamics 365 utiliza OAuth 2 con la concesión de autorización como mecanismo de autenticación para comunicarse con Contact Entity Reference API. Instrucciones para autenticarse en su Dynamics 365 más abajo, en la sección Autenticar en el destino sección.

Casos de uso

Como experto en marketing, puede ofrecer experiencias personalizadas a los usuarios en función de los atributos de sus perfiles de Adobe Experience Platform. Puede generar segmentos a partir de los datos sin conexión y enviarlos a Dynamics 365, para que se muestren en las fuentes de los usuarios en cuanto los segmentos y perfiles se actualicen en Adobe Experience Platform.

Requisitos previos

Requisitos previos del Experience Platform

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

Consulte la documentación del Adobe para Grupo de campos de esquema Detalles de pertenencia a segmento si necesita orientación sobre los estados de los segmentos.

Microsoft Dynamics 365 requisitos previos

Tenga en cuenta los siguientes requisitos previos Dynamics 365, para exportar datos de Platform a su Dynamics 365 cuenta:

Necesita tener un Microsoft Dynamics 365 account

Vaya a la Dynamics 365 prueba página para registrarse y crear una cuenta, si todavía no la tiene.

Crear campo en Dynamics 365

Crear el campo personalizado de tipo Simple con tipo de datos de campo como Single Line of Text qué Experience Platform utilizará para actualizar el estado del segmento en Dynamics 365.
Consulte la Dynamics 365 documentación para crear un campo (atributo) si necesita orientación adicional.

Un ejemplo de configuración en Dynamics 365 se muestra a continuación:
Captura de pantalla de la IU de Dynamics 365 que muestra los campos personalizados.

Registrar una aplicación y un usuario de aplicación en Azure Active Directory

Para habilitar Dynamics 365 para acceder a los recursos, deberá iniciar sesión con su Azure Account hasta Azure Active Directory y cree lo siguiente:

  • Un Azure Active Directory aplicación
  • Una entidad de servicio
  • Un secreto de aplicación

También deberá hacer lo siguiente crear un usuario de aplicación in Azure Active Directory y asociarlo a la aplicación recién creada.

Reunir Dynamics 365 credenciales

Tenga en cuenta los elementos siguientes antes de autenticarse en el Dynamics 365 Destino de CRM:

Credencial Descripción Ejemplo
Client ID El Dynamics 365 ID de cliente para su Azure Active Directory aplicación. Consulte la Dynamics 365 documentación para obtener orientación. ababbaba-abab-baba-acac-acacacacacac
Client Secret El Dynamics 365 Secreto del cliente para su Azure Active Directory aplicación. Utilizaría la opción #2 dentro del Dynamics 365 documentación. abcde~abcdefghijklmnopqrstuvwxyz12345678 para obtener orientación.
Tenant ID El Dynamics 365 ID de inquilino para su Azure Active Directory aplicación. Consulte la Dynamics 365 documentación para obtener orientación. 1234567-aaaa-12ab-ba21-1234567890
Environment URL Consulte la Dynamics 365 documentación para obtener orientación. Si su Dynamics 365 El dominio es el siguiente, necesita el valor resaltado.
org57771b33.crm.dynamics.com

Mecanismos de protección

El Límites de solicitudes y asignaciones La página detalla Dynamics 365 Límites de API asociados con su Dynamics 365 licencia. Debe asegurarse de que los datos y la carga útil se encuentren dentro de estas restricciones.

Identidades admitidas

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

Identidad de destino Ejemplo Descripción Consideraciones
contactId 7eb682f1-ca75-e511-80d4-00155d2a68d1 Identificador único de un contacto. Obligatorio. Consulte la Dynamics 365 documentación para obtener más información.

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.

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.
  • Cada estado del segmento en Dynamics 365 se actualiza con el estado del segmento correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante la programación de segmentos paso.
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 segmentos, 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

IMPORTANTE

Para conectarse al destino, necesita el Administrar destinos permiso 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 Dynamics 365. También puede encontrarlo en la sección CRM categoría.

Autenticar en el destino

Para autenticarse en el destino, seleccione Conectar con destino.
Captura de pantalla de la IU de Platform que muestra cómo autenticarse.

Rellene los campos obligatorios siguientes. Consulte la Recopilar credenciales de Dynamics 365 para obtener cualquier guía.

  • ID de cliente: La Dynamics 365 ID de cliente para su Azure Active Directory aplicación.
  • ID de inquilino: La Dynamics 365 ID de inquilino para su Azure Active Directory aplicación.
  • Secreto del cliente: La Dynamics 365 Secreto del cliente para su Azure Active Directory aplicación.
  • URL de entorno: su Dynamics 365 URL de entorno.

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.
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.

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 segmentos en este destino

IMPORTANTE

Para activar los datos, necesita el Administrar destinos, Activar destinos, Ver perfiles, y Ver segmentos 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.

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

Consideraciones sobre asignación y ejemplo

Para enviar correctamente los datos de audiencia de Adobe Experience Platform a Dynamics 365 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 correctamente los campos XDM a Dynamics 365 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.
    Ejemplo de captura de pantalla de la IU de Platform para Añadir nueva asignación.

  2. En el Seleccionar campo de origen , seleccione la Seleccionar área de nombres de identidad categoría y seleccione contactId.
    Ejemplo de captura de pantalla de la IU de Platform para asignación de origen.

  3. En el Seleccionar campo de destino , seleccione el tipo de campo de destino al que desea asignar el campo de origen.

    • Seleccionar área de nombres de identidad: seleccione esta opción para asignar el campo de origen a un área de nombres de identidad de la lista.

      Captura de pantalla de la IU de Platform que muestra la asignación de Target para contactId.

    • Añada la siguiente asignación entre su esquema de perfil XDM y su Dynamics 365 instancia: Esquema de perfil XDMDynamics 365 Instancia| Obligatoria| |—|—|—| |contactId|contactId| Sí |

    • Seleccionar atributos personalizados: seleccione esta opción para asignar el campo de origen a un atributo personalizado que defina en la Nombre de atributo field. Consulte Dynamics 365 documentación para obtener una lista completa de los atributos admitidos.

      Captura de pantalla de la IU de Platform que muestra la asignación de Target para LastName.

      IMPORTANTE

      Si tiene un campo de origen de fecha u hora asignado a una Dynamics 365 fecha o marca de tiempo campo de destino, asegúrese de que el valor asignado que se está mostrando no esté vacío. Si el valor pasado está vacío, se encontrará con un Bad request reported while pushing events to the destination. Please contact the administrator and try again. mensaje de error y los datos no se actualizarán. Este es un Dynamics 365 limitación.

    • Por ejemplo, según los valores que desee actualizar, añada la siguiente asignación entre el esquema de perfil XDM y la variable Dynamics 365 instancia: Esquema de perfil XDMDynamics 365 Instancia| |—|—| |person.name.firstName|FirstName| |person.name.lastName|LastName| |personalEmail.address|Email|

    • A continuación se muestra un ejemplo con estas asignaciones:

      Captura de pantalla de la IU de Platform que muestra asignaciones de Target.

Programar exportación de segmentos y ejemplo

En el Programar exportación de segmentos del flujo de trabajo de activación, debe asignar manualmente los segmentos de Platform al atributo de campo personalizado en Dynamics 365.

Para ello, seleccione cada segmento e introduzca el atributo de campo personalizado correspondiente en Dynamics 365 en el ID de asignación field.

IMPORTANTE

El valor utilizado para ID de asignación debe coincidir exactamente con el nombre del atributo de campo personalizado creado en Dynamics 365. Consulte Dynamics 365 documentación si necesita ayuda para encontrar los atributos de campo personalizados.

A continuación se muestra un ejemplo:
Captura de pantalla de la IU de Platform que muestra Programar exportación de segmentos.

Validar exportación de datos

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

  1. Seleccionar Destinos > Examinar para ir a la lista de destinos.
    Captura de pantalla de la IU de Platform que muestra destinos de exploración.

  2. Seleccione el destino y valide que el estado es activado.
    Captura de pantalla de la IU de Platform que muestra Destinations Dataflow Run.

  3. Cambie a la Activation data y, a continuación, seleccione un nombre de segmento.
    Captura de pantalla de la IU de Platform que muestra los datos de activación de destinos.

  4. Monitorice el resumen del segmento y asegúrese de que el recuento de perfiles corresponde al recuento creado dentro del segmento.
    Captura de pantalla de la IU de Platform que muestra el segmento.

  5. Inicie sesión en Dynamics 365 sitio web y, a continuación, vaya al Customers > Contacts y compruebe si se han añadido los perfiles del segmento. Puede ver que cada estado del segmento en Dynamics 365 se ha actualizado con el estado del segmento correspondiente de Platform, según el ID de asignación valor proporcionado durante la programación de segmentos paso.
    Captura de pantalla de la interfaz de usuario de Dynamics 365 que muestra la página Contactos con estados de segmento actualizados.

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

Se detectaron errores desconocidos al insertar eventos en el destino

Al comprobar la ejecución de un flujo de datos, si obtiene el siguiente mensaje de error: Bad request reported while pushing events to the destination. Please contact the administrator and try again.

Captura de pantalla de la IU de Platform que muestra un error de solicitud incorrecto.

Para corregir este error, compruebe que la variable ID de asignación ha proporcionado en Dynamics 365 El para el segmento de Platform es válido y existe en Dynamics 365.

Recursos adicionales

Información útil adicional del Dynamics 365 documentación se muestra a continuación:

En esta página