Skip to main content

Overview

Read this page carefully to determine which integration is best for your Shopify site. If you’re not sure which to use, contact support.
This integration captures logs from a Shopify site. Unlike other platforms, Shopify has no built-in log export. Profound supports the following Shopify integrations:
  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

Shopify setup

Limitations of Hydrogen-based integrations

Important: Shopify’s Hydrogen platform does not expose client IP addresses in log drains or trace exports. This is a Shopify platform limitation.

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, Profound can’t run the multi-step verification process. Shopify imposes this platform constraint. No configuration, workaround, or API option includes 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
Profound still collects and displays analytics data from Hydrogen-based integrations, but classification accuracy is lower than with integrations that provide complete request metadata.

Recommendation

Integrate your Shopify site via Nostra (option 1 above). Nostra’s platform uses a Cloudflare integration, which provides full request metadata, including client IP addresses. As a result, the Nostra integration avoids 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.
This limitation is not unique to Agent Analytics. Any third-party service consuming Hydrogen log drains or trace exports faces the same constraint: Shopify doesn’t include client IP data in these exports. The recommended path for complete traffic visibility on Shopify is through a CDN-native integration like Nostra.