Documentação Experience Platform Guia de destinos

Salesforce CRM conexão

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Destinos

Criado para:

Administrador
Usuário

Visão geral overview

Salesforce CRM é uma plataforma popular de CRM (relacionamento com o cliente) e oferece suporte aos tipos de perfis descritos abaixo:

Clientes potenciais - Um cliente potencial é o nome de uma pessoa ou empresa que pode (ou não) estar interessada nos produtos ou serviços que você vende.
Contatos - Um contato é um indivíduo com quem um de seus representantes estabeleceu uma relação e foi qualificado como um cliente potencial.

Este Adobe Experience Platform destino aproveita o Salesforce composite API, que oferece suporte aos dois tipos de perfis descritos acima.

Ao ativar segmentos, você pode selecionar entre clientes em potencial ou contatos e atualizar atributos e dados de público-alvo para Salesforce CRM.

Salesforce CRM usa OAuth 2 com Concessão de senha como um mecanismo de autenticação para se comunicar com a API REST do Salesforce. As instruções para autenticar na sua instância do Salesforce CRM 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 criar públicos-alvo com base em seus dados offline e enviá-los para o Salesforce CRM, para atualizar a associação ao CRM assim que os públicos-alvo e os perfis forem atualizados no Adobe Experience Platform.

Pré-requisitos prerequisites

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

Antes de ativar dados para o destino do Salesforce CRM, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform.

Pré-requisitos em Salesforce CRM prerequisites-destination

Observe os seguintes pré-requisitos em Salesforce CRM, para exportar dados da Platform para sua conta do Salesforce:

Você precisa ter uma conta Salesforce prerequisites-account

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

Configurar um aplicativo conectado no Salesforce prerequisites-connected-app

Primeiro, você precisa configurar um Salesforce aplicativo conectado na sua conta do Salesforce, se ainda não tiver um. Salesforce CRM aproveitará o aplicativo conectado para se conectar a Salesforce.

Em seguida, habilite OAuth Settings for API Integration para o Salesforce connected app. Consulte a documentação de Salesforce para obter orientação.

Além disso, verifique se os escopos mencionados abaixo estão selecionados para o Salesforce connected app.

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

Finalmente, certifique-se de que a concessão password esteja habilitada em sua conta Salesforce. Consulte a documentação do Salesforce Fluxo de Nome de Usuário-Senha do OAuth 2.0 para Cenários Especiais se precisar de orientação.

IMPORTANT

Se o administrador da sua conta do Salesforce tiver restringido o acesso a intervalos IP confiáveis, você precisará contatá-los para obter Experience Platform incluir na lista de permissões IPs. Consulte a documentação Salesforce Restringir Acesso a Intervalos IP Confiáveis para um Aplicativo Conectado se precisar de orientação adicional.

Criar campos personalizados em Salesforce prerequisites-custom-field

Ao ativar públicos para o destino Salesforce CRM, você deve inserir um valor no campo ID de Mapeamento para cada público ativado, na etapa Agenda de público-alvo.

Salesforce CRM requer esse valor para ler e interpretar corretamente os públicos-alvo vindos do Experience Platform e atualizar seu status de público-alvo em Salesforce. Consulte a documentação do Experience Platform para Grupo de campos do esquema de Detalhes da associação do público-alvo se precisar de orientação sobre os status do público-alvo.

Para cada público ativado da Platform para Salesforce CRM, é necessário criar um campo personalizado do tipo Text Area (Long) em Salesforce. Você pode definir o comprimento de caracteres de qualquer tamanho entre 256 e 131.072 caracteres de acordo com suas necessidades comerciais. Consulte a página de documentação Salesforce Tipos de campo personalizado para obter informações adicionais sobre tipos de campo personalizado. Consulte também a documentação do Salesforce para criar campos personalizados, se precisar de assistência para a criação de campos.

IMPORTANT

Não inclua caracteres de espaço em branco no nome do campo. Em vez disso, use o caractere de sublinhado (_) como separador.
Em Salesforce, você deve criar campos personalizados com um Nome do Campo que corresponda exatamente ao valor especificado em ID de Mapeamento para cada segmento ativado da Platform. Por exemplo, a captura de tela abaixo mostra um campo personalizado chamado crm_2_seg. Ao ativar um público-alvo para esse destino, adicione crm_2_seg como ID de mapeamento para preencher públicos-alvo do Experience Platform nesse campo personalizado.

Um exemplo de criação de campo personalizado em Salesforce, Etapa 1 - Selecionar o tipo de dados, é mostrado abaixo:
Captura de tela da interface do usuário do Salesforce mostrando a criação de campo personalizado, Etapa 1 - Selecione o tipo de dados.

Um exemplo de criação de campo personalizado em Salesforce, Etapa 2 - Inserir os detalhes do campo personalizado, é mostrado abaixo:
Captura de tela da interface do usuário do Salesforce mostrando a criação de campo personalizado, Etapa 2 - Insira os detalhes do campo personalizado.

TIP

Para distinguir entre campos personalizados usados para públicos da Platform e outros campos personalizados dentro do Salesforce, você pode incluir um prefixo ou sufixo reconhecível ao criar o campo personalizado. Por exemplo, em vez de test_segment, use Adobe_test_segment ou test_segment_Adobe
Se você já tiver outros campos personalizados criados no Salesforce, poderá usar o mesmo nome do segmento da Platform para identificar facilmente o público-alvo no Salesforce.

NOTE

Os objetos no Salesforce são restritos a 25 campos externos, consulte Atributos de campo personalizado.
Essa restrição implica que você só pode ter um máximo de 25 associações de público-alvo de Experience Platform ativas a qualquer momento.
Se você atingiu esse limite no Salesforce, deve remover os atributos personalizados do Salesforce que foram usados para armazenar o status do público-alvo em relação a públicos-alvo mais antigos no Experience Platform antes que uma nova ID de mapeamento possa ser usada.

Obter credenciais de Salesforce CRM gather-credentials

Anote os itens abaixo antes de autenticar no destino Salesforce CRM:

Credencial

Descrição

Exemplo

Username

Seu nome de usuário da conta Salesforce.

Password

A senha da sua conta Salesforce.

Security Token

O token de segurança Salesforce que você anexará posteriormente ao final da Senha Salesforce para criar uma cadeia de caracteres concatenada a ser usada como a Senha ao autenticar no destino.
Consulte a documentação do Salesforce para redefinir seu token de segurança e saber como gerá-lo novamente a partir da interface do Salesforce se você não tiver o Token de Segurança.

Custom Domain

O prefixo de domínio Salesforce.
Consulte a Salesforce documentação para saber como obter este valor da interface Salesforce.

Se o domínio Salesforce for
d5i000000isb4eak-dev-ed.my.salesforce.com,
você precisará de d5i000000isb4eak-dev-ed como valor.

Client ID

Seu Salesforce Consumer Key.
Consulte a Salesforce documentação para saber como obter este valor na interface Salesforce.

Client Secret

Seu Salesforce Consumer Secret.
Consulte a Salesforce documentação para saber como obter este valor na interface Salesforce.

Medidas de proteção guardrails

Salesforce equilibra cargas de transação impondo limites de solicitação, taxa e tempo limite. Consulte Limites e alocações de solicitação de API para obter detalhes.

Se o administrador da sua conta do Salesforce impôs restrições de IP, será necessário adicionar endereços IP de Experience Platform aos intervalos IP confiáveis das suas contas do Salesforce. Consulte a documentação Salesforce Restringir Acesso a Intervalos IP Confiáveis para um Aplicativo Conectado se precisar de orientação adicional.

IMPORTANT

Ao ativar segmentos, você deve selecionar entre os tipos Contato ou Cliente Potencial. É necessário garantir que seus públicos-alvo tenham o mapeamento de dados apropriado de acordo com o tipo selecionado.

Identidades suportadas supported-identities

Salesforce CRM oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino

Descrição

Considerações

SalesforceId

O identificador Salesforce CRM das identidades de contato ou cliente potencial que você exporta ou atualiza por meio do seu segmento.

Obrigatório

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 segmento, 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 Salesforce CRM é 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 Salesforce CRM. Como alternativa, você pode localizá-lo na categoria CRM.

Autenticar para o destino authenticate

Para autenticar no destino, preencha os campos obrigatórios abaixo e selecione Conectar ao destino. Consulte a seção Coletar Salesforce CRM credenciais para obter qualquer orientação.

Credencial

Descrição

Nome de usuário

Seu nome de usuário da conta Salesforce.

Password

Uma cadeia de caracteres concatenada composta por sua senha de conta do Salesforce anexada com seu Token de Segurança do Salesforce.
O valor concatenado assume a forma de {PASSWORD}{TOKEN}.
Observação: não use chaves ou espaços.
Por exemplo, se a sua Senha do Salesforce for MyPa$$w0rd123 e o Token de Segurança do Salesforce for TOKEN12345....0000, o valor concatenado que você usará no campo Senha será MyPa$$w0rd123TOKEN12345....0000.

Domínio personalizado

O prefixo de domínio Salesforce.
Por exemplo, se o seu domínio for d5i000000isb4eak-dev-ed.my.salesforce.com, você precisará fornecer d5i000000isb4eak-dev-ed como valor.

ID do cliente

Seu Salesforce conectou o aplicativo Consumer Key.

Segredo do cliente

Seu Salesforce conectou o aplicativo Consumer Secret.

Captura de tela da interface do usuário da plataforma mostrando como autenticar.

Se os detalhes fornecidos forem válidos, a interface exibirá um status Conectado com uma marca de seleção verde, você poderá 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.

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.
Tipo de ID do Salesforce:
- Selecione Contato se as identidades que você deseja exportar ou atualizar forem do tipo Contato.
- Selecione Lead se as identidades que você deseja exportar ou atualizar forem do tipo Lead.

Captura de tela da Interface do Usuário da Plataforma mostrando os detalhes de destino.

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

Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos 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 exportar identidades, você precisa da permissão Exibir Gráfico de Identidade controle de acesso.

{width="100" modal="regular"}

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 Salesforce CRM, é 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.

Os atributos especificados no campo de Destino devem ser nomeados exatamente como descrito na tabela de mapeamentos de atributos, pois esses atributos formarão o corpo da solicitação.

Os atributos especificados no campo Source não seguem nenhuma restrição desse tipo. Você pode mapeá-los com base na sua necessidade. No entanto, verifique se o formato dos dados de entrada é válido de acordo com a Salesforce documentação. Se os dados de entrada não forem válidos, a chamada de atualização para Salesforce falhará e seus contatos/clientes potenciais não serão atualizados.

Para mapear corretamente os campos XDM para os campos de destino (API) Salesforce CRM, siga estas etapas:

Na etapa Mapeamento, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
Na janela Selecionar campo de origem, escolha a categoria Selecionar atributos e selecione o atributo XDM ou escolha o Selecionar namespace de identidade e selecione uma identidade.

Na janela Selecionar campo de destino, escolha o Selecionar namespace de identidade e selecione uma identidade ou escolha a categoria Selecionar atributos personalizados e selecione um atributo ou defina um usando o campo Nome do atributo, conforme necessário. Consulte a Salesforce CRM documentação para obter orientação sobre os atributos suportados.

Repita essas etapas para adicionar os seguintes mapeamentos entre o esquema de perfil XDM e o (API) Salesforce CRM:

Trabalhando com Contatos

Se você estiver trabalhando com Contatos no seu segmento, consulte a Referência de Objeto no Salesforce para Contato para definir mapeamentos para os campos que serão atualizados.
Você pode identificar campos obrigatórios procurando a palavra Obrigatório, que é mencionada nas descrições dos campos no link acima.

Dependendo dos campos que deseja exportar ou atualizar, adicione mapeamentos entre o esquema de perfil XDM e (API) Salesforce CRM:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Campo de origem	Campo de público alvo	Notas
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Sobrenome do contato com até 80 caracteres.
`xdm: person.name.firstName`	`Attribute: FirstName`	O nome do contato tem até 40 caracteres.
`xdm: personalEmail.address`	`Attribute: Email`	O endereço de email do contato.

Um exemplo usando esses mapeamentos é mostrado abaixo:

Trabalhando com clientes em potencial

Se você estiver trabalhando com Clientes potenciais no seu segmento, consulte a Referência de objeto no Salesforce para Clientes potenciais para definir os mapeamentos para os campos que serão atualizados.
Você pode identificar campos obrigatórios procurando a palavra Obrigatório, que é mencionada nas descrições dos campos no link acima.

Dependendo dos campos que deseja exportar ou atualizar, adicione mapeamentos entre o esquema de perfil XDM e (API) Salesforce CRM:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Campo de origem	Campo de público alvo	Notas
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`. Sobrenome do lead com até 80 caracteres.
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory`. A empresa do lead.
`xdm: personalEmail.address`	`Attribute: Email`	O endereço de email do lead.

Um exemplo usando esses mapeamentos é mostrado abaixo:

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Avançar.

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

Ao executar a etapa Agendar exportação de público-alvo, mapeie manualmente os públicos-alvo ativados da Platform para o campo personalizado correspondente em Salesforce.

Para fazer isso, selecione cada segmento e insira o nome do campo personalizado de Salesforce no campo Salesforce CRM ID de Mapeamento. Consulte a seção Criar campos personalizados em Salesforce para obter orientação e práticas recomendadas sobre como criar campos personalizados em Salesforce.

Por exemplo, se o campo personalizado Salesforce for crm_2_seg, especifique esse valor na Salesforce CRM ID de mapeamento para preencher públicos-alvo do Experience Platform nesse campo personalizado.

Um exemplo de campo personalizado de Salesforce é mostrado abaixo:
Captura de tela da interface do usuário Salesforce mostrando o campo personalizado.

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

Como mostrado acima, o Salesforce Nome do Campo corresponde exatamente ao valor especificado em Salesforce CRM ID de Mapeamento.

Dependendo do seu caso de uso, todos os públicos ativados podem ser mapeados para o mesmo campo personalizado Salesforce ou para um Nome do Campo diferente em Salesforce CRM. Um exemplo típico com base na imagem mostrada acima pode ser.

Nome do segmento Salesforce CRM

Salesforce Nome do Campo

Salesforce CRM ID de Mapeamento

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

Repita esta seção para cada segmento da Platform ativado.

Validar exportação de dados exported-data

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

Selecione Destinos > Procurar para navegar até a lista de destinos.
Selecione o destino e valide se o status é habilitado.
Alterne para a guia Dados de ativação e selecione um nome de público-alvo.
Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem criada no segmento.
Por fim, faça logon no site do Salesforce e valide se os perfis do público-alvo foram adicionados ou atualizados.

Trabalhando com Contatos
- Se você selecionou Contatos no seu segmento da Platform, navegue até a página Apps > Contacts.
- Selecione um Contato e verifique se os campos estão atualizados. Você pode ver que cada status de público-alvo em Salesforce CRM foi atualizado com o status de público-alvo correspondente da Platform, com base no valor de ID de Mapeamento fornecido durante o agendamento de público-alvo.
Trabalhando com clientes em potencial
- Se você selecionou Clientes potenciais no seu segmento da Platform, navegue até a página Apps > Leads.
- Selecione um cliente em potencial e verifique se os campos estão atualizados. Você pode ver que cada status de público-alvo em Salesforce CRM foi atualizado com o status de público-alvo correspondente da Platform, com base no valor de ID de Mapeamento fornecido durante o agendamento de público-alvo.

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, você pode encontrar a seguinte mensagem de erro: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- Para corrigir esse erro, verifique se a ID de Mapeamento fornecida no fluxo de trabalho de ativação para o destino Salesforce CRM corresponde exatamente ao valor do tipo de campo personalizado criado em Salesforce. Consulte a seção Criar campos personalizados em Salesforce para obter orientação.
Ao ativar um segmento, você pode obter uma mensagem de erro: The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- Para corrigir esse erro, contate o administrador da sua conta Salesforce para adicionar endereços IP de Experience Platform aos intervalos IP confiáveis das suas contas do Salesforce. Consulte a documentação Salesforce Restringir Acesso a Intervalos IP Confiáveis para um Aplicativo Conectado se precisar de orientação adicional.

Recursos adicionais additional-resources

Informações adicionais úteis do portal do desenvolvedor Salesforce estão abaixo:

Início rápido
Criar um Registro
Públicos-alvo de recomendação personalizados
Usando Recursos Compostos
Este destino usa a API Inserir vários registros em vez da chamada à API Inserir registro único.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6