# Dema.ai documentation ## Docs - [Apify](https://docs.dema.ai/guides/agent/integrations/apify.md): Let the Dema Agent run Apify Actors for web scraping, enrichment, and automated data collection. - [Commercetools](https://docs.dema.ai/guides/agent/integrations/commercetools.md): Let the Dema Agent query orders, products, customers, inventory, and categories from Commercetools Composable Commerce. - [Intercom](https://docs.dema.ai/guides/agent/integrations/intercom.md): Let the Dema Agent search Intercom conversations and access contact and company data. - [Klaviyo](https://docs.dema.ai/guides/agent/integrations/klaviyo.md): Let the Dema Agent analyze campaigns and flows, manage profiles and segments, and draft email campaigns in Klaviyo. - [NetSuite](https://docs.dema.ai/guides/agent/integrations/netsuite.md): Let the Dema Agent access NetSuite ERP data, records, and business processes through the NetSuite AI Connector. - [Integrations overview](https://docs.dema.ai/guides/agent/integrations/overview.md): Connect the Dema Agent to your third-party tools. Each integration expands what the agent can do inside a conversation. - [Shopify](https://docs.dema.ai/guides/agent/integrations/shopify.md): Let the Dema Agent query products, orders, customers, and inventory from your Shopify store. - [Slack](https://docs.dema.ai/guides/agent/integrations/slack.md): Let the Dema Agent search Slack messages, post updates, and collaborate on Slack canvases. - [Snowflake](https://docs.dema.ai/guides/agent/integrations/snowflake.md): Let the Dema Agent query data, run Cortex AI tools, and execute SQL through your Snowflake account. - [Dema Agent](https://docs.dema.ai/guides/agent/overview.md): Learn how the Dema AI agent works — from conversations and instructions to specialized agents and tools. - [Skills](https://docs.dema.ai/guides/agent/skills.md): Learn how to create and manage skills that extend the Dema Agent with specialized knowledge, workflows, and Python helpers. - [Authentication](https://docs.dema.ai/guides/api-access/authentication.md): Learn how to obtain API keys and authenticate your requests to the Dema's GraphQL API. - [Endpoints](https://docs.dema.ai/guides/api-access/endpoints.md): Learn about the Dema API endpoint URL and how to make requests. - [Examples & Usage](https://docs.dema.ai/guides/api-access/examples.md): Practical examples for querying the Dema API, including organization information, definitions, and statistics data. - [Overview](https://docs.dema.ai/guides/api-access/overview.md): Introduction to Dema's API for accessing your business and statistical data programmatically. - [Rate Limits](https://docs.dema.ai/guides/api-access/rate-limits.md): Understand rate limits for the Dema API and how to handle them. - [Versioning](https://docs.dema.ai/guides/api-access/versioning.md): Dema GraphQL API versioning strategy and deprecation practices. - [Configuring calibration settings](https://docs.dema.ai/guides/causal-factor-attribution/configuring-calibrations.md): Step-by-step guide to setting up causal factor attribution calibrations: from reading the benchmark distribution to saving your configuration. - [How Causal factor attribution works](https://docs.dema.ai/guides/causal-factor-attribution/how-it-works.md): Learn how Dema uses causal evidence from incrementality experiments and platform-wide benchmarks to correct attribution values and reveal the true impact of your marketing. - [Interpreting calibrated attribution](https://docs.dema.ai/guides/causal-factor-attribution/interpreting-results.md): Understand how calibrated attribution changes your channel mix, read before-and-after comparisons, and know when to update your calibrations. - [Custom metrics/dimensions](https://docs.dema.ai/guides/custom-metrics-dimensions.md): How to do create custom metrics/dimensions - [Create dashboards](https://docs.dema.ai/guides/dashboards/create-dashboard.md): Learn how to create dashboards in Dema to visualize your data and insights. - [How filters work in dashboards](https://docs.dema.ai/guides/dashboards/filters.md): Learn how to apply filters to your dashboards in Dema to refine your data and focus on what matters most. - [Inventory forecasting](https://docs.dema.ai/guides/forecasts/inventory-forecasting.md): Understand how historical data is transformed into actionable business insights. - [LTV forecasting](https://docs.dema.ai/guides/forecasts/ltv-forecasting.md): Understand how customer data is transformed into actionable profit-based lifetime value insights. - [Order forecasting](https://docs.dema.ai/guides/forecasts/order-forecasting.md): Transform historical order patterns into accurate time series predictions using advanced seasonal decomposition models. - [Attribution](https://docs.dema.ai/guides/fundamentals/attribution.md): Understand how Dema attributes conversions to specific channels or campaigns. Learn about our supported models (last-click, linear, ML-based multi-touch, ad platform-reported, and causal factor attribution) and how to interpret the results. - [Our core data model](https://docs.dema.ai/guides/fundamentals/data-model.md): Discover how Dema collects, processes, and enriches your e-commerce data—from real-time events and orders to marketing costs, shipping rules, and returns. See how each data point comes together to power near real-time profitability insights, including Gross Profit 2 (GP2) costs like toll, pick & pac… - [Dimensions](https://docs.dema.ai/guides/fundamentals/dimensions.md): Learn about the dimensions in Dema that let you slice, segment, and analyze your data across different categories (channel, country, product, etc.). These dimensions are automatically populated from your tracking script, e-commerce platform, or marketing integrations, giving you granular insights in… - [Discounts](https://docs.dema.ai/guides/fundamentals/discounts.md) - [Metrics](https://docs.dema.ai/guides/fundamentals/metrics.md): Discover the key performance metrics that Dema tracks and calculates to empower data-driven decisions. This section explains what each metric represents, how it’s calculated, and why it matters. You can use these metrics to uncover growth opportunities, optimize spend, and monitor profitability in n… - [Tracking](https://docs.dema.ai/guides/fundamentals/tracking.md): Learn how Dema’s tracking script collects and processes your e-commerce data in near real-time. Understand which events are captured by default, how sessions are created (similar to GA Universal), and how to install Dema on Shopify, GTM, or via a server-side integration. - [Analyze a suggested experiment](https://docs.dema.ai/guides/incrementality-testing/analyze-suggestion.md): Learn how to interpret the suggested experiment table in Dema and what each metric represents. - [Concurrent tests](https://docs.dema.ai/guides/incrementality-testing/concurrent-tests.md): Learn how to run multiple 2-cell experiments concurrently in Dema and understand the risks and best practices. - [How incrementality testing works in Dema](https://docs.dema.ai/guides/incrementality-testing/how-it-works.md): Learn how Dema's incrementality testing isolates the true impact of your marketing campaigns on both sales and profit. - [Platform lift studies vs Dema](https://docs.dema.ai/guides/incrementality-testing/platform-lift-studies.md): Understand the differences between platform conversion lift studies and Dema's geo-based incrementality tests, and why Dema provides a more reliable, neutral measurement. - [Post-treatment window](https://docs.dema.ai/guides/incrementality-testing/post-treatment-window.md): Discover how Dema uses a post-treatment window to capture delayed marketing effects and provide a complete picture of your campaign's performance. - [Seasonality effects](https://docs.dema.ai/guides/incrementality-testing/seasonality.md): Learn how Dema adjusts for seasonality in incrementality testing to ensure accurate measurement of marketing impact. - [Structuring tests](https://docs.dema.ai/guides/incrementality-testing/structuring-tests.md): Learn how to design and structure incrementality experiments in Dema to measure true business impact. - [Terminology](https://docs.dema.ai/guides/incrementality-testing/terminology.md): Key terms and concepts used in Dema's incrementality testing documentation. - [Understand test results](https://docs.dema.ai/guides/incrementality-testing/understand-test-results.md): Learn how to interpret key metrics, graphs, and insights from Dema's incrementality test results. - [What is incrementality](https://docs.dema.ai/guides/incrementality-testing/what-is-incrementality.md): Learn how incrementality testing isolates true marketing impact and enhances MMM. - [Planning future budgets](https://docs.dema.ai/guides/mmm/create-a-future-scenario.md): Learn how to use Dema's MMM to plan upcoming marketing budgets, optimize for profit targets, and test different allocation strategies. - [Details view](https://docs.dema.ai/guides/mmm/details.md): Learn how to analyze spend recommendations, saturation curves, adstock effects, and channel contributions in Dema's MMM Details view. - [How MMM works in Dema](https://docs.dema.ai/guides/mmm/how-mmm-works.md): Learn how Dema's Marketing Mix Modeling uses profitability-focused models to optimize your marketing spend and maximize profit. - [Model settings](https://docs.dema.ai/guides/mmm/model-settings.md): Learn how to configure MMM optimization targets, budget constraints, and guardrails to align recommendations with your business strategy. - [Overview view](https://docs.dema.ai/guides/mmm/overview.md): Learn how to use Dema's MMM Overview to quickly assess optimization opportunities across markets and channels. - [View settings](https://docs.dema.ai/guides/mmm/view-settings.md): Learn how to filter, aggregate, and customize the MMM view to focus on the markets, channels, and metrics that matter most. - [Using labels to organize reports](https://docs.dema.ai/guides/organization/labels.md): Learn how to set up and use labels in Dema to organize, find, and filter reports with ease. - [Manage users](https://docs.dema.ai/guides/organization/manage-users.md): Learn how to invite manage members to Dema, assign roles, and manage access levels for seamless collaboration across your organization. - [Single Sign-On (SSO) with Microsoft Entra ID](https://docs.dema.ai/guides/organization/microsoft-sso.md): Learn how to configure Microsoft Entra ID (formerly Azure AD) as a SAML-based SSO provider for your Dema organization. - [Reset password](https://docs.dema.ai/guides/organization/reset-password.md) - [Single Sign-On (SSO) with Google](https://docs.dema.ai/guides/organization/sso.md): Learn how to set up and use Google SSO for secure and streamlined access to Dema. - [Creating and managing teams](https://docs.dema.ai/guides/organization/team.md): Learn how to set up and manage teams in Dema to streamline navigation, restrict data access, and simplify reporting. - [How filters work in reports](https://docs.dema.ai/guides/reports/filters.md): Learn how to apply filters to your reports in Dema, refine your data, and focus on what matters most using dimension and metric filtering. - [Setting your attribution model](https://docs.dema.ai/guides/reports/select-attribution.md): Learn how to customize and apply attribution models in Dema reports to better analyze and distribute your revenue data. - [Create product sets](https://docs.dema.ai/guides/segmentation/create-product-sets.md): Learn how to create product sets in Dema to segment your catalog and export custom labels for Google and Meta feeds. - [Export to Shopify tag](https://docs.dema.ai/guides/segmentation/export-to-shopify-tag.md): Learn how to export your product set labels to Shopify as tags for use in your store. - [Override product sets from reports](https://docs.dema.ai/guides/segmentation/manual-overrides.md): Learn how to manually override product sets directly from reports in Dema, giving you precise control over your feed segmentations. - [Integrate marketing spend](https://docs.dema.ai/guides/setup/integrate-marketing.md): Connect Meta, Google Ads, TikTok, and more to track your marketing spend seamlessly in Dema. - [Integrate orders and inventory](https://docs.dema.ai/guides/setup/integrate-orders-and-inventory.md): Mix and match e-commerce platforms, sFTP, and data warehouses to sync orders, inventory, and returns seamlessly with Dema. - [Invite your team](https://docs.dema.ai/guides/setup/invite.md): Quickly invite team members to Dema and assign roles to streamline collaboration across your organization. - [Add pixel (Tracking script)](https://docs.dema.ai/guides/setup/pixel.md): Learn how to install the Dema tracking script on various platforms like Shopify, custom sites, and Google Tag Manager. Verify your events are coming in and troubleshoot common issues. - [Set up hierarchical costs and returns](https://docs.dema.ai/guides/setup/setup-cost.md): Learn how to configure rules-based fulfillment and return costs for shipping, toll, pick & pack, and transaction fees, along with return thresholds and fallback margins. - [Targets](https://docs.dema.ai/guides/setup/targets.md): Learn more about how you can use your budget to setup targets in our platform. - [Create UTM mapping](https://docs.dema.ai/guides/setup/utm-mapping.md): Learn how to map UTM parameters to the correct channels and channel groups in Dema to ensure accurate attribution and cost mapping. - [Setup UTM parameters](https://docs.dema.ai/guides/setup/utm-parameters.md): Learn how to setup UTM parameters effectively for seamless integration with Dema. - [Set up tracking with single page applications](https://docs.dema.ai/guides/single-page-application.md): How to set up tracking with single page applications - [Google BigQuery](https://docs.dema.ai/integrations/datawarehouse/bigquery.md): Integrating Google BigQuery with our platform enables seamless data synchronization, enhancing your analytics capabilities. - [Databricks (Delta Sharing)](https://docs.dema.ai/integrations/datawarehouse/databricks.md): Integrating Databricks with our platform via Delta Sharing enables seamless data synchronization, enhancing your analytics capabilities. - [File transfer](https://docs.dema.ai/integrations/datawarehouse/fileTransfer.md): Our platform supports multiple methods for data integration through file transfers. Once uploaded, files are automatically processed and synchronized. - [Overview](https://docs.dema.ai/integrations/datawarehouse/overview.md): Import data from various sources using file transfers or connect directly to your data warehouse. - [Snowflake](https://docs.dema.ai/integrations/datawarehouse/snowflake.md): Integrating Snowflake with our platform enables seamless data synchronization, enhancing your analytics capabilities. - [Centra](https://docs.dema.ai/integrations/ecommerce/centra.md): Integrating Centra with our platform streamlines the synchronization of orders, indeliveries and inventory data, significantly enhancing the management of your e-commerce operations. - [Commercetools](https://docs.dema.ai/integrations/ecommerce/commercetools.md): Integrating commercetools with our platform allows for the seamless synchronization of orders and inventory data, enhancing your e-commerce operations. - [Overview](https://docs.dema.ai/integrations/ecommerce/overview.md): Integrate your e-commerce platform to automatically sync orders, products, inventory, and customer data. - [Shopify](https://docs.dema.ai/integrations/ecommerce/shopify.md): Learn how to integrate your Shopify store's orders and inventory with Dema using our custom app distribution link. - [Google Ads](https://docs.dema.ai/integrations/marketing/google.md): Integrating Google Ads with our platform enables access to detailed advertising data, empowering you with advanced analysis and insights for optimizing your marketing efforts. - [Google Sheets](https://docs.dema.ai/integrations/marketing/google-sheets.md): Integrating Google Sheets with our platform allows you to seamlessly import and analyze marketing cost data. - [Meta Ads](https://docs.dema.ai/integrations/marketing/meta.md): Integrating Meta Ads with our platform enables seamless synchronization of your advertising data, enhancing marketing analysis and insights. - [Overview](https://docs.dema.ai/integrations/marketing/overview.md): Connect your marketing platforms to automatically import campaign costs and performance data. This enables accurate ROI calculations and marketing attribution. - [Pinterest Ads](https://docs.dema.ai/integrations/marketing/pinterest.md): Integrating Pinterest Ads with our platform enables seamless synchronization of your advertising data, enhancing marketing analysis and insights. - [Snapchat Ads](https://docs.dema.ai/integrations/marketing/snapchat.md): Integrating Snapchat Ads with our platform enables seamless synchronization of your advertising data, enhancing marketing analysis and insights. - [TikTok Ads](https://docs.dema.ai/integrations/marketing/tiktok.md): Integrating TikTok Ads with our platform enables seamless synchronization of your advertising data, enhancing marketing analysis and insights. - [Overview](https://docs.dema.ai/integrations/overview.md): Our platform integrates with your existing tools to provide a unified view of your business performance. Choose an integration category below to get started. - [Sitoo POS](https://docs.dema.ai/integrations/pos/sitoo.md): This guide outlines the process of integrating the Sitoo Point of Sale (POS) system with our platform to synchronize in-store sales and return data. - [Google Tag Manager](https://docs.dema.ai/integrations/tracking/google-tag-manager.md): This guide covers the process for integrating Dema tracking into your website using Google Tag Manager (GTM) with the V2 event API. - [Overview](https://docs.dema.ai/integrations/tracking/overview.md): Dema offers three flexible methods for tracking events on your website: Server-Side Event Tracking, Google Tag Manager (GTM) Integration, and Shopify App Integration. - [Server-side tracking (deprecated)](https://docs.dema.ai/integrations/tracking/server-side-tracking.md): This guide outlines the process for sending event tracking data to Dema from the server-side, covering pageview and order events via HTTP requests. - [Server-side tracking V2](https://docs.dema.ai/integrations/tracking/server-side-tracking-v2.md): Send event tracking data to Dema from the server-side using the V2 tracking API. Supports extensible event types including page views, product views, and purchases. - [Home](https://docs.dema.ai/welcome/home.md) ## OpenAPI Specs - [package-lock](https://docs.dema.ai/package-lock.json) - [openapi](https://docs.dema.ai/api-reference/openapi.json) ## Optional - [Blog](https://dema.ai/blog) - [Changelog](https://dema.ai/changelog) - [Roadmap](https://inside.dema.ai)