Getting Started with ShopiPixel

From installation to your first event in under 5 minutes.

1. Install ShopiPixel

Open the Shopify App Store (opens in new window) and search for "ShopiPixel". Click "Add app" and confirm the installation in your Shopify Admin.

Tip

Installation is free. The Free plan supports up to 50 orders/month with Meta Conversions API. You can upgrade anytime.

2. Complete onboarding

After installation, the onboarding wizard opens automatically. Here you set up your first platform connection:

  1. Accept Terms of Service and DPA
  2. Activate Web Pixel
  3. Check your consent banner — with a live test in your store
  4. Choose your plan
  5. Configure platforms
  6. Verify tracking

Detailed guides for each platform can be found under Platform Setup.

3. Activate Web Pixel

ShopiPixel uses the Shopify Web Pixel to capture browser events (PageView, AddToCart, etc.). The Web Pixel is created automatically during installation.

You can check the Web Pixel status in your Shopify Admin:

  1. Go to Shopify Admin > Settings > Customer Events
  2. Check that "ShopiPixel" is shown as "Connected"
  3. If not: Click "Connect"
This is what the tracking settings look like — configure tracking mode, event distribution and consent here.
This is what the tracking settings look like — configure tracking mode, event distribution and consent here.

4. Check your first event

After setup, open your store in a new browser tab and navigate through a few pages. Then go back to the ShopiPixel Dashboard:

  1. Open the ShopiPixel app in Shopify Admin
  2. Go to the Dashboard
  3. Check the Live Events view
  4. You should see PageView events
Important

Events may appear with a delay of up to 2 minutes. If no events are shown after 5 minutes, check the Web Pixel status and the Troubleshooting guide.

Verify your setup in test mode

You don't have to wait for real customers to see whether everything works. Enable <b>test mode</b> in the tracking settings, then place an order in your store and go through the checkout. This is how you verify your complete setup:

  1. Enable the Test mode switch under Settings > Tracking.
  2. Place an order in your store and complete the checkout.
  3. Open the Events page in ShopiPixel — your test purchase appears there with a TEST hint.
  4. Open Check your setup (tracking debugger) and run the self-test. It sends a test event to each connected platform and you'll see Ready ✓: platforms with their own test tool (e.g. Meta, TikTok, Pinterest, GA4) show this test event there; for the rest (e.g. Microsoft Ads, LinkedIn, Klaviyo) ShopiPixel confirms readiness directly — the conversion then appears with real orders.
  5. Once you see TEST on your purchase and Ready ✓ on your platforms, your setup is complete. Then disable test mode again for live operation.
Your numbers stay clean

While test mode is active, purchases don't count toward revenue, conversions or ad conversions. So you can test as often as you like without skewing your dashboard or the optimization of your ad campaigns.

Improve data quality (optional)

Under Settings > Tracking you'll find two optional toggles: Enhanced Conversions (enabled by default) sends hashed contact data to the platforms for better matching — plaintext data never reaches the advertising platforms. Consent Mode Modeling (disabled by default, for Google Analytics 4 and Google Ads only) sends an anonymous signal without personal data and without an IP address for visitors who have not given marketing consent.

5. Connect more platforms

You can add more platforms at any time. ShopiPixel supports 10 platforms:

  • Meta (Facebook & Instagram)
  • Google Analytics 4
  • TikTok
  • Google Ads
  • Pinterest
  • Snapchat
  • LinkedIn
  • Microsoft Ads
  • Klaviyo
  • Custom Webhooks

Go to ShopiPixel > Settings > Tracking, select the platform, enter the API credentials and save. All events are automatically sent to all configured platforms.

Detailed guides for each platform can be found under Platform Setup.

6. Choose a plan (optional)

Plan selection is part of the onboarding wizard. You can choose your plan there directly or change it anytime under Settings → Billing:

  • Free: Meta, 50 orders
  • Starter ($35/month): Meta + GA4, 500 orders
  • Growth ($70/month): + TikTok, Attribution, 2,000 orders
  • Scale ($119/month): All 10 platforms, 10,000 orders
  • Enterprise ($299/month): 100,000 orders, Public API, Dedicated Support

All paid plans include a 14-day free trial. More details on the Pricing page.

Setting up alerts

With alerts, you are automatically notified when something important happens — e.g. when a platform reports errors or your event volume is unusual.

  • Create alert rules: Go to Settings > Alerts. Define conditions (e.g. success rate below 90%), choose the threshold and notification channel.
  • Rule types: event volume (no incoming events), success/error rate, revenue and conversion drops, and agency quota utilization.
  • Notification channels: In-app banner, email or webhook. You can choose one or more channels per rule.
  • Automatic system notices: ShopiPixel automatically flags important states — e.g. when your plan limit is reached or (in Dual-Track mode) the Web Pixel stops sending events.

Ad Spend & ROAS

Connect your ad accounts to see spend and Return on Ad Spend (ROAS) directly in the dashboard.

  • Connect ad accounts: Go to Settings > Tracking and enter the ad account ID alongside the tracking credentials. For Meta this is the act_123456789012345 (prefix act_ + 15–16 digits), for Google Ads the 10-digit customer ID.
  • Automatic import: ShopiPixel regularly imports ad spend from connected platforms. The import runs at least once daily.
  • ROAS in the dashboard: Under Dashboard > Attribution you can see ROAS per platform and time period. ROAS = Revenue / Ad Spend. A ROAS of 3.0 means: for every dollar spent, 3 dollars in revenue come back.
  • Supported platforms: Ad spend import is available for Meta, Google Ads, TikTok, Pinterest, Snapchat, LinkedIn and Microsoft Ads.

Customer Journey

The customer journey shows the complete path of your customers from first contact to purchase.

  • Funnel flow: Under Dashboard > Conversion Funnel you can see the stages: Page view → Product view → Cart → Checkout → Purchase. The drop-off rate is visible at each stage.
  • Individual journeys: In the Attribution section, you can open individual orders and see which platform the customer came from and how long the purchase process took.
  • Touchpoints: With multiple touchpoints (e.g. first Facebook click, then Google search), ShopiPixel shows all involved platforms — with timestamp and event type.

Cohort analysis

Cohort analysis shows you how customer groups behave over time — ideal for retention optimization.

  • Retention heatmap: Under Dashboard > Cohorts you see a heatmap showing how many customers from a cohort (e.g. all first-time buyers in January) purchase again in the following months.
  • LTV curve: The lifetime value curve shows cumulative average revenue per customer across the months after first purchase (averaged over all cohorts). This shows how valuable your customers are long-term.
  • Cohort comparison: Compare different time periods or platforms to identify seasonal effects or channel differences.
  • Export: Export your cohort data via the export button as CSV or XLSX.

Custom Reports

Create individual reports with the metrics and dimensions that are relevant to your business.

  • Create a report: Go to Dashboard > Reports > New Report. Choose a name and the desired metrics.
  • Metrics: Revenue, conversions, events, success rate, AOV and more. Combine up to 10 metrics in one report.
  • Dimensions: Time period, platform. Additionally filterable by platform and event type.
  • Filters: Narrow the report to specific platforms, event types or time periods.
  • Schedule: Set up automatic delivery — daily, weekly or monthly via email as a CSV attachment.

Data Warehouse Export

Export your tracking data regularly to your data warehouse or BI tool.

  • Export methods: Custom webhook (real-time), manual CSV/XLSX download or scheduled automatic export.
  • Custom webhook: Under Settings > Tracking > Custom Webhooks you configure an endpoint where all events are sent in real-time. Ideal for data warehouses like BigQuery, Snowflake or Redshift.
  • CSV/XLSX download: Under Events > Export you can export your event data as CSV or XLSX at any time (from Starter plan).
  • PII stripping: During export, personal data is automatically removed or pseudonymized unless configured otherwise.