Ir al contenido
Rex, tu asistente de IA: él se encarga del trabajo pesado, las ideas son 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 actualiza como cliente en tu proyecto de Bloomreach Engagement, identificada por su dirección de correo electrónico. También puedes asignarle un consentimiento de Bloomreach para poder enviarle comunicaciones de marketing.

Qué 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 nuevo grupo con Private access y ponle un nombre, por ejemplo, "Scratcher".
  4. Crea una nueva clave de API en el grupo. Copia el API key ID y el API secret. El secreto solo se muestra una vez.
  5. Asigna al grupo los permisos que se indican a continuación y guarda.

Permisos que necesita la clave

En los permisos del grupo, habilita:

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

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

Paso 2: Conecta Bloomreach con 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 verifica 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 conectaste más de un proyecto, elígelo en Seleccionar cuenta.
  3. En Mapeo de campos, haz clic en Añadir mapeo de campo y asocia 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 deben recibir las personas, por ejemplo "newsletter", o ninguna.
  5. En Filtrar por permisos (opcional), elige tu casilla de consentimiento de marketing para que solo se envíen las personas que la marcaron.
  6. Haz clic en Guardar y luego en Probar.

Bueno saberlo: Bloomreach no tiene listas. Todos entran al 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 que la campaña esté en vivo o configúrala de inmediato.

Mapeo de campos

  • La dirección de correo electrónico siempre se envía y se usa para encontrar al cliente. No necesitas mapearla.
  • La lista Campo de destino muestra las propiedades de cliente de tu proyecto. Si falta alguna, créala primero en Bloomreach.
  • Para indicar de dónde vienen los clientes, mapea 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 permisos para que solo reciban el consentimiento las personas que marcaron tu casilla de marketing.

Qué se envía y cuándo

Los nuevos registros se envían en uno o dos minutos. Al activar la integración, también se envían los leads existentes de la campaña. Cuando alguien vuelve a participar, el cliente se actualiza. Revisa cada envío en Configuración > Integraciones > Estado de envío. Consulta Revisar el estado de envío y reenviar leads.

Solución de problemas

  • "All or some of the fields are invalid..." al instalar: revisa la API base URL y el project token, y vuelve a copiar el ID de la clave y el secreto.
  • Los envíos fallan con un error de acceso: al grupo de API le falta alguno de los permisos indicados arriba. Edítalo en Bloomreach.
  • El consentimiento no aparece en el cliente: la categoría de consentimiento no existe en Bloomreach o está escrita de otra forma.
  • Bloomreach tiene sus propias guías sobre claves de API. Busca "API access management" en la documentación de Bloomreach si los menús se ven diferentes.
¿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.

  • Agenda 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.