Commerce Services Connector
Certaines fonctionnalités d’Adobe Commerce et de Magento Open Source sont optimisées par Commerce Services et déployées en tant que SaaS (logiciel en tant que service). Pour utiliser ces services, vous devez connecter votre instance Commerce à l’aide des clés API de production et sandbox, puis spécifier l’espace de données dans la configuration. Il vous suffit de configurer la connexion une seule fois pour chaque instance.
Services disponibles
Vous trouverez ci-dessous la liste des fonctionnalités Commerce auxquelles vous pouvez accéder via l’Commerce Services Connector :
| Service | Disponibilité |
|---|---|
| Product Recommendations optimisé par Adobe Sensei | Adobe Commerce |
| Live Search optimisé par Adobe Sensei | Adobe Commerce |
| Payment Services | Adobe Commerce et Magento Open Source |
| Site-Wide Analysis Tool | Adobe Commerce |
| Catalog Service | Adobe Commerce |
| Data Connection | Adobe Commerce |
Architecture
À un niveau élevé, le Commerce Services Connector est constitué des éléments principaux suivants :
Les sections suivantes examinent plus en détail chacun de ces éléments.
Informations d’identification
Les clés API de production et sandbox sont générées à partir du compte Commerce du propriétaire de la licence. Le compte Commerce est identifié par un ID de Commerce unique (MageID). Le propriétaire de la licence de l’organisation du commerçant peut générer des clés d’API pour des services tels que les recommandations de produits ou la recherche en direct, à condition que le compte soit en règle.
Les clés peuvent être partagées selon le « besoin d’en connaître » avec l’intégrateur de systèmes ou l’équipe de développement qui gère les projets et les environnements au nom du titulaire de la licence. Les développeurs qui ont reçu une Shared Access du propriétaire de la licence ne peuvent pas générer les clés en leur nom, même si l’organisation du commerçant figure dans la liste déroulante Switch Accounts de leur compte .
En outre, les intégrateurs de solutions sont également autorisés à utiliser Commerce Services. Si vous êtes un intégrateur de solutions, le signataire du contrat du partenaire Commerce doit générer les clés API.
NOTEGénérer les clés API de production et Sandbox
-
Connectez-vous à votre compte Commerce sur https://account.magento.com.
-
Sous l’onglet Magento, sélectionnez Portail API dans la barre latérale.
-
Dans le menu Environnement, sélectionnez Production ou Sandbox.
NOTELes Production et Sandbox se rapportent aux environnements d’espace de données où les données sont stockées dans les systèmes principaux SaaS d’Adobe. Il ne fait pas référence aux environnements de commerce dans lesquels vous utiliserez les clés. -
Saisissez un nom dans la section Clés API, puis cliquez sur Ajouter pour ouvrir la boîte de dialogue afin de télécharger la nouvelle clé.
WARNINGCette boîte de dialogue vous offre la seule possibilité de copier ou de télécharger vos clés. -
Cliquez sur Télécharger puis sur Annuler.
-
Répétez les étapes ci-dessus pour chaque environnement (production et sandbox).
La section Clés API affiche désormais vos clés API (publiques). Vous avez besoin des quatre clés (clé de production et clé sandbox, publique + privée) lorsque vous sélectionnez ou créez un projet SaaS dans l’un des environnements ou installations associés à la licence.
Configuration SaaS
Commerce instances doivent être configurées avec un projet SaaS et un espace de données SaaS afin que Commerce Services puissiez envoyer des données au bon emplacement. Un projet SaaS regroupe tous les espaces de données SaaS. Les espaces de données SaaS sont utilisés pour collecter et stocker des données qui Commerce Services permettent de travailler. Certaines de ces données peuvent être exportées à partir de l’instance Commerce et d’autres peuvent être collectées à partir du comportement de l’acheteur sur le storefront. Ces données sont ensuite conservées dans un espace de stockage cloud sécurisé.
Par Product Recommendations, l’espace de données SaaS contient des données de catalogue et des données comportementales. Vous pouvez pointer une instance Commerce vers un espace de données SaaS en la sélectionnant dans la configuration Commerce.
WARNINGSi cela se produit, envoyez une demande d’assistance pour demander le nettoyage des données.
Approvisionnement de l’espace de données SaaS
Tous les commerçants Adobe Commerce peuvent accéder à un espace de données de production et à deux espaces de données de test par projet SaaS.
Vous pouvez utiliser les espaces de données de test dans n’importe quel environnement hors production tant que vous n’utilisez pas le même espace de données dans plusieurs environnements en même temps. Pour utiliser l’espace de données de test dans un autre environnement, effectuez un nettoyage des données avant de sélectionner et de configurer l’espace de données dans cet environnement.
Pour les projets Adobe Commerce Cloud Pro avec plusieurs environnements d’évaluation, vous pouvez demander des espaces de données de test supplémentaires pour chaque environnement d’évaluation en soumettant une demande d’assistance. Cependant, si vous ne disposez que d’un environnement d’évaluation et que vous avez besoin d’espaces de données de test supplémentaires, vous disposez des options suivantes :
- Contactez l’équipe du succès client ou votre responsable du succès client désigné pour demander un environnement d’évaluation supplémentaire.
- Envoyez une demande d’assistance pour demander l’espace de données de test supplémentaire et indiquer la justification commerciale de l’espace de données supplémentaire. Cette demande est sujette à approbation.
Les clients Magento Open Source qui utilisent les services de paiement Adobe peuvent également demander un espace de données supplémentaire. Contactez l’équipe des paiements pour obtenir une approbation préalable des espaces de données supplémentaires avant d’envoyer une demande d’assistance pour demander l’espace de données de test.
Les clients qui possèdent plusieurs projets cloud ou installations sur site (en ligne/de production) peuvent également demander des espaces de données de production et de test supplémentaires pour chaque projet ou instance en soumettant une demande d’assistance.
Sélectionner ou créer un projet SaaS
Pour sélectionner ou créer un projet SaaS, demandez la clé API Commerce au propriétaire de la licence Commerce de votre boutique :
NOTE-
Dans la barre latérale Admin, accédez à Système > Services > Commerce Services Connector.
Si la section Commerce Services Connector n’apparaît pas dans la configuration Commerce, installez les modules Commerce correspondant au Commerce service souhaité. Assurez-vous également que le package
magento/module-services-idest installé. -
Dans les sections Sandbox API Keys et Production API Keys, collez vos valeurs clés.
- Les clés privées doivent inclure des
----BEGIN PRIVATE KEY---au début de la clé et des----END PRIVATE KEY----à la fin de la clé. - Si vous ne disposez pas d’une copie des clés réelles, demandez-les au propriétaire du compte, puis connectez les valeurs à la configuration.
WARNINGSi vous ajoutez des valeurs de clé en interrogeant une sauvegarde ou un instantané de base de données et en collant les valeurs dans la configuration, une couche de chiffrement supplémentaire est appliquée et les clés ne fonctionnent pas. - Les clés privées doivent inclure des
-
Cliquez sur Enregistrer.
Tous les projets SaaS associés à vos clés apparaissent dans le champ Projet de la section Identifiant SaaS.
- S'il n'existe aucun projet SaaS, cliquez sur Créer un projet. Ensuite, dans le champ Projet, entrez un nom pour votre projet SaaS.
NOTE- Sélectionnez l’Espace de données à utiliser pour la configuration actuelle de votre magasin de Commerce.
NOTEWARNINGPour modifier les noms de votre projet SaaS ou de votre espace de données, cliquez sur Renommer en regard de l’un des deux. La modification du nom n’affecte pas votre service, car le nom n’est qu’un libellé pour vous aider à identifier et à différencier les projets des espaces de données.
Organisation IMS (facultatif)
Pour connecter votre instance Adobe Commerce au Adobe Experience Platform, connectez-vous à votre compte Adobe à l’aide de votre Adobe ID. Une fois que vous êtes connecté, l’organisation IMS associée à votre compte Adobe s’affiche dans cette section.
Export de données SaaS
Lorsque votre instance Commerce se connecte à Commerce Services, le processus d’exportation de données SaaS exporte les données Commerce de votre serveur Commerce vers Commerce SaaS Services afin qu’elles puissent être synchronisées avec les services Commerce connectés. Dans Admin, vous pouvez vérifier l’état de synchronisation à l’aide du tableau de bord Data Management. Pour plus d'informations, consultez le Guide d'exportation de données SaaS.
