Installation
Get Converlay running on your Shopify store in under 5 minutes. No code changes required.
Prerequisites
- An active Shopify store (any plan)
- Admin access to your Shopify store
- At least one destination ready (e.g., a GA4 Measurement ID or Meta Pixel ID)
Step 1: Install from the Shopify App Store
- Visit the Converlay listing on the Shopify App Store
- Click Install
- Review the requested permissions and click Install app
Permissions requested
Converlay requests the following scopes during installation:
| Scope | Purpose |
|---|---|
read_pixels, write_pixels | Install and manage the Converlay tracking pixel |
read_customer_events | Receive storefront and checkout events to forward |
read_orders | Read completed-purchase value and line items |
read_customers | Match purchases to ad clicks with hashed email and phone |
read_products | Include product details in event payloads |
read_analytics | Benchmark Shopify's own totals against what was delivered |
Why Converlay needs each permission
In plain terms — what each permission lets Converlay do, why it's needed, and what it is never used for.
read_pixels, write_pixels
- What it accesses: Lets Converlay add its pixel to your store's Customer Events and keep it up to date.
- Why it's needed: This is what captures storefront events — with no theme edits or code from you.
- Not used for: It touches only the Converlay pixel, never your theme, other apps, or store settings.
read_customer_events
- What it accesses: Receives the events Shopify's pixel emits — page views, add-to-cart, checkout, and purchases.
- Why it's needed: These events are the conversions Converlay forwards server-side to your destinations.
- Not used for: Building customer profiles or tracking people across other stores.
read_orders
- What it accesses: Reads the value, currency, and line items of completed orders.
- Why it's needed: Ad platforms need accurate order value and contents to attribute revenue and optimize campaigns.
- Not used for: Fulfillment, editing orders, or payments — Converlay never sees card or bank data.
read_customers
- What it accesses: Reads the email and phone tied to an order.
- Why it's needed: Platforms like Meta and Google match a purchase to the ad click that drove it using hashed contact details, which Converlay hashes with SHA-256 before they leave your server.
- Not used for: Emailing or marketing to your customers, or sending raw personal data anywhere.
read_products
- What it accesses: Reads the product names, IDs, and prices referenced in an event.
- Why it's needed: Destinations that power catalog and dynamic ads need product details in the payload.
- Not used for: Editing your catalog, pricing, or inventory.
read_analytics
- What it accesses: Reads your store's aggregate sales totals — not individual customer records.
- Why it's needed: Converlay's tracking health check compares what Shopify recorded against what each destination received, so you can spot gaps.
- Not used for: Anything that identifies an individual customer.
Step 2: Connect a destination
After installation, you'll be taken to the Converlay dashboard. Navigate to Setup and enter your destination credentials. See the destinations guide for detailed instructions per platform.
Step 3: Verify the pixel is connected
- In your Shopify Admin, go to Settings → Customer events
- Find Converlay in the pixel list
- Confirm the status shows Connected
Test your pixel
Click the three-dot menu next to the Converlay pixel and select Test. Shopify's built-in pixel tester will open — browse your storefront and verify events fire in real time.