On this page

Autocapture Remote Configuration

Autocapture Remote Configuration lets you make adjustments to your implementation and send additional metadata into Amplitude. Use Remote Configuration either when setting up Autocapture or after Autocapture is running. After you analyze your first data capture, use Remote Configuration to update Autocapture's settings without a code update.

With remote configuration you can:

  • Modify the SDK settings to adjust which events you want to capture. For example:
    • Turn specific Autocapture events on or off.
    • Configure Autocapture events such as allowed elements or allowed pages and add sub-configurations.
    • Capture additional properties such as page referrer or page URL across all events.
Autocapture Remote Configuration works with Browser SDK v2.10.0+ when fetchRemoteConfig is enabled. Browser SDK v2.16.1 enables Remote Configuration by default.

Set up remote configuration for Autocapture

  1. Go to Data > Settings > Autocapture.
  2. Specify which elements you want to capture. By default, Amplitude captures all elements. You can capture or not capture any of the following elements:
    • File downloads: Track when a user clicks an anchor or <a> tag linked to a file.
    • Form Interactions: Track a user's interaction with the form element.
    • Sessions: Track the period of time that a user has your website open. Amplitude tracks both Start Session and End Session events.
    • Page Views: Track when a user navigates to a page.
    • Element Interactions: Track when users click links, buttons, inputs, and so forth.
  3. For Element Interactions, specify the following additional aspects:
    • CSS Selector Allowlist: CSS selectors that specify which elements on the page Amplitude always tracks.
    • Action Click Allowlist: Additional CSS selectors to track when clicked.
    • Page URL Allowlist: Defines one or more URLs or URL patterns on which Amplitude tracks element click and change events.
    • Page URL Exclude List: Defines one or more URLs or URL patterns to exclude from element click and change tracking. Note: Using RegEx or glob patterns requires your SDK version to be 2.23.7 or higher.
    • Text Masking RegEx Patterns: Defines the RegEx patterns to mask for event properties in Autocapture. Note: Using this masking feature requires your SDK version to be 2.23.7 or higher.
    • Data Attribute Prefix: Lets Amplitude capture data attributes as event properties.
    • Frustration interactions: Frustration interactions (rage or dead clicks) performed by the user. Rage clicks are clicks that occur four or more times in a second. Dead clicks are clicks on an interactive element that result in no visible change within three seconds.
  4. Click Save Changes.

Was this helpful?