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 “No tienes integraciones de Currents restantes” al añadir una nueva integración, o si el botón para añadir un nuevo conector de Currents aparece en gris, las causas habituales son:

• No se ha adquirido una suscripción de Currents para este espacio de trabajo.
• La suscripción de Currents está disponible en un espacio de trabajo diferente de tu empresa.

Para resolver esto, comprueba otros espacios de trabajo dentro de tu empresa. Es posible que un espacio de trabajo diferente muestre una suscripción de Currents disponible. Si necesitas solicitar una suscripción 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 suscripción para esa categoría de eventos.

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

Si necesitas suscripciones 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 partners requiere los mismos parámetros básicos y la misma metodología de conexión.

Cada partner requiere que Braze tenga permiso para escribir y enviar archivos de datos, y Braze solicita la ubicación donde debe escribir esos archivos, en concreto nombres de contenedores o claves.

Los siguientes requisitos son los básicos y mínimos para integrarse con la mayoría de nuestros partners. Algunos partners requerirán parámetros adicionales, que se enumeran en su respectiva documentación del partner junto con cualquier particularidad asociada a estos requisitos básicos.

Importante

Es importante mantener tus claves de partner, tokens de partner y datos de autenticación actualizados; si las credenciales de tu conector expiran, 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 partner

Braze Currents te permite integrarte mediante almacenamiento de datos usando archivos planos o con nuestros partners de análisis del comportamiento y datos de clientes utilizando cargas útiles JSON agrupadas hacia un endpoint designado.

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

Paso 2: Abre Currents

Para comenzar, ve a Integraciones de partners > Currents. Se te llevará a la página de gestión de integración de Currents.

Paso 3: Añade tu partner

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

Cada partner 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 enviar a ese partner 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 sobre 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 partner rechaza eventos con campos faltantes o vacíos.
• 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 hash aplicará hash al 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 del 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 pruebas, considera revisar nuestros datos de ejemplo de Currents en GitHub. Cuando estés listo para probar, elige una opción en la siguiente sección:

Enviar 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 información detallada sobre cada tipo de evento, consulta nuestras bibliotecas de eventos de comportamiento del cliente y eventos de interacción con mensajes.

Probar 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 reinicia a medianoche UTC. En la página de Currents, puedes hacer seguimiento de tu volumen de envío actual respecto a este límite. Braze actualiza este total cada hora.

Cuando tus conectores de prueba de Currents alcancen el límite de envío, Braze deshabilitará el conector y descartará los eventos que se creen mientras se alcanza el límite. La sincronización de eventos se reanuda después de que el límite se reinicie 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.

Listas 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)