> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Set up customer data infrastructure in hours, not weeks

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

## Getting Started with Converge

Follow the instructions below to learn how to get your data into Converge, set up your first destination and power the dashboard with your ad platform data.

### 1. Get your customer data in Converge

To get started with Converge, you need to track the <OutboundLink linkText="Converge event spec" linkTarget="/sources/converge-spec" />. Converge has pre-built integrations with most Shopping Platforms. Simply pick your platform below and follow the steps.

<Note> Most Converge installations only involve a storefront and store backend setup. If you leverage custom checkouts, subscriptions, or landing page builders, you will want to connect these as well. </Note>

<AccordionGroup>
  <Accordion icon="globe" title="Connect your storefront">
    <Tabs>
      <Tab title="Shopify">
        Install our prebuilt <OutboundLink linkText="Shopify Storefront integration" linkTarget="/sources/website-integrations/shopify#installation-instruction" /> to track all important storefront and checkout events.

        <Info> We support headless Shopify stores natively. You can find more information on that in the  <OutboundLink linkText="Shopify Storefront integration documentation" linkTarget="/sources/website-integrations/shopify#installation-instruction" />  </Info>
      </Tab>

      <Tab title="WooCommerce">
        Install our prebuilt <OutboundLink linkText="WooCommerce Plugin" linkTarget="/sources/website-integrations/woocommerce#installation-instruction" />  to track all important storefront and checkout events.
      </Tab>

      <Tab title="Magento">
        Install our prebuilt <OutboundLink linkText="Magento Module" linkTarget="/sources/website-integrations/magento#installation-instruction" /> to track all important storefront and checkout events.
      </Tab>

      <Tab title="Custom">
        <Steps>
          <Step title="Install the Converge JS Pixel">
            You can find detailed instructions on installing the Converge JS Pixel on your storefront <OutboundLink linkText="here" linkTarget="/sources/website-integrations/converge-pixel#installation-instructions" />
          </Step>

          <Step title="Instrument Ecommerce Lifecycle events">
            Once installed, you should instrument your storefront with all <OutboundLink linkText="Ecommerce Lifecycle Events" linkTarget="/sources/website-integrations/converge-pixel#installation-instructions" />.
          </Step>
        </Steps>

        <Note>If multitouch attribution or longer cookie lifetimes are important, consider implementing a <OutboundLink linkText="server-side first party cookie" linkTarget="/sources/concepts/aliases#setting-up-a-server-side-first-party-cookie" />. If you want to understand why this might be necessary, start by reading about cookie lifetimes <OutboundLink linkText="here" linkTarget="/sources/concepts/aliases#aliases-for-re-identification" /> </Note>
      </Tab>

      <Tab title="BigCommerce">
        Install our prebuilt <OutboundLink linkText="BigCommerce Plugin" linkTarget="/sources/website-integrations/bigcommerce#installation-instruction" />  to track all important storefront and checkout events.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion icon="store" title="Connect your Store Backend">
    <Tabs>
      <Tab title="Shopify">
        Install our prebuilt <OutboundLink linkText="Shopify Store Backend integration" linkTarget="/sources/server-integrations/shopify#installation-instruction" /> to track all important server-side conversion events.
      </Tab>

      <Tab title="WooCommerce">
        Install our prebuilt <OutboundLink linkText="WooCommerce REST API integration" linkTarget="/sources/server-integrations/woocommerce#installation-instruction" /> to track all important server-side conversion events.
      </Tab>

      <Tab title="Magento">
        Install our prebuilt <OutboundLink linkText="Magento REST API integration" linkTarget="/sources/server-integrations/magento#installation-instruction" /> to track all important server-side conversion events.
      </Tab>

      <Tab title="Custom">
        <Steps>
          <Step title="Install the Converge Webhook Integration">
            You can find detailed instructions on installing the Converge Webhook Integration for server-side conversions <OutboundLink linkText="here" linkTarget="/sources/server-integrations/webhook#installation-instruction" />.
          </Step>

          <Step title="Instrument Ecommerce Lifecycle events">
            Once installed, you should instrument your webhook integration with the appropriate server-side <OutboundLink linkText="Ecommerce Lifecycle Events" linkTarget="/sources/converge-spec#ecommerce-events" />.
          </Step>
        </Steps>
      </Tab>

      <Tab title="BigCommerce">
        Install our prebuilt <OutboundLink linkText="BigCommerce API integration" linkTarget="/sources/server-integrations/bigcommerce#installation-instruction" /> to track all important server-side conversion events.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion icon="database" title="Connect other Datasources">
    <Tabs>
      <Tab title="Subscriptions">
        Use one of our pre-built connectors to get Subscription Lifecycle events in Converge.

        *         <OutboundLink linkText="Recharge" linkTarget="/sources/server-integrations/recharge#installation-instructions" />
        *         <OutboundLink linkText="Skio" linkTarget="/sources/server-integrations/skio#installation-instructions" />
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

### 2. Set up your Destinations

<Note>
  **Destinations send data from Converge** (e.g. `Purchase` events) to Destinations (e.g. Facebook Ads).
</Note>

<AccordionGroup>
  <Accordion icon="square-share-nodes" title="Set up destinations">
    <Tabs>
      <Tab title="Meta">
        Send your customer events to Meta using the <OutboundLink linkText="Meta Integration" linkTarget="/destinations/integrations/facebook#installation-instructions" />.
      </Tab>

      <Tab title="Google Ads">
        Send your customer events to Google Ads using the <OutboundLink linkText="Google Ads - Remarketing" linkTarget="/destinations/integrations/google-ads-remarketing#installation-instructions" /> or <OutboundLink linkText="Google Ads - Conversion tracking" linkTarget="/destinations/integrations/google-ads-conversions#installation-instructions" /> destinations.
      </Tab>

      <Tab title="Google Analytics 4">
        Send your customer events to Google Analytics 4 using the <OutboundLink linkText="Google Analytics 4 Integration" linkTarget="/destinations/integrations/ga4#installation-instructions" />.
      </Tab>

      <Tab title="TikTok Ads">
        Send your customer events to TikTok Ads using the <OutboundLink linkText="TikTok Ads Integration" linkTarget="/destinations/integrations/tiktok#installation-instructions" />
      </Tab>

      <Tab title="Other">
        You can find a full list of destinations under the <OutboundLink linkText="Destinations" linkTarget="/destinations/overview" /> section in the documentation.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

### 3. Set up Ad Platform Integrations

<Note>
  **Ad Platform Integrations pull metrics** (e.g. Ad Spend) from Ad Platforms **into Converge** for dashboarding purposes.
</Note>

<AccordionGroup>
  <Accordion icon="rotate" title="Set up Ad Platform Integrations">
    <Tabs>
      <Tab title="Meta">
        Pull in Ad Platform metrics from Meta using the <OutboundLink linkText="Meta Integration" linkTarget="/ad-platforms/integrations/facebook#installation-instructions" />
      </Tab>

      <Tab title="Google Ads">
        Pull in Ad Platform metrics from Google Ads using the <OutboundLink linkText="Google Ads Integration" linkTarget="/ad-platforms/integrations/google-ads#installation-instructions" />
      </Tab>

      <Tab title="TikTok Ads">
        Pull in Ad Platform metrics from TikTok Ads using the <OutboundLink linkText="TikTok Ads Integration" linkTarget="/ad-platforms/integrations/tiktok#installation-instructions" />
      </Tab>

      <Tab title="Other">
        You can find a full list of Marketing Sources under the <OutboundLink linkText="Marketing Sources" linkTarget="/ad-platforms/overview" /> section in the documentation.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

### 4. Connect the Converge MCP

Connect the Converge MCP server to your AI assistant to query your analytics data in natural language. Follow the [MCP setup guide](/mcp/setup) to get started.
