Connect Shopify to Metrikia

Goal

By the end of this guide, your Shopify store will be connected to Metrikia: your orders, products and customers will sync automatically so they can be correlated with your ad spend and real ROAS.

Prerequisites

• An active Metrikia account
• Being the Shopify store owner, or a staff member with the App development permission. A collaborator account cannot do this setup: the Dev Dashboard is a Shopify organisation-level surface they have no access to.
• Your store's technical domain, which ends in .myshopify.com

Since January 1st 2026 a merchant can no longer create a custom app from their store admin. New apps are created in the Dev Dashboard, which no longer shows an access token to copy: you copy a Client ID and a Client secret, and Metrikia mints the token for you. If you are looking for a token starting with shpat_, it no longer exists for an app created today.

Step 1: Open the Dev Dashboard

1. In your Shopify admin, go to Settings, then Apps and sales channels
2. Click Develop apps at the top of the page
3. Click Develop apps in the Dev Dashboard

You can also open dev.shopify.com/dashboard directly. On that page, the orange notice restates the January 1st 2026 date: the "Create an app" button still sitting next to it only concerns Shopify partners on a store they have not transferred to a merchant yet, which is not your case.

Step 2: Create the app

1. In the Dev Dashboard, stay on Apps and click Create app in the top right
2. In the Start from Dev Dashboard card, enter a name (for example Metrikia)
3. Click Create

Step 3: Declare the read access and release

1. The version screen opens on its own right after creation
2. Untick the option that embeds the app in the Shopify admin: this app provides no screen, leaving it on adds an empty page to your admin
3. Under API access, in the Scopes field, enter the four read scopes separated by commas: read_orders, read_products, read_customers, read_inventory
4. Click Release in the top right, then confirm in the dialog that opens

Until the version is released, the credentials from step 5 grant access to nothing. The version name and message are optional.

Step 4: Declare the custom distribution

Without this step Shopify REFUSES access to your orders: your app is treated as an unapproved public app. Everything else will look fine (products sync, the connection is accepted) but neither your sales nor your revenue will reach Metrikia.

1. In the app, open API access requests: Shopify states there that API access depends on the distribution model, and that you must choose it before any request
2. Open Distribution, select Custom distribution, then click Select
3. Confirm in the dialog: the operation is irreversible and limits the app to a single store, which is exactly the intent here
4. Enter your store's .myshopify.com domain, then click Generate link

Both screens live in the Partner Dashboard (partners.shopify.com), not in the Dev Dashboard. The Select distribution method link on the app overview page takes you straight there.

Step 5: Install the app on your store

1. In the left menu, click the app name to open its overview page
2. In the Installations card, click Install app
3. Select your store
4. On the authorization screen in your Shopify admin, click Install

Step 6: Copy your credentials

1. In the app's left menu, open Settings
2. In the credentials card, copy the Client ID
3. Copy the Client secret right below it, with the copy icon. It also authenticates the notifications Shopify sends to Metrikia.

Both values stay readable in the Dev Dashboard. Unlike the old token, you can come back for them later if you lose them.

Step 7: Connect Shopify in Metrikia

1. In Metrikia, open Settings, then My connections
2. In the E-commerce category, open the Shopify card
3. Click Connect with a custom app instead, below the main button
4. Fill in the 3 fields:

• Shop domain: your-shop.myshopify.com
• Client ID: the value copied in step 6
• Client Secret: the value copied in step 6

1. Click Connect: the card flips to Connected

Expected result

Your orders, products and customers start syncing automatically. The first data appears within a few minutes; if your store has a large history, the full sync can take a few hours. The Check Connection button on the card confirms at any time that the access still works.

Tracking pixel

With this connection mode the pixel is not installed automatically: the app belongs to your own organisation, so Metrikia cannot deploy its tracking extension into it. You install it yourself, in a few minutes.

1. On the Metrikia Shopify connection page, once the connection is established, a card shows the code to paste along with a Copy button
2. In your Shopify admin, open Settings, then Customer events (also linked directly from the card)
3. Click Add custom pixel, name it Metrikia, then paste the code copied in step 1
4. Set the permission to Not required and the data sale option to Does not qualify
5. Click Save, then Connect: a saved but unconnected pixel does nothing
6. Open your store in a new tab so the first event fires

The card shows the pixel status live: Waiting for the first event, then Pixel active once the first event is received. The same code stays available under Settings > Pixel, tab Shopify (custom pixel). One pixel per store: do not also install the website snippet on a Shopify theme.

Without the pixel, orders still sync, but Metrikia cannot tie a purchase back to the ad that triggered it. That is the step that makes real ROAS possible: do not skip it.

Common problems

I cannot find the Admin API access token

That is expected: it no longer exists for an app created in the Dev Dashboard, and Metrikia no longer needs it. It mints its own token, valid for 24 hours and renewed automatically, from the Client ID and the Client secret. If you still see the app development screen in your store admin, an app was created there before January 1st 2026: it keeps working, but every new app goes through the Dev Dashboard.

I have no access to the Dev Dashboard

A collaborator account, the usual case for an agency or an external developer, has no access: it is an organisation-level permission, not a store one. Ask the store owner to run steps 1 to 6, or have the App development permission granted to you.

Invalid credentials or the connection fails

• Check that the app is actually installed on the store (step 5)
• Double-check the scopes from step 3, and that you clicked Release
• Check that the custom distribution is declared (step 4): without it orders are refused while everything else works
• Check that the Client secret was copied in full, with no leading or trailing space

The domain must end with .myshopify.com

Use your store's technical .myshopify.com domain, not your custom domain (for example mystore.com). You can find it in your Shopify admin URL or under Settings > Domains.

Next step

Your Shopify data is now in Metrikia. Cross-reference it with your campaigns in ADS to measure your store's real ROAS. Questions along the way? Ask Diana from the help menu.