Objectif

Ce guide s'adresse aux agences qui veulent connecter la boutique Shopify d'un client à partir d'une application créée dans l'organisation Shopify de l'agence. Votre client n'a pas à créer l'application : il lui suffit de cliquer sur un lien d'installation. À la fin, les commandes, produits et clients de sa boutique se synchronisent automatiquement dans son compte Metrikia.

Votre client préfère créer l'application lui-même dans sa propre organisation, ou vous ajoute comme membre du staff de sa boutique ? Suivez plutôt le guide Connecter Shopify à Metrikia.

Prérequis

Un compte Shopify pour votre agence, rattaché à une organisation Partner. Seule une organisation Partner propose la distribution personnalisée (étape 3) : une organisation créée uniquement depuis le Dev Dashboard ne l'affiche pas.
Le domaine technique de la boutique de votre client, qui se termine par .myshopify.com (par exemple votre-boutique.myshopify.com). Son domaine personnalisé ne fonctionne pas ici.
Le propriétaire de la boutique, ou un membre du staff autorisé à installer des applications, disponible pour cliquer sur le lien d'installation dans les 7 jours qui suivent sa création.
Un accès au compte Metrikia de votre client, avec le droit de gérer ses connexions.

Une application en distribution personnalisée ne sert qu'une seule boutique (ou les boutiques d'une même organisation Shopify Plus). Si vous accompagnez plusieurs clients, prévoyez une application par client.

Étape 1 : Créez l'organisation Partner de votre agence

Votre agence a déjà une organisation Partner ? Passez directement à l'étape 2. Les écrans Shopify de cette étape sont en anglais.

Créez un compte Shopify pour votre agence, de préférence avec une adresse email dédiée. Shopify crée au passage une boutique d'essai (My Store) : elle ne sert pas, ce n'est pas la boutique de votre client.
Ouvrez partners.shopify.com/signup et choisissez ce compte. Si Shopify propose de créer une clé d'accès (passkey), vous pouvez cliquer sur Not now.
À la question How would you like to get started as a partner?, choisissez Create and set up a new partner organization.
À la question What's your main focus as a Shopify partner?, choisissez Provide services for existing businesses, puis cliquez sur Next.
Sur l'écran Where's your business located?, choisissez votre pays, puis cliquez sur Next.
Remplissez Add your business contact information (nom de l'agence, adresse, email), cochez I have read and agree to the Partner Program Agreement, puis cliquez sur Create partner organization.

Le nom de l'organisation s'affiche chez votre client au moment de l'installation. Choisissez un nom qu'il reconnaîtra, en général celui de votre agence.

Étape 2 : Créez l'application dans le Dev Dashboard

Ouvrez dev.shopify.com/dashboard, vérifiez en haut à gauche que l'organisation de votre agence est sélectionnée, puis cliquez sur Create app.
App name : un nom que votre client reconnaîtra, par exemple Metrikia suivi du nom de votre agence. Version name (optional) est facultatif.
App URL : indiquez par exemple l'adresse du site de votre agence (https://...). Metrikia ne l'utilise pas, mais votre client y sera redirigé juste après l'installation. Si Shopify exige aussi une valeur dans Allowed redirection URL(s), reprenez la même adresse.
Décochez Embed app in Shopify admin : l'application n'affiche aucun écran dans l'admin de la boutique.
Laissez Use legacy install flow décoché : c'est Shopify qui gère l'installation.
Dans Scopes, collez la ligne complète : read_orders,read_products,read_customers
Laissez Webhooks API version sur sa valeur par défaut, cliquez sur Create app, puis sur Release dans la fenêtre Release version.

Tant que la version n'est pas publiée avec Release, l'application ne donne accès à rien. Une fois publiée, la page Overview de l'application affiche les cartes Installs, Credentials, Distribution et Versions. Avec la portée read_orders, Shopify ne donne accès qu'aux commandes des 60 derniers jours : l'historique importé à la connexion se limite à cette période.

Étape 3 : Choisissez la distribution personnalisée

Sur la page Overview de l'application, cliquez sur la carte Distribution (Select distribution method). La page Distribution s'ouvre dans le tableau de bord Partner.
Choisissez Custom distribution, puis cliquez sur Select.
Shopify demande confirmation (Select custom distribution?) et prévient que ce choix est définitif (This can't be undone). Confirmez avec Select custom distribution.
Dans Store domain, saisissez le domaine de la boutique de votre client : votre-boutique.myshopify.com
La case Allow multi-store install for one Plus organization est cochée par défaut. Gardez-la cochée seulement si votre client a plusieurs boutiques dans une même organisation Shopify Plus, sinon décochez-la.
Cliquez sur Generate link. Si la case multi-boutique est cochée, confirmez une seconde fois avec Generate link.
À côté de Install link, cliquez sur Copy to clipboard, puis envoyez ce lien au propriétaire de la boutique.

Le lien expire 7 jours après sa création : prévenez votre client pour qu'il l'installe dans la semaine. Une fois le lien généré, le domaine de la boutique et l'option multi-boutique sont verrouillés : vérifiez le domaine avant de cliquer sur Generate link.

Étape 4 : Votre client installe l'application

Votre client ouvre le lien en étant connecté à son propre compte Shopify, pas à celui de votre agence.
Si son compte gère plusieurs boutiques, il choisit la boutique concernée dans la liste.
L'écran Installer l'application affiche le nom de l'application, le nom de l'organisation de votre agence et les accès demandés (données des clients, des produits et des commandes, en lecture).
Il clique sur Installer.

Après l'installation, Shopify redirige votre client vers l'App URL de l'application. C'est normal : il peut fermer cet onglet, il n'a rien d'autre à faire.

Étape 5 : Copiez les identifiants de l'application

Dans le Dev Dashboard de votre agence, ouvrez l'application, page Overview.
Dans la carte Credentials, copiez le Client ID.
Copiez le Client secret juste en dessous, avec l'icône de copie.

Ces deux valeurs donnent accès à la boutique de votre client. Ne les envoyez pas par email ou par messagerie : saisissez-les directement dans Metrikia. Elles restent consultables dans le Dev Dashboard si vous devez y revenir.

Étape 6 : Connectez la boutique dans Metrikia

Dans le compte Metrikia de votre client, 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, le même domaine qu'à l'étape 3
- ID client : le Client ID copié à l'étape 5
- Secret : le Client secret copié à l'étape 5
Cliquez sur Connecter : la fiche passe à Connecté.

Résultat attendu

La connexion est acceptée et la synchronisation des commandes, produits et clients démarre automatiquement. Les premières données apparaissent sous quelques minutes. Metrikia renouvelle ensuite l'accès à la boutique automatiquement : vous n'avez rien à refaire tant que l'application reste installée. Le bouton Vérifier la connexion de la fiche permet de confirmer à tout moment que l'accès fonctionne toujours.

Pixel de tracking

Sur ce parcours, le pixel n'est pas posé automatiquement sur la boutique. Une fois la connexion établie, la fiche Shopify de Metrikia affiche le code à coller : il s'installe dans l'admin de la boutique, depuis Paramètres, puis Événements client. Suivez la section Pixel de tracking du guide Connecter Shopify à Metrikia.

L'installation du pixel demande un compte propriétaire, administrateur, ou staff avec les permissions sur les événements clients. Si vous n'avez pas ces droits sur la boutique de votre client, envoyez-lui le code et les étapes. Sans pixel, les commandes remontent, mais Metrikia ne peut pas rattacher un achat à la publicité qui l'a déclenché.

Problèmes fréquents

« Shopify refuse ce Client ID et ce secret »

Une seule erreur de copie suffit, y compris dans le Client ID. Copiez à nouveau les deux valeurs depuis la carte Credentials, en entier et sans espace avant ou après, et vérifiez que vous ne les avez pas inversées entre les champs ID client et Secret.

« Shopify refuse de délivrer un accès pour cette boutique »

L'application n'est pas encore installée sur la boutique. Demandez à votre client de terminer l'étape 4, puis cliquez à nouveau sur Connecter. Vérifiez aussi que le domaine saisi dans Metrikia est exactement celui de l'étape 3.

Le lien d'installation a expiré

Le lien est valable 7 jours. Passé ce délai, retournez sur la page Distribution de l'application dans le tableau de bord Partner et générez un nouveau lien. Le domaine de la boutique est déjà verrouillé, il reste le même. Envoyez le nouveau lien à votre client.

Votre client ne peut pas installer l'application

Le compte qui ouvre le lien doit être celui du propriétaire de la boutique, ou d'un membre du staff autorisé à installer des applications (permission Gérer et installer des applications et des canaux). Le lien ne fonctionne que pour la boutique saisie à l'étape 3 : ouvert sur une autre boutique, il est refusé.

Le domaine saisi à l'étape 3 est faux

Le domaine ne peut plus être modifié une fois le lien généré. Créez une nouvelle application (étape 2) et reprenez la distribution personnalisée avec le bon domaine.

Je veux connecter un autre client

Une application en distribution personnalisée ne sert qu'une boutique (ou une organisation Shopify Plus). Reprenez ce guide à l'étape 2 et créez une nouvelle application pour chaque client.

Étape suivante

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

Connecter la boutique Shopify d'un client (agences)