Objectif

À la fin de ce guide, votre boutique Shopify sera connectée à Metrikia : vos commandes, produits et clients se synchroniseront automatiquement pour être corrélés avec vos dépenses publicitaires et votre ROAS réel.

Prérequis

Un compte Metrikia actif
Créer l'application dans l'organisation Shopify qui possède la boutique, ou, pour une agence, dans sa propre organisation Partner, puis la faire installer par le client via un lien de distribution personnalisée (voir le guide Connecter la boutique Shopify d'un client (agences)). Ce guide suit la première option : en bas à gauche du Dev Dashboard, le nom de l'organisation est affiché, ce doit être celle de la boutique. Si vous gérez plusieurs organisations, changez d'organisation depuis ce menu avant de créer l'application.
Être propriétaire ou administrateur de la boutique Shopify, ou un membre du staff avec trois permissions : App development, Gérer et installer des applications et des canaux, et les événements clients. Un compte collaborateur ne peut pas faire cette configuration : le Dev Dashboard est une surface au niveau de l'organisation Shopify, à laquelle il n'a pas accès. Un simple accès développeur permet de créer l'application, mais pas d'installer ensuite le pixel de tracking.
Le domaine technique de votre boutique, qui se termine par .myshopify.com

Vérifiez l'organisation et vos permissions avant de commencer, sinon la connexion sera refusée. Si l'un de ces deux points n'est pas rempli, demandez au propriétaire de la boutique de créer l'application lui-même. Le bouton Installer l'appli de l'étape 4 ne propose que les boutiques de l'organisation de l'application : si l'application est créée dans l'organisation d'une agence, suivez le guide Connecter la boutique Shopify d'un client (agences).

Vous êtes une agence ?

Deux options s'offrent à vous pour connecter la boutique d'un client. Option A : l'application est créée dans l'organisation de la boutique, en suivant ce guide. La marche à suivre :

Le propriétaire de la boutique vous ajoute comme membre du staff de la boutique (pas comme compte collaborateur : un collaborateur n'a pas accès au Dev Dashboard)
Il vous attribue la permission App development, plus Gérer et installer des applications et des canaux si vous installez aussi le pixel
Dans le Dev Dashboard, sélectionnez l'organisation de la boutique en bas à gauche, puis créez l'application en suivant les étapes ci-dessous

Option B : votre agence crée l'application dans sa propre organisation Partner, puis votre client l'installe depuis un lien de distribution personnalisée, sans avoir à créer l'application lui-même. Suivez alors le guide Connecter la boutique Shopify d'un client (agences).

Depuis le 1er janvier 2026, un marchand ne peut plus créer d'application personnalisée depuis l'admin de sa boutique. Les nouvelles applications se créent dans le Dev Dashboard, qui n'affiche plus de jeton d'accès à copier : vous copiez un ID client et un Secret, et Metrikia génère le jeton pour vous. Si vous cherchez un jeton commençant par shpat_, il n'existe plus pour une application créée aujourd'hui.

Étape 1 : Ouvrez le Dev Dashboard

Dans l'admin Shopify, allez dans Paramètres, puis Applications
Cliquez sur Développer des applications en haut de la page
Cliquez sur Développer des applications dans le Dev Dashboard

Vous pouvez aussi ouvrir directement dev.shopify.com/dashboard. Sur cette page, l'encadré orange rappelle la date du 1er janvier 2026 : le bouton "Créer une application" qui subsiste à côté ne concerne que les partenaires Shopify sur une boutique qu'ils n'ont pas encore transférée à un marchand, pas votre cas.

Étape 2 : Créez l'application

Dans le Dev Dashboard, restez sur Applis et cliquez sur Créer une appli en haut à droite
Dans le formulaire de création, saisissez un nom (par exemple Metrikia). Le nom de version est facultatif
Champ App URL : Shopify préremplit https://example.com. Indiquez n'importe quelle adresse en https, par exemple celle de votre site : Metrikia ne l'utilise pas

Étape 3 : Déclarez les accès en lecture et publiez

Toujours dans ce formulaire, décochez Intégrer l'appli dans l'interface administrateur Shopify, cochée par défaut : cette application ne fournit aucun écran, la laisser cochée ajoute une page vide dans votre admin
Laissez vide URL de redirection autorisées : ce champ ne sert qu'au parcours des agences, pas à la connexion décrite ici
Dans Accès à l'API, tapez ou collez directement dans le champ Portées la ligne complète : read_orders,read_all_orders,read_products,read_customers,read_inventory. Ne passez pas par la liste de sélection : read_all_orders n'y figure pas toujours

Gardez bien read_all_orders. Avec read_orders seul, Shopify ne donne accès qu'aux commandes créées dans les 60 derniers jours : Metrikia importe 90 jours d'historique à la connexion, les 30 jours les plus anciens manqueraient.

Shopify refuse read_all_orders ? Cette portée doit parfois être demandée. Retirez-la de la ligne pour avancer : la connexion fonctionne, avec les commandes des 60 derniers jours seulement. Pour l'historique complet, demandez l'accès dans Shopify Partners (votre application, puis API access requests, Read all orders scope et Request access), puis ajoutez read_all_orders dans une nouvelle version publiée.

Cliquez sur Créer, puis confirmez avec Publier dans la fenêtre qui s'ouvre

Tant que la version n'est pas publiée, les identifiants de l'étape 5 ne donnent accès à rien. Le nom et le message de version sont facultatifs.

Étape 4 : Installez l'application sur votre boutique

Si la page Aperçu de l'application affiche Sélectionner la méthode de distribution, l'application a été créée dans une organisation partenaire ou d'agence, pas dans celle de la boutique : l'installation ci-dessous ne vous proposera pas la boutique. Deux solutions : changez d'organisation en bas à gauche du Dev Dashboard et recréez l'application dans celle de la boutique, ou, si vous êtes une agence, suivez le guide Connecter la boutique Shopify d'un client (agences), qui fait installer l'application par votre client via un lien de distribution personnalisée.

Dans le menu de gauche, cliquez sur le nom de l'application pour ouvrir la page Aperçu
Dans la carte Installations, cliquez sur Installer l'appli
Sélectionnez votre boutique. Si elle n'y figure pas, l'application n'est pas dans l'organisation de la boutique : reprenez la vérification des prérequis
Sur l'écran d'autorisation de votre admin Shopify, cliquez sur Installer

Après l'installation, Shopify peut vous rediriger vers l'App URL de l'application, ou vers une page d'exemple de Shopify si vous avez gardé https://example.com. C'est normal : fermez cet onglet et passez à l'étape 5.

Étape 5 : Copiez vos identifiants

Dans le menu de gauche de l'application, ouvrez Paramètres
Dans la carte Identifiants, copiez l'ID client
Copiez le Secret juste en dessous, avec l'icône de copie. Il sert aussi à authentifier les notifications que Shopify envoie à Metrikia.

Ces deux valeurs restent consultables dans le Dev Dashboard. Contrairement à l'ancien jeton, vous pouvez y revenir plus tard si vous les perdez.

Étape 6 : Connectez Shopify dans Metrikia

Dans Metrikia, ouvrez Réglages, puis Mes connexions
Dans la catégorie E-commerce, ouvrez la fiche Shopify
Cliquez sur Connecter via une app personnalisée sous le bouton principal
Renseignez les 3 champs :

Domaine de la boutique : votre-boutique.myshopify.com
ID client : la valeur copiée à l'étape 5
Secret : la valeur copiée à l'étape 5

Cliquez sur Connecter : la fiche passe à Connecté

Résultat attendu

La synchronisation de vos commandes, produits et clients démarre automatiquement. Les premières données apparaissent sous quelques minutes ; si votre boutique a un gros historique, la synchronisation complète peut prendre quelques heures. Le bouton Vérifier la connexion de la fiche permet de confirmer à tout moment que l'accès fonctionne toujours.

Pixel de tracking

Avec ce mode de connexion, le pixel n'est pas posé automatiquement sur votre boutique : l'application appartient à votre organisation, Metrikia ne peut donc pas y installer son extension de tracking. Vous devez le poser vous-même, en quelques minutes.

Sur la fiche Shopify de Metrikia, une fois la connexion établie, une carte affiche le code à coller ainsi qu'un bouton Copier
Dans l'admin Shopify, ouvrez Paramètres, puis Événements client (le lien direct est aussi rappelé sur la carte)
Cliquez sur Ajouter un pixel personnalisé, nommez-le Metrikia, puis collez le code copié à l'étape 1
Réglez la permission sur Non requis et l'option relative à la vente de données sur Non éligible
Cliquez sur Enregistrer, puis sur Connecter : un pixel enregistré mais non connecté ne fait rien
Ouvrez votre boutique dans un nouvel onglet pour déclencher le premier événement

La carte affiche l'état du pixel en direct : En attente du premier événement, puis Pixel actif une fois le premier événement reçu. Le même code reste disponible dans Réglages > Pixel, onglet Shopify (pixel personnalisé). Un seul pixel par boutique : n'installez pas aussi l'extrait de suivi du site sur un thème Shopify.

Sans pixel, les commandes remontent, mais Metrikia ne peut pas rattacher un achat à la publicité qui l'a déclenché. C'est l'étape qui donne son sens au ROAS réel : ne la sautez pas.

Problèmes fréquents

Je ne trouve pas le jeton d'accès Admin API

C'est normal : il n'existe plus pour une application créée dans le Dev Dashboard, et Metrikia n'en a plus besoin. Elle génère elle-même un jeton, valable 24 heures et renouvelé automatiquement, à partir de l'ID client et du Secret. Si vous voyez encore l'écran Développement d'applications dans l'admin de votre boutique, c'est qu'une application y a été créée avant le 1er janvier 2026 : elle continue de fonctionner, mais toute nouvelle application passe par le Dev Dashboard.

Je n'ai pas accès au Dev Dashboard

Un compte collaborateur, le cas courant d'une agence ou d'un développeur externe, n'y a pas accès : c'est une permission au niveau de l'organisation, pas de la boutique. Demandez au propriétaire de la boutique de faire les étapes 1 à 5, ou faites-vous attribuer la permission App development. Si vous êtes une agence, vous avez deux options : vous faire ajouter comme membre du staff de la boutique (voir Vous êtes une agence ? dans les prérequis), ou suivre le guide Connecter la boutique Shopify d'un client (agences).

Je ne peux pas installer le pixel dans les événements clients

L'installation du pixel (Paramètres > Événements client) demande plus de droits que la création de l'application. Un accès collaborateur ou développeur ne suffit pas : il faut être propriétaire, administrateur, ou staff avec la permission sur les événements clients et Gérer et installer des applications et des canaux. Demandez ce niveau d'accès dès le départ pour faire toute l'installation d'une traite.

« [TFA] Unauthorized Access »

La boutique exige la double authentification sur le compte utilisé. Activez-la sur votre compte Shopify, ou utilisez un compte qui l'a déjà activée, puis recommencez l'étape en cours.

La connexion échoue

« Shopify refuse de délivrer un accès pour cette boutique » : l'application n'est pas installée sur la boutique. Installez-la d'abord (étape 4), puis cliquez à nouveau sur Connecter. Vérifiez aussi que le domaine saisi est bien celui de la boutique sur laquelle l'application est installée. Si l'application a été créée dans l'organisation d'une agence, Shopify refuse cette connexion directe sur une boutique payante : suivez le guide Connecter la boutique Shopify d'un client (agences), qui passe par Autoriser via Shopify.
« Shopify refuse ce Client ID et ce secret » : copiez à nouveau l'ID client et le Secret depuis la page Paramètres de l'application (étape 5), en entier : une seule erreur de copie dans l'un ou l'autre suffit. Si vous avez renouvelé le secret, collez le nouveau.
« Aucune boutique Shopify ne répond à cette adresse » : vérifiez le domaine votre-boutique.myshopify.com, qui se trouve dans l'URL de votre admin Shopify ou dans Paramètres > Domaines. Votre domaine personnalisé (par exemple maboutique.fr) ne fonctionne pas ici.
« Shopify n'a pas pu être joint pour vérifier ces identifiants » : Shopify est momentanément indisponible. Rien n'a été enregistré : réessayez dans quelques minutes.
La connexion est acceptée mais aucune commande n'arrive : vérifiez que la version contenant read_orders et read_all_orders a bien été publiée (étape 3). Si le problème persiste, contactez le support.

Le domaine doit se terminer par .myshopify.com

Utilisez le domaine technique .myshopify.com de votre boutique, pas votre domaine personnalisé (par exemple maboutique.fr). Vous le trouvez dans l'URL de votre admin Shopify ou dans Paramètres > Domaines.

Étape suivante

Vos données Shopify sont maintenant dans Metrikia. Croisez-les avec vos campagnes dans ADS pour mesurer le vrai ROAS de votre boutique. Une question en cours de route ? Demandez à Diana depuis le menu d'aide.

Connecter Shopify à Metrikia