DocumentaciónExperience PlatformGuía de destinos

Microsoft Dynamics 365 conexión

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Admin
  • User

Información general overview

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 una audiencia 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 use-cases

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 crear audiencias a partir de los datos sin conexión y enviarlas a Dynamics 365, para que se muestren en las fuentes de los usuarios en cuanto las audiencias y los perfiles se actualicen en Adobe Experience Platform.

Requisitos previos prerequisites

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

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

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

Microsoft Dynamics 365 requisitos previos prerequisites-destination

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 prerequisites-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 prerequisites-custom-field

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 de audiencia en Dynamics 365.

Consulte la Dynamics 365 Crear o editar un campo (atributo) documentación de si necesita instrucciones adicionales.

Anote el Prefijo de personalización del campo personalizado que crea en Dynamics 365. Necesitará este prefijo durante la Rellenar detalles de destino paso. Consulte la Creación y edición de campos de la sección Dynamics 365 para obtener más información.
Captura de pantalla de la IU de Dynamics 365 que muestra el prefijo de personalización.

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 prerequisites-app-user

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

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
Region
La región de Microsoft asociada a la URL del entorno.
Consulte la Dynamics 365 documentación para obtener orientación.
Si el dominio es el siguiente, debe proporcionar el valor resaltado para el campo CRM en el selector desplegable al autenticarse en el destino.
org57771b33.crm.dynamics.com
Por ejemplo: si su empresa está aprovisionada en la región de América del Norte (NAM), la dirección URL sería crm.dynamics.com y debe seleccionar crm. Si su empresa está aprovisionada en la región de Canadá (CAN), su dirección URL sería crm3.dynamics.com y debe seleccionar crm3.
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 guardrails

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 supported-identities

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.

Audiencias compatibles supported-audiences

Esta sección describe todas las audiencias que puede exportar a este destino.

Este destino admite la activación de todas las audiencias generadas a través del Experience Platform Servicio de segmentación.

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 una audiencia, 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 de audiencia en Dynamics 365 se actualiza con el estado de audiencia correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante la programación de audiencia 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 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 Dynamics 365. También puede encontrarlo en la sección CRM categoría.

Autenticarse en el destino authenticate

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.
  • Región: su Dynamics 365 Región. Por ejemplo: si su empresa está aprovisionada en la región de América del Norte (NAM), la dirección URL sería crm.dynamics.com y debe seleccionar crm. Si su empresa está aprovisionada en la región de Canadá (CAN), su dirección URL sería crm3.dynamics.com y debe seleccionar crm3.
  • 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 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.
  • Prefijo de personalización: La Customization prefix del campo personalizado que ha creado en Dynamics 365. Consulte la Creación y edición de campos de la sección Dynamics 365 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 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| Obligatorio| |—|—|—| |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 correo electrónico.

      note important
      IMPORTANT
      • Los nombres de los campos de destino deben estar en lowercase.
      • Además, 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 no esté vacío. Si el valor del campo exportado está vacío, se mostrará 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|emailaddress1|

    • 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 audiencias y ejemplo schedule-audience-export-example

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

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

IMPORTANT
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 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 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 audiencia.
    Captura de pantalla de la IU de Platform que muestra los datos de activación de destinos.

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

  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 de la audiencia. Puede ver que cada estado de la audiencia en Dynamics 365 se ha actualizado con el estado de audiencia correspondiente de Platform, según el ID de asignación valor proporcionado durante la programación de audiencia paso.
    Captura de pantalla de la interfaz de usuario de Dynamics 365 que muestra la página Contactos con estados de audiencia actualizados.

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

Se detectaron errores desconocidos al insertar eventos en el destino unknown-errors

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 La para la audiencia de Platform es válida y existe en Dynamics 365.

Recursos adicionales additional-resources

Información útil adicional del Dynamics 365 documentación se muestra a continuació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 3-row-3 layout-auto
Mes de lanzamiento Tipo de actualización Descripción
Octubre de 2023 Actualización de documentación La guía actualizada para indicar todos los nombres de atributos de destino deben estar en minúsculas, en el Consideraciones sobre asignación y ejemplo paso.
Agosto de 2023 Actualización de funcionalidad y documentación Se ha añadido la compatibilidad con Dynamics 365 prefijos de campo personalizados para campos personalizados que no se crearon dentro de la solución predeterminada en Dynamics 365. Un nuevo campo de entrada, Prefijo de personalización, se ha añadido en la Rellenar detalles de destino paso. (PLATIR-31602).
Noviembre de 2022 Versión inicial Versión de destino inicial y publicación de documentación.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6