Com a integração do Emarsys, todas as pessoas que se registam são criadas ou atualizadas como contacto no Emarsys e adicionadas à lista de contactos que escolher.
O que precisa
- Uma conta do Emarsys e um utilizador que possa gerir credenciais de API (em Management > Security Settings).
Passo 1: criar credenciais de API no Emarsys
- No Emarsys, vá a Management > Security Settings > API Credentials.
- Clique em Create API Credentials e certifique-se de que seleciona OpenID Connect.
- Em Permissions, ative estas quatro:
contact.create,contact.update,contactlist.listefield.list. - Guarde e copie o Client ID e o Client Secret. Precisa de ambos no Scratcher.
Permissões de que as credenciais precisam
contact.createecontact.update: para criar novos contactos e atualizar os existentes.contactlist.list: para mostrar as suas listas de contactos na campanha.field.list: para mostrar os seus campos do Emarsys no mapeamento de campos.
Não são necessárias outras permissões.
Passo 2: ligar o Emarsys ao Scratcher
- No Scratcher, vá a Definições > Integrações e clique em Emarsys. O Guia de configuração na janela repete os passos acima.
- Cole o ID do cliente e o Client secret.
- Clique em Instalar integração. O Scratcher verifica se consegue ler as suas listas de contactos.
Passo 3: ativar numa campanha
- No editor, vá a Ligar > Integrações > Emarsys e clique em Ativar.
- Se tiver ligado mais do que uma conta, escolha-a em Selecionar conta.
- Em Lista externa, escolha a lista de contactos.
- Em Mapeamentos de campos, associe pelo menos "Lead - E-mail" ao campo Email do Emarsys e depois os seus outros campos, por exemplo First Name e Last Name. Os campos do Emarsys aparecem pelo nome.
- Em Filtrar por consentimentos (opcional), escolha a sua caixa de consentimento de marketing.
- Clique em Guardar e depois em Testar.
Mapeamento de campos
- Associe o endereço de e-mail você mesmo. O Emarsys usa-o para encontrar contactos existentes, por isso um contacto sem ele não pode ser associado.
- Só são enviados os campos que associar.
- Alguns campos de sistema do Emarsys, como o opt-in, a data de registo e a newsletter, não são oferecidos, porque é o próprio Emarsys que os define.
Consentimento
O Scratcher define o campo de opt-in do contacto no Emarsys como "true" para todas as pessoas que envia. Por isso, use sempre Filtrar por consentimentos (opcional) com a sua caixa de consentimento de marketing, se ela for opcional no seu formulário.
O que é enviado e quando
Os novos registos são enviados em um ou dois minutos, e os leads existentes da campanha são enviados quando ativa a integração. Se o contacto já existir, é atualizado e adicionado à lista.
Resolução de problemas
- "Alguns ou todos os campos são inválidos..." ao instalar: o client ID ou o secret estão errados, ou as credenciais não usam OpenID Connect.
- As entregas falham, ou os menus pendentes de listas ou de campos estão vazios: falta às credenciais uma das quatro permissões. Edite-as no Emarsys.
- Os contactos são criados em duplicado: "Lead - E-mail" não está associado ao campo Email.