Configurar Currents

Esta página resume y describe el proceso genérico de integración y configuración de Braze Currents.

Importante

Currents está incluido en determinados paquetes de Braze. Ponte en contacto con tu representante de Braze si tienes alguna pregunta o deseas obtener acceso.

Solución de problemas

No se puede añadir una nueva integración de Currents

Si ves “You do not have any remaining Currents integrations” al añadir una nueva integración, o si el botón para añadir un nuevo conector de Currents está atenuado, las causas comunes son:

• No se ha adquirido un derecho de Currents para este espacio de trabajo.
• El derecho de Currents está disponible en un espacio de trabajo diferente dentro de tu empresa.

Para resolverlo, comprueba otros espacios de trabajo dentro de tu empresa. Es posible que un espacio de trabajo diferente muestre un derecho de Currents disponible. Si necesitas solicitar un derecho o ajustar tu configuración, ponte en contacto con tu director de cuentas de Braze.

No se puede habilitar el seguimiento de eventos adicionales

Si puedes crear o editar un conector pero no puedes habilitar uno de los interruptores de seguimiento opcionales, es posible que tu espacio de trabajo haya alcanzado el límite de derechos para esa categoría de eventos.

• Track Customer Behavior and User Events requiere derechos disponibles de Customer Behavior Events.
• Track user profiles and attributes requiere derechos disponibles de User Profiles and Attributes.

Si necesitas derechos adicionales o ayuda para ajustar tu configuración, ponte en contacto con tu director de cuentas de Braze.

Requisitos

Utilizar Currents con cualquiera de nuestros socios requiere los mismos parámetros básicos y la misma metodología de conexión.

Cada socio requiere que Braze tenga permiso para escribir y enviar archivos de datos hacia ellos, y Braze solicita la ubicación donde debería escribir esos archivos, específicamente nombres de contenedores o claves.

Los siguientes requisitos son los básicos y mínimos para la integración con la mayoría de nuestros socios. Algunos socios requieren parámetros adicionales, que se enumeran en su respectiva documentación del partner junto con cualquier matiz asociado a estos requisitos básicos.

Importante

Es importante mantener actualizados tus claves del partner, tokens del partner y datos de autenticación; si las credenciales de tu conector caducan, el conector dejará de enviar eventos. Si esto persiste durante más de 5 días, los eventos del conector se descartarán y los datos se perderán permanentemente.

Configurar Currents

Paso 1: Elige tu socio

Braze Currents te permite integrarte a través de almacenamiento de datos utilizando archivos planos o con nuestros socios de análisis del comportamiento y datos de clientes mediante cargas útiles JSON agrupadas a un endpoint designado.

Antes de comenzar tu integración, es mejor decidir qué integración se adapta mejor a tus propósitos. Por ejemplo, si ya utilizas mParticle y Segment y te gustaría que los datos de Braze se transmitieran allí, sería mejor usar una carga útil JSON agrupada. Si prefieres manipular los datos por tu cuenta o tienes un sistema de análisis de datos más complejo, podría ser mejor usar almacenamiento de datos (¡Braze usa este método!)

Paso 2: Abre Currents

Para comenzar, ve a Integraciones de socios > Currents. Serás dirigido a la página de gestión de integraciones de Currents.

Paso 3: Añade tu socio

Añade un socio, a veces llamado “conector de Currents”, seleccionando el menú desplegable en la parte superior de la pantalla.

Cada socio requiere un conjunto diferente de pasos de configuración. Para habilitar cada integración, consulta nuestra lista de socios disponibles y sigue las instrucciones en sus respectivas páginas.

Proporciona un correo electrónico de contacto para las notificaciones de errores de integración. Braze envía notificaciones a esta dirección si la integración encuentra errores, como problemas con las credenciales o de conectividad. Para ayudar a garantizar que las personas adecuadas reciban las alertas, utiliza una lista de distribución o una dirección de correo electrónico de grupo.

Paso 4: Configura tus eventos

Elige los eventos que deseas pasar a ese socio marcando las opciones disponibles. Puedes encontrar listados de estos eventos en nuestras bibliotecas de eventos de comportamiento del cliente y eventos de interacción con mensajes.

Si lo necesitas, puedes obtener más información sobre nuestros eventos en nuestro artículo de semántica de la entrega de eventos.

Paso 5: Configura las transformaciones de campos

Puedes usar las transformaciones de campos de Currents para eliminar o aplicar hash a un campo de cadena.

• Eliminar: Reemplaza el campo de cadena con [REDACTED]. Esto es útil si tu socio rechaza eventos con campos vacíos o faltantes.
• Hash: Aplica un algoritmo de hash SHA-256 al campo de cadena.

Seleccionar un campo para una de estas transformaciones aplicará esa transformación a todos los eventos en los que aparezca ese campo. Por ejemplo, seleccionar email_address para aplicar hash cifrará el campo email_address en los eventos de envío de correo electrónico, apertura de correo electrónico, rebote de correo electrónico y cambio de estado de grupo de suscripción.

Paso 6: Prueba tu integración

Importante

Currents descartará eventos con cargas útiles excesivamente grandes de más de 900 KB.

Antes de hacer la prueba, considera consultar nuestros datos de muestra de Currents en GitHub. Cuando estés listo para probar, elige una opción en la siguiente sección:

Envío de eventos de prueba

Para probar tu integración, puedes seleccionar Send Test Events para enviar un evento de cada uno de los tipos de evento seleccionados a este Current. Para obtener información detallada sobre cada tipo de evento, consulta nuestras bibliotecas de eventos de comportamiento del cliente y eventos de interacción con mensajes.

Prueba de conectores de Currents

Los conectores de prueba de Currents son versiones gratuitas de nuestros conectores existentes que se pueden usar para probar y experimentar con diferentes destinos. Los Currents de prueba tienen:

• Hasta 10 conectores de prueba de Currents por espacio de trabajo.
• Un máximo agregado de 1500 eventos por período fijo de 24 horas, que se restablece a medianoche UTC. Este total de eventos se actualiza cada hora en el panel.

Después de que tus conectores de prueba de Currents alcancen el límite de envío, tu conector no enviará eventos hasta el día siguiente (a medianoche UTC).

Para actualizar tu conector de prueba de Currents, edita la integración en el panel y selecciona Upgrade Test Integration.

Actualización de Currents

Para actualizar tu conector de Currents después de lanzarlo, haz lo siguiente:

1. En Braze, ve a Integraciones de socios > Exportación de datos.
2. Localiza tu conector de Currents en la lista.
3. Selecciona  Editar.
4. Haz tus cambios.
5. Selecciona Actualizar Current.

Esto no detendrá tu exportación existente y comenzará a enviar eventos según tu nueva selección.

Nota

Los cambios pueden tardar algún tiempo en surtir efecto.

Lista de IP permitidas

Braze enviará datos de Currents desde las IP enumeradas:

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)