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
- En Bloomreach Engagement, abre el proyecto y ve a Project settings > Access management > API.
- Copia el Project token y la API base URL que aparecen en la página.
- En los grupos de API, crea un nuevo grupo con Private access y ponle un nombre, por ejemplo, "Scratcher".
- 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.
- 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
- En Scratcher, ve a Configuración > Integraciones y haz clic en Bloomreach.
- Pega la API base URL, el project token, el API key ID y el API secret en los campos correspondientes.
- Haz clic en Instalar integración. Scratcher verifica los datos con Bloomreach.
Paso 3: Actívala en una campaña
- En el editor, ve a Conectar > Integraciones > Bloomreach y haz clic en Activar.
- Si conectaste más de un proyecto, elígelo en Seleccionar cuenta.
- 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.
- Elige la categoría de consentimiento que deben recibir las personas, por ejemplo "newsletter", o ninguna.
- En Filtrar por permisos (opcional), elige tu casilla de consentimiento de marketing para que solo se envíen las personas que la marcaron.
- 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.