Com a integração do Bloomreach, todas as pessoas que se registam são criadas ou atualizadas como cliente (customer) no seu projeto do Bloomreach Engagement, identificadas pelo endereço de e-mail. Também lhes pode dar um consentimento do Bloomreach, para lhes poder enviar marketing.
O que precisa
- Um projeto do Bloomreach Engagement e um utilizador que possa gerir o acesso à API nas definições do projeto (normalmente um administrador do projeto).
Passo 1: criar uma chave da API no Bloomreach
- No Bloomreach Engagement, abra o projeto e vá a Project settings > Access management > API.
- Copie o Project token e o API base URL que aparecem na página.
- Nos grupos de API, crie um novo grupo com Private access e dê-lhe um nome, por exemplo "Scratcher".
- Crie uma nova chave da API no grupo. Copie o API key ID e o API secret. O secret só é mostrado uma vez.
- Dê ao grupo as permissões indicadas abaixo e guarde.
Permissões de que a chave precisa
Nas permissões do grupo, permita:
- Customer properties: get e set, para encontrar clientes e criá-los ou atualizá-los, e para mostrar as suas propriedades de cliente no mapeamento de campos.
- Events: set, para o evento
consent, para que o Scratcher possa registar consentimentos.
Não é necessário mais nada. Sem as permissões set, as entregas falham com o erro de acesso do próprio Bloomreach.
Passo 2: ligar o Bloomreach ao Scratcher
- No Scratcher, vá a Definições > Integrações e clique em Bloomreach.
- Cole o API base URL, o project token, o API key ID e o API secret nos campos correspondentes.
- Clique em Instalar integração. O Scratcher verifica os dados com o Bloomreach.
Passo 3: ativar numa campanha
- No editor, vá a Ligar > Integrações > Bloomreach e clique em Ativar.
- Se tiver ligado mais do que um projeto, escolha-o em Selecionar conta.
- Em Mapeamentos de campos, clique em Adicionar mapeamento de campos e associe cada Campo do Scratcher a uma propriedade de cliente do Bloomreach, por exemplo "Lead - Nome próprio" a first_name.
- Escolha a categoria de consentimento que as pessoas devem receber, por exemplo "newsletter", ou nenhuma.
- 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.
É bom saber: o Bloomreach não tem listas. Todas as pessoas vão para o projeto, e é no Bloomreach que as agrupa com segmentos. Por isso, o Scratcher começa a enviar assim que clica em Ativar. Ative-o antes de a campanha ficar online, ou configure-o de imediato.
Mapeamento de campos
- O endereço de e-mail é sempre enviado e é usado para encontrar o cliente. Não precisa de o associar.
- A lista Campo de destino mostra as propriedades de cliente do seu projeto. Se faltar uma propriedade, crie-a primeiro no Bloomreach.
- Para marcar de onde vieram os clientes, associe um Usar valor personalizado como "Jogo de verão Scratcher" a uma propriedade que use para a origem.
Consentimento
Se escolher uma categoria de consentimento, o Scratcher regista um evento consent com a ação accept e o nome da campanha como origem. A categoria tem de existir no Bloomreach (nas definições de consentimento em Project settings). Use Filtrar por consentimentos para que só as pessoas que assinalaram a sua caixa de marketing recebam o consentimento.
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 cliente é atualizado. Verifique cada entrega em Definições > Integrações > Estado da entrega. 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 o API base URL e o project token, e copie novamente o key ID e o secret.
- As entregas falham com um erro de acesso: falta ao grupo de API uma das permissões acima. Edite-o no Bloomreach.
- O consentimento não aparece no cliente: a categoria de consentimento não existe no Bloomreach, ou está escrita de outra forma.
- O Bloomreach tem os seus próprios guias para as chaves da API. Pesquise "API access management" na documentação do Bloomreach se os menus tiverem outro aspeto.