Com a integração do Apsis One, todas as pessoas que se registam são criadas ou atualizadas como perfil no Apsis One, na secção que escolher, e podem ser inscritas numa das suas subscrições do Apsis One.
O que precisa
- Uma conta do Apsis One e um utilizador que possa gerir chaves da API (normalmente um administrador).
- Saber se a sua conta do Apsis One está na região Europa ou Ásia. A maioria das contas está na Europa.
Passo 1: criar uma chave da API no Apsis One
- No Apsis One, abra Account settings e vá a API keys (nas integrações).
- Clique para criar uma nova chave da API. Dê-lhe um nome que reconheça, por exemplo "Scratcher".
- Dê à chave acesso à secção ou às secções para onde quer que o Scratcher envie perfis, com as permissões indicadas abaixo.
- Guarde e copie o Client ID e o Client secret. O secret só é mostrado uma vez.
O Apsis tem o seu próprio guia passo a passo para isto. Tem ligação no Guia de configuração da janela de instalação no Scratcher ("To install the integration, follow the guide here").
Permissões de que a chave precisa
O Scratcher usa a chave para:
- ler as suas secções e os atributos, as subscrições (temas de consentimento) e os eventos que contêm, para que os possa escolher na campanha;
- criar perfis e atualizar os respetivos atributos;
- adicionar consentimentos (opt-ins) aos perfis;
- adicionar eventos aos perfis.
Por isso, a chave precisa de acesso de leitura às secções e de acesso de escrita a perfis, consentimentos e eventos nas secções que usa. Sem acesso de escrita, as entregas falham com a mensagem de erro do próprio Apsis One.
Passo 2: ligar o Apsis One ao Scratcher
- No Scratcher, vá a Definições > Integrações e clique em Apsis One.
- Escolha a Região da API: Europa ou Ásia.
- Cole o ID do cliente e o Client secret.
- Clique em Instalar integração. O Scratcher inicia sessão no Apsis One para verificar os dados.
Passo 3: ativar numa campanha
- No editor, vá a Ligar > Integrações > Apsis One e clique em Ativar.
- Se tiver ligado mais do que uma conta do Apsis One, escolha-a em Selecionar conta.
- Em Secção Apsis, escolha a secção (Selecione uma secção).
- Em Mapeamentos de campos, clique em Adicionar mapeamento de campos para cada campo e associe o Campo do Scratcher ao atributo do Apsis One em Campo de destino. A lista mostra os atributos da secção que escolheu, incluindo os seus.
- Em Subscrições (consentimentos), escolha a subscrição em que as pessoas devem ser inscritas, ou Nenhum. "Escolha a subscrição em que o participante deve ser inscrito."
- Em Filtrar por consentimentos (opcional), escolha a sua caixa de consentimento de marketing, para que só sejam enviadas as pessoas que a assinalaram.
- Clique em Guardar e depois em Testar para enviar um perfil de teste.
Mapeamento de campos
- O endereço de e-mail é sempre enviado e é usado para identificar o perfil. Não precisa de o associar.
- Nos números de telefone, use a definição Formato para enviar o número da forma que o seu atributo espera.
- Os atributos sim/não recebem true ou false, por isso associe o campo Aceite de um consentimento a um atributo sim/não.
Consentimento
Se escolher uma subscrição, cada pessoa é inscrita nela com o motivo "Subscribed via" e o nome da campanha, e a origem "Scratcher". Se a pessoa já estiver inscrita, nada muda. Use Filtrar por consentimentos para que só sejam inscritas as pessoas que assinalaram a sua caixa de marketing.
Se a sua secção tiver o evento de formulário de consentimento do Apsis One, o Scratcher regista também o registo como evento no perfil, com o endereço da campanha.
O que é enviado e quando
Os novos registos são enviados em um ou dois minutos. Quando ativa a integração, os leads existentes da campanha também são enviados. Quando alguém volta a participar, o seu perfil é atualizado. Verifique cada entrega em Definições > Integrações > Estado da entrega; também mostra se o perfil era novo ou já existia. Consulte Verifique o estado da entrega e reenvie leads.
Resolução de problemas
- "Alguns ou todos os campos são inválidos..." ao instalar: verifique a região e copie novamente o client ID e o secret.
- As entregas falham com um erro de acesso do Apsis One: a chave não tem acesso à secção, ou não tem permissões de escrita. Edite a chave no Apsis One.
- Subscrições (consentimentos) está vazio: a secção ainda não tem subscrições. Crie uma no Apsis One e abra novamente a integração.