Conectar sua conta do Salesforce à Experience Platform usando a interface

Leia este guia para saber como conectar sua conta do Salesforce e trazer seus dados do CRM para a Adobe Experience Platform usando a interface do usuário do Experience Platform.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Experience Platform:

Se você já tiver uma conta autenticada do Salesforce, ignore o restante deste documento e prossiga para o tutorial em configurando um fluxo de dados para dados do CRM.

Configurar o aplicativo conectado do Salesforce

Antes de conectar Salesforce ao Adobe Experience Platform, verifique se o aplicativo conectado Salesforce usado para autenticação inclui o escopo OAuth Gerenciar dados do usuário por meio de APIs (api). Este escopo é necessário para que o Experience Platform acesse os dados de Salesforce. Se esse escopo estiver ausente, a autenticação poderá falhar.

Coletar credenciais necessárias gather-required-credentials

A origem Salesforce dá suporte à autenticação por meio da Credencial do Cliente OAuth2.

Credencial
Descrição
URL do ambiente
A URL da instância de origem Salesforce. O formato da URL do ambiente é https://[domain].my.salesforce.com.
ID de cliente
A ID do cliente é usada em conjunto com o segredo do cliente como parte da autenticação OAuth2. Juntos, a ID do cliente e o segredo do cliente permitem que o aplicativo opere em nome da sua conta, identificando o aplicativo no Salesforce.
Segredo do cliente
O segredo do cliente é usado em conjunto com a ID do cliente como parte da autenticação OAuth2. Juntos, a ID do cliente e o segredo do cliente permitem que o aplicativo opere em nome da sua conta, identificando o aplicativo no Salesforce.
Versão da API
A versão da API REST da instância Salesforce que você está usando. O valor da versão da API deve ser formatado com um decimal. Por exemplo, se você estiver usando a versão da API 52, será necessário inserir o valor como 52.0. Se esse campo ficar em branco, o Experience Platform usará automaticamente a versão mais recente disponível.
Incluir objetos excluídos
Um valor booleano usado para determinar se os registros excluídos por software devem ser incluídos. Se definido como verdadeiro, os registros excluídos por software podem ser incluídos na consulta do Salesforce e assimilados de sua conta na Experience Platform. Se você não especificar sua configuração, esse valor assumirá como padrão false.

Para obter mais informações sobre como usar o OAuth para Salesforce, leia o Salesforce guia sobre Fluxos de Autorização do OAuth.

Conectar sua conta do Salesforce

Na interface do Experience Platform, navegue até Fontes no menu esquerdo para abrir o espaço de trabalho Fontes. Use o catálogo à esquerda para procurar categorias ou use a barra de pesquisa para localizar rapidamente a origem que deseja conectar.

Selecione Salesforce na categoria CRM e selecione Adicionar dados.

TIP
No catálogo de fontes, você verá Configurar se nenhuma conta estiver conectada, ou Adicionar dados se uma conta já estiver autenticada.

O catálogo de origens na interface do usuário do Experience Platform com o cartão de origem do Salesforce selecionado.

A página Conectar-se ao Salesforce é exibida. Nesta página, você pode usar credenciais novas ou existentes.

Usar uma conta existente

Para usar uma conta existente, selecione Conta existente e, em seguida, selecione a conta que deseja usar na lista exibida. Quando terminar, selecione Avançar para continuar.

Uma lista de contas autenticadas do Salesforce que já existem em sua organização.

Criar uma nova conta

Para criar uma nova conta, selecione Nova conta e forneça um nome e uma descrição para sua nova conta Salesforce.

Para a Credencial do cliente OAuth 2, selecione Credencial do cliente OAuth2 e forneça valores para as seguintes credenciais:

  • URL do ambiente
  • ID de cliente
  • Segredo do cliente
  • Versão da API
  • Incluir objetos de exclusão
IMPORTANT
Verifique se o aplicativo conectado Salesforce usado para esta conexão inclui o escopo OAuth Gerenciar dados do usuário via APIs (api). Se esse escopo estiver ausente, a autenticação poderá falhar quando o Experience Platform tentar ler os dados de Salesforce.

Quando terminar, selecione Conectar à origem.

A interface na qual você pode criar uma nova conta do Salesforce fornecendo as credenciais de autenticação apropriadas.

Ignorar pré-visualização de dados de amostra skip-preview-of-sample-data

Durante a etapa de seleção de dados, você pode encontrar um tempo limite ao assimilar tabelas ou arquivos de dados grandes. Você pode ignorar a visualização de dados para contornar o tempo limite e ainda visualizar o esquema, embora sem dados de amostra. Para ignorar a visualização de dados, habilite a opção Ignorar visualização de dados de amostra.

O restante do workflow permanecerá o mesmo. O único problema é que ignorar a pré-visualização de dados pode impedir que campos calculados e obrigatórios sejam validados automaticamente durante a etapa de mapeamento e, em seguida, será necessário validar manualmente esses campos durante o mapeamento.

Próximas etapas

Seguindo este tutorial, você estabeleceu uma conexão com sua conta do Salesforce. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados para o Experience Platform.

recommendation-more-help
experience-platform-help-sources