Você está aqui:
Preparar-se para usar formulários em um site externo
Antes de integrar um formulário a um site externo, configure sua organização do Salesforce para que o site possa se comunicar com seu site do Experience Cloud.
Edições obrigatórias
| Disponível em: Edições Enterprise e Unlimited do Salesforce com o Marketing Cloud Next Growth ou Advanced Edition e nas edições Starter e Pro Suite. Sua edição determina as opções que você tem. |
| Permissões de usuário necessárias | |
|---|---|
| Para configurar formulários para sites externos: | Modificar todos os dados OU Conjunto de permissões de Administrador do Marketing Cloud OU Personalizar aplicativo E Gerenciar experiências |
Antes de começar, certifique-se de que estes itens estejam prontos:
- Você tem um site ativo do Experience Cloud conectado à sua instância Marketing Cloud Next.
- Seu formulário Marketing Cloud Next é publicado e você tem o código de inserção gerado, que consiste em duas tags de
<script>e um elemento de fragmento HTML personalizado. - Você identificou o URL de origem completo do site externo em que planeja integrar o formulário.
- O site externo oferece suporte à execução de JavaScript e à integração de iframe.
- Para garantir que as atividades sejam rastreadas, configure seu site para usar o rastreamento de primeira parte alinhando todas as suas páginas da Web e conteúdo do Salesforce em seu domínio raiz. Os padrões do setor estão se afastando do rastreamento de cookies de terceiros e recomendamos usar o alinhamento de domínio de primeira parte.
Consulte também:
Adicionar o site externo ao compartilhamento de recurso entre origens (CORS)
Adicione o site externo como uma origem para solicitações entre origens entre o site e sua organização do Salesforce. O Compartilhamento de recurso entre origens (CORS) permite aos navegadores da Web solicitar recursos de outras origens.
- Em Configuração, pesquise e selecione Lista de origens permitidas CORS.
- Clique em Novo.
-
Para Padrão de URL de origem, insira a origem do site externo. Por exemplo,
https://www.example.com. - Clique em Salvar.
Configurar proteção contra clickjack
Atualize a proteção contra clickjack no site do Experience Cloud para que sites externos possam integrar o conteúdo do seu site em um iframe do Salesforce. O código de integração do formulário depende do Lightning Out, que é um recurso que cria um iframe para carregar conteúdo do seu site do Experience Cloud.
Você pode definir a proteção contra clickjack para um destes níveis:
- Permitir quadros das páginas do site em domínios externos (boa proteção): Selecione essa opção se estiver hospedando o formulário em um site em que seu HTML seja executado diretamente na página. Por exemplo, um site personalizado, CMS ou provedor de hospedagem estático. Esse nível de proteção restringe o quadro aos domínios que você adiciona, mantendo a proteção contra clickjack enquanto ativa o código de integração de formulário.
- Permitir quadros de qualquer página (sem proteção): Selecione essa opção se estiver hospedando o formulário em uma plataforma que gere vários URLs entre seu site e o iframe do Salesforce. Como os URLs são dinâmicos, não é possível adicioná-los à lista Domínios confiáveis com antecedência. Por exemplo, o Google Sites usa domínios como
www.gstatic.come*.atari-embeds.googleusercontent.compara incorporar conteúdo.
Importante Essa opção remove todas as restrições de clickjack no site do Experience Cloud, o que significa que qualquer página externa pode estruturá-lo. Use-o apenas quando permitir quadros de páginas do site em domínios externos (boa proteção) não for compatível com sua plataforma de hospedagem.
- Em Configuração, pesquise e selecione Todos os sites.
- Ao lado do site do Experience Cloud conectado aos formulários do Marketing Cloud, clique em Criador.
- No Criador de experiências, selecione Configurações | Segurança e privacidade.
-
Em Nível de proteção contra clickjack, selecione um nível de proteção contra clickjack com base em sua plataforma de hospedagem externa.
Se você selecionar Permitir quadros de páginas do site em domínios externos (boa proteção), adicione domínios externos nos quais você planeja integrar o formulário.
- Em Domínios confiáveis para quadros embutidos, clique em + Adicionar domínio confiável.
-
Insira o URL do site externo. Por exemplo,
https://www.example.com. - Repita as etapas para cada domínio externo.
Adicionar o domínio externo como um site confiável para scripts
Habilite scripts do site externo para interagir com seu site do Experience Cloud.
- No Criador de experiências, selecione Configurações | Segurança e privacidade.
- Em Sites confiáveis para scripts, clique em + Adicionar site confiável.
- Para Nome do site confiável, insira um nome descritivo para o site.
-
Para o URL do site confiável, insira o URL do site externo. Por exemplo,
https://www.example.com. - Verifique se o status está ativo.
- Clique em Salvar.
Publicar o site do Experience Cloud
Publique o site do Experience Cloud para garantir que as alterações de configuração no Criador de experiências entrem em vigor. Sempre republique o site depois de atualizar as configurações de segurança. Ignorar a publicação faz com que seu formulário externo mostre um erro de Política de segurança de conteúdo de frame-ancestors 'self'.
- Na barra de ferramentas do Criador de experiências, clique em Publicar.
- Clique novamente em Publicar.
- Aguarde a conclusão do processo de publicação.
Adicionar o código de integração ao seu site externo
Depois de configurar sua organização do Salesforce, copie o código de integração gerado automaticamente do formulário publicado e adicione-o ao seu site externo.
- Na guia Conteúdo, abra o formulário publicado para edição.
- Na guia Integrar, clique em Copiar código para copiar o snippet de código de integração para sua área de transferência.
-
Cole todo o snippet de código no HTML do site externo no local em que deseja que o formulário apareça.
-
Coloque as duas marcas de
<script>para hospedagem e a barra de inicialização do Lightning Out acima do local pretendido do formulário. -
Insira o elemento de
<fragment>HTML personalizado que serve como o contêiner do formulário exatamente onde o formulário deve ser renderizado.
-
Coloque as duas marcas de
O código de integração é gerado a partir da versão publicada do formulário. Se você atualizar o conteúdo do formulário, republique o formulário para atualizar o código de integração.
(Opcional) Configurar rastreamento da Web
Acompanhe interações do visitante em seu site externo usando um atributo no elemento de fragmento. Quando definido como verdadeiro, o formulário usa o SDK da Web Data 360 para rastrear as interações.
-
Para ativar o rastreamento da Web, defina a
data-web-tracking="true"e configure o conector do Data 360 Web SDK.Quando o rastreamento da Web estiver ativado, mas o SDK da Web Data 360 não estiver configurado, o console do navegador mostrará uma mensagem informando que o SDK da Web não está disponível. Essa mensagem é informativa e não impede que o formulário gere ou aceite envios.
-
Para desativar o rastreamento da Web, defina
data-web-tracking="false".
