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 puedes añadir una nueva integración de Currents

Si ves el mensaje “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 aparece en gris, las causas más comunes son:

• No se ha comprado ningún derecho de uso de Currents para este espacio de trabajo.
• El derecho de uso de Currents está disponible en otro espacio de trabajo de tu empresa.

Para resolverlo, revisa los demás espacios de trabajo de tu empresa. Es posible que otro espacio de trabajo muestre un derecho de uso de Currents disponible. Si necesitas solicitar un derecho de uso o ajustar tu configuración, ponte en contacto con tu director de cuentas de Braze.

No puedes 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 de uso para esa categoría de eventos.

• Seguimiento del comportamiento del cliente y eventos de usuario requiere derechos de uso disponibles de Eventos de comportamiento del cliente.
• Seguimiento de perfiles de usuario y atributos requiere derechos de uso disponibles de Perfiles de usuario y atributos.

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

Comprender las notificaciones de error de integración

Cuando una integración de Currents tiene problemas para entregar eventos, Braze envía un correo electrónico a las direcciones de contacto configuradas en esa integración. Si la integración no tiene un correo electrónico de contacto, Braze le pide a tu equipo de cuenta de Braze que se comunique con la persona adecuada. Para recibir estos avisos directamente, añade un correo electrónico de contacto a cada integración.

Todos los avisos usan la misma línea del asunto, “[Urgent Action Required to Prevent Data Loss] Nombre de la empresa Tipo de integración Currents integration failing”, incluidos los avisos que indican que la integración se ha recuperado. Para identificar qué aviso recibiste, busca en la siguiente tabla la frase que coincide con el cuerpo del correo electrónico. Si el correo electrónico indica que la integración se deshabilitó, usa la fila “disabled” correspondiente, aunque el correo también indique que la integración sigue fallando.

Requisitos

Usar Currents con cualquiera de nuestros partners requiere los mismos parámetros básicos y el mismo método de conexión.

Cada partner necesita que Braze tenga permiso para escribir y enviarle archivos de datos. Braze también te pide la ubicación donde debe escribir esos archivos, en concreto los nombres de contenedor o las claves.

Estos son los requisitos básicos mínimos para integrarte con la mayoría de nuestros partners. Algunos partners requieren parámetros adicionales. Los encontrarás en su respectiva documentación del partner, junto con los matices de 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 esta situación dura más de 5 días, se descartarán los eventos del conector y los datos se perderán de forma permanente.

Configuración de Currents

Paso 1: Elige tu partner

Braze Currents te permite integrarte mediante almacenamiento de datos con archivos planos, o con nuestros partners de análisis del comportamiento y de datos de clientes mediante cargas útiles JSON por lotes enviadas a un endpoint designado.

Antes de empezar tu integración, conviene que decidas cuál se adapta mejor a tus objetivos. Por ejemplo, si ya usas mParticle y Segment y quieres que los datos de Braze fluyan hacia allí, lo mejor sería usar una carga útil JSON por lotes. Si prefieres manipular los datos por tu cuenta o tienes un sistema de análisis de datos más complejo, quizá lo mejor sea usar el almacenamiento de datos (¡Braze usa este método!)

Paso 2: Abre Currents

Para empezar, ve a Integraciones de socios > Currents. Accederás a la página de administración de integraciones de Currents.

Paso 3: Añade tu partner

Añade un partner, a veces llamado “conector de Currents”, seleccionando el menú desplegable de 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 partners disponibles y sigue las instrucciones de 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 quieres enviar a ese partner marcándolos entre las opciones disponibles. Puedes encontrar listados de estos eventos en nuestras bibliotecas de eventos de comportamiento del cliente y eventos de participación en mensajes.

Si lo necesitas, puedes obtener más información sobre nuestros eventos en nuestro artículo sobre la 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: Sustituye el campo de cadena por [REDACTED]. Esto es útil si tu partner rechaza eventos con campos ausentes o vacíos.
• Hash: Aplica un algoritmo de hash SHA-256 al campo de cadena.

Al seleccionar un campo para una de estas transformaciones, esa transformación se aplicará a todos los eventos en los que aparezca ese campo. Por ejemplo, si seleccionas email_address para aplicarle hash, se aplicará hash al campo email_address en los eventos Email Send, Email Open, Email Bounce y Subscription Group State Change.

Las transformaciones de campos solo funcionan con campos de cadena. Otros tipos de campo, como las matrices, no están disponibles para seleccionar, así que no puedes eliminarlos ni aplicarles hash. Por ejemplo, el campo de matriz suspected_bot_click_reason de los eventos Email Click se mantiene en tu exportación.

Editar transformaciones de campos en un conector activo

Puedes añadir, cambiar o eliminar transformaciones de campos en un conector activo sin volver a lanzarlo. Después de actualizar el conector, tus cambios se aplican en unos 5 minutos.

Editar las transformaciones de campos no cambia la versión del esquema Avro ni el segmento version=<currents_version> de tu ruta de almacenamiento. Solo las versiones de Currents cambian ese segmento. Para más información, consulta Cambios en el esquema Avro.

Paso 6: Prueba tu integración

Importante

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

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

Enviar eventos de prueba

Para probar tu integración, puedes seleccionar Enviar eventos de prueba para enviar un evento de cada uno de los tipos de eventos 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 participación en mensajes.

Probar conectores de Currents

Los conectores de Currents de prueba son versiones gratuitas de nuestros conectores existentes que puedes usar para hacer pruebas y probar distintos destinos. Los Currents de prueba tienen:

• Hasta 10 conectores de Currents de prueba por espacio de trabajo.
• Un máximo total de 1500 eventos por periodo fijo de 24 horas, que se restablece a medianoche UTC. En la página Currents, puedes hacer un seguimiento de tu volumen de envío actual con respecto a este límite. Braze actualiza este total cada hora.

Braze comprueba el uso de los Currents de prueba con respecto a este límite una vez por hora. Si llega una gran ráfaga de eventos entre dos comprobaciones horarias, tus conectores de Currents de prueba pueden exportar más de 1500 eventos en ese periodo antes de que el límite se aplique.

Cuando una comprobación horaria detecta que tus conectores de Currents de prueba han alcanzado el límite de envío, Braze deshabilita el conector y descarta los eventos que se crean mientras se ha alcanzado el límite. La sincronización de eventos se reanuda después de que el límite se restablezca a medianoche UTC.

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

Actualizar 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á los datos de Currents desde las IP indicadas:

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