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
• Creating the app in the Shopify organization that owns the store or, for an agency, in its own Partner organization, then having the client install it through a custom distribution link (see the Connect a client's Shopify store (agencies) guide). This guide follows the first option: the organization name is shown in the bottom left of the Dev Dashboard, and it must be the store's organization. If you manage several organizations, switch from that menu before creating the app.
• Being the Shopify store owner or an admin, or a staff member with three permissions: App development, Manage and install apps and channels, and customer events. A collaborator account cannot do this setup: the Dev Dashboard is a Shopify organisation-level surface they have no access to. Plain developer access lets you create the app, but not install the tracking pixel afterwards.
• Your store's technical domain, which ends in .myshopify.com

Check the organization and your permissions before you start, otherwise the connection will be refused. If either point is not met, ask the store owner to create the app themselves. The Install app button in step 4 only offers the stores of the app's organization: if the app is created in an agency's organization, follow the Connect a client's Shopify store (agencies) guide.

Are you an agency?

You have two options to connect a client's store. Option A: the app is created in the store's organization, by following this guide. Here is how to proceed:

1. The store owner adds you as a staff member of the store (not as a collaborator account: collaborators have no access to the Dev Dashboard)
2. They grant you the App development permission, plus Manage and install apps and channels if you also install the pixel
3. In the Dev Dashboard, select the store's organization in the bottom left, then create the app by following the steps below

Option B: your agency creates the app in its own Partner organization, then your client installs it from a custom distribution link, without creating the app themselves. In that case, follow the Connect a client's Shopify store (agencies) guide.

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 creation form, enter a name (for example Metrikia). The version name is optional
3. App URL field: Shopify prefills https://example.com. Enter any https address, for example your website: Metrikia does not use it

Step 3: Declare the read access and release

1. Still in that form, untick Embed app in Shopify admin, which is ticked by default: this app provides no screen, leaving it on adds an empty page to your admin
2. Leave Allowed redirection URL(s) empty: that field only serves the agency path, not the connection described here
3. Under API access, type or paste the full line straight into the Scopes field: read_orders,read_all_orders,read_products,read_customers,read_inventory. Do not use the picker list: read_all_orders does not always appear in it

Keep read_all_orders. With read_orders alone, Shopify only grants access to orders created in the last 60 days: Metrikia imports 90 days of history on connection, so the oldest 30 days would be missing.

Shopify refuses read_all_orders? That scope sometimes has to be requested. Remove it from the line to move on: the connection works, with orders from the last 60 days only. For the full history, request access in Shopify Partners (your app, then API access requests, Read all orders scope and Request access), then add read_all_orders in a new released version.

1. Click Create, then confirm with Release 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: Install the app on your store

If the app overview page shows Select distribution method, the app was created in a partner or agency organization, not in the store's one: the install below will not offer you the store. Two ways out: switch organization in the bottom left of the Dev Dashboard and create the app again in the store's organization, or, if you are an agency, follow the Connect a client's Shopify store (agencies) guide, where your client installs the app through a custom distribution link.

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. If it is not listed, the app is not in the store's organization: go back to the prerequisites
4. On the authorization screen in your Shopify admin, click Install

After the install, Shopify may redirect you to the app's App URL, or to a Shopify example page if you kept https://example.com. That is expected: close the tab and go on to step 5.

Step 5: 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 6: 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 5
• Client Secret: the value copied in step 5

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 card, 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 5, or have the App development permission granted to you. If you are an agency, you have two options: get added as a staff member of the store (see Are you an agency? under Prerequisites), or follow the Connect a client's Shopify store (agencies) guide.

I cannot install the pixel in customer events

Installing the pixel (Settings > Customer events) needs more rights than creating the app. Collaborator or developer access is not enough: you need to be the owner, an admin, or staff with the customer events permission and Manage and install apps and channels. Ask for that access level from the start to run the whole setup in one go.

"[TFA] Unauthorized Access"

The store requires two-factor authentication on the account used. Turn it on for your Shopify account, or use an account that already has it, then run the current step again.

The connection fails

• "Shopify refused to grant access to this store": the app is not installed on the store. Install it first (step 4), then click Connect again. Also check that the domain you entered is the one of the store where the app is installed. If the app was created in an agency's organization, Shopify refuses that direct connection on a paid store: follow the Connect a client's Shopify store (agencies) guide, which goes through Authorize via Shopify.
• "Shopify rejected this Client ID and secret": copy the Client ID and the Client secret again, in full, from the app's Settings page (step 5): a single copy mistake in either one is enough. If you rotated the secret, paste the new one.
• "No Shopify store answers at this address": check the your-store.myshopify.com domain, found in your Shopify admin URL or under Settings > Domains. Your custom domain (for example mystore.com) does not work here.
• "Shopify could not be reached to check these credentials": Shopify is temporarily unavailable. Nothing was saved: try again in a few minutes.
• The connection is accepted but no order arrives: check that the version holding read_orders and read_all_orders was released (step 3). If it persists, contact support.

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.