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

# Shopify

> This documentation details 3 potential Shopify log drain integrations for Profound Agent Analytics platform.

## Overview

<Note>
  Please carefully read the documentation to determine which integration is best for your Shopify site. Not sure which to use? Please contact [support](mailto:support@tryprofound.com) for assistance.
</Note>

This integration is designed to capture logs from a Shopify site. Shopify is unlike other integrations in that there is no out-of-the-box solution for log exports. We detail three potential integrations for Shopify:

1. Shopify via Nostra (Recommended)
2. Shopify Log Drain via Hydrogen (Requires Hydrogen)
3. Shopify Trace Exporter (Requires Hydrogen)

## Prerequisites

* A Shopify site

* Access and management permissions to the Shopify site

* If connecting via **Nostra**, you must be a customer of both Profound and Nostra.

* If connecting via **Hydrogen**, you must have a Shopify Plus account.

## Configuration

<img src="https://mintcdn.com/profound-37face47/jkiOf0G56QSlBLCH/images/agent-analytics/shopify/shopify_setup.png?fit=max&auto=format&n=jkiOf0G56QSlBLCH&q=85&s=3ac484e400fcb734ec29cdea1c7c4608" alt="Shopify setup" width="3680" height="2392" data-path="images/agent-analytics/shopify/shopify_setup.png" />

<Tabs>
  <Tab title="Shopify via Nostra (Recommended)">
    Learn how to integrate your Shopify site with Profound Partner Nostra

    <Info>
      Integrating your Shopify site via Nostra is the recommended method with optimal analytics data. This method requires you to use Nostra's platform to track your Shopify site.
    </Info>

    <Steps>
      <Step title="Step 1">
        Ensure you are a Nostra customer hosting your Shopify site on their platform.
      </Step>

      <Step title="Step 2">
        Contact your Nostra account representative to request a log drain integration.
      </Step>

      <Step title="Step 3">
        Once the integration is complete, you will be able to see your Shopify site in the Profound dashboard.
      </Step>
    </Steps>

    <Check>That's it! Your Shopify site is now integrated with Profound via Nostra.</Check>
  </Tab>

  <Tab title="Shopify Log Drain via Hydrogen (Requires Hydrogen)">
    Learn how to integrate your Shopify site with Profound via Hydrogen.

    <Warning>
      This method requires your site uses Hydrogen and you have a Shopify Plus account.
    </Warning>

    <Steps>
      <Step title="Step 1">
        Ensure your Shopify site uses Hydrogen and you have a Shopify Plus account.
      </Step>

      <Step title="Step 2">
        Navigate to the Hydrogen Log Drain setup [documentation](https://shopify.dev/docs/storefronts/headless/hydrogen/logging#connecting-a-log-drain) and follow the instructions to configure the log drain.
      </Step>

      <Step title="Step 3">
        Select an an `HTTP` log drain for generic integrations. Enter the following URL:

        `https://artemis.api.tryprofound.com/v1/logs/shopify_hydrogen`
      </Step>

      <Step title="Step 4">
        Provider a header value `Bearer` with your Profound Log Ingestion Token. Your token should start with `bot_PROFOUND_LOG_INGESTION_TOKEN`.
      </Step>

      <Step title="Step 5">
        Click **Connect** to connect the log drain.

        <img src="https://mintcdn.com/profound-37face47/zh0y2yz9HzqrrnAo/images/agent-analytics/shopify/shopify_hydrogen.png?fit=max&auto=format&n=zh0y2yz9HzqrrnAo&q=85&s=89e5772d381aee0d39da5c638669a872" alt="Hydrogen Log Drain Configuration" width="1334" height="1150" data-path="images/agent-analytics/shopify/shopify_hydrogen.png" />
      </Step>
    </Steps>

    <Check>
      That's it! Your Shopify site is now integrated with Profound via Hydrogen.
    </Check>
  </Tab>

  <Tab title="Shopify Trace Exporter (Requires Hydrogen)">
    Learn how to integrate your Shopify site with Profound via the Trace Exporter.

    <Note>
      This method provides sampled tracing data, not a full log export.
    </Note>

    <Warning>
      This method requires your site uses Hydrogen and you have a Shopify Plus account.
    </Warning>

    <Steps>
      <Step title="Step 1">
        Ensure your Shopify site uses Hydrogen and you have a Shopify Plus account.
      </Step>

      <Step title="Step 2">
        Navigate to the Hydrogen Trace Export setup [documentation](https://shopify.dev/docs/storefronts/headless/hydrogen/trace-exports#configure-trace-exports) and follow the instructions to configure trace exports.
      </Step>

      <Step title="Step 3">
        Select an `HTTP` trace export for generic integrations. Enter the following URL:

        `https://artemis.api.tryprofound.com/v1/logs/shopify_hydrogen`
      </Step>

      <Step title="Step 4">
        Provide a header value `x-api-key` with your Profound Log Ingestion Token. Your token should start with `bot_PROFOUND_LOG_INGESTION_TOKEN`.
      </Step>

      <Step title="Step 5">
        Click **Save** to save the trace export configuration.
      </Step>
    </Steps>

    <Check>
      That's it! Your Shopify site is now integrated with Profound via the Trace Exporter.
    </Check>
  </Tab>
</Tabs>

## Limitations of Hydrogen-Based Integrations

<Warning>
  **Important**: Shopify's Hydrogen platform does not expose client IP addresses in log drains or trace exports. This is a platform limitation, not a Profound limitation.
</Warning>

### The Issue

Profound's Agent Analytics uses a multi-step verification process to accurately classify traffic — distinguishing real users from bots, crawlers, and automated agents. A key input to this process is the client IP address.

Shopify's Hydrogen runtime, hosted on Oxygen, strips client IP information from logs and traces before they reach external consumers. Because Profound never receives IP data through these integrations, the multi-step verification process cannot be performed.

This is an unavoidable platform constraint imposed by Shopify. There is no configuration, workaround, or API option to include IP addresses in Hydrogen log drains or trace exports.

### Impact on Analytics

Without client IP addresses, Profound cannot:

* Perform IP-based reputation checks against known bot networks
* Correlate requests across sessions for behavioral analysis
* Apply geographic and network-level classification signals
* Execute the full multi-step verification pipeline

Analytics data from Hydrogen-based integrations will still be collected and displayed, but classification accuracy is reduced compared to integrations that provide complete request metadata.

### Recommendation

We recommend integrating your Shopify site via **Nostra** (option 1 above). Nostra's platform uses a Cloudflare integration under the hood, which provides full request metadata — including client IP addresses. This means the Nostra integration does not suffer from any of the limitations described above, and Profound can run the complete multi-step verification process.

Using the Nostra integration requires you to be a customer of both **Profound** and **Nostra**.

<Note>
  This limitation is not unique to Agent Analytics. Any third-party service consuming Hydrogen log drains or trace exports faces the same constraint — Shopify simply does not include client IP data in these exports. The recommended path for complete traffic visibility on Shopify is through a CDN-native integration like Nostra.
</Note>