{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","partial","img","callout","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"},"seo":{"title":"Integrate Amplitude with Databox","description":"Connect Amplitude to Databox to track user behavior, monitor product engagement, and visualize event, funnel, and retention data alongside all your other tools.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-amplitude-with-databox","__idx":0},"children":["Integrate Amplitude with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"all"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amplitude is a product analytics platform that helps businesses understand how users interact with their digital products. It tracks events, user journeys, funnel conversions, and retention patterns across web and mobile applications, giving product and growth teams the data they need to make informed decisions. Connecting Amplitude to Databox brings your product analytics alongside data from your marketing, sales, and support tools, so you can monitor user engagement, measure feature adoption, and track conversion performance in a unified view."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"before-you-begin","__idx":2},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"IntegrationPermissions","attributes":{"integrationKey":"amplitude"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-find-your-api-credentials-in-amplitude","__idx":3},"children":["Step 1: Find your API credentials in Amplitude"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox uses your Amplitude ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Key"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret Key"]}," to authenticate the connection. Follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.docs.developers.amplitude.com/analytics/find-api-credentials/"},"children":["Amplitude's official documentation"]}," to locate your API Key, Secret Key, and the time zone configured for your Amplitude account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-add-a-connection","__idx":4},"children":["Step 2: Add a connection"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a name for the connection in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Profile name"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste your Amplitude API Key into the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste your Amplitude Secret Key into the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret key"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timezone"]}," to match the time zone configured in your Amplitude account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-amplitude-with-databox_1.0fbbf24c04967100a302b8fee1f45f9a0509d7da5004ed54fc2abcad72b71509.4783b0ec.png","alt":"connect-amplitude-to-databox","withLightbox":true,"className":"ss-img","style":"margin-top: 10px;"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"metric-builder","__idx":5},"children":["Metric Builder"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Amplitude integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-amplitude-with-databox_2.8421c183e865693d635cfac067f0ef088f376b280369079631c772bf3ad8825b.4783b0ec.png","alt":"amplitude-metric-builder","withLightbox":true,"className":"ss-img","style":"margin-top: 10px; margin-bottom: 10px;"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a custom metric, select an entity type from the radio buttons at the top of the metric builder. Each entity type exposes different fields based on the kind of analysis you want to perform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The entity types available for metric creation are listed below."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"active--new-users","__idx":6},"children":["Active / New Users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Active / New Users entity lets you measure how many users were active or new within a given time period. Use it to track user growth and engagement trends, optionally broken down by a user property."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metric"]}," (Active Users or New Users). Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Segments"]}," section to add one or more property filters — each row defines a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Property"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operator"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Values"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/eye-open.01fa8df107050486c946fe7375d84f07ab920629bcee3449d51d3976a4cea5cc.419bb737.svg","alt":"see","withLightbox":false,"style":"vertical-align: text-bottom;"},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In Amplitude:"]}," Go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]}," section to browse the user properties available for grouping and filtering."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"funnel","__idx":7},"children":["Funnel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Funnel entity measures conversion rates across a defined sequence of events. Use it to understand how many users complete each step of a flow and where drop-offs occur."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add one or more events using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Funnel Steps"]}," rows. Choose a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Type"]}," and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mode"]},". Optionally specify a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conversion Window"]}," to restrict the analysis to events occurring within a given time frame. Select a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dimension (Optional)"]}," to break results down by a property. Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Filters"]}," section to apply entity-level filters and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Segments"]}," section to apply property-level filters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/eye-open.01fa8df107050486c946fe7375d84f07ab920629bcee3449d51d3976a4cea5cc.419bb737.svg","alt":"see","withLightbox":false,"style":"vertical-align: text-bottom;"},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In Amplitude:"]}," Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Analytics > Funnel Analysis"]}," to find and review the events that make up your funnels."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"segmentation","__idx":8},"children":["Segmentation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Segmentation entity lets you measure any event metric with optional rolling calculations and property-level filtering. Use it to track event totals, averages, or unique counts for any event in your Amplitude account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Event"]}," from your Amplitude account. Optionally apply a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rolling Operator"]}," to calculate a rolling average or rolling window value. Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Segments"]}," section to add property-level filters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/eye-open.01fa8df107050486c946fe7375d84f07ab920629bcee3449d51d3976a4cea5cc.419bb737.svg","alt":"see","withLightbox":false,"style":"vertical-align: text-bottom;"},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In Amplitude:"]}," Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Analytics > Segmentation Analysis"]}," to explore the events and properties available in your account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sessions-by-length","__idx":9},"children":["Sessions by Length"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Sessions by Length entity groups session data into configurable time buckets, letting you analyze the distribution of session durations across your user base."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dimension"]}," to define the time unit for the buckets. Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Min Bucket Value"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Max Bucket Value"]}," to define the range. Optionally specify a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bucket Size"]}," to control how many buckets are created within the range."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"tip"},"children":["Always specify a Bucket Size. When left unset, Amplitude determines bucket boundaries automatically, and the number or size of buckets returned is not guaranteed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"user-composition","__idx":10},"children":["User Composition"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The User Composition entity lets you analyze the makeup of your user base by breaking down a user metric by a chosen dimension. Use it to understand how your users are distributed across dimensions such as country, region, or app version."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metric"]}," (such as Users) and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dimension"]}," to segment the results. If no dimension is selected, the metric returns a single aggregated value per date range."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":11},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"amplitude"},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does the time zone setting affect how data appears in Databox?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes. Amplitude data syncs in the time zone configured in your Amplitude account. Set the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timezone"]}," field during connection to match your Amplitude account's time zone to avoid discrepancies between what you see in Amplitude and in Databox."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Why does date range data from Amplitude differ from what I see in Databox?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amplitude counts \"last X days\" as the X days preceding today, while Databox includes today in its count. For example, selecting the last 2 days in Amplitude corresponds to selecting the last 3 days (including today) in Databox. Adjust your Databox date range accordingly when comparing values between the two tools."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate Amplitude with Databox","id":"integrate-amplitude-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Before you begin","id":"before-you-begin","depth":3},{"value":"Step 1: Find your API credentials in Amplitude","id":"step-1-find-your-api-credentials-in-amplitude","depth":3},{"value":"Step 2: Add a connection","id":"step-2-add-a-connection","depth":3},{"value":"Metric Builder","id":"metric-builder","depth":2},{"value":"Active / New Users","id":"active--new-users","depth":3},{"value":"Funnel","id":"funnel","depth":3},{"value":"Segmentation","id":"segmentation","depth":3},{"value":"Sessions by Length","id":"sessions-by-length","depth":3},{"value":"User Composition","id":"user-composition","depth":3},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-amplitude-with-databox","seo":{"title":"Integrate Amplitude with Databox","description":"Connect Amplitude to Databox to track user behavior, monitor product engagement, and visualize event, funnel, and retention data alongside all your other tools."},"keywords":{"includes":["amplitude","connect amplitude","amplitude integration","amplitude api key","amplitude metric builder","amplitude segmentation","amplitude funnel","amplitude active users","amplitude sessions by length","amplitude user composition"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"}},"lastModified":"2026-05-07T16:23:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-amplitude-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}