Pular para o conteúdo
Rex, seu assistente de IA: o trabalho braçal fica com ele, as ideias ficam com você 👉 Conheça o Rex

Conecte o Bloomreach

Crie uma chave de API no Bloomreach Engagement, conecte-a e crie ou atualize clientes com seus consentimentos.

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

  1. No Bloomreach Engagement, abra o projeto e acesse Project settings > Access management > API.
  2. Copie o Project token e a API base URL exibidos na página.
  3. Em API groups, crie um novo grupo com Private access e dê um nome a ele, por exemplo, “Scratcher”.
  4. Crie uma nova chave de API no grupo. Copie o API key ID e o API secret. O secret é exibido apenas uma vez.
  5. 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

  1. No Scratcher, acesse Configurações > Integrações e clique em Bloomreach.
  2. Cole a API base URL, o project token, o API key ID e o API secret nos campos correspondentes.
  3. Clique em Instalar integração. O Scratcher verifica os dados com o Bloomreach.

Etapa 3: Ative na campanha

  1. No editor, acesse Conectar > Integrações > Bloomreach e clique em Ativar.
  2. Se você conectou mais de um projeto, escolha-o em Selecionar conta.
  3. 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.
  4. Escolha a categoria de consentimento que as pessoas devem receber, por exemplo, “newsletter”, ou nenhuma.
  5. Em Filtrar por permissões (opcional), escolha sua caixa de seleção de consentimento de marketing, para que apenas quem a marcou seja enviado.
  6. 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.
Precisa de ajuda?

Ainda precisa de ajuda?

Pessoas de verdade estão aqui para ajudar. Se você já usa o Scratcher, o jeito mais rápido é o chat dentro da plataforma.

  • Converse com a gente

    Entre na sua conta e clique no botão de chat no canto inferior direito. O Rex responde na hora, e nossa equipe está a um clique.

  • Agende uma reunião

    Uma videochamada gratuita de 30 minutos com nossa equipe: um tour, ideias de campanhas ou ajuda com a configuração.

  • Mande um e-mail

    Escreva para contact@scratcher.io e retornaremos o contato.