Documentation

Everything you need to integrate North Star Metric with your Shopify store

Quick Start

Installation

Install the North Star Metric app from the Shopify App Store in under 2 minutes.

Read guide →

API Reference

Complete API documentation for advanced integrations and custom tracking.

View API docs →

Privacy & GDPR

Learn how we handle data privacy, GDPR compliance, and cookie consent.

Read more →

Installation

Getting started with North Star Metric is simple. Follow these steps:

  1. Install the Shopify App - Visit the Shopify App Store and click "Add App"
  2. Grant Permissions - Approve the required permissions for tracking and webhooks
  3. Start Tracking - Our tracking script is automatically installed on your store
  4. View Analytics - Visit your dashboard to see real-time visitor data

⚡ Quick Tip: No code changes required! Everything is handled automatically through our Shopify App Extension.

API Reference

For advanced use cases, you can integrate with our API:

# Track custom events
POST https://track.northstarmetric.io/event
{
"store_id": "your-store.myshopify.com",
"event_type": "custom_event",
"visitor_id": "vtr_...",
"properties": { ... }
}

Available Endpoints:

  • /event - Track custom events
  • /matching - Device fingerprinting (internal)
  • /atc - Add-to-cart tracking

Privacy & GDPR

We take privacy seriously. Here's how we handle data:

✅ Cookie-less by Default

Our fingerprinting technology works without cookies, eliminating GDPR cookie consent requirements.

✅ Anonymized Data

Visitor IDs are cryptographically generated and cannot be reverse-engineered to identify individuals.

✅ Data Retention

All tracking data is automatically deleted after 365 days (configurable per store).

✅ Consent Management

We respect your customers' consent choices via Shopify Customer Privacy API.

🔒 Privacy-First: Our UTM tracking works even without consent, as UTM parameters are considered non-PII under GDPR.

Attribution Models

North Star Metric supports multiple attribution models:

First-Touch

Credits the first marketing touchpoint that brought the customer to your store.

Last-Touch

Credits the last marketing touchpoint before the purchase.

Linear

Coming soon - Equal credit to all touchpoints.

Time-Decay

Coming soon - More credit to recent touchpoints.

Ready to Get Started?

Install North Star Metric and start tracking in minutes

Start Free Trial