---
url: /guides/api/overview.md
---
# Overview

The Elevar API lets you push ecommerce events from your site and route them to
marketing platforms. Events are automatically enriched with user identity,
consent state, and attribution data before being forwarded to your live
destinations. You focus on pushing the right events at the right time.

![Data Layer Diagram](/img/data-layer-diagram.webp)

## Implementation Paths

The setup process varies based on your platform architecture. All customers
start with the [Browser Setup](#browser-setup), then follow additional steps
based on their integration type.

::: info

Not sure which path to follow?

* **Shopify Headless** (custom storefront with headless backend) →
  [Browser Setup](#browser-setup) + [Headless](#headless)
* **Platform Agnostic** (Non-Shopify with full checkout control) →
  [Browser Setup](#browser-setup) + [Agnostic](#agnostic)

:::

## Browser Setup

**Required for ALL customers**

All implementations start here. The Browser Setup configures the core Elevar
tracking functionality on your website.

### Steps to Complete

1. **[Install Scripts](/guides/api/browser-setup/install-scripts)** - Install
   Elevar tracking scripts on your site
2. **[Push Events](/guides/api/browser-setup/push-events)** - Implement the
   standard ecommerce events
3. **[Debug Mode](/guides/api/browser-setup/debug-mode)** - Verify your
   implementation is working correctly
4. **[User ID](/guides/api/browser-setup/user-id)** - Pass your own user
   identifier
5. **[Proxy Path](/guides/api/browser-setup/proxy-path)** - Work around ad
   blockers

::: info

After completing this section, proceed with your architecture-specific steps.

:::

## Headless

**Only for Shopify Headless integrations**

::: warning

Complete the [Browser Setup](#browser-setup) setup before starting this section.

:::

If you're implementing on a custom storefront with a headless commerce backend
(e.g., using Next.js, Remix, Hydrogen, or similar frameworks), follow these
additional steps after completing the Browser Setup:

* **[Shopify Source](/guides/api/headless/shopify-source)** - Connect our app
  embed into your live theme
* **[Market ID](/guides/api/headless/market-id)** - Configure market
  identification for multi-region stores
* **[Checkout URL](/guides/api/headless/checkout-url)** - Set up checkout URL
  handling for headless flows

## Agnostic

**Only for non-Shopify integrations**

::: warning

Complete the [Browser Setup](#browser-setup) setup before starting this section.

:::

If you have complete control over your checkout process and platform
architecture, and you're implementing on a non-Shopify ecommerce platform,
follow these steps after completing the Browser Setup:

* **[API Source](/guides/api/agnostic/api-source)** - Configure browser scripts
  and server credentials
* **[Checkout Events](/guides/api/agnostic/checkout-events)** - Implement the
  Data Layer checkout events
* **[Server Setup](/guides/api/agnostic/server-setup)** - Send events directly
  from your server

## Additional Resources

After completing your implementation path, explore these resources:

* **[Refreshing Context](/guides/api/additional-resources/refreshing-context)** -
  Understanding context refresh behavior
* **[Overarching Domain](/guides/api/additional-resources/overarching-domain)** -
  How to find the main overarching domain
