Com a integração do Emarsys, todas as pessoas que se cadastram são criadas ou atualizadas como contatos no Emarsys e adicionadas à lista de contatos que você escolher.
O que você precisa
- Uma conta no Emarsys e um usuário que possa gerenciar credenciais de API (em Management > Security Settings).
Etapa 1: crie credenciais de API no Emarsys
- No Emarsys, acesse Management > Security Settings > API Credentials.
- Clique em Create API Credentials e não se esqueça de selecionar OpenID Connect.
- Em Permissions, ative estas quatro:
contact.create,contact.update,contactlist.listefield.list. - Salve e copie o Client ID e o Client Secret. Você vai precisar dos dois no Scratcher.
Permissões necessárias para as credenciais
contact.createecontact.update: para criar novos contatos e atualizar os existentes.contactlist.list: para exibir suas listas de contatos na campanha.field.list: para exibir seus campos do Emarsys no mapeamento de campos.
Nenhuma outra permissão é necessária.
Etapa 2: conecte o Emarsys ao Scratcher
- No Scratcher, acesse Configurações > Integrações e clique em Emarsys. O Guia de configuração na janela repete as etapas acima.
- Cole o Client ID e o Client secret.
- Clique em Instalar integração. O Scratcher verifica se consegue ler suas listas de contatos.
Etapa 3: ative a integração em uma campanha
- No editor, acesse Conectar > Integrações > Emarsys e clique em Ativar.
- Se você conectou mais de uma conta, escolha-a em Selecionar conta.
- Em Lista externa, escolha a lista de contatos.
- Em Mapeamento de campos, mapeie pelo menos "Lead - Email" para o campo Email do Emarsys e, em seguida, seus outros campos, por exemplo First Name e Last Name. Os campos do Emarsys são listados pelo nome.
- Em Filtrar por permissões (opcional), escolha sua caixa de seleção de consentimento de marketing.
- Clique em Salvar e depois em Testar.
Mapeamento de campos
- Mapeie o endereço de e-mail você mesmo. O Emarsys o utiliza para encontrar contatos existentes, então um contato sem ele não pode ser identificado.
- Somente os campos que você mapear são enviados.
- Alguns campos de sistema do Emarsys, como opt-in, data de cadastro e newsletter, não são oferecidos, porque o próprio Emarsys os define.
Consentimento
O Scratcher define o campo de opt-in do contato no Emarsys como "true" para todas as pessoas que envia. Por isso, sempre use Filtrar por permissões (opcional) com sua caixa de seleção de consentimento de marketing, caso ela seja opcional no seu formulário.
O que é enviado e quando
Os novos cadastros são enviados em um ou dois minutos, e os leads já existentes da campanha são enviados quando você a ativa. Se o contato já existir, ele é atualizado e adicionado à lista.
Solução de problemas
- "All or some of the fields are invalid..." durante a instalação: o client ID ou o secret está incorreto, ou as credenciais não usam OpenID Connect.
- Os envios falham ou os menus suspensos de lista ou de campos estão vazios: falta uma das quatro permissões nas credenciais. Edite-as no Emarsys.
- Os contatos são criados em duplicidade: "Lead - Email" não está mapeado para o campo Email.