Connecter une boutique Shopify

Installer l'application, allumer la recherche sur la boutique, et les blocs de similaires et de recommandés, dans le bon ordre.

Sur une boutique Shopify, il n'y a pas de code à coller ni de fichiers à modifier : on installe l'application Buskara, on approuve l'accès en lecture, et on allume un interrupteur dans l'éditeur du thème. À partir de là, le catalogue se synchronise tout seul, changements de produits et de stock compris, quelques secondes après leur enregistrement dans la boutique. Ce que l'application de recherche pour Shopify change sur la boutique, ce qui reste en place et ce que cela coûte est raconté sur le blog ; ce guide n'est que le chemin, dans le bon ordre.

1. Installer l'application

Le chemin habituel commence sur Shopify :

1. Dans la Shopify App Store, ouvrez la page Buskara et cliquez sur Installer. Shopify affiche l'écran de consentement avec les accès demandés, tous en lecture : produits, inventaire, publications, langues, marchés et commandes. Cliquez sur Installer.
2. L'application s'ouvre dans l'administration de la boutique. Le compte Buskara est créé à ce moment avec l'email de la boutique, et la première synchronisation du catalogue démarre toute seule.
3. Cliquez sur Choisir un forfait. Shopify affiche les forfaits et les jours d'essai, et le forfait choisi est facturé par Shopify, sur la même facture que la boutique ; le changement de forfait, l'annulation et l'essai se gèrent depuis là, sous Applications → Buskara.

Quiconque possède déjà un compte Buskara avec l'email de la boutique retrouve la boutique dans ce compte. Quiconque commence par Buskara, sur /ativar, choisit Shopify et est conduit à la page Buskara sur la Shopify App Store : l'installation commence toujours sur Shopify, jamais par une adresse saisie dans Buskara, et le consentement est le même.

Et c'est tout : la boutique apparaît dans le panneau, sous Compte → Boutiques, et le bouton Ouvrir le panneau Buskara dans l'administration de la boutique y entre sans mot de passe. Le premier passage du catalogue prend généralement moins d'une minute, un grand catalogue en prend quelques-unes.

Buskara ne demande aucune autorisation d'écriture sur la boutique, et l'accès aux commandes sert uniquement à attribuer les ventes à la recherche, pour le compte du marchand.

2. Afficher la recherche sur la boutique

La recherche n'apparaît aux visiteurs que lorsque le marchand l'allume, et l'interrupteur vit dans l'éditeur du thème :

1. Dans l'administration de la boutique, ouvrez Boutique en ligne → Personnaliser.
2. Dans la barre d'icônes du panneau gauche, ouvrez les intégrations d'applications (l'icône des carrés, à côté des paramètres du thème).
3. Allumez l'interrupteur Buskara et cliquez sur Enregistrer.

Ne changez pas le champ « Adresse du service » dans l'intégration : le support Buskara le dira si c'est un jour nécessaire.

Dès lors, la barre et la loupe de recherche du thème ouvrent le panneau Buskara, avec le curseur prêt à écrire. Éteindre l'interrupteur rend la recherche native du thème, immédiatement.

3. Le bouton « produits similaires » sur les fiches

Un bouton discret sur la fiche produit qui ouvre le panneau des similaires, avec filtres et comparaison. Il se place où le marchand le veut :

1. Dans l'éditeur du thème, ouvrez un modèle de produit (sélecteur de pages en haut → Produits → le modèle utilisé).
2. Dans la section des détails du produit, cliquez sur Ajouter un bloc et choisissez « Buskara : bouton produits similaires ».
3. Glissez le bloc à sa place (sous le bouton d'achat est l'endroit habituel) et Enregistrer.

4. Le bloc « vous pourriez aussi aimer »

Le carrousel de recommandations, nourri par ce qui se voit et s'achète dans la boutique :

1. Dans le même éditeur, sur n'importe quel modèle (fiches produit comprises), Ajouter une section ou un bloc et choisissez « Buskara : bloc vous pourriez aussi aimer ».
2. Sur une fiche produit, les suggestions partent de ce produit ; sur toute autre page, le carrousel montre les recommandés généraux de la boutique.
3. Glissez à sa place et Enregistrer.

Les deux blocs ne se dessinent que lorsqu'il y a des résultats à montrer : un bloc qui n'a rien à dire ne prend pas de place.

Les deux ont leur propre guide, avec la suite de l'histoire : le bouton de similaires et le bandeau « vous pourriez aussi aimer » raconte ce que montre chacun, ce qui se règle dans le panneau et quoi faire quand ils n'apparaissent pas.

5. Le quotidien

Après la première synchronisation, le catalogue reste à jour tout seul :

• En temps réel : créer, modifier ou supprimer un produit, ou toucher au stock, atteint l'index quelques secondes plus tard, depuis Shopify même.
• Filet périodique : à intervalles réguliers, Buskara vérifie ce qui a changé depuis le dernier passage, pour que rien ne reste derrière.
• Manuel : le bouton Tout réindexer sur la fiche de la boutique, dans le panneau. Les synchronisations automatiques ne coûtent rien ; forcer une réindexation complète coûte 1 bToken par 1 000 documents, et l'avis avec le montant s'affiche avant de confirmer.

L'index suit la langue et la devise principales de la boutique, plus les langues publiées : une boutique en deux langues obtient la recherche dans les deux, avec les traductions de produits qui existent dans Shopify et l'original là où elles n'existent pas.

6. Connexion par jeton, pour les cas particuliers

Les boutiques headless ou les montages inhabituels peuvent se connecter sans l'application, avec un jeton d'accès créé à la main : dans l'administration de la boutique, sous Paramètres → Applications et canaux de vente → Développer des applications, on crée une application avec les autorisations de lecture (produits, inventaire, publications, langues, marchés), on l'installe, et on colle le jeton shpat_ sur l'écran d'activation de Buskara, via le raccourci « Montage particulier : connecter avec un jeton d'accès ». Tout le reste se comporte pareil.

7. Si quelque chose cloche

• La recherche n'apparaît pas sur la boutique : vérifiez l'interrupteur des intégrations d'applications (étape 2) et l'enregistrement.
• Des produits manquent : les brouillons, les produits archivés et ceux non publiés sur le canal de la boutique en ligne restent hors de l'index à dessein, parce qu'ils n'ont pas de page vers laquelle pointer. Le guide des produits qui n'apparaissent pas parcourt les autres causes.
• La synchronisation s'est arrêtée : le signe habituel d'une application désinstallée ou d'un accès révoqué. Réinstallez par l'étape 1 ; la boutique se reconnecte au même compte et rien n'est perdu.
• La limite de boutiques du plan est atteinte : le message indique le plan et la limite ; reconnecter une boutique qui existe déjà n'est jamais bloqué.