El complemento Autocapture de amplía los eventos y las propiedades que rastrea de forma predeterminada y habilita el etiquetado visual para que puedas definir eventos en función de los elementos de tu sitio. Para obtener más información sobre el etiquetado visual, consulta Etiquetado visual.
Instalación
La captura automática requiere las últimas versiones del SDK de Browser (2.9.0) y el complemento de captura automática (0.9.0)
Cargador de secuencias de comandos
1<guion aplazar origen=“https://cdn.amplitude.com/libs/analytics-browser-2.9.0-min.js.gz“>guion>
2<guion aplazar origen=“https://cdn.amplitude.com/libs/plugin-autocapture-browser-0.9.0-min.js.gz“>guion>
1npm instalar @/analítica-navegador
2npm instalar @amplitude/plugin-autocapture-browser@beta
1hilo agregar @/analítica-navegador
2hilo agregar @amplitude/plugin-autocapture-browser@beta
Inicializar el complemento
El SDK de Browser admite una arquitectura de complementos que permite funciones como la captura automática. Para habilitar el complemento, actualice su código con uno de los siguientes fragmentos, según su implementación. Ambos métodos requieren que defina el complemento de captura automática y luego llame a add() para habilitarlo.
Script loadernpm / hilo
1<guion tipo=“módulo“>
2 ventana..en eso(CLAVE_API_DE_AMPLITUD)
3 constante complemento de captura automática = ventana.amplitudeAutocapturePlugin.enchufar();
4 ventana..agregar(Complemento de captura automática);
5guion>
1importar * como de '@/analítica-navegador';
2importar { complemento de captura automática } de '@amplitude/plugin-autocaptura-navegador';
3
4.en eso(CLAVE_API_DE_AMPLITUD);
5.agregar(complemento de captura automática());
Configuración
El complemento Autocapture agrega cuatro configuraciones que lo ayudan a configurar lo que rastrea el complemento.
Configuración
Descripción predeterminada cssSelectorAllowlist
[‘a’,’button’,’input’,’select’,’textarea’,’label’,'[data-amp-default-track]','.amp-default-track']Cadena[]. Acepta uno o más selectores CSS que definen qué elementos de la página se deben rastrear. pageUrlAllowlist undefined `(string shouldTrackEventResolver undefined Función. Determina programáticamente si debe o no rastrear un evento. dataAttributePrefix data-amp-track Permite que el complemento capture atributos de datos como una propiedad de evento.
1constante enchufar = complemento de captura automática({
2 Lista de permitidos de CSSSelector: [
3 ‘.amp-tracking‘,
4 ‘[amp-tracking]'
5 ],
6 Lista de permitidos de URL de página: [
7 ‘‘,
8 new RegExp(‘/blog/*‘)
9 ],
10});
De forma predeterminada, si no utiliza estas configuraciones, rastrea los selectores predeterminados en todas las páginas en las que habilita el complemento.
Nota
Cuando se especifican los selectores CSS que se van a rastrear, la selección anula la predeterminada. Para conservar los selectores predeterminados, importe DEFAULT_CSS_SELECTOR_ALLOWLIST e inclúyalo en el código.
1importar {LISTA PERMITIDA DEL SELECTOR CSS PREDETERMINADO} de '@amplitude/plugin-autocaptura-navegador';
2
3constante selectores = [
4 …DEFAULT_CSS_SELECTOR_ALLOWLIST,
5 ‘.class-of-a-thing-i-want-to-track‘,
6];
Nuevos eventos
Cuando habilita el complemento de captura automática, envía dos eventos, a partir de los cuales puede crear eventos etiquetados con etiquetado visual:
[] Elemento en el que se hizo clic [] Elemento cambiadoEstos dos eventos capturan propiedades que describen el elemento correspondiente y otro contexto sobre el navegador del usuario:
[] Identificación del elemento [] Clase de elemento [] Etiqueta de elemento [] Texto del elemento (recopilado para [] Elemento en el que se hizo clic, únicamente) [] Elemento Href (recopilado para [] Elemento en el que se hizo clic, únicamente) [] Posición del elemento izquierda [] Posición del elemento superior [] Altura de la ventana gráfica [] Ancho de la ventana gráfica [] URL de la página [] Título de la página [] Selector de elementos [] Atributos del elemento [] Etiqueta del elemento Aria [] Etiqueta principal del elementoDesactivar captura automática
Para deshabilitar la captura automática, elimine el complemento de cualquier página que lo implemente y configure defaultTracking: false en la inicialización de en esa página.
Script loadernpm / hilo
Eliminar las siguientes líneas de código:
1
2<guion aplazar origen=“https://cdn.amplitude.com/libs/plugin-autocapture-browser-0.9.0-min.js.gz“>guion>
3
4<guion tipo=“módulo“>
5 constante complemento de captura automática = ventana.amplitudeAutocapturePlugin.enchufar();
6 ventana..agregar(Complemento de captura automática);
7guion>
Eliminar el complemento:
1// npm
2npm Desinstalar @amplitude/plugin-autocaptura-navegador
3
4// hilo
5hilo eliminar @amplitude/plugin-autocaptura-navegador
Eliminar el código de inicialización:
1//Elimine las siguientes líneas de código
2importar { complemento de captura automática } de '@amplitude/plugin-autocaptura-navegador';
3
4.agregar(complemento de captura automática());