Recherche

Votre transition de l'ancien plugin Shopware 6 vers le nouveau

Avec la nouvelle version de notre plugin Shopware 6, on te propose des performances encore meilleures et des fonctionnalités améliorées. Le processus de migration est partiellement automatisé via une fenêtre modale et ne prend que quelques minutes.
Dans ce guide, on va t'expliquer, étape par étape, comment passer de ton intégration actuelle au nouveau plugin.

Remarque importante : 
L'ancienne connexion sera automatiquement coupée dès que tu cliqueras dans la fenêtre modale de migration option de transfert automatique vers Appliquer les paramètres . Si tu choisis la configuration manuelle Configurer manuellement , la désactivation automatique n'aura pas lieu.

Limitations de la version actuelle

  • Modification des données de synchronisation : Tu souhaites ajuster plus tard certains paramètres, comme les données des destinataires ou le mappage des champs de données ? Déconnecte-toi de ton compte CleverReach via la page des paramètres du plugin et recommence la procédure de configuration.

    Création de segments : La création automatique de segments n'est pas prise en charge pour le moment

    Importation de la liste noire : L'option permettant d'exclure certains clients du transfert n'est pas encore implémentée non plus.

    Mode hors ligne : La détection automatique de la suppression du groupe lié dans CleverReach n’a pas encore été intégrée. Par conséquent, évite de supprimer manuellement la liste de destinataires liée dans CleverReach.

Les exigences et demandes supplémentaires figurent déjà sur notre liste interne. Si tu souhaites des fonctionnalités spécifiques ou nouvelles, n’hésite pas à utiliser le questionnaire de feedback directement dans le plugin.

Les principales différences en un coup d’œil

Section Nouveautés de l'interface mise à jour
Performances et architecture Entièrement repensée pour de meilleures performances et une synchronisation plus stable
Historique des commandes Données des 12 derniers mois (par défaut), ajustables jusqu’à 24 mois
Formulaires Utilisation du nouveau module de formulaires CleverReach. Les anciens formulaires ne sont plus pris en charge.
Langues Interface du plugin disponible en allemand, anglais et néerlandais
Autorisations et modèle de rôles Attribution fine des autorisations via la gestion des autorisations de Shopware (voir la section ci-dessous)
.htaccess Le plugin détecte automatiquement si une protection par mot de passe est en place et affiche les étapes suivantes à suivre

Conditions préalables et préparatifs

Pour que la migration et la synchronisation qui suivra se passent bien, assure-toi au préalable que les points suivants sont bien pris en compte :

Version de Shopware : La nouvelle intégration Shopware 6 est disponible à partir de la version 6.6 (les versions 6.6 et 6.7 sont prises en charge)

Version PHP : Ton serveur nécessite PHP 8.2 ou une version supérieure.

Connexion existante : L'ancien plugin CleverReach est installé, actif et correctement connecté à ton compte CleverReach.

Protection par mot de passe (.htaccess / authentification de base) :

Si ta boutique (par exemple, un environnement de test ou de préproduction) est protégée par un mot de passe, les points de terminaison de l’API doivent être autorisés par CleverReach. Pour ça, ajoute les deux routes API dans le fichier .htaccess d’authentification (liste blanche) :

/api/crsw-on-prem-CleverReach/webhook/receiver
/api/crsw-on-prem-CleverReach/webhook/abandonedCart

(Sans cette mise sur liste blanche, l’importation échouera et la synchronisation se bloquera).

Étape 1 : Installe le nouveau plugin

  1. Connecte-toi à ton compte Shopware et rends-toi dans Extensions > Boutique.

    Recherche le nouveau plugin CleverReach et clique sur Installer l’extension.

Étape 2 : Ouvre la fenêtre modale de migration et lance le transfert de données

  1. Clique sur l'élément de menu Mes extensions. Ici, l'ancien et le nouveau plug-in CleverReach sont désormais tous les deux répertoriés. Active le nouveau plug-in à l'aide du curseur. 

    Dans le menu, clique sur Marketing et sélectionne le nouveau plugin CleverReach .

    Dès que tu ouvres le nouveau plugin pour la première fois, le système détecte automatiquement la connexion existante. Une fenêtre (modale) s'affiche avec deux options :

    Importation automatique (recommandée) : Le plugin importe directement la liste des destinataires déjà associée depuis l’ ancien plugin.

    Remarque technique importante : De plus, lors de cette étape, la connexion entre l’ ancien plugin et CleverReach est automatiquement coupée, et le plugin est automatiquement désactivé dans les extensions Shopware. Il s’agit d’un mécanisme de sécurité conçu pour :

    • Empêcher les synchronisations en double.

      Préserver les performances de ta boutique.

      À l’étape suivante, tu pourras connecter notre nouvelle appli à ton compte CleverReach .

    Connexion manuelle : Choisis cette option si tu veux te connecter à un autre compte CleverReach . Remarque : l’ancienne application ne sera pas désactivée. Sache que cela peut entraîner des incohérences dans les données.

    À l’étape suivante, sélectionne les listes de destinataires que tu veux importer, puis clique sur Suivant.

Étape 3 : Configurer les paramètres d’importation

À cette étape, tu as le choix entre de nombreux paramètres d'import. 

  • Quels groupes de clients importer (abonnés à la newsletter, clients ayant effectué un achat, autres contacts)

    Faut-il transférer l’historique des commandes (par défaut : les 12 derniers mois, réglable jusqu’à 24 mois)

    Faut-il importer des balises 

    Faut-il mapper les champs de données ? 

Enfin, clique sur Lancer l'importation.

Remarque : L’ importation s’effectue en arrière-plan. Tu peux changer d’onglet ou continuer à travailler dans d’autres menus. Garde l’onglet du navigateur ouvert jusqu’à ce que le processus soit terminé.

Étape 4 : Fin de l'opération et vérification du bon fonctionnement

Une fois la migration terminée, tu recevras une confirmation dans la fenêtre modale. Ton nouveau tableau de bord est prêt, et tu peux à nouveau profiter pleinement de ton intégration avec CleverReach. 

Remarque : L’ ancien plugin a été automatiquement désactivé. Tu peux désormais désinstaller et supprimer en toute sécurité l’ancienne version du plugin depuis ton backend Shopware.

Qu'est-ce qui reste identique, qu'est-ce qui change ?

Utilisation des balises
Le format des balises correspond exactement à l’interface précédente. Tes segments et automatisations existants continueront donc de fonctionner sans problème et ne nécessiteront aucun ajustement.

Utilisation des formulaires
La nouvelle intégration utilise notre module de formulaires actuel. Les anciens formulaires ne sont plus pris en charge. Crée le formulaire souhaité directement dans CleverReach pour pouvoir ensuite l'intégrer via l'interface.

Création de segments
La création de nouveaux segments directement via l’intégration n’est pas prévue pour l’instant. Tu peux toutefois continuer à utiliser tes segments existants sans aucune restriction : Comme le format des balises reste inchangé, toutes les segmentations et tous les filtrages par champs de données fonctionneront comme d’habitude.

Utilisation des automatisations
Tu as déjà configuré des automatisations basées sur des balises ? Celles-ci continueront de s’exécuter sans aucune intervention manuelle. On te recommande simplement de vérifier rapidement que tous les déclencheurs fonctionnent comme prévu.

Modèle d’autorisations et de rôles

Grâce à la gestion des autorisations de Shopware, tu peux attribuer différents rôles pour l’accès au plugin CleverReach :

Rôle Peut Ne peut pas
Admin Accès complet à toutes les fonctionnalités -
Lecteur Consulter le tableau de bord et les données (rapports, journaux, statut) ; accéder au module via le menu Modifier les paramètres ; déclencher des actions (resynchronisation, importation) ; connecter/déconnecter le compte ; supprimer la configuration
Éditeur Modifier la configuration (DOI, panier abandonné, formulaires), déclencher une resynchronisation ou un rafraîchissement du tableau de bord Déconnecter le compte, supprimer la configuration, supprimer l’intégration
Supprimer Afficher le module, déconnecter l’intégration Modifier la configuration, déclencher la synchronisation/des actions, connecter le compte
  • Problème/Sujet Cause/Solution
    L'importation CleverReach se bloque lorsque la protection par mot de passe (.htaccess) est activée

    Cause : Dans les environnements protégés par mot de passe (authentification de base / environnement de test), l’import se bloque dans une boucle infinie (Spinner infini), car les processus en arrière-plan sont bloqués (401 ).

    Solution : Désactive temporairement la protection par mot de passe pour l’importation, ou active les routes API suivantes dans la configuration de ton serveur :

    • /api/crsw-on-prem-CleverReach/webhook/receiver

        /api/crsw-on-prem-CleverReach/webhook/abandonedCart

    La synchronisation ne démarre pas

    Vérifie : 

    1. Est-ce que les workers de la file d'attente de messages ou les workers d'administration tournent ?

    2. Est-ce que l'authentification CleverReach est valide ?

    3. Les fichiers journaux du plugin contiennent-ils des erreurs ?
    La synchronisation s'interrompt avant d'être terminée

    Vérifie :

    1. La file d’attente des messages.

    2. Les fichiers journaux du plugin.

    3. La validité de la connexion OAuth.
    Problèmes avec les synchronisations volumineuses (50 000 entrées ou plus)

    Cause : La valeur par défaut du délai d’expiration de la requête est de 3 600 secondes (1 heure). Si le processus prend plus de temps, un worker va récupérer le message à nouveau.

    Solution : Définis le délai d’expiration pour le transport DSN redeliver_timeout sur une valeur plus élevée (recommandé : 8 heures) :

    • MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0&redeliver_timeout=28800
    Les e-mails concernant les paniers abandonnés ne sont pas envoyés. 

    Vérifie ce qui suit :

    1. L’automatisation CleverReach pour les « Paniers abandonnés » est-elle activée ?

    2. Les workers pour les tâches planifiées (Tâches planifiées) fonctionnent-ils ?

    3. Les journaux indiquent-ils des erreurs de webhook ou d’automatisation ?
    Les e-mails concernant les paniers abandonnés sont envoyés avec un léger retard Explication : Le plugin effectue une vérification programmée toutes les 15 minutes (Exécution programmée) pour détecter les nouveaux paniers abandonnés. En fonction de l’intervalle de temps, l’envoi peut donc être légèrement retardé.
    Le groupe associé ne doit pas être supprimé dans CleverReach

    Explication : Le « mode hors ligne » permettant de détecter automatiquement les groupes supprimés n’est pas encore intégré.

    Solution : Ne supprime pas manuellement la liste de destinataires liée dans CleverReach.
    Les anciens formulaires ne fonctionnent plus après le changement de plugin Solution : Lors du passage au nouveau plugin, les formulaires précédemment intégrés dans les Shopware Experience Worlds doivent être remplacés manuellement par les nouveaux formulaires.
    Synchronisation bidirectionnelle entre les formulaires Flow de CleverReach et Shopware Solution : Pour garantir la synchronisation dans les deux sens, le Flow Form dans CleverReach doit être configuré avec la même liste de destinataires que le plugin.
  • Question Réponse
    Est-ce que je peux simplement passer de l'ancienne interface à la nouvelle sans perdre de données ? Oui. La migration est en partie automatisée via une fenêtre modale et ne prend que quelques minutes. Ta liste de destinataires existante sera automatiquement transférée. Pendant ce processus, l'ancien plugin CleverReach est également désactivé automatiquement. Après avoir sélectionné la liste de destinataires, tu peux configurer individuellement des données supplémentaires pour l'importation.
    Dois-je d'abord désinstaller l'ancien plugin ? Non. Laisse l'ancien plugin actif pour l'instant. Dès que la première étape (fenêtre modale de migration) du nouveau plugin sera terminée avec succès , l’ancienne connexion sera automatiquement interrompue et l’ancien plugin désactivé. Une fois que tu auras terminé l’ importation dans la nouvelle interface, tu pourras désinstaller l’ancien plugin.
    Quelle version de Shopware me faut-il pour le nouveau plugin ? Le plugin prend en charge Shopware 6.6 et 6.7 ainsi que PHP 8.2 ou une version supérieure.
    Quelles données sont transférées lors de la migration ? Grâce à la fenêtre modale de migration du nouveau plugin, tu peux choisir si on doit charger les données automatiquement ou de les configurer manuellement. Si tu choisis « Automatique », on va lire la liste de destinataires CleverReach déjà connectée et l’importer dans le nouveau plugin. Tu pourras toujours modifier ce paramètre plus tard. De plus, lors des étapes de configuration suivantes, tu pourras sélectionner individuellement d’autres nouvelles options d’importation (données de commande, balises, champs de données).
    Dois-je réintégrer mes formulaires d’inscription à la newsletter ? Oui. La nouvelle interface utilise notre nouveau module de formulaires. Les anciens formulaires présents dans tes univers d’expérience ne fonctionneront plus avec la nouvelle interface et doivent être remplacés par de nouveaux formulaires.
    Que se passe-t-il avec la confirmation par double opt-in quand j’utilise CleverReach ? Si tu actives la fonctionnalité de double opt-in de CleverReach, CleverReach envoie l’e-mail de confirmation, et l’e-mail e-mail de double opt-in de Shopware est supprimé. L’ensemble du processus de confirmation se déroule alors via ton formulaire CleverReach.
    Mes segments et automatisations existants continueront-ils à fonctionner ? Oui. Le format des balises reste identique à celui de l’ancienne interface, donc les segments existants et les automatisations basées sur des balises continueront à fonctionner sans intervention manuelle. Il est recommandé de faire un rapide bilan des fonctionnalités après la migration.
    Plusieurs employés disposant de droits d’accès différents peuvent-ils accéder à l’intégration ? Oui. Grâce à la gestion des autorisations de Shopware, tu peux attribuer différents rôles : de l’accès en lecture seule (consultation du tableau de bord/des journaux uniquement) aux autorisations de modification (modification des paramètres, déclenchement de la synchronisation/de l’importation) jusqu’à l’accès administrateur complet.
    L'e-mail de panier abandonné n'arrive pas exactement à l'heure définie. Est-ce normal ? Oui, le plugin vérifie s’il y a de nouveaux paniers abandonnés toutes les 15 minutes ; l’envoi peut donc être retardé jusqu’à ce délai.
    Ma boutique est protégée par un mot de passe (par ex. environnement de test) — l’importation est bloquée. Que dois-je faire ? Dans les environnements protégés par mot de passe (authentification de base), la protection par mot de passe bloque les processus d’arrière-plan de l’importation (erreur 401), ce qui fait que celle-ci se charge indéfiniment. Autorise les deux routes API suivantes dans ta configuration .htaccess (liste blanche), ou désactive temporairement la protection par mot de passe pour l’importation :
    /api/crsw-on-prem-CleverReach/webhook/receiver
    /api/crsw-on-prem-CleverReach/webhook/abandonedCart

Aide et assistance

Si tu as des questions ou besoin d’aide, n’hésite pas à contacter notre équipe d’assistance à tout moment.