Salesforce CRM conexão

Visão geral overview

Salesforce CRM O é 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 dos seus representantes estabeleceu um relacionamento e foi qualificado como um cliente em potencial.

Este Adobe Experience Platform destino utiliza o Salesforce composite API, que aceita os dois tipos de perfis descritos acima.

Quando ativação de segmentos, você pode selecionar entre clientes potenciais ou contatos e atualizar atributos e dados de público-alvo no Salesforce CRM.

Salesforce CRM O usa o OAuth 2 com Concessão de senha como um mecanismo de autenticação para se comunicar com a API REST do Salesforce. Instruções para autenticar em seu Salesforce CRM exemplo, são apresentados mais abaixo, no Autenticar para destino seção.

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 schema, um conjunto de dados, e segmentos criado em Experience Platform.

Pré-requisitos no 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 um Salesforce account prerequisites-account

Vá para a Salesforce avaliação página para registrar e criar um Salesforce conta, se você ainda não tiver uma.

Configurar um aplicativo conectado no Salesforce prerequisites-connected-app

Primeiro, é necessário configurar um Salesforce aplicativo conectado no seu Salesforce conta, se você ainda não tiver uma. Salesforce CRM aproveitará o aplicativo conectado para se conectar Salesforce.

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

Além disso, assegure que a escopos mencionadas abaixo são selecionadas para o Salesforce connected app.

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Por último, devem assegurar que o password a concessão está ativada em seu Salesforce conta. Consulte a Salesforce Fluxo de nome de usuário-senha do OAuth 2.0 para cenários especiais se precisar de orientação.

IMPORTANT
Se o seu Salesforce administrador da conta restringiu o acesso a intervalos IP confiáveis, você precisa contatá-los para obter IPs Experience Platform incluído na lista de permissões. Consulte a Salesforce Restringir o 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-alvo para a variável Salesforce CRM destino, você deve inserir um valor no campo ID do mapeamento para cada público-alvo ativado, no campo Programação de público etapa.

Salesforce CRM exige que esse valor leia e interprete corretamente os públicos-alvo provenientes do Experience Platform e atualize o status dos públicos-alvo dentro de Salesforce. Consulte a documentação do Experience Platform para Grupo de campos de esquema Detalhes da associação do público se precisar de orientação sobre os status do público-alvo.

Para cada público-alvo que você ativar da Platform para o Salesforce CRM, é necessário criar um campo personalizado do tipo Text Area (Long) no prazo de 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 Salesforce Tipos de campo personalizado página de documentação para obter informações adicionais sobre tipos de campos personalizados. Consulte também a Salesforce documentação para criar campos personalizados se precisar de assistência na criação do campo.

IMPORTANT
Não inclua caracteres de espaço em branco no nome do campo. Em vez disso, use sublinhado (_) como separador.
Dentro de Salesforce você deve criar campos personalizados com um Nome do campo que corresponde exatamente ao valor especificado em ID do 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 as ID do 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, você pode usar o mesmo nome do segmento da Platform para identificar facilmente o público-alvo no Salesforce.
NOTE
  • Os objetos no Salesforce estã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 de um novo ID do mapeamento pode ser usado.

Coletar Salesforce CRM credenciais gather-credentials

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

Credencial
Descrição
Exemplo
Username
Seu Salesforce usuário da conta.
Password
Seu Salesforce senha da conta.
Security Token
Seu Salesforce token de segurança que você anexará posteriormente ao final da Salesforce Senha para criar uma cadeia concatenada a ser usada como Senha quando autenticando no destino.
Consulte a Salesforce documentação para redefinir seu token de segurança para saber como gerá-la novamente a partir do Salesforce se você não tiver o token de segurança.
Custom Domain
Seu Salesforce prefixo do domínio.
Consulte a Salesforce documentação para saber como obter esse valor do Salesforce interface.
Se o seu Salesforce o domínio é
d5i000000isb4eak-dev-ed.my.salesforce.com,
você precisará d5i000000isb4eak-dev-ed como o valor.
Client ID
Seu Salesforce Consumer Key.
Consulte a Salesforce documentação para saber como obter esse valor do Salesforce interface.
Client Secret
Seu Salesforce Consumer Secret.
Consulte a Salesforce documentação para saber como obter esse valor do Salesforce interface.

Medidas de proteção guardrails

Salesforce balanceia cargas de transação impondo limites de solicitação, taxa e timeout. Consulte a Limites e alocações de solicitação de API para obter detalhes.

Se o seu Salesforce administrador da conta impôs restrições de IP, será necessário adicionar Endereços IP do Experience Platform ao seu Salesforce intervalos de IP confiáveis das contas. Consulte a Salesforce Restringir o acesso a intervalos IP confiáveis para um aplicativo conectado se precisar de orientação adicional.

IMPORTANT
Quando ativação de segmentos você deve selecionar entre Contato ou Lead tipos. É 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 O oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino
Descrição
Considerações
SalesforceId
A variável Salesforce CRM identificador para as 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 campo.
  • Cada status de público-alvo no Salesforce CRM é atualizado com o status de público-alvo correspondente na Platform, com base no ID do mapeamento valor fornecido durante o agendamento de público etapa.
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 transmissão.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Para se conectar a esse 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.

Dentro de Destinos > Catálogo pesquisar Salesforce CRM. Como alternativa, você pode localizá-lo na CRM categoria.

Autenticar para o destino authenticate

Para autenticar no destino, preencha os campos obrigatórios abaixo e selecione Conectar ao destino. Consulte a Coletar Salesforce CRM credenciais para obter orientação.
| Credencial | Descrição | | — | — | | Nome de usuário | Seu Salesforce usuário da conta. | | Senha | Uma string concatenada composta por Salesforce senha da conta anexada com seu Salesforce Token de segurança.
O valor concatenado assume a forma de {PASSWORD}{TOKEN}.
Observe que não use chaves ou espaços.
Por exemplo, se seu Salesforce A senha é MyPa$$w0rd123 e Salesforce O token de segurança é TOKEN12345....0000, o valor concatenado que será usado no Senha o campo é MyPa$$w0rd123TOKEN12345....0000. | | Domínio personalizado | Seu Salesforce prefixo do domínio.
Por exemplo, se o domínio for d5i000000isb4eak-dev-ed.my.salesforce.com, é necessário fornecer d5i000000isb4eak-dev-ed como o valor. | | ID do cliente | Seu Salesforce aplicativo conectado Consumer Key. | | Segredo do cliente | Seu Salesforce aplicativo conectado 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á uma Conectado com uma marca de seleção verde, você pode 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á esse destino no futuro.

  • Descrição: uma descrição que ajudará você a identificar esse destino no futuro.

  • Tipo de ID do Salesforce:

    • Selecionar Contato se as identidades que você deseja exportar ou atualizar forem do tipo Contato.
    • Selecionar 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 do 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 do.

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino activate

IMPORTANT

Ler Ativar perfis e públicos para destinos de exportação de público de transmissão para obter instruções sobre como ativar públicos-alvo para esse destino.

Considerações e exemplo de mapeamento mapping-considerations-example

Para enviar corretamente os dados do público-alvo do Adobe Experience Platform para a Salesforce CRM destino, é 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.

Atributos especificados na variável Campo de destino deve ser nomeado exatamente como descrito na tabela mapeamentos de atributos, pois esses atributos formarão o corpo da solicitação.

Atributos especificados na variável Campo de origem 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 o Salesforce documentação. Se os dados de entrada não forem válidos, a chamada de atualização para Salesforce falhará e seus contatos/leads não serão atualizados.

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

  1. No Mapeamento etapa, selecione Adicionar novo mapeamento, você verá uma nova linha de mapeamento na tela.
    Exemplo de captura de tela da interface do Platform para Adicionar novo mapeamento.

  2. No Selecionar campo de origem escolha a Selecionar atributos e selecione o atributo XDM ou escolha o atributo Selecionar namespace de identidade e selecione uma identidade.

  3. No Selecionar campo de destino escolha a Selecionar namespace de identidade e selecione uma identidade ou escolha Selecionar atributos personalizados categoria e selecione um atributo ou defina-o usando a variável Nome do atributo conforme necessário. Consulte a Salesforce CRM documentação para obter orientação sobre atributos compatíveis.

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

    Trabalhar com contatos

    • Se você estiver trabalhando com Contatos no seu segmento, consulte a Referência a objetos no Salesforce para Contato para definir mapeamentos para os campos que serão atualizados.

    • Você pode identificar campos obrigatórios pesquisando a palavra Obrigatório, que é mencionado 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: |Campo de origem|Campo de destino| 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:

      Exemplo de captura de tela da interface do Platform mostrando os mapeamentos do Target.

    Trabalhar com clientes em potencial

    • Se você estiver trabalhando com Clientes potenciais no seu segmento, consulte a Referência a objetos no Salesforce para Lead para definir mapeamentos para os campos que serão atualizados.

    • Você pode identificar campos obrigatórios pesquisando a palavra Obrigatório, que é mencionado 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: |Campo de origem|Campo de destino| 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:

      Exemplo de captura de tela da interface do Platform mostrando os mapeamentos do Target.

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Próxima.

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

Ao executar a Agendar exportação de público etapa você deve mapear 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 em Salesforce no Salesforce CRM ID do mapeamento campo. Consulte a Criar campos personalizados em Salesforce seção para obter orientação e práticas recomendadas sobre a criação de campos personalizados no Salesforce.

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

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

Um exemplo indicando a localização do Salesforce CRM ID do mapeamento é mostrado abaixo:
Exemplo de captura de tela da interface do Platform mostrando Programar exportação de público-alvo.

Como mostrado acima, o Salesforce Nome do campo corresponde exatamente ao valor especificado em Salesforce CRM ID do mapeamento.

Dependendo do caso de uso, todos os públicos ativados podem ser mapeados para o mesmo Salesforce campo personalizado ou para diferente Nome do campo in Salesforce CRM. Um exemplo típico com base na imagem mostrada acima pode ser.
| Salesforce CRM nome do segmento | Salesforce Nome do campo | Salesforce CRM ID do mapeamento | | — | — | — | | crm_1_seg | crm_1_seg | crm_1_seg | | crm_2_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:

  1. Selecionar Destinos > Procurar para navegar até a lista de destinos.
    Captura de tela da interface do usuário da plataforma mostrando os destinos de navegação.

  2. Selecionar o destino e validar se o status é habilitado.
    Captura de tela da interface do usuário da plataforma mostrando a execução do fluxo de dados de destinos.

  3. Alterne para a Dados de ativação e selecione um nome de público-alvo.
    Exemplo de captura de tela da interface do Platform mostrando Dados de ativação de destinos.

  4. Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem criada no segmento.
    Exemplo de captura de tela da interface do Platform mostrando o segmento.

  5. Por fim, faça logon no site do Salesforce e valide se os perfis do público-alvo foram adicionados ou atualizados.

    Trabalhar com contatos

    • Se você selecionou Contatos no segmento da Platform, navegue até a Apps > Contacts página.

      Captura de tela do Salesforce CRM mostrando a página Contatos com os perfis do segmento.

    • Selecione um Contato e verifique se os campos foram atualizados. Você pode ver que cada status de público-alvo em Salesforce CRM foi atualizado com o status de público-alvo correspondente na Platform, com base na ID do mapeamento valor fornecido durante o agendamento de público.

      Captura de tela do Salesforce CRM mostrando a página Detalhes do contato com status de público-alvo atualizados.

    Trabalhar com clientes em potencial

    • Se você selecionou Clientes potenciais no seu segmento da Platform, em seguida, navegue até a Apps > Leads página.

      Captura de tela do Salesforce CRM mostrando a página de clientes potenciais com os perfis do segmento.

    • Selecione um Lead e verifique se os campos foram atualizados. Você pode ver que cada status de público-alvo em Salesforce CRM foi atualizado com o status de público-alvo correspondente na Platform, com base na ID do mapeamento valor fornecido durante o agendamento de público.

      Captura de tela do Salesforce CRM mostrando a página Detalhes do cliente potencial com status de público-alvo atualizados.

Uso e governança de dados data-usage-governance

Todos Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, consulte o 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.
    Captura de tela da interface do usuário da plataforma mostrando erro.

    • Para corrigir esse erro, verifique se ID do mapeamento que você forneceu no fluxo de trabalho de ativação para a Salesforce CRM destino corresponde exatamente ao valor do tipo de campo personalizado que você criou no Salesforce. Consulte a 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...

Recursos adicionais additional-resources

Informações adicionais úteis do Portal do desenvolvedor do Salesforce está abaixo:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6