Shopify

Use this setup when Shopify is the source of truth for purchases. It connects the first campaign visit to product discovery, checkout, the completed order, and later refunds so reporting reflects net revenue.

​

Before you start

You need permission to install apps, edit the active theme, and connect the ad accounts you use. Have Shopify’s test-payment flow ready so you can verify the integration without relying on a live customer.

​

1. Connect the store

Open Sources → Shopify and enter the permanent myshopify.com domain—not a custom storefront domain. Complete OAuth, install the Datalyr Web Pixel, and enable the Datalyr App Embed in the active theme. Both installations matter: the App Embed observes the editable storefront, while the Web Pixel covers supported Shopify checkout activity. Do not add an extra manual Datalyr snippet when the App Embed already owns browser tracking.

​

2. Verify product discovery

Open the storefront in a private window with test UTMs. Browse a product and begin checkout. In Events, confirm the first pageview contains the expected page URL and campaign properties, followed by the storefront events you expect. If the first visit is missing, fix that before testing revenue. Attribution cannot reconstruct acquisition context that was never collected.

​

3. Verify an order

Complete a Shopify test order and confirm the purchase includes:

• Order or transaction ID
• Value and currency
• Customer identity when available
• Products or line items
• The earlier visitor journey

Then refund the order and confirm refunded and net revenue update. Shopify should be the only authority for these transaction events; do not also send the same purchase manually.

​

4. Connect acquisition platforms

Connect Meta, Google Ads, TikTok, Snapchat, or OpenAI Ads from Sources as needed. Select the correct account and asset, then create a conversion rule for the paid-order event. Use the destination’s test-event mode when available before enabling production delivery.

​

5. Reconcile reporting

Compare Shopify and Datalyr with the same date range, timezone, currency, test-order policy, and refund basis. Small differences can come from whether a report uses order date, event date, or refund date.

​

Common problems

• Duplicate pageviews: both the App Embed and a manual snippet are installed.
• Checkout is visible but the landing visit is not: the App Embed is disabled or blocked on the storefront.
• The store will not connect: a custom domain was entered instead of the permanent Shopify domain.
• Purchases are duplicated: Shopify and custom code both send the order.
• Revenue differs after refunds: the reports use different timezones or refund-date behavior.

​

You are done when

A private test visit with campaign parameters leads to one Shopify order on the same journey, the correct conversion reaches the selected destination, and a refund updates net revenue without creating duplicate events. See Install on Shopify and Shopify revenue for detailed configuration.