Llamar Appcues .page() frente a Appcues .identify()
Conozca la diferencia entre dos componentes de su instalación Appcues : Seguimiento de páginas e Identificación de usuario.
A veces hay confusión sobre Appcues .page() y Appcues .identify vamos a aclararlo.
Mejores prácticas de implementación Appcues :
Asegúrese de que su Appcues .identify(); se llame antes de la ejecución de la primera llamada page() dentro de su código de implementación Appcues .
Si no se implementa de esta manera, los usuarios finales podrían experimentar una demora debido al almacenamiento en búfer de eventos mientras esperan que se identifique a un usuario.
Appcues .identify()
- Esta función debe llamarse al cargar la página con un ID de usuario y un conjunto de propiedades de usuario que se deseen utilizar como objetivo. Las propiedades que se envían a Appcues son las que se utilizan para determinar si un usuario cumple los requisitos para acceder a algún contenido Appcues .
- Esta función llama automáticamente Appcues .page(). Nunca debería ser necesario que una llamada a la función de identificación siga a una llamada a la función de página. En otras palabras, su código Appcues NO debería verse así:
Appcues.identify("user1234", {
isAdmin: false,
created: 12344556677
});
Appcues.page(); // Overkill :)
- Puedes llamar a esta función varias veces por página para generar las propiedades del objeto de usuario si cargas datos de forma asíncrona. Por ejemplo:
YourAPI.getUsersFavoriteColor(function(data) {
Appcues.identify("user1234", {
favoriteColor: data.color
});
});
// Further down in your code.
YourAPI.getUsersFavoriteSnack(function(data) {
Appcues.identify("user1234", {
favoriteSnack: data.snack // Cheetos, right?
});
})
Cuando ambas llamadas regresan, Appcues conoce el color y el refrigerio favoritos del usuario. En el estado intermedio, cuando una ha regresado y la otra aún está en proceso, Appcues solo conocerá una de las dos propiedades.
Appcues .group()
Si desea incorporar propiedades a nivel de cuenta en Appcues para sus usuarios, deberá llamar también Appcues .group(); después de haber identificado correctamente a su usuario. Para ver ejemplos de llamadas de grupo, consulte nuestro documento "Resumen de instalación (para desarrolladores)" .
Appcues .page()
- Esta función debe llamarse cuando el usuario ya se ha identificado una vez desde la carga de la página actual, pero se desea que Appcues intente mostrar contenido nuevo. Consultaremos la lista de contenido y las propiedades del usuario actual y mostraremos el contenido si el usuario cumple los requisitos.
- El escenario más común donde esto aplica es en aplicaciones de una sola página (es decir, aplicaciones que usan React, Vue, Angular, Ember, etc.). Estas aplicaciones solo cargan la página completa una vez y, posteriormente, toda la navegación se realiza sin cargas completas. Por ello, llamar En estas aplicaciones, Appcues .identify() una vez al cargar la página debería ser suficiente. Ante cualquier cambio en la navegación, Se puede llamar Appcues .page() y se utilizará el conjunto anterior de propiedades de usuario.