Conecte sua conta do Salesforce ao Experience Platform usando a interface
Este tutorial fornece etapas sobre 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 um entendimento prático 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 | |
|---|---|
| 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. |
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 ao Experience Platform.
Conectar sua conta do Salesforce
Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
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
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 Platform.