Este documento se centra en la instalación de Appcues en aplicaciones web utilizando Segment. Para obtener información sobre la instalación de Appcues en aplicaciones móviles utilizando Segment, consulte el documento Instalación del SDK móvil .

Appcues se integra con el script del lado del cliente analytics.js de Segment.

Importante : Segment debe estar instalado activamente en cada página en la que desea que aparezcan sus flujos Appcues , es decir, la La llamada analytics.identify() debe ejecutarse cada vez que se carga la página para que la integración funcione correctamente. Esto significa que cualquier propiedad de usuario transferida a Segment mediante la llamada identify() también se transferirá a Appcues y hará que Appcues muestren contenido dirigido a ese usuario (si cumple los requisitos).

Activación

Lo primero que deberás hacer es habilitar la integración de Segment- Appcues ( hay información adicional sobre esta configuración disponible en la documentación de Segment Appcues Destination ):

1. Busque el segmento “fuente” para su aplicación y selecciónelo.
2. Haga clic en el botón Agregar destino.
3. Busque " Appcues " y selecciónelo en la lista de destinos. Haga clic en "Configurar Appcues ".
4. Introduce tu ID Appcues o tu clave API heredada. El ID de cuenta Appcues habilitará Appcues como destino de Segment del lado del cliente y es todo lo necesario para instalar Appcues a través de Segment. Además, puedes añadir la clave API heredada para habilitar Appcues como destino de Segment del lado del servidor. Si solo quieres enviar eventos del lado del servidor desde Segment a Appcues , solo necesitas la clave API heredada. Puedes encontrar el ID de cuenta en la página de tu cuenta y tu clave API heredada en la página de claves API (también llamada clave API en la página de configuración de la cuenta para los clientes con planes heredados).

¡Listo! Appcues se instala ahora a través de Segment. Se Appcues en cualquier lugar donde esté instalado el script de Segment.

Requerido

En el lenguaje de Segment, la integración Appcues "asume la carga de la página". Esto significa que si no se llama a analytics.page() , Segment no cargará nuestro script.

Además, se requiere una llamada a analytics.identify() ; de lo contrario, no se pasarán propiedades de usuario a Appcues desde Segment. Sin la identificación del usuario, Appcues no sabe cómo intentar mostrar el contenido.

Recomendado

Una llamada a analytics.group() permitirá la asociación de grupos con tus usuarios. Esto simplificará la categorización de las propiedades a nivel de cuenta. Incorporar propiedades de grupo a Appcues te permitirá personalizar las experiencias según información de grupo más amplia, reducir el número total de propiedades de usuario que se deben rastrear y, próximamente, podrás ver análisis a nivel de cuenta directamente en Appcues Studio.

Opcional

Appcues también recibirá datos de Segment cuando se llame a analytics.track() .

Una vez que Segment carga el script del SDK Appcues , Appcues se carga completamente en la página. Si hay datos específicos de Appcues que no genera Segment y que prefiere omitir en su implementación, puede enviarlos directamente a Appcues mediante cualquiera de nuestras llamadas estándar a la API de Javascript .

Si tiene preguntas o comentarios sobre nuestra integración de Segment, comuníquese con nosotros a support@appcues.com .