Segmento

Segment es una potente herramienta analítica que ayuda a los equipos de producto y marketing a comprender el comportamiento de los usuarios. Permite a las empresas recopilar, transformar, enviar y almacenar sus datos de clientes de primera mano de forma más eficaz. Segment simplifica la gestión de datos y facilita conectar los datos de los clientes con otras herramientas de tu stack, de modo que dedicas menos tiempo a la configuración y más tiempo a analizar datos significativos.

Integrar Segment con Document360 te permite enviar datos de visitantes de la base de conocimiento a Segment y enrutarlos a cualquier destino de análisis o marketing de tu pila.

Antes de que empieces

• Necesitas una cuenta de Segment.
• Necesitas tu clave de escritura de segmentos. En Document360, esto se denomina el ID de Segmento. Consulta cómo encontrar tu clave de escritura de segmentos a continuación.

Cómo encontrar tu clave de escritura de segmentos

Para integrar Segment con Document360, necesitas crear un código fuente en Segment y copiar su clave de escritura.

1. Inicia sesión en tu cuenta de Segment.
2. Navega a Conexiones > Fuentes y luego haz clic en Añadir fuente.
3. Elige Javascript como tipo fuente. Puedes buscarlo usando la barra de búsqueda en la esquina superior derecha.
4. En la página de código fuente de Javascript, haz clic en Añadir fuente.
5. En la página de configuración de fuente , introduce un nombre para tu fuente. Opcionalmente puedes añadir una etiqueta (como dev o prod) y una URL de sitio web. Estos campos son opcionales y se utilizan únicamente para identificación.

6. Después de crear el código-fuente, encuentra tu clave de escritura en cualquiera de estas ubicaciones:

   • Pestaña de resumen: En el bloque de código de integración, busca la línea analytics.load("YOUR_WRITE_KEY"). El valor dentro de las comillas es tu Clave de Escritura.
   
   • Pestaña de configuración: En claves API, copia la clave de escritura que aparece allí.
   

7. Utiliza esta clave de escritura en Document360 al configurar la integración de Segmento (en el campo ID de Segmento ).

Cómo integrar Segment con Document360

1. En el portal Document360, navega a Conexiones () > Integraciones () en la barra de navegación izquierda.

2. Selecciona Segmentar de la lista de integraciones y haz clic en Añadir.

3. En el panel Añadir nueva integración , elige un tipo de configuración:

   Configuración básica: usa esto para conectar rápidamente Segment con tu base de conocimientos.

   • Descripción (opcional): añadir una etiqueta para identificar la integración.
   • ID de segmento: pega aquí tu clave de escritura de segmento.

   Configuración personalizada: usa esto para añadir código JavaScript personalizado para seguimiento avanzado.

   • Descripción (opcional): añadir una etiqueta para identificar la integración.
   • Código: pega el fragmento completo de Segment con tu Clave de Escritura. También puedes incluir eventos personalizados usando analytics.track() o analytics.page().

4. Opcionalmente, amplía las condiciones de inclusión/exclusión de código para controlar dónde se aplica la integración de Segment según la dirección IP, el espacio de trabajo o el idioma.

5. Haz clic en Añadir para completar la integración.

Verifica la integración

Una vez que hayas completado la integración, sigue estos pasos para confirmar que Segment está recibiendo datos de tu base de conocimientos de Document360.

1. Abre tu base de conocimientos de Document360 en una pestaña nueva. Esto activa un page evento que Segment debería capturar.
2. En una pestaña aparte, ve a tu espacio de trabajo de segmentos.
3. Navega a Conexiones > Fuentes y selecciona la fuente que creaste para Document360.
4. Ve a la pestaña Depurador .
5. Deberías ver aparecer un page evento en el depurador. Si configuraste eventos personalizados como clics de botones, realiza esas acciones ahora y verifica que aparezcan los eventos correspondientes.

Si no aparecen eventos en el Depurador, comprueba lo siguiente:

• Write Key es incorrecto: comprueba dos veces que has pegado el valor correcto en el campo ID de segmento.
• Error de JavaScript en la página: abre la consola del navegador y comprueba si hay errores que puedan estar bloqueando la ejecución de scripts.
• Extensión del navegador que bloquea los scripts de seguimiento: prueba a desactivar extensiones de privacidad como uBlock Origin o Ghostery y recarga la página.
• Condiciones de inclusión/exclusión de código que impiden que el script se ejecute: revise cualquier dirección IP, espacio de trabajo o filtros de idioma aplicados en la configuración de integración.

Mejores prácticas

• Usa la configuración básica para el seguimiento estándar de la vista de página. Introducir tu clave de escritura en configuración Básica es la forma más rápida de empezar a enviar datos a Segment. Usa configuración personalizada solo cuando necesites añadir seguimiento específico de eventos más allá de las vistas de página.
• Nombra claramente la fuente de tu segmento. Utiliza un nombre descriptivo como "Document360 Producción" para que sea fácil identificarlo en tu espacio de trabajo de Segmento cuando hay múltiples fuentes conectadas.
• Utiliza el Depurador de Segmentos para verificar los eventos tras cualquier cambio. Cada vez que actualices la configuración de integración o añadas nuevos eventos personalizados, revisa la pestaña Depurador para confirmar que los eventos fluyen correctamente.
• Enruta los datos de los segmentos a tus destinos de analítica y marketing. Una vez que Segment reciba datos de Document360, conéctalo con herramientas posteriores como Amplitude, Mixpanel o tu CRM para analizar el rendimiento de la base de conocimiento junto con otros datos de tu producto.
• Utiliza condiciones de inclusión/exclusión de código para excluir el tráfico interno. Añade tu dirección IP de oficina como una excepción para evitar que las visitas al equipo distorsionen tus datos de analítica.

Preguntas frecuentes