Com a integração do Bloomreach, todos que se cadastram são criados ou atualizados como clientes no seu projeto do Bloomreach Engagement, identificados pelo endereço de e-mail. Você também pode atribuir a eles um consentimento do Bloomreach, para poder enviar comunicações de marketing.
O que você precisa
- Um projeto no Bloomreach Engagement e um usuário que possa gerenciar o acesso à API nas configurações do projeto (normalmente um administrador do projeto).
Etapa 1: Crie uma chave de API no Bloomreach
- No Bloomreach Engagement, abra o projeto e acesse Project settings > Access management > API.
- Copie o Project token e a API base URL exibidos na página.
- Em API groups, crie um novo grupo com Private access e dê um nome a ele, por exemplo, “Scratcher”.
- Crie uma nova chave de API no grupo. Copie o API key ID e o API secret. O secret é exibido apenas uma vez.
- Conceda ao grupo as permissões abaixo e salve.
Permissões necessárias para a chave
Nas permissões do grupo, permita:
- Customer properties: get e set, para localizar clientes, criá-los ou atualizá-los e exibir as propriedades de cliente no mapeamento de campos.
- Events: set, para o evento
consent, para que o Scratcher possa registrar consentimentos.
Nada mais é necessário. Sem as permissões de set, os envios falham com o erro de acesso do próprio Bloomreach.
Etapa 2: Conecte o Bloomreach ao Scratcher
- No Scratcher, acesse Configurações > Integrações e clique em Bloomreach.
- Cole a 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.
Etapa 3: Ative na campanha
- No editor, acesse Conectar > Integrações > Bloomreach e clique em Ativar.
- Se você conectou mais de um projeto, escolha-o em Selecionar conta.
- Em Mapeamento de campos, clique em Adicionar mapeamento de campo e associe cada Campo do Scratcher a uma propriedade de cliente do Bloomreach, por exemplo, “Lead - Nome” a first_name.
- Escolha a categoria de consentimento que as pessoas devem receber, por exemplo, “newsletter”, ou nenhuma.
- Em Filtrar por permissões (opcional), escolha sua caixa de seleção de consentimento de marketing, para que apenas quem a marcou seja enviado.
- Clique em Salvar e depois em Testar.
Bom saber: o Bloomreach não tem listas. Todos entram no projeto, e você os agrupa com segmentos no Bloomreach. Por isso, o Scratcher começa a enviar assim que você clica em Ativar. Ative antes de a campanha entrar no ar ou configure tudo imediatamente.
Mapeamento de campos
- O endereço de e-mail é sempre enviado e usado para localizar o cliente. Não é preciso mapeá-lo.
- A lista Campo de destino mostra as propriedades de cliente do seu projeto. Se faltar alguma, crie a propriedade no Bloomreach primeiro.
- Para indicar a origem dos clientes, mapeie um Usar valor personalizado, como “Jogo de verão Scratcher”, para uma propriedade que você usa como origem.
Consentimento
Se você escolher uma categoria de consentimento, o Scratcher registra um evento consent com a ação accept e o nome da campanha como origem. A categoria precisa existir no Bloomreach (nas configurações de consentimento em Project settings). Use Filtrar por permissões para que apenas quem marcou sua caixa de marketing receba o consentimento.
O que é enviado e quando
Novos cadastros são enviados em um ou dois minutos. Ao ativar a integração, os leads já existentes da campanha também são enviados. Quando alguém participa novamente, o cliente é atualizado. Confira cada envio em Configurações > Integrações > Status de envio. Veja Verifique o status de envio e reenvie leads.
Solução de problemas
- “All or some of the fields are invalid...” ao instalar: verifique a API base URL e o project token e copie novamente o key ID e o secret.
- Os envios falham com um erro de acesso: falta alguma das permissões acima no grupo de API. 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 seus próprios guias sobre chaves de API. Pesquise “API access management” na documentação do Bloomreach se os menus estiverem diferentes.