How do I connect Shopify so orders flow into Decisa?

Open Sidebar → Integrations → Shopify, paste your shop domain and a Shopify Admin API access token, and click Connect Shopify — Decisa then pulls orders every night and recovers any checkout that never arrived by webhook.

Before you start

• A workspace with the Attribution module active.
• The Admin role in the workspace — only admins can manage the order backfill.
• Access to your Shopify admin, so you can create an Admin API access token.

Steps

1. Open the Shopify integration

   Go to Sidebar → Integrations → Shopify. The page shows a card titled "Backfill missed orders (Shopify)" with the connection form.

2. Create a Shopify access token

   In your Shopify admin, go to Settings → Apps and sales channels → Develop apps, create an app with the read_orders scope, then copy its Admin API access token (it starts with shpat_).

3. Connect Shopify

   Back in Decisa, fill in "Shop domain" (for example acme.myshopify.com) and "Admin API access token", then click "Connect Shopify".

4. Confirm the connection

   You'll see the confirmation "Shopify connected. Decisa will backfill missed orders nightly." The card then shows "Not synced yet — the first pull runs tonight."

What happens next

• Every night, Decisa pulls recent orders from your store and recovers any checkout that never reached us by webhook. Orders already tracked are never double-counted.
• After the first pull, the card shows "Last synced" with how long ago it ran, next to your shop domain.
• The "Webhook coverage" card on the same page shows whether the checkout webhooks Decisa received over the last 14 days became conversions, broken down by provider — so you can see live tracking and the nightly recovery side by side.
• Recovered orders appear with your conversions and count toward the ROAS report like any other order.

Gotchas

• The token must include the read_orders scope. Without it, the connection is saved but the nightly pull can't read your orders — recreate the app's token with the right scope and update the credentials.
• A 100% rate on "Webhook coverage" does not mean every order was captured — it only counts webhooks that actually reached Decisa. Orders that never arrived are exactly what the nightly Shopify pull recovers, so keep both connected.
• The pull runs nightly, not instantly. If a missed order doesn't show up right after connecting, check again the next morning.
• Clicking "Disconnect" stops the nightly pull. Conversions already captured stay, but future missed orders won't be recovered until you reconnect.