Ir al contenido
Rex, tu asistente de IA: el trabajo pesado, resuelto. Las ideas, tuyas 👉 Conoce a Rex

Conecta Bloomreach

Crea una clave de API en Bloomreach Engagement, conéctala y crea o actualiza clientes con sus consentimientos.

Con la integración de Bloomreach, cada persona que se registra se crea o se actualiza como cliente en tu proyecto de Bloomreach Engagement, identificada por su dirección de correo. También puedes darle un consentimiento de Bloomreach, para poder enviarle marketing.

Lo que necesitas

  • Un proyecto de Bloomreach Engagement y un usuario que pueda gestionar el acceso a la API en la configuración del proyecto (normalmente un administrador del proyecto).

Paso 1: crea una clave de API en Bloomreach

  1. En Bloomreach Engagement, abre el proyecto y ve a Project settings > Access management > API.
  2. Copia el Project token y la API base URL que aparecen en la página.
  3. En los grupos de API, crea un grupo nuevo con Private access y ponle un nombre, por ejemplo «Scratcher».
  4. Crea una clave de API nueva en el grupo. Copia el API key ID y el API secret. El secreto solo se muestra una vez.
  5. Da al grupo los permisos de abajo y guarda.

Permisos que necesita la clave

En los permisos del grupo, permite:

  • Customer properties: get y set, para buscar clientes y crearlos o actualizarlos, y para mostrar tus propiedades de cliente en la asignación de campos.
  • Events: set, para el evento consent, para que Scratcher pueda registrar consentimientos.

No hace falta nada más. Sin los permisos set, los envíos fallan con el error de acceso propio de Bloomreach.

Paso 2: conecta Bloomreach a Scratcher

  1. En Scratcher, ve a Configuración > Integraciones y haz clic en Bloomreach.
  2. Pega la API base URL, el project token, el API key ID y el API secret en los campos correspondientes.
  3. Haz clic en Instalar integración. Scratcher comprueba los datos con Bloomreach.

Paso 3: actívala en una campaña

  1. En el editor, ve a Conectar > Integraciones > Bloomreach y haz clic en Activar.
  2. Si has conectado más de un proyecto, elígelo en Seleccionar cuenta.
  3. En Asignaciones de campos, haz clic en Añadir asignación de campos y empareja cada Campo de Scratcher con una propiedad de cliente de Bloomreach, por ejemplo «Lead - Nombre» con first_name.
  4. Elige la categoría de consentimiento que debe recibir la gente, por ejemplo «newsletter», o ninguna.
  5. En Filtrar por consentimientos (opcional), elige tu casilla de consentimiento de marketing, para que solo se envíe a quienes la marcaron.
  6. Haz clic en Guardar y luego en Probar.

Conviene saber: Bloomreach no tiene listas. Todo el mundo entra en el proyecto y tú los agrupas con segmentos en Bloomreach. Por eso Scratcher empieza a enviar en cuanto haces clic en Activar. Actívala antes de publicar la campaña, o configúrala enseguida.

Asignación de campos

  • La dirección de correo siempre se envía y se usa para encontrar al cliente. No hace falta asignarla.
  • La lista Campo de destino muestra las propiedades de cliente de tu proyecto. Si falta una propiedad, créala antes en Bloomreach.
  • Para marcar de dónde vienen los clientes, asigna un Usar valor personalizado como «Juego de verano de Scratcher» a una propiedad que uses para el origen.

Consentimiento

Si eliges una categoría de consentimiento, Scratcher registra un evento consent con la acción accept y el nombre de la campaña como origen. La categoría debe existir en Bloomreach (en la configuración de consentimientos de Project settings). Usa Filtrar por consentimientos para que solo reciban el consentimiento quienes marcaron tu casilla de marketing.

Qué se envía y cuándo

Los nuevos registros se envían en uno o dos minutos. Cuando activas la integración, también se envían los leads que ya tiene la campaña. Cuando alguien vuelve a participar, el cliente se actualiza. Revisa cada envío en Configuración > Integraciones > Estado de la entrega. Consulta Consulta el estado de la entrega y reenvía leads.

Solución de problemas

  • «Algunos o todos los campos no son válidos...» al instalar: revisa la API base URL y el project token, y vuelve a copiar el key ID y el secreto.
  • Los envíos fallan con un error de acceso: al grupo de API le falta uno de los permisos de arriba. Edítalo en Bloomreach.
  • El consentimiento no aparece en el cliente: la categoría de consentimiento no existe en Bloomreach o se escribe de otra forma.
  • Bloomreach tiene sus propias guías sobre las claves de API. Busca "API access management" en la documentación de Bloomreach si los menús son distintos.
¿Necesitas ayuda?

¿Sigues necesitando ayuda?

Hay personas reales para ayudarte. Si ya usas Scratcher, lo más rápido es el chat dentro de la plataforma.

  • Chatea con nosotros

    Inicia sesión y haz clic en el botón del chat, abajo a la derecha. Rex responde al instante y nuestro equipo está a un clic.

  • Reserva una reunión

    Una videollamada gratuita de 30 minutos con nuestro equipo: una demostración, ideas para campañas o ayuda con tu configuración.

  • Escríbenos

    Escribe a contact@scratcher.io y te responderemos.