Saltar para o conteúdo
Rex, o seu assistente de IA: o trabalho repetitivo fica tratado. As ideias são suas 👉 Conheça o Rex

Ligue o Bloomreach

Crie uma chave da API no Bloomreach Engagement, ligue-a e crie ou atualize clientes com os respetivos consentimentos.

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

  1. No Bloomreach Engagement, abra o projeto e vá a Project settings > Access management > API.
  2. Copie o Project token e o API base URL que aparecem na página.
  3. Nos grupos de API, crie um novo grupo com Private access e dê-lhe um nome, por exemplo "Scratcher".
  4. Crie uma nova chave da API no grupo. Copie o API key ID e o API secret. O secret só é mostrado uma vez.
  5. 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

  1. No Scratcher, vá a Definições > Integrações e clique em Bloomreach.
  2. Cole o 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.

Passo 3: ativar numa campanha

  1. No editor, vá a Ligar > Integrações > Bloomreach e clique em Ativar.
  2. Se tiver ligado mais do que um projeto, escolha-o em Selecionar conta.
  3. 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.
  4. Escolha a categoria de consentimento que as pessoas devem receber, por exemplo "newsletter", ou nenhuma.
  5. Em Filtrar por consentimentos (opcional), escolha a sua caixa de consentimento de marketing, para que só sejam enviadas as pessoas que a assinalaram.
  6. 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.
Precisa de ajuda?

Ainda precisa de ajuda?

Há pessoas reais prontas para ajudar. Se já usa o Scratcher, o mais rápido é o chat dentro da plataforma.

  • Fale connosco no chat

    Inicie sessão e clique no botão de chat no canto inferior direito. O Rex responde de imediato e a nossa equipa está à distância de um clique.

  • Marque uma reunião

    Uma videochamada gratuita de 30 minutos com a nossa equipa: uma demonstração, ideias de campanhas ou ajuda com a sua configuração.

  • Envie-nos um e-mail

    Escreva para contact@scratcher.io e entraremos em contacto consigo.