Documentação Experience Platform Guia de destinos

(API) Salesforce Marketing Cloud conexão

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Destinations

Criado para:

Admin
User

Visão geral overview

(API) Salesforce Marketing Cloud (anteriormente conhecido como ExactTarget) é uma suíte de marketing digital que permite criar e personalizar jornadas para visitantes e clientes personalizarem suas experiências.

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 a Salesforce Marketing Cloud Account Engagement mais orientada para a B2B marketing, a (API) Salesforce Marketing Cloud destino é ideal para B2C Casos de uso do com ciclos mais curtos de tomada de decisão transacional. Você pode consolidar conjuntos de dados maiores representando o comportamento do público-alvo para ajustar e melhorar as campanhas de marketing, priorizando e segmentando contatos, especialmente de conjuntos de dados externos Salesforce. Observe que o Experience Platform também tem uma conexão para o Salesforce Marketing Cloud Account Engagement.

Este Adobe Experience Platform destino usa o Salesforce Marketing Cloud atualizar contatos API, que permite adicionar contatos e atualizar dados de contato para as suas necessidades de negócios depois de ativá-las em um novo Salesforce Marketing Cloud segmento.

Salesforce Marketing Cloud O usa o OAuth 2 com credenciais de cliente como o mecanismo de autenticação para se comunicar com o Salesforce Marketing Cloud API. Instruções para autenticar em seu Salesforce Marketing Cloud exemplo, são apresentados mais abaixo, no Autenticar para destino seção.

Casos de uso use-cases

Para ajudá-lo a entender melhor como e quando você deve usar o (API) Salesforce Marketing Cloud destino, este é um exemplo de caso de uso que os clientes do 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 contatos existentes (e seus endereços de email) no Adobe Experience Platform, crie públicos-alvo a partir de seus próprios dados offline e envie esses públicos-alvo 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 os dados para o (API) Salesforce Marketing Cloud destino, você deve ter um schema, um conjunto de dados, e segmentos criado em Experience Platform.

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

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

Você precisa ter um Salesforce Marketing Cloud account prerequisites-account

A Salesforce Marketing Cloud conta com uma assinatura do Marketing Cloud Engagement o produto é obrigatório para continuar.

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

Criar atributos em Salesforce Marketing Cloud prerequisites-attribute

Ao ativar públicos-alvo para a variável (API) Salesforce Marketing Cloud 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 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 Marketing Cloud. 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, você deve ter um atributo do tipo Text vinculado ao Email Demographics extensão de dados no Salesforce Marketing Cloud. Use o Salesforce Marketing Cloud Contact Builder para criar atributos. Consulte a Salesforce Marketing Cloud documentação para criar atributos se você precisar de orientação sobre como criar atributos.

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

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

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

A variável (API) Salesforce Marketing Cloud o destino usa o 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.

Elas são exibidas na guia Campo de destino janela de seleção ao configurar a variável mapeamento no fluxo de trabalho para ativar públicos-alvo para o destino.

IMPORTANT

Dentro de Salesforce Marketing Cloud, você deve criar atributos 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 atributo chamado salesforce_mc_segment_1. Ao ativar um público-alvo para esse destino, adicione salesforce_mc_segment_1 as ID do 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 Salesforce Marketing Cloud 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 sublinhado (_) como separador.
Para distinguir entre atributos usados para públicos da Platform e outros atributos em Salesforce Marketing Cloud, você pode incluir um prefixo ou sufixo reconhecível para os atributos usados para os segmentos de Adobe. Por exemplo, em vez de test_segment, use Adobe_test_segment ou test_segment_Adobe.
Se você já tiver outros atributos criados no Salesforce Marketing Cloud, você pode usar o mesmo nome do segmento da Platform para identificar facilmente o público-alvo no Salesforce Marketing Cloud.

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

Como Salesforce Marketing Cloud O suporta funções personalizadas dependendo do seu caso de uso, seu 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 de quais funções o seu Salesforce Marketing Cloud usuário tiver sido atribuído, também será necessário atribuir permissões ao Salesforce Marketing Cloud extensão de dados vinculada aos campos que você deseja atualizar.

Como esse destino requer acesso à data extension, você precisa permitir. Por exemplo, para a variável 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 a Marketing Cloud Roles e Marketing Cloud Roles and Permissions para obter orientação detalhada.

Coletar Salesforce Marketing Cloud credenciais gather-credentials

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

Credencial

Descrição

Exemplo

Subdomain

Consulte Salesforce Marketing Cloud domain prefix para saber como obter esse valor do Salesforce Marketing Cloud interface.

Se o seu Salesforce Marketing Cloud o domínio é
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
você precisa fornecer mcq4jrssqdlyc4lph19nnqgzzs84 como o valor.

ID do cliente

Consulte a Salesforce Marketing Cloud documentação para saber como obter esse valor do Salesforce Marketing Cloud interface.

r23kxxxxxxxx0z05xxxxxx

Segredo do cliente

Consulte a Salesforce Marketing Cloud documentação para saber como obter esse valor do Salesforce Marketing Cloud interface.

ipxxxxxxxxxxT4xxxxxxxxx

Medidas de proteção guardrails

A Salesforce impõe certas 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 Salesforce Marketing Cloud Preços do compromisso página para Baixe o gráfico de comparação da edição completa como um pdf que detalha os limites impostos pelo seu plano.
- A variável Visão geral da API a página detalha limites adicionais.
- Consultar aqui para uma página que reúne 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 tiver atingido o limite definido para campos personalizados permitidos por objeto no prazo de Salesforce Marketing Cloud será necessário
  - Remova atributos mais antigos antes de adicionar novos atributos no 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 ID do mapeamento durante o agendamento de público etapa.

Identidades suportadas supported-identities

(API) Salesforce Marketing Cloud O oferece 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-alvo gerados pelo Experience Platform Serviço de segmentação.

Uploads personalizados

Públicos-alvo importado 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 campo.
Cada status de segmento em Salesforce Marketing Cloud é 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 Gerenciar destinos permissão 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 (API) Salesforce Marketing Cloud. Como alternativa, você pode localizá-lo na Marketing por email 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 Marketing Cloud credenciais para obter orientação.

(API) Salesforce Marketing Cloud destino

Salesforce Marketing Cloud

Subdomínio

Seu Salesforce Marketing Cloud prefixo do domínio.
Por exemplo, se o domínio for
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com,
você precisa fornecer mcq4jrssqdlyc4lph19nnqgzzs84 como o 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á 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.
Captura de tela da interface do usuário da plataforma mostrando os detalhes do destino.

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.

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

Para ativar os dados, é necessário Exibir destinos, Ativar destinos, Exibir perfis, e Exibir segmentos 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 exportar identidades, você precisará do Exibir gráfico de identidade permissão de controle de acesso.
{width="100" modal="regular"}

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

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

IMPORTANT

Embora seus nomes de atributo sejam os mesmos de acordo com Salesforce Marketing Cloud conta, os mapeamentos para ambos contactKey e personalEmail.address são obrigatórios.
A integração com o Salesforce Marketing Cloud A API está sujeita a um limite de paginação de quantos atributos o Experience Platform pode recuperar do Salesforce. Isso significa que, durante o Mapeamento etapa, o esquema de campo de destino pode exibir no máximo 2000 atributos da sua conta do Salesforce.

No Mapeamento etapa, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
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.

No Selecionar campo de destino escolha a Selecionar namespace de identidade e selecione uma identidade ou escolha Selecionar atributos e selecione um atributo nas extensões de dados exibidas conforme necessário. A variável (API) Salesforce Marketing Cloud o destino usa o 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. Elas são exibidas na guia Campo de destino pop-up ao configurar o mapeamento no ativar fluxo de trabalho de públicos.

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

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

Um exemplo usando esses mapeamentos é mostrado abaixo:

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

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

Por exemplo, se o Salesforce Marketing Cloud atributo é salesforce_mc_segment_1, especifique esse valor no campo (API) Salesforce Marketing Cloud ID do mapeamento para preencher públicos-alvo do Experience Platform nesse atributo.

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

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

Como mostrado na (API) Salesforce Marketing Cloud ID do mapeamento deve corresponder exatamente ao valor especificado Salesforce Marketing Cloud NOME DO CAMPO.

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:

Selecionar Destinos > Procurar para navegar até a lista de destinos.
Selecionar o destino e validar se o status é habilitado.
Alterne para a Activation data 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.
Faça logon no Salesforce Marketing Cloud site. Em seguida, navegue até o Audience Builder > Contact Builder > All contacts > Email e verifique se os perfis do público-alvo foram adicionados.
Para verificar se algum perfil foi atualizado, navegue até o E-mail e verifique se os valores de atributo do perfil do público-alvo foram atualizados. Se tiver sucesso, você poderá ver que cada status de público-alvo em Salesforce Marketing Cloud foi atualizado com o status de público-alvo correspondente na Platform, com base na ID do mapeamento valor fornecido na variável agendamento de público etapa.

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 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.
- Para corrigir esse erro, verifique se ID do mapeamento que você forneceu no fluxo de trabalho de ativação para a (API) Salesforce Marketing Cloud destino corresponde exatamente ao nome do atributo criado no Salesforce Marketing Cloud. Consulte a 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...
- Para corrigir esse erro, entre em contato com o Salesforce Marketing Cloud administrador da conta a adicionar Endereços IP do Experience Platform ao seu Salesforce Marketing Cloud intervalos de IP confiáveis das contas. Consulte a Salesforce Marketing Cloud Endereços IP para inclusão nas Listas de permissões no Marketing Cloud se precisar de orientação adicional.

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 o Pré-requisitos no (API) Salesforce Marketing Cloud e, em geral, removeu 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 dentro do Email Demographics somente extensão de dados. Atualizamos a tabela de mapeamento dentro do Considerações e exemplo de mapeamento seção, o mapeamento para `Email Address` atributo dentro do `Email Addresses` a extensão de dados é marcada como obrigatória, esse requisito foi mencionado na chamada marcada como IMPORTANTE, mas foi omitido da tabela.
Abril de 2023	Atualização da documentação	Corrigimos uma declaração e um link de referência na Pré-requisitos no (API) Salesforce Marketing Cloud seção para chamar isso Salesforce Marketing Cloud Engagement é uma assinatura obrigatória para usar esse destino. A seção anteriormente informava incorretamente que os usuários precisavam de uma assinatura do Marketing Cloud Conta Compromisso para continuar. Adicionamos uma seção em pré-requisitos para funções e permissões a ser atribuído à Salesforce usuário para este destino funcionar. (PLATIR-26299)
Fevereiro de 2023	Atualização da documentação	Atualizamos o Pré-requisitos no (API) Salesforce Marketing Cloud seção para incluir um link de referência chamando isso de Salesforce Marketing Cloud Engagement é uma assinatura obrigatória para usar esse 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 o Pré-requisitos no Salesforce seção para informar que os atributos precisam ser criados na Salesforce lado. 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 agendamento de público etapa. (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