DocumentaçãoExperience PlatformGuia de destinos

Microsoft Dynamics 365 conexão

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

Criado para:

  • Admin
  • User

Visão geral overview

Microsoft Dynamics 365 O é uma plataforma de aplicativos de negócios baseada em nuvem que combina ERP (Enterprise Resource Planning, planejamento de recursos corporativos) e CRM (Customer Relationship Management, gerenciamento de relacionamento com o cliente), além de aplicativos de produtividade e ferramentas de IA, para oferecer operações completas, mais perfeitas e controladas, melhor potencial de crescimento e custos reduzidos.

Este Adobe Experience Platform destino utiliza o Contact Entity Reference API, que permite atualizar as identidades em um público-alvo para Dynamics 365.

Dynamics 365 O usa o OAuth 2 com concessão de autorização como mecanismo de autenticação para se comunicar com o Contact Entity Reference API. Instruções para autenticar em seu Dynamics 365 exemplo, são apresentados mais abaixo, no Autenticar para destino seção.

Casos de uso use-cases

Como profissional de marketing, você pode fornecer experiências personalizadas aos seus usuários com base em atributos de seus perfis do Adobe Experience Platform. Você pode criar públicos-alvo com base nos dados offline e enviá-los para Dynamics 365, para ser exibido nos feeds dos usuários assim que os públicos-alvo e os perfis forem atualizados no Adobe Experience Platform.

Pré-requisitos prerequisites

Pré-requisitos do Experience Platform prerequisites-in-experience-platform

Antes de ativar os dados para o Dynamics 365 destino, você deve ter um schema, um conjunto de dados, e públicos criado em Experience Platform.

Consulte a documentação do Adobe para Grupo de campos de esquema Detalhes da associação do público se precisar de orientação sobre os status do público-alvo.

Microsoft Dynamics 365 pré-requisitos prerequisites-destination

Observe os seguintes pré-requisitos em Dynamics 365, para exportar dados da Platform para o seu Dynamics 365 conta:

Você precisa ter um Microsoft Dynamics 365 account prerequisites-account

Vá para a Dynamics 365 avaliação para registrar e criar uma conta, se ainda não tiver uma.

Criar campo dentro de Dynamics 365 prerequisites-custom-field

Criar o campo personalizado do tipo Simple com tipo de dados de campo como Single Line of Text qual Experience Platform usará para atualizar o status do público-alvo no Dynamics 365.

Consulte a Dynamics 365 Criar ou editar um campo (atributo) se precisar de orientação adicional.

Anote o Prefixo de personalização do campo personalizado que você cria no Dynamics 365. Você precisará desse prefixo durante o Preencher detalhes do destino etapa. Consulte a Criar e editar campos seção do Dynamics 365 para obter mais detalhes.
Captura de tela da interface do Dynamics 365 mostrando o prefixo de personalização.

Um exemplo de configuração em Dynamics 365 é mostrado abaixo:
Captura de tela da interface do usuário do Dynamics 365 mostrando os campos personalizados.

Registrar um aplicativo e um usuário de aplicativo no Azure Ative Diretory prerequisites-app-user

Para habilitar Dynamics 365 para acessar os recursos, é necessário fazer logon com a Azure Account para Azure Active Directory e crie o seguinte:

  • Um Azure Active Directory aplicativo
  • Uma Entidade de serviço
  • Um segredo de aplicativo

Você também precisará criar um usuário do aplicativo in Azure Active Directory e associá-lo ao aplicativo recém-criado.

Coletar Dynamics 365 credenciais gather-credentials

Anote os itens abaixo antes de autenticar na Dynamics 365 Destino do CRM:

Credencial
Descrição
Exemplo
Client ID
A variável Dynamics 365 ID do cliente para o seu Azure Active Directory aplicação. Consulte a Dynamics 365 documentação para obter orientação.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
A variável Dynamics 365 Segredo do cliente para o seu Azure Active Directory aplicação. Você usaria a opção #2 dentro do Dynamics 365 documentação.
abcde~abcdefghijklmnopqrstuvwxyz12345678 para obter orientação.
Tenant ID
A variável Dynamics 365 ID de locatário para o seu Azure Active Directory aplicação. Consulte a Dynamics 365 documentação para obter orientação.
1234567-aaaa-12ab-ba21-1234567890
Region
A região do Microsoft associada ao URL do ambiente.
Consulte a Dynamics 365 documentação para obter orientação.
Se o seu domínio for como abaixo, você precisará fornecer o valor destacado para o campo CRM no seletor suspenso ao autenticar para o destino.
org57771b33crm.dynamics.com
Por exemplo: se sua empresa for provisionada na região da América do Norte (NAM), seu URL será crm.dynamics.com e você precisa selecionar crm. Se sua empresa for provisionada na região do Canadá (CAN), o URL será crm3.dynamics.com e você precisa selecionar crm3.
Environment URL
Consulte a Dynamics 365 documentação para obter orientação.
Se o seu Dynamics 365 for conforme abaixo, você precisará do valor realçado.
org57771b33.crm.dynamics.com

Medidas de proteção guardrails

A variável Limites de solicitações e alocações detalhes da página o Dynamics 365 Limites de API associados ao seu Dynamics 365 licença. Você precisa garantir que seus dados e carga estejam dentro dessas restrições.

Identidades suportadas supported-identities

Dynamics 365 O oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino
Exemplo
Descrição
Considerações
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
Identificador exclusivo de um contato.
Obrigatório. Consulte a Dynamics 365 documentação para obter mais detalhes.

Públicos-alvo compatíveis supported-audiences

Esta seção descreve todos os públicos-alvo que você pode exportar para esse destino.

Esse destino suporta a ativação de todos os públicos-alvo gerados pelo Experience Platform Serviço de segmentação.

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Item
Tipo
Notas
Tipo de exportação
Baseado em perfil
  • Você está exportando todos os membros de um público-alvo, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), de acordo com o mapeamento de campo.
  • Cada status de público-alvo no Dynamics 365 é atualizado com o status de público-alvo correspondente na Platform, com base no ID do mapeamento valor fornecido durante o agendamento de público etapa.
Frequência de exportação
Streaming
  • Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que um perfil é atualizado em Experience Platform com base na avaliação do público-alvo, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de transmissão.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Para se conectar a esse destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Dentro de Destinos > Catálogo pesquisar Dynamics 365. Como alternativa, você pode localizá-lo na CRM categoria.

Autenticar para o destino authenticate

Para autenticar no destino, selecione Conectar ao destino.
Captura de tela da interface do usuário da plataforma mostrando como autenticar.

Preencha os campos obrigatórios abaixo. Consulte a Coletar credenciais do Dynamics 365 para obter orientação.

  • ID do cliente: A variável Dynamics 365 ID do cliente para o seu Azure Active Directory aplicação.
  • ID do inquilino: A variável Dynamics 365 ID de locatário para o seu Azure Active Directory aplicação.
  • Segredo do cliente: A variável Dynamics 365 Segredo do cliente para o seu Azure Active Directory aplicação.
  • Região: Seu Dynamics 365 Região. Por exemplo: se sua empresa for provisionada na região da América do Norte (NAM), seu URL será crm.dynamics.com e você precisa selecionar crm. Se sua empresa for provisionada na região do Canadá (CAN), o URL será crm3.dynamics.com e você precisa selecionar crm3.
  • URL do ambiente: Seu Dynamics 365 URL do ambiente.

Se os detalhes fornecidos forem válidos, a interface exibirá uma Conectado com uma marca de seleção verde. Você pode prosseguir para a próxima etapa.

Preencher detalhes do destino destination-details

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.
Captura de tela da interface do usuário da plataforma mostrando os detalhes do destino.

  • Nome: um nome pelo qual você reconhecerá esse destino no futuro.
  • Descrição: uma descrição que ajudará você a identificar esse destino no futuro.
  • Prefixo de personalização: A variável Customization prefix do campo personalizado que você criou no Dynamics 365. Consulte a Criar e editar campos seção do Dynamics 365 para obter mais detalhes.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface do.

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino activate

IMPORTANT

Ler Ativar perfis e públicos para destinos de exportação de público de transmissão para obter instruções sobre como ativar públicos-alvo para esse destino.

Considerações e exemplo de mapeamento mapping-considerations-example

Para enviar corretamente os dados do público-alvo do Adobe Experience Platform para a Dynamics 365 destino, é necessário passar pela etapa de mapeamento de campos. O mapeamento consiste em criar um link entre os campos do esquema do Experience Data Model (XDM) na sua conta da Platform e seus equivalentes correspondentes no destino. Para mapear corretamente os campos XDM para o Dynamics 365 campos de destino, siga estas etapas:

  1. No Mapeamento etapa, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
    Exemplo de captura de tela da interface do Platform para Adicionar novo mapeamento.

  2. No Selecionar campo de origem escolha a Selecionar namespace de identidade categoria e selecione contactid.
    Exemplo de captura de tela da interface do Platform para mapeamento de origem.

  3. No Selecionar campo de destino selecione o tipo de campo de destino para o qual deseja mapear seu campo de origem.

    • Selecionar namespace de identidade: selecione esta opção para mapear o campo de origem para um namespace de identidade da lista.

      Captura de tela da interface do usuário da plataforma mostrando o Target mapping para contactid.

    • Adicione o mapeamento a seguir entre o esquema de perfil XDM e o Dynamics 365 instância: |Esquema do perfil XDM|Dynamics 365 Instância| Obrigatório| |—|—|—| |contactid|contactid| Sim |

    • Selecionar atributos personalizados: selecione esta opção para mapear o campo de origem para um atributo personalizado definido na variável Nome do atributo campo. Consulte Dynamics 365 documentação para obter uma lista abrangente dos atributos suportados.

      Captura de tela da interface do usuário da plataforma mostrando o Target mapping para email.

      note important
      IMPORTANT
      • Os nomes dos campos de destino devem estar em lowercase.
      • Além disso, se você tiver um campo de origem de data ou carimbo de data e hora mapeado para um Dynamics 365 data ou carimbo de data e hora target, certifique-se de que o valor mapeado não esteja vazio. Se o valor de campo exportado estiver vazio, você encontrará um Bad request reported while pushing events to the destination. Please contact the administrator and try again. mensagem de erro e os dados não serão atualizados. Este é um Dynamics 365 limitação.

    • Por exemplo, dependendo dos valores que você deseja atualizar, adicione o seguinte mapeamento entre o esquema de perfil XDM e o Dynamics 365 instância: |Esquema do perfil XDM|Dynamics 365 Instância| |—|—| |person.name.firstName|firstname| |person.name.lastName|lastname| |personalEmail.address|emailaddress1|

    • Um exemplo usando esses mapeamentos é mostrado abaixo:

      Exemplo de captura de tela da interface do Platform mostrando os mapeamentos do Target.

Agendar exportação de público e exemplo schedule-audience-export-example

No Agendar exportação de público do fluxo de trabalho de ativação, você deve mapear manualmente os públicos-alvo da Platform para o atributo de campo personalizado em Dynamics 365.

Para fazer isso, selecione cada público e insira o atributo de campo personalizado correspondente em Dynamics 365 no ID do mapeamento campo.

IMPORTANT
O valor usado para a variável ID do mapeamento deve corresponder exatamente ao nome do atributo de campo personalizado criado em Dynamics 365. Consulte Dynamics 365 documentação se precisar de orientação sobre como encontrar os atributos de campo personalizado.

Um exemplo é mostrado abaixo:
Exemplo de captura de tela da interface do Platform mostrando Programar exportação de público-alvo.

Validar exportação de dados exported-data

Para validar se você configurou o destino corretamente, siga as etapas abaixo:

  1. Selecionar Destinos > Procurar para navegar até a lista de destinos.
    Captura de tela da interface do usuário da plataforma mostrando os destinos de navegação.

  2. Selecionar o destino e validar se o status é habilitado.
    Captura de tela da interface do usuário da plataforma mostrando a execução do fluxo de dados de destinos.

  3. Alterne para a Activation data e selecione um nome de público-alvo.
    Exemplo de captura de tela da interface do Platform mostrando Dados de ativação de destinos.

  4. Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem criada no público-alvo.
    Exemplo de captura de tela da interface do usuário do Platform mostrando o público-alvo.

  5. Faça logon no Dynamics 365 site e, em seguida, navegue até o Customers > Contacts e verifique se os perfis do público-alvo foram adicionados. Você pode ver que cada status de público-alvo em Dynamics 365 foi atualizado com o status de público-alvo correspondente na Platform, com base na ID do mapeamento valor fornecido durante o agendamento de público etapa.
    Captura de tela da interface do usuário do Dynamics 365 mostrando a página Contatos com status de público atualizado.

Uso e governança de dados data-usage-governance

Todos Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, consulte o Visão geral da governança de dados.

Erros e solução de problemas errors-and-troubleshooting

Erros desconhecidos encontrados ao enviar eventos para o destino unknown-errors

Ao verificar uma execução de fluxo de dados, se você obter a seguinte mensagem de erro: Bad request reported while pushing events to the destination. Please contact the administrator and try again.

Captura de tela da interface do usuário do Platform mostrando o erro de solicitação incorreta.

Para corrigir esse erro, verifique se ID do mapeamento você forneceu em Dynamics 365 para seu público-alvo da Platform é válido e existe em Dynamics 365.

Recursos adicionais additional-resources

Informações adicionais úteis do Dynamics 365 documentação está abaixo:

Changelog

Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.

Exibir changelog
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
Mês de lançamento Tipo de atualização Descrição
Outubro de 2023 Atualização da documentação Atualização da orientação para indicar que todos os nomes de atributos de destino devem estar em minúsculas, no Considerações e exemplo de mapeamento etapa.
Agosto de 2023 Atualização de funcionalidade e documentação Suporte adicionado para Dynamics 365 prefixos de campo personalizado para campos personalizados que não foram criados na solução padrão no Dynamics 365. Um novo campo de entrada, Prefixo de personalização, foi adicionada na Preencher detalhes do destino etapa. (PLATIR-31602).
Nov. de 2022 Versão inicial Versão inicial de destino e publicação da documentação.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6