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 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.
Un ejemplo de configuración en Dynamics 365 se muestra a continuación:
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:
Client ID
ababbaba-abab-baba-acac-acacacacacac
Client Secret
abcde~abcdefghijklmnopqrstuvwxyz12345678
para obtener orientación.Tenant ID
1234567-aaaa-12ab-ba21-1234567890
Region
Consulte la Dynamics 365 documentación para obtener orientación.
org57771b33.
crm
.dynamics.comPor 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
org57771b33
.crm.dynamics.comMecanismos 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.
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.
- 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.
- 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 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.
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 seleccionarcrm
. Si su empresa está aprovisionada en la región de Canadá (CAN), su dirección URL seríacrm3.dynamics.com
y debe seleccionarcrm3
. - 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.
- 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
- Para activar los datos, necesita el Ver 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.
- Para exportar identidades, necesita el Ver gráfico de identidad permiso de control de acceso.
{width="100" modal="regular"}
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:
-
En el Asignación paso, seleccione Añadir nueva asignación. Verá una nueva fila de asignación en la pantalla.
-
En el Seleccionar campo de origen , seleccione la Seleccionar área de nombres de identidad categoría y seleccione
contactid
.
-
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.
-
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.
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.
- Los nombres de los campos de destino deben estar en
-
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:
-
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.
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:
-
Seleccionar Destinos > Examinar para ir a la lista de destinos.
-
Seleccione el destino y valide que el estado es activado.
-
Cambie a la 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 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.
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.
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.
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. |