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:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
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.
Coletar credenciais necessárias gather-required-credentials
A origem Salesforce dá suporte à autenticação básica e à Credencial do Cliente OAuth2.
Você deve fornecer valores para as credenciais a seguir para conectar sua conta do Salesforce usando autenticação básica.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| 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. |
| Nome de usuário | O nome de usuário da conta de usuário Salesforce. |
| Senha | A senha da conta de usuário Salesforce. |
| Token de segurança | O token de segurança para a conta de usuário Salesforce. |
| Versão da API | (Opcional) 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. |
Para obter mais informações sobre autenticação, consulte este Salesforce guia de autenticação.
Você deve fornecer valores para as credenciais a seguir para conectar sua conta do Salesforce usando a Credencial do Cliente OAuth2.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| 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.
Depois de obter as credenciais necessárias, você poderá seguir as etapas abaixo para conectar sua conta do Salesforce à Experience Platform.
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.
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.
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.
Em seguida, selecione o tipo de autenticação que deseja usar para a nova conta.
Para autenticação básica, selecione Autenticação básica e forneça valores para as seguintes credenciais:
- URL do ambiente
- Nome de usuário
- Senha
- Versão da API (opcional)
Quando terminar, selecione Conectar à origem.
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
Quando terminar, selecione Conectar à origem.
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.