DocumentaçãoExperience PlatformGuia de destinos

Microsoft Dynamics 365 conexão

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Usuário

Visão geral overview

Microsoft Dynamics 365 é uma plataforma de aplicativo comercial baseada em nuvem que combina ERP (Enterprise Resource Planning, planejamento de recursos corporativos) e CRM (Customer Relationship Management, gerenciamento de relacionamento com o cliente), 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 aproveita o Contact Entity Reference API, que permite que você atualize as identidades dentro de um público-alvo para Dynamics 365.

Dynamics 365 usa OAuth 2 com Concessão de Autorização como o mecanismo de autenticação para se comunicar com o Contact Entity Reference API. As instruções para autenticar na sua instância do Dynamics 365 estão mais abaixo, na seção Autenticar no destino.

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 compilar audiências com base em seus dados offline e enviá-las para o Dynamics 365, para exibição nos feeds de usuário, assim que as audiências e os perfis forem atualizados no Adobe Experience Platform.

Pré-requisitos prerequisites

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

Antes de ativar dados para o destino Dynamics 365, você deve ter um esquema, um conjunto de dados e públicos-alvo criados em Experience Platform.

Consulte a documentação do Adobe para Grupo de campos de esquema de Detalhes da associação do público-alvo 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 Plataforma para sua conta do Dynamics 365:

Você precisa ter uma conta Microsoft Dynamics 365 prerequisites-account

Vá para a página de Dynamics 365 avaliação para se registrar e criar uma conta, caso ainda não tenha uma.

Criar campo dentro de Dynamics 365 prerequisites-custom-field

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

Consulte a documentação 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 em Dynamics 365. Você precisará desse prefixo durante a etapa Preencher detalhes do destino. Consulte a seção Criar e editar campos da documentação do Dynamics 365 para obter mais detalhes.
Captura de tela da interface do usuário do Dynamics 365 mostrando o prefixo de personalização.

Um exemplo de configuração dentro de 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 o Dynamics 365 para acessar os recursos, você precisará fazer logon com o Azure Account para Azure Active Directory e criar o seguinte:

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

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

Obter credenciais de Dynamics 365 gather-credentials

Anote os itens abaixo antes de autenticar no destino do CRM Dynamics 365:

Credencial
Descrição
Exemplo
Client ID
A ID do Cliente Dynamics 365 do aplicativo Azure Active Directory. Consulte a Dynamics 365 documentação para obter orientação.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
O Segredo do Cliente Dynamics 365 do aplicativo Azure Active Directory. Você usaria a opção #2 na Dynamics 365 documentação.
abcde~abcdefghijklmnopqrstuvwxyz12345678 para orientação.
Tenant ID
A ID de Locatário do Dynamics 365 para seu aplicativo Azure Active Directory. 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 o abaixo, você precisa fornecer o valor destacado para o campo CRM no seletor suspenso ao autenticar no destino.
org57771b33.crm.dynamics.com
Como exemplo: se sua empresa estiver provisionada na região da América do Norte (NAM), sua URL será crm.dynamics.com e você precisará selecionar crm. Se sua empresa for provisionada na região do Canadá (CAN), sua URL será crm3.dynamics.com e você precisará selecionar crm3.
Environment URL
Consulte a Dynamics 365 documentação para obter orientação.
Se o domínio Dynamics 365 for o abaixo, você precisará do valor realçado.
org57771b33.crm.dynamics.com

Medidas de proteção guardrails

A página Solicitações de limites e alocações detalha os limites de API Dynamics 365 associados à sua licença do Dynamics 365. Você precisa garantir que seus dados e carga estejam dentro dessas restrições.

Identidades suportadas supported-identities

Dynamics 365 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.

Este destino dá suporte à ativação de todos os públicos-alvo gerados pelo Serviço de Segmentação da Experience Platform.

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 campos.
  • Cada status de público-alvo em Dynamics 365 é atualizado com o status de público-alvo correspondente da Platform, com base no valor ID de Mapeamento fornecido durante a etapa agendamento de público-alvo.
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 streaming.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

Para se conectar a este 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.

Em Destinos > Catálogo, pesquise por Dynamics 365. Como alternativa, você pode localizá-lo na categoria CRM.

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 seção Coletar credenciais do Dynamics 365 para obter orientação.

  • ID do Cliente: A ID do Cliente Dynamics 365 para o aplicativo Azure Active Directory.
  • ID do Locatário: A ID do Locatário Dynamics 365 para seu aplicativo Azure Active Directory.
  • Segredo do Cliente: o Segredo do Cliente Dynamics 365 para o aplicativo Azure Active Directory.
  • Região: Sua Região Dynamics 365. Como exemplo: se sua empresa for provisionada na região da América do Norte (NAM), sua URL será crm.dynamics.com e você precisará selecionar crm. Se sua empresa for provisionada na região do Canadá (CAN), sua URL será crm3.dynamics.com e você precisará selecionar crm3.
  • URL do Ambiente: Sua URL do Ambiente Dynamics 365.

Se os detalhes fornecidos forem válidos, a interface exibirá um status 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 de destino.

  • Nome: um nome pelo qual você reconhecerá este destino no futuro.
  • Descrição: uma descrição que ajudará você a identificar este destino no futuro.
  • Prefixo de Personalização: o Customization prefix do campo personalizado que você criou em Dynamics 365. Consulte a seção Criar e editar campos da documentaçã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.

Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.

Ativar públicos-alvo para esse destino activate

IMPORTANT

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

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

Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino Dynamics 365, é 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 os campos de destino Dynamics 365, siga estas etapas:

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

  2. Na janela Selecionar campo de origem, escolha a categoria Selecionar namespace de identidade e selecione contactid.
    Exemplo de captura de tela da interface do usuário da plataforma para mapeamento Source.

  3. Na janela Selecionar campo de destino, selecione o tipo de campo de destino para o qual você deseja mapear seu campo de origem.

    • Selecionar namespace de identidade: selecione esta opção para mapear seu 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 a instância Dynamics 365:

      table 0-row-3 1-row-3
      Esquema de 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 no campo Nome do atributo. Consulte a 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 campo de destino Dynamics 365 data ou carimbo de data e hora, verifique se o valor mapeado não está vazio. Se o valor do campo exportado estiver vazio, você encontrará uma mensagem de erro Bad request reported while pushing events to the destination. Please contact the administrator and try again. e os dados não serão atualizados. Esta é uma limitação de Dynamics 365.

    • Por exemplo, dependendo dos valores que você deseja atualizar, adicione o seguinte mapeamento entre o esquema de perfil XDM e a instância Dynamics 365:

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Esquema de 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 usuário da plataforma mostrando os mapeamentos do Target.

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

Na etapa Agendar exportação de público-alvo 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 de Dynamics 365 no campo ID de Mapeamento.

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

Um exemplo é mostrado abaixo:
Exemplo de captura de tela da Interface do Usuário da Plataforma mostrando a opção Agendar exportação de público.

Validar exportação de dados exported-data

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

  1. Selecione 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. Selecione o destino e valide 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 guia Activation data e selecione um nome de público-alvo.
    Exemplo de captura de tela da interface do usuário da plataforma 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 da plataforma mostrando o público-alvo.

  5. Faça logon no site do Dynamics 365, navegue até a página 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 da Platform, com base no valor de ID de Mapeamento fornecido durante a etapa agendamento de público-alvo.
    Captura de tela da interface do Dynamics 365 mostrando a página Contatos com status de público atualizado.

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

Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform impõe a governança de dados, consulte a 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 da Plataforma mostrando um erro de solicitação incorreta.

Para corrigir esse erro, verifique se a ID de Mapeamento fornecida em Dynamics 365 para o público-alvo da Platform é válida e existe em Dynamics 365.

Recursos adicionais additional-resources

Informações adicionais úteis da Dynamics 365 documentação estão 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, na etapa Considerações de mapeamento e exemplo.
Agosto de 2023 Atualização de funcionalidade e documentação Adicionado suporte para Dynamics 365 prefixos de campos personalizados para campos personalizados que não foram criados na solução padrão em Dynamics 365. Um novo campo de entrada, Prefixo de Personalização, foi adicionado na etapa Preencher detalhes de destino. (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