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.
A continuación se muestra un ejemplo de configuración en Dynamics 365:
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:
Client ID
ababbaba-abab-baba-acac-acacacacacac
Client Secret
abcde~abcdefghijklmnopqrstuvwxyz12345678
como guía.Tenant ID
1234567-aaaa-12ab-ba21-1234567890
Region
Consulte la Dynamics 365 documentación para obtener instrucciones.
org57771b33.
crm
.dynamics.comPor 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
org57771b33
.crm.dynamics.comMecanismos 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.
contactid
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.
- 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.
- 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
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.
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 seleccionarcrm
. Si su empresa está aprovisionada en la región de Canadá (CAN), su dirección URL seríacrm3.dynamics.com
y necesita seleccionarcrm3
. - 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.
- 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
- Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. 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[.
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:
-
En el paso Asignación, seleccione Agregar nueva asignación. Verá una nueva fila de asignación en la pantalla.
-
En la ventana Seleccionar campo de origen, elija la categoría Seleccionar área de nombres de identidad y seleccione
contactid
.
-
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.
-
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.
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.
- Los nombres de los campos de destino deben estar en
-
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:
-
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.
A continuación se muestra un ejemplo:
Validar exportación de datos exported-data
Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:
-
Seleccione Destinos > Examinar para navegar a la lista de destinos.
-
Seleccione el destino y valide que el estado es enabled.
-
Cambie a la ficha Activation data y, a continuación, seleccione un nombre de audiencia.
-
Monitorice el resumen de audiencia y asegúrese de que el recuento de perfiles corresponde al recuento creado dentro de la audiencia.
-
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.
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.
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.
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. |