DocumentaçãoExperience PlatformGuia de destinos

(API) Salesforce Marketing Cloud conexão

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Usuário

Visão geral overview

(API) Salesforce Marketing Cloud (antigo ExactTarget) é um conjunto de marketing digital que permite a você criar e personalizar jornadas para visitantes e clientes para personalizar sua experiência.

IMPORTANT
Observe a diferença entre essa conexão e a outra Salesforce Marketing Cloud conexão que existe na seção Catálogo de marketing por email. A outra conexão do Salesforce Marketing Cloud permite exportar arquivos para um local de armazenamento especificado, enquanto essa é uma conexão de transmissão baseada em API.

Comparado ao Salesforce Marketing Cloud Account Engagement, que é mais orientado para marketing B2B, o destino (API) Salesforce Marketing Cloud é ideal para casos de uso do B2C com ciclos de tomada de decisão transacionais mais curtos. Você pode consolidar conjuntos de dados maiores, representando o comportamento do seu público-alvo, para ajustar e melhorar as campanhas de marketing, priorizando e segmentando contatos, especialmente de conjuntos de dados fora do Salesforce. Observação: o Experience Platform também tem uma conexão para Salesforce Marketing Cloud Account Engagement.

Este Adobe Experience Platform destino usa a API de Salesforce Marketing Cloud atualização de contatos, que permite adicionar contatos e atualizar dados de contato para as suas necessidades comerciais depois de ativá-los em um novo segmento Salesforce Marketing Cloud.

Salesforce Marketing Cloud usa OAuth 2 com Credenciais de Cliente como o mecanismo de autenticação para se comunicar com a API Salesforce Marketing Cloud. As instruções para autenticar na sua instância do Salesforce Marketing Cloud estão mais abaixo, na seção Autenticar no destino.

Casos de uso use-cases

Para ajudá-lo a entender melhor como e quando você deve usar o destino (API) Salesforce Marketing Cloud, veja um exemplo de caso de uso que os clientes da Adobe Experience Platform podem resolver usando esse destino.

Enviar emails para contatos de campanhas de marketing use-case-send-emails

O departamento de vendas de uma plataforma de aluguel de residências quer transmitir um email de marketing para um público-alvo de clientes direcionado. A equipe de marketing da plataforma pode adicionar novos contatos / atualizar os contatos existentes (e seus endereços de email) por meio do Adobe Experience Platform, criar públicos a partir de seus próprios dados offline e enviar esses públicos para Salesforce Marketing Cloud, que pode ser usado para enviar o email da campanha de marketing.

Pré-requisitos prerequisites

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

Antes de ativar dados para o destino (API) Salesforce Marketing Cloud, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform.

Pré-requisitos em (API) Salesforce Marketing Cloud prerequisites-destination

Observe os seguintes pré-requisitos para exportar dados da Platform para sua conta do Salesforce Marketing Cloud:

Você precisa ter uma conta Salesforce Marketing Cloud prerequisites-account

Uma conta do Salesforce Marketing Cloud com uma assinatura do produto Marketing Cloud Engagement é obrigatória para continuar.

Entre em contato com o Salesforce Suporte se você não tiver uma conta do Salesforce Marketing Cloud ou se sua conta não tiver a assinatura do produto Marketing Cloud Engagement.

Criar atributos em Salesforce Marketing Cloud prerequisites-attribute

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

Salesforce 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 Marketing Cloud. 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, você deve ter um atributo do tipo Text vinculado à extensão de dados Email Demographics no Salesforce Marketing Cloud. Use o Salesforce Marketing Cloud Contact Builder para criar atributos. Consulte a documentação do Salesforce Marketing Cloud para criar atributos se precisar de orientação sobre como criar atributos.

Os nomes de campo de atributo são usados para o campo de destino (API) Salesforce Marketing Cloud durante a etapa Mapping. Você pode definir o caractere de campo com no máximo 4.000 caracteres, de acordo com sua necessidade comercial. Consulte a página de documentação de Salesforce Marketing Cloud Tipos de dados das extensões de dados para obter informações adicionais sobre tipos de atributos.

Um exemplo da tela do designer de dados em Salesforce Marketing Cloud, na qual você adicionará o atributo, é mostrado abaixo:
Designer de dados da interface do usuário do Marketing Cloud do Salesforce.

Uma exibição de um grupo de atributos Salesforce Marketing Cloud Email Data com atributos correspondentes ao status do público-alvo na extensão de dados Email Demographics é mostrada abaixo:
Grupo de atributos de dados de email da interface do usuário do Marketing Cloud do Salesforce.

O destino (API) Salesforce Marketing Cloud usa a Salesforce Marketing Cloud Search Attribute-Set Definitions REST API para recuperar dinamicamente as extensões de dados e seus atributos vinculados' definidos em Salesforce Marketing Cloud.

Eles são exibidos na janela de seleção Campo de destino quando você configura o mapeamento no fluxo de trabalho para ativar públicos para o destino.

IMPORTANT
Em Salesforce Marketing Cloud, você deve criar atributos 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 atributo chamado salesforce_mc_segment_1. Ao ativar um público-alvo para esse destino, adicione salesforce_mc_segment_1 como ID de Mapeamento para preencher públicos-alvo do Experience Platform nesse atributo.

Um exemplo de criação de atributo em Salesforce Marketing Cloud, é mostrado abaixo:
Captura de tela da interface do usuário do Marketing Cloud do Salesforce mostrando um atributo.

TIP
  • Ao criar o atributo, não inclua caracteres de espaço em branco no nome do campo. Em vez disso, use o caractere de sublinhado (_) como separador.
  • Para distinguir entre atributos usados para públicos da Platform e outros atributos dentro de Salesforce Marketing Cloud, você pode incluir um prefixo ou sufixo reconhecível para os atributos usados para segmentos Adobe. Por exemplo, em vez de test_segment, use Adobe_test_segment ou test_segment_Adobe.
  • Se você já tiver outros atributos criados em Salesforce Marketing Cloud, poderá usar o mesmo nome do segmento da Platform para identificar facilmente o público-alvo em Salesforce Marketing Cloud.

Atribuir funções e permissões de usuário em Salesforce Marketing Cloud prerequisites-roles-permissions

Como o Salesforce Marketing Cloud oferece suporte a funções personalizadas, dependendo do seu caso de uso, o usuário deve receber as funções relevantes para atualizar seus atributos no Salesforce Marketing Cloud. Um exemplo de funções atribuídas a um usuário é mostrado abaixo:
Interface do usuário do Salesforce Marketing Cloud para um usuário selecionado que mostra suas funções atribuídas.

Dependendo das funções atribuídas ao usuário Salesforce Marketing Cloud, também será necessário atribuir permissões para a extensão de dados Salesforce Marketing Cloud, que estão vinculadas aos campos que você deseja atualizar.

Como esse destino requer acesso ao data extension, é necessário permitir. Por exemplo, para o Email data extension, você precisa permitir, conforme mostrado abaixo:

Interface do usuário do Salesforce Marketing Cloud mostrando a extensão de dados de email com permissões permitidas.

Para restringir o nível de acesso, você também pode substituir o acesso individual usando privilégios granulares.
Interface do usuário do Salesforce Marketing Cloud mostrando a extensão de dados de email com permissões granulares.

Consulte as páginas Marketing Cloud Roles e Marketing Cloud Roles and Permissions para obter orientação detalhada.

Obter credenciais de Salesforce Marketing Cloud gather-credentials

Anote os itens abaixo antes de autenticar no destino (API) Salesforce Marketing Cloud.

Credencial
Descrição
Exemplo
Subdomain
Consulte Salesforce Marketing Cloud domain prefix para saber como obter esse valor na interface Salesforce Marketing Cloud.
Se o domínio Salesforce Marketing Cloud for
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
você precisa fornecer mcq4jrssqdlyc4lph19nnqgzzs84 como o valor.
ID de cliente
Consulte a Salesforce Marketing Cloud documentação para saber como obter este valor da interface Salesforce Marketing Cloud.
r23kxxxxxxxx0z05xxxxxx
Segredo do cliente
Consulte a Salesforce Marketing Cloud documentação para saber como obter este valor da interface Salesforce Marketing Cloud.
ipxxxxxxxxxxT4xxxxxxxxx

Medidas de proteção guardrails

  • O Salesforce impõe determinados limites de taxa.

    • Consulte a Salesforce Marketing Cloud documentação para resolver quaisquer limites prováveis que você possa encontrar e reduzir erros durante a execução.
    • Consulte a página Salesforce Marketing Cloud Preços do Envolvimento para Baixar o Gráfico de Comparação da Edição Completa como um pdf que detalha os limites impostos pelo seu plano.
    • A página Visão geral da API detalha limites adicionais.
    • Consulte aqui para obter uma página que reúna esses detalhes.

  • A contagem de campos personalizados permitidos por objeto varia de acordo com sua Edição do Salesforce.

    • Consulte a Salesforce documentação para obter orientação adicional.

    • Se você atingiu o limite definido para campos personalizados permitidos por objeto em Salesforce Marketing Cloud, será necessário

      • Remova os atributos mais antigos antes de adicionar novos atributos em Salesforce Marketing Cloud.
      • Atualize ou remova qualquer público ativado nos destinos da Platform que usam esses nomes de atributo mais antigos como o valor fornecido para a ID de Mapeamento durante a etapa agendamento de público-alvo.

Identidades suportadas supported-identities

(API) Salesforce Marketing Cloud dá suporte à ativação das identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino
Descrição
Considerações
contactKey
Salesforce Marketing Cloud Chave do Contato. Consulte a Salesforce Marketing Cloud documentação se precisar de orientação adicional.
Obrigatório

Públicos-alvo compatíveis supported-audiences

Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.

Origem do público
Suportado
Descrição
Segmentation Service
✓
Públicos gerados por meio do Serviço de segmentação do Experience Platform.
Uploads personalizados
X
Públicos importados para o Experience Platform de arquivos CSV.

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 segmento em Salesforce Marketing Cloud é atualizado com o status de público 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 da Permissão de controle de acesso Gerenciar Destinos. 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, procure por (API) Salesforce Marketing Cloud. Como alternativa, você pode localizá-lo na categoria Email marketing.

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 Marketing Cloud credenciais para obter qualquer orientação.

(API) Salesforce Marketing Cloud destino
Salesforce Marketing Cloud
Subdomínio
O prefixo de domínio Salesforce Marketing Cloud.
Por exemplo, se seu domínio for
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
é necessário fornecer mcq4jrssqdlyc4lph19nnqgzzs84 como valor.
ID do cliente
Seu Salesforce Marketing Cloud Client ID.
Segredo do cliente
Seu Salesforce Marketing Cloud Client Secret.

Captura de tela da interface do usuário da Platform mostrando como autenticar no Salesforce Marketing Cloud.

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.
Captura de tela da Interface do Usuário da Plataforma mostrando os detalhes de destino.

  • 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.

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

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 (API) Salesforce Marketing Cloud, é 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.

Para mapear corretamente os campos XDM para os campos de destino (API) Salesforce Marketing Cloud, siga as etapas abaixo.

IMPORTANT

  • Embora seus nomes de atributos sejam iguais aos da conta do Salesforce Marketing Cloud, os mapeamentos para contactKey e personalEmail.address são obrigatórios.

  • A integração com a API Salesforce Marketing Cloud está sujeita a um limite de paginação de quantos atributos o Experience Platform pode recuperar do Salesforce. Isso significa que durante a etapa Mapping, o esquema de campo de destino pode exibir no máximo 2000 atributos da sua conta do Salesforce.

  1. Na etapa Mapeamento, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
    Exemplo de captura de tela da interface do usuário da plataforma para Adicionar novo mapeamento.

  2. 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.

  3. Na janela Selecionar campo de destino, escolha o Selecionar namespace de identidade e selecione uma identidade ou escolha a categoria Selecionar atributos e selecione um atributo nas extensões de dados exibidas conforme necessário. O destino (API) Salesforce Marketing Cloud usa a Salesforce Marketing Cloud Search Attribute-Set Definitions REST API para recuperar dinamicamente as extensões de dados e seus atributos vinculados' definidos em Salesforce Marketing Cloud. Eles são exibidos no pop-up Campo de destino quando você configura o mapeamento no fluxo de trabalho para ativar públicos.

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

      table 0-row-3 1-row-3 2-row-3 3-row-3
      Campo de origem Campo de público alvo Obrigatório
      IdentityMap: contactKey Identity: salesforceContactKey Mandatory
      xdm: personalEmail.address Attribute: Email Address da extensão de dados Salesforce Marketing Cloud Email Addresses. Mandatory, ao adicionar novos contatos.
      xdm: person.name.firstName Attribute: First Name da extensão de dados Salesforce Marketing Cloud desejada. -

    • Um exemplo usando esses mapeamentos é mostrado abaixo:

      Exemplo de captura de tela da interface do usuário da plataforma mostrando os mapeamentos do Target.

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 da Platform para os atributos em Salesforce Marketing Cloud.

Para fazer isso, selecione cada segmento e digite o nome do atributo de Salesforce Marketing Cloud no campo (API) Salesforce Marketing Cloud ID de Mapeamento. Consulte a seção Criar atributo em Salesforce Marketing Cloud para obter orientação e práticas recomendadas sobre como criar atributos em Salesforce Marketing Cloud.

Por exemplo, se o atributo Salesforce Marketing Cloud for salesforce_mc_segment_1, especifique esse valor na (API) Salesforce Marketing Cloud ID de Mapeamento para preencher públicos-alvo do Experience Platform para esse atributo.

Um exemplo de atributo de Salesforce Marketing Cloud é mostrado abaixo:
Captura de tela da interface do usuário do Marketing Cloud do Salesforce mostrando um atributo.

Um exemplo indicando o local da (API) Salesforce Marketing Cloud 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, a (API) Salesforce Marketing Cloud ID do Mapeamento deve corresponder exatamente ao valor especificado em Salesforce Marketing Cloud NOME DO CAMPO.

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

Um exemplo típico com base na imagem mostrada acima pode ser.

Nome do segmento (API) Salesforce Marketing Cloud
Salesforce Marketing Cloud NOME DO CAMPO
(API) Salesforce Marketing Cloud ID de Mapeamento
público-alvo do salesforce mc 1
salesforce_mc_segment_1
salesforce_mc_segment_1
salesforce mc audience 2
salesforce_mc_segment_2
salesforce_mc_segment_2

Validar exportação de dados exported-data

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

  1. Selecione 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. Selecione o destino e valide 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 guia Activation data e selecione um nome de público-alvo.
    Exemplo de captura de tela da interface do usuário da plataforma 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 Usuário da Plataforma mostrando o Segmento.

  5. Faça logon no site Salesforce Marketing Cloud. Navegue até a página Audience Builder > Contact Builder > All contacts > Email e verifique se os perfis do público-alvo foram adicionados.
    Captura de tela da interface do usuário do Marketing Cloud do Salesforce mostrando a página Contatos com perfis usados no segmento.

  6. Para verificar se algum perfil foi atualizado, navegue até a página Email e verifique se os valores de atributo do perfil do público-alvo foram atualizados. Se for bem-sucedido, você poderá ver que cada status de público-alvo em Salesforce Marketing Cloud foi atualizado com o status de público-alvo correspondente da Platform, com base no valor ID de Mapeamento fornecido na etapa agendamento de público-alvo.
    Captura de tela da interface do usuário do Marketing Cloud do Salesforce mostrando a página de Email dos Contatos selecionada com status de público atualizado.

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 por push para o Marketing Cloud do Salesforce 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 a ID de Mapeamento fornecida no fluxo de trabalho de ativação para o destino (API) Salesforce Marketing Cloud corresponde exatamente ao nome do atributo criado em Salesforce Marketing Cloud. Consulte a seção Criar atributo em Salesforce Marketing Cloud 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

  • Salesforce Marketing Cloud API
  • Salesforce Marketing Cloud documentação explicando como os contatos são atualizados com as informações especificadas.

Changelog changelog

Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.

Exibir changelog
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Mês de lançamento Tipo de atualização Descrição
Outubro de 2023 Atualização da documentação
  • Atualizamos os Pré-requisitos na seção Marketing Cloud do Salesforce (API) e, em geral, removemos referências desnecessárias a grupos de atributos no documento.
  • Atualização da documentação para indicar que os atributos para os status de públicos-alvo devem ser criados em Salesforce Marketing Cloud somente dentro da extensão de dados Email Demographics.
  • Atualizamos a tabela de mapeamento na seção Considerações de mapeamento e exemplo. O mapeamento do atributo Email Address na extensão de dados Email Addresses está marcado como obrigatório. Esse requisito foi mencionado no texto explicativo marcado como IMPORTANTE, mas foi omitido da tabela.
Abril de 2023 Atualização da documentação
  • Corrigimos uma instrução e um link de referência na seção Pré-requisitos no Marketing Cloud do Salesforce (API) para informar que Salesforce Marketing Cloud Engagement é uma assinatura obrigatória para usar esse destino. A seção anteriormente informava incorretamente que os usuários precisam de uma assinatura para o Compromisso de Conta do Marketing Cloud para continuar.
  • Adicionamos uma seção em pré-requisitos para que funções e permissões sejam atribuídas ao usuário Salesforce para que este destino funcione. (PLATIR-26299)
Fevereiro de 2023 Atualização da documentação Atualizamos os Pré-requisitos na seção Marketing Cloud do Salesforce (API) para incluir um link de referência que informa que Salesforce Marketing Cloud Engagement é uma assinatura obrigatória para usar este destino.
Fevereiro de 2023 Atualização de funcionalidade Corrigimos um problema em que uma configuração incorreta no destino estava causando o envio de um JSON malformado para o Salesforce. Isso resultou em alguns usuários vendo altos números de identidades que falharam na ativação. (PLATIR-26299)
Janeiro de 2023 Atualização da documentação
  • Atualizamos a seção Pré-requisitos em Salesforce para informar que os atributos precisam ser criados no lado Salesforce. Esta seção agora inclui instruções detalhadas sobre como fazer isso e práticas recomendadas para nomear os atributos em Salesforce. (PLATIR-25602)
  • Adicionamos instruções claras sobre como usar a ID de mapeamento para cada público ativado na etapa agendamento de público-alvo. (PLATIR-25602)
Outubro de 2022 Versão inicial Versão inicial de destino e publicação da documentação.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6