DocumentaçãoCampaignDocumentação do Campaign Standard

Configurar o Microsoft Dynamics 365 para integração com o Adobe Campaign Standard

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Experiente
  • Desenvolvedor

Saiba como configurar a integração com o Microsoft Dynamics 365 e ativar os dados do CRM na comunicação entre canais com o Adobe Campaign Standard.

Visão geral

A descrição geral da integração do Adobe Campaign Standard com o Microsoft Dynamics 365 está descrita em esta página.

Vários aplicativos precisarão ser configurados para habilitar a integração. No entanto, este artigo se concentrará nas etapas necessárias no Dynamics 365.

Pré-requisitos

Antes de executar a configuração de pré-integração neste documento, presume-se que você já tenha provisionado e tido acesso de administrador à instância do Microsoft Dynamics 365 de sua organização. Se isso não tiver acontecido, você precisará entrar em contato com o suporte ao cliente da Microsoft para concluir o provisionamento do Dynamics 365.

Se você estiver configurando a integração para ambientes de preparo e produção, será necessário executar as etapas abaixo para as instâncias de preparo e produção do Dynamics 365. Algumas instruções abaixo variam um pouco, dependendo se você está configurando um estágio ou uma instância de produção do Dynamics 365 (por exemplo, para a instância de produção, selecione "prod" para <stage or prod>)

Configuração do aplicativo e das permissões

Um token de acesso OAuth permite que a ferramenta de integração seja autenticada em sua instância do Microsoft Dynamics 365 por meio de APIs da Web para publicar eventos de experiência de Campaign Standard na exibição da linha do tempo da interface do Microsoft Dynamics 365.

As etapas principais estão descritas no vídeo a seguir:

https://video.tv.adobe.com/v/34838?captions=por_br

Para gerar o token de acesso OAuth, siga as etapas descritas abaixo.

Registrar um novo aplicativo register-a-new-app

  1. Em seu logon de administrador, faça logon no portal.azure.com.

  2. Clique em Azure Active Directory no menu do lado esquerdo; em seguida, clique em App registrations no submenu que aparece.

  3. Clique em New registration na parte superior da tela.

  4. Preencha a tela de registro do aplicativo:

    • Nome: adobe campaign <stage or prod>
    • Tipo de conta com suporte: Accounts in this organizational directory only (valor padrão)

Para obter mais informações sobre como criar um novo aplicativo, consulte esta seção.

NOTE
O Microsoft Azure Diretory atribui uma ID de aplicativo (cliente) exclusiva ao aplicativo. Você precisará dessa ID posteriormente na configuração do Dynamics 365, bem como ao executar a configuração da ferramenta de integração.

Gerar segredo do cliente generate-a-client-secret

  1. Na tela de visão geral do aplicativo, no submenu à esquerda, clique em Certificates and Secrets > New client secret

  2. Insira uma descrição, defina a duração e clique em OK.

O segredo do cliente foi criado. Retenha o valor temporariamente para a conclusão da configuração de pré-integração da ferramenta de integração.

CAUTION
Mantenha esse valor como você precisará dele para concluir a configuração de pré-integração da ferramenta de integração. Ele não pode ser recuperado posteriormente.

Configurar permissões

  1. Nesta tela ou na tela de visão geral do aplicativo, clique em API permissions no submenu à esquerda. Depois de clicar em Add a permission, você precisa selecionar Dynamics CRM no menu.

  2. Marque a caixa para user_impersonation e clique no botão Add permissions.

Para obter mais informações sobre a configuração de permissões, consulte esta seção.

Criar o usuário do aplicativo

Este novo usuário é um usuário genérico. Ele será usado pelo aplicativo: qualquer alteração no Microsoft Dynamics 365 usando a API será feita por esse usuário. Para criá-lo, siga as etapas abaixo:

  1. Navegue até a instância do Dynamics 365 e faça logon como Administrador.

  2. Clique no ícone de engrenagem no canto superior direito e clique em Advanced Settings. No banner superior, clique no menu suspenso ao lado de Settings, clique em Security > Users.

  3. Clique no menu suspenso para ir para Application Users. Clique em New.

  4. O menu suspenso ao lado do ícone do usuário deve informar USER:APPLICATION USER.

    Preencha a tela para o novo usuário. Sugestões de parâmetros:

    • User Name (email): adobe_api_<stage-or-prod>@<your-d365-hostname>" (por exemplo, adobe_api_stage@some-company.crm.dynamics.com)
    • Application ID: ID do aplicativo que você registrou no Azure AD (isso é obrigatório)
    • Você pode deixar em branco Application ID URI e Azure AD Object ID
    • Full Name: API Adobe <stage or prod>
    • Email: o mesmo que User Name (ou email do administrador, se desejar)

    Para obter mais informações sobre a criação de usuários do aplicativo, consulte esta seção.

  5. Clique no ícone do usuário e carregue um ícone do Adobe Campaign; esse é o ícone que será exibido na exibição Linha do tempo quando novos eventos de Adobe aparecerem no Dynamics 365.

  6. Abra a lista de funções de usuário clicando em MANAGE ROLES na faixa superior.

  7. Role para baixo e selecione System administrator acesso para este usuário.

  8. Clique em OK.

Obter a ID do locatário get-the-tenant-id

Siga as instruções nesta página para encontrar sua ID de locatário. Você precisará dessa ID durante a configuração de pré-integração na ferramenta de integração.

Campaign Standard de instalação do Microsoft Dynamics 365 install-appsource-app

Para integrar o aplicativo Dynamics 365 ao seu ambiente de Campaign Standard, siga as etapas abaixo:

  1. Navegue até Microsoft Business Apps e pesquise por Adobe Campaign Standard na barra de pesquisa.
    Como alternativa, você pode navegar até este link.
  2. Siga as instruções para instalar o aplicativo para sua instância do Dynamics 365.
  3. Depois de instalado, navegue até a instância do Dynamics 365 e entre como administrador.
  4. Clique no ícone de engrenagem no canto superior direito e clique em Advanced Settings. No banner superior, clique no menu suspenso ao lado de Settings, clique em Processes em Process Center.
  5. Procure a tarefa Adobe Campaign Email Bounce e clique nela.
  6. Na guia Administration, altere o proprietário para o usuário do aplicativo da API de Adobe criado anteriormente clicando em Actions na faixa superior e, em seguida, selecione a opção Assign to another User, selecione Adobe API application user na lista suspensa para atribuir.
  7. Reative o processo.
  8. Faça o mesmo para a tarefa Adobe Campaign Email Click.
NOTE
Se quiser desativar esses processos a qualquer momento, você poderá fazê-lo nesta tela Processes.

Tópicos relacionados

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff