Microsoft Dynamics 365 conexión

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

Este Adobe Experience Platform destino aprovecha Contact Entity Reference API, lo que le permite actualizar identidades dentro de una audiencia en Dynamics 365.

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

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 generar 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 datos en el destino Dynamics 365, debe tener un esquema, un conjunto de datos y audiencias creados en Experience Platform.

Consulte la documentación de Adobe para el grupo de campos de esquema Detalles de pertenencia a audiencias si necesita instrucciones sobre los estados de audiencia.

Microsoft Dynamics 365 requisitos previos prerequisites-destination

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

Necesita tener una cuenta de Microsoft Dynamics 365 prerequisites-account

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

Crear campo dentro de Dynamics 365 prerequisites-custom-field

Cree el campo personalizado de tipo Simple con el tipo de datos de campo Single Line of Text que el Experience Platform utilizará para actualizar el estado de la audiencia en Dynamics 365.

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

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

A continuación se muestra un ejemplo de configuración en Dynamics 365:
Captura de pantalla de la interfaz de usuario 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 permitir que Dynamics 365 acceda a los recursos, deberá iniciar sesión con su Azure Account en Azure Active Directory y crear lo siguiente:

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

También necesitará crear un usuario de aplicación en Azure Active Directory y asociarlo con la aplicación recién creada.

Recopilar Dynamics 365 credenciales gather-credentials

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

Credencial
Descripción
Ejemplo
Client ID
Identificador de cliente Dynamics 365 para su aplicación Azure Active Directory. Consulte la Dynamics 365 documentación para obtener instrucciones.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Secreto de cliente Dynamics 365 para su aplicación Azure Active Directory. Utilizaría la opción #2 en la Dynamics 365 documentación.
abcde~abcdefghijklmnopqrstuvwxyz12345678 como guía.
Tenant ID
Identificador de inquilino Dynamics 365 para su aplicación Azure Active Directory. Consulte la Dynamics 365 documentación para obtener instrucciones.
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 instrucciones.
Si su dominio es como se muestra a continuación, debe proporcionar el valor resaltado para el campo CRM en el selector desplegable al autenticarse en destino.
org57771b33.crm.dynamics.com
Por ejemplo: Si su compañía está aprovisionada en la región de Norteamérica (NAM), su 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 necesita seleccionar crm3.
Environment URL
Consulte la Dynamics 365 documentación para obtener instrucciones.
Si el dominio Dynamics 365 es como se muestra a continuación, necesita el valor resaltado.
org57771b33.crm.dynamics.com

Mecanismos de protección guardrails

La página Límites de solicitudes y asignaciones detalla los límites de API Dynamics 365 asociados con su licencia de Dynamics 365. 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 las identidades descritas 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 perfil
  • Va a exportar 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 campos.
  • Cada estado de audiencia de Dynamics 365 se actualiza con el estado de audiencia correspondiente de Platform, según el valor de ID de asignación proporcionado durante el paso programación de audiencia.
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 los permisos de control de acceso de Ver destinos] y Administrar destinos[5}. 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 destinos > catálogo, busque Dynamics 365. También puede ubicarlo en la categoría CRM.

Autenticarse en el destino authenticate

Para autenticarse en el destino, seleccione Conectarse al destino.
Captura de pantalla de IU de Platform que muestra cómo autenticarse.

Rellene los campos obligatorios siguientes. Consulte la sección Recopilar credenciales de Dynamics 365 para obtener instrucciones.

  • ID de cliente: El ID de cliente Dynamics 365 para su aplicación Azure Active Directory.
  • ID de inquilino: El ID de inquilino de Dynamics 365 para su aplicación de Azure Active Directory.
  • Secreto de cliente: El secreto de cliente Dynamics 365 para su aplicación Azure Active Directory.
  • Región: Tu Región Dynamics 365. Por ejemplo: si su empresa está aprovisionada en la región de América del Norte (NAM), su 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 necesita seleccionar crm3.
  • URL de entorno: La URL de entorno Dynamics 365.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Conectado 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 IU de Platform que muestra los detalles del destino.

  • Nombre: Un nombre por el cual 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: El Customization prefix del campo personalizado que creó en Dynamics 365. Consulte la sección Crear y editar campos de la documentación de 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 sobre suscripción a alertas de destinos mediante la interfaz de usuario.

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

Activar públicos en este destino activate

IMPORTANT
  • Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentospara. 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 exportar identidades, necesita el permiso de control de acceso de] Ver gráfico de identidad[.
    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 Dynamics 365, debe pasar por el 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 los campos de destino Dynamics 365, siga estos pasos:

  1. En el paso Asignación, seleccione Agregar nueva asignación. Verá una nueva fila de asignación en la pantalla.
    Ejemplo de captura de pantalla de IU de Platform para agregar nueva asignación.

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

  3. En la ventana 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 IU de Platform que muestra la asignación de Target para contactid.

    • Agregue la siguiente asignación entre su esquema de perfil XDM y su instancia Dynamics 365:
      |Esquema de perfil XDM|Dynamics 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 el campo Nombre de atributo. Consulte Dynamics 365 documentación para obtener una lista completa de los atributos admitidos.

      Captura de pantalla de IU de Platform que muestra la asignación de destino 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 un campo de destino Dynamics 365 fecha o marca de hora, asegúrese de que el valor asignado no esté vacío. Si el valor del campo exportado está vacío, aparecerá un mensaje de error Bad request reported while pushing events to the destination. Please contact the administrator and try again. y los datos no se actualizarán. Esta es una limitación de Dynamics 365.
    • Por ejemplo, según los valores que desee actualizar, agregue la siguiente asignación entre el esquema de perfil XDM y la instancia Dynamics 365:
      |Esquema de perfil XDM|Dynamics 365 instancia|
      |—|—|
      |person.name.firstName|firstname|
      |person.name.lastName|lastname|
      |personalEmail.address|emailaddress1|

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

      Ejemplo de captura de pantalla de IU de Platform que muestra asignaciones de Target.

Programar exportación de audiencias y ejemplo schedule-audience-export-example

En el paso 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 de Dynamics 365 en el campo ID de asignación.

IMPORTANT
El valor usado 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 sus campos personalizados.

A continuación se muestra un ejemplo:
Ejemplo de 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. Seleccione Destinos > Examinar para navegar a la lista de destinos.
    Captura de pantalla de IU que muestra destinos de exploración.

  2. Seleccione el destino y valide que el estado es enabled.
    Captura de pantalla de IU de Platform que muestra la ejecución del flujo de datos de destinos.

  3. Cambie a la ficha Activation data y, a continuación, seleccione un nombre de audiencia.
    Ejemplo de captura de pantalla de IU de Platform que muestra 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.
    Ejemplo de captura de pantalla de IU de Platform que muestra la audiencia.

  5. Inicie sesión en el sitio web de Dynamics 365, luego vaya a la página Customers > Contacts y compruebe si se han agregado los perfiles de la audiencia. Puede ver que cada estado de audiencia en Dynamics 365 se actualizó con el estado de audiencia correspondiente de Platform, según el valor de ID de asignación proporcionado durante el paso programación de audiencia.
    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

Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, consulte la Información general sobre el control 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 IU de plataforma que muestra error de solicitud incorrecto.

Para corregir este error, compruebe que la ID de asignación que ha proporcionado en Dynamics 365 para la audiencia de Platform sea válida y exista en Dynamics 365.

Recursos adicionales additional-resources

A continuación encontrará información útil adicional de la Dynamics 365 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 3-row-3 layout-auto
Mes de lanzamiento Tipo de actualización Descripción
Octubre de 2023 Actualización de documentación Se ha actualizado la guía para indicar que todos los nombres de atributos de destino deben estar en minúsculas, en el paso Consideraciones de asignación y ejemplo.
Agosto de 2023 Actualización de funcionalidad y documentación Se agregó compatibilidad con Dynamics 365 prefijos de campo personalizados para campos personalizados que no se crearon dentro de la solución predeterminada en Dynamics 365. Se ha agregado un nuevo campo de entrada Prefijo de personalización en el paso Rellenar detalles de destino. (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