Connexion SAP Commerce

SAP Commerce, anciennement appelée Hybris, est une solution de plateforme d’e-commerce cloud destinée aux entreprises B2B et B2C et disponible dans le cadre du portefeuille d’expériences client SAP. SAP Facturation des abonnements est un produit du portefeuille qui permet une gestion complète du cycle de vie des abonnements avec des expériences de vente et de paiement simplifiées grâce à des intégrations normalisées.

Cette Adobe Experience Platform destination utilise l’SAP Subscription Billing API de gestion des clients pour mettre à jour les détails de vos clients dans SAP Commerce à partir d’une audience Experience Platform existante après activation.

Les instructions vous permettant de vous authentifier sur votre instance SAP Commerce sont plus loin dans la section Authentifier à la destination.

Cas d’utilisation use-cases

Pour mieux comprendre quand et comment utiliser la destination SAP Commerce, consultez l’exemple de cas d’utilisation ci-dessous que les clientes et clients d’Adobe Experience Platform peuvent résoudre à l’aide de cette destination.

SAP Commerce clients stockent des informations sur les personnes ou les entités organisationnelles qui interagissent avec votre entreprise. Votre équipe utilise les clients existants dans SAP Commerce pour créer les audiences Experience Platform. Après avoir envoyé ces audiences à SAP Commerce, leurs informations sont mises à jour et chaque client se voit attribuer une propriété avec sa valeur comme nom d’audience indiquant à quelle audience appartient le client.

Conditions préalables prerequisites

Reportez-vous aux sections ci-dessous pour connaître les conditions préalables à configurer dans Experience Platform et SAP Commerce et pour obtenir des informations que vous devez collecter avant d’utiliser la destination SAP Commerce.

Conditions préalables d’Experience Platform prerequisites-in-experience-platform

Avant d’activer des données dans la destination SAP Commerce, vous devez avoir créé un schéma, un jeu de données et des audiences dans Experience Platform.

Reportez-vous à la documentation Experience Platform pour le groupe de champs de schéma Détails sur l’appartenance à une audience si vous avez besoin de conseils sur les statuts de l’audience.

Conditions préalables pour la destination SAP Commerce prerequisites-destination

Notez les conditions préalables suivantes pour exporter des données d’Experience Platform vers votre compte SAP Commerce :

Vous devez disposer d'un compte SAP Subscription Billing prerequisites-account

Pour exporter des données d’Experience Platform vers votre compte SAP Commerce, vous devez disposer d’un compte SAP Subscription Billing. Si vous ne disposez pas d’un compte de facturation valide, contactez votre gestionnaire de compte SAP. Reportez-vous au document SAP Configuration de Platform pour plus d’informations.

Générer une clé de service prerequisites-service-key

{
    "url": "https://eu10.revenue.cloud.sap/api",
    "uaa": {
        "clientid": "XXX",
        "clientsecret": "XXX",
        "url": "https://subscriptionbilling.authentication.eu10.hana.ondemand.com",
        "identityzone": "subscriptionbilling",
        "identityzoneid": "XXX",
        "tenantid": "XXX",
        "tenantmode": "dedicated",
        "sburl": "https://internal-xsuaa.authentication.eu10.hana.ondemand.com",
        "apiurl": "https://api.authentication.eu10.hana.ondemand.com",
        "verificationkey": "XXX",
        "xsappname": "XXX",
        "subaccountid": "XXX",
        "uaadomain": "authentication.eu10.hana.ondemand.com",
        "zoneid": "XXX",
        "credential-type": "binding-secret"
    },
    "vendor": "SAP"
}

Création de références personnalisées dans SAP Subscription Billing prerequisites-custom-reference

Pour mettre à jour le statut de l’audience Experience Platform dans SAP Subscription Billing, vous avez besoin d’un champ de référence personnalisé pour chaque audience sélectionnée dans Experience Platform.

Pour créer les références personnalisées, connectez-vous à votre compte SAP Subscription Billing et accédez à la page [Données et configuration de Principal] > [Références personnalisées]. Sélectionnez ensuite Créer pour ajouter une nouvelle référence pour chaque audience sélectionnée dans Experience Platform. Vous aurez besoin de ces noms de champ de référence à l’étape Planifier l’exportation de l’audience et exemple suivante.

Vous trouverez ci-dessous un exemple de création d’un Type de référence personnalisé dans SAP Subscription Billing :

Pour plus d’informations, reportez-vous à la documentation SAP Subscription Billing références personnalisées.

Collecter les informations d’identification requises gather-credentials

Pour connecter SAP Commerce à Experience Platform, vous devez fournir des valeurs pour les propriétés de connexion suivantes :

Mécanismes de sécurisation guardrails

Les requêtes d’API au SAP Cloud Management service sont soumises aux limites de débit. Lorsque la limite de taux est dépassée, vous rencontrez un code de statut de réponse HTTP 429 Too Many Requests .

Identités prises en charge supported-identities

SAP Commerce prend en charge la mise à jour des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.

Audiences prises en charge supported-audiences

Cette section décrit toutes les audiences que vous pouvez exporter vers cette destination.

Cette destination prend en charge l’activation de toutes les audiences générées par le Segmentation Service d’Experience Platform.

Cette destination prend également en charge l’activation des audiences décrites dans le tableau ci-dessous.

Type et fréquence d’exportation export-type-frequency

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Se connecter à la destination connect

Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.

Dans Destinations > Catalogue, recherchez SAP Commerce. Vous pouvez également localiser cet élément dans la catégorie eCommerce.

S’authentifier auprès de la destination authenticate

Renseignez les champs obligatoires ci-dessous. Reportez-vous à la section Générer une clé de service pour obtenir des conseils.

Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.

Si les détails fournis sont valides, l’interface utilisateur affiche un statut Connecté avec une coche verte. Vous pouvez ensuite passer à l’étape suivante.

Renseigner les détails de la destination destination-details

Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.

Activer les alertes enable-alerts

Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.

Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.

Activer des audiences vers cette destination activate

Consultez la section Activer les profils et les audiences vers les destinations d’exportation d’audiences en flux continu pour obtenir des instructions sur l’activation des audiences vers cette destination.

Mapper les attributs et les identités map

Pour envoyer correctement vos données d’audience de Adobe Experience Platform vers la destination SAP Commerce, vous devez passer par l’étape de mappage des champs. Le mappage consiste à créer un lien entre vos champs de schéma de modèle de données d’expérience (XDM) dans votre compte Experience Platform et leurs équivalents issus de la destination cible. Pour mapper correctement vos champs XDM vers les champs de destination SAP Commerce, procédez comme suit :

Mapper l’identité customerNumberSAP

L’identité customerNumberSAP est un mappage obligatoire pour cette destination. Suivez les étapes ci-dessous pour le mapper :

Un exemple avec le mappage d’identité est illustré ci-dessous :

Attributs de mappage

Pour ajouter d’autres attributs à mettre à jour entre votre schéma de profil XDM et votre compte SAP Subscription Billing, répétez les étapes ci-dessous :

Mapper les attributs de mandatory pour le type de client sélectionné

Les mappages d’attributs obligatoires dépendent du type de client que vous avez sélectionné. Pour mapper les attributs obligatoires, sélectionnez l’un des éléments suivants :

Mappage d’attributs supplémentaires

Vous pouvez ensuite ajouter d’autres mappages entre votre schéma de profil XDM et les attributs SAP Subscription Billing schema pour un client, comme illustré ci-dessous :

Lorsque vous avez terminé de fournir les mappages pour votre connexion de destination, sélectionnez Suivant.

Planifier l’exportation de l’audience et exemple schedule-segment-export-example

Lors de l’exécution de l’étape ​ Planifier l’exportation d’audience ​, vous devez mapper manuellement les audiences Experience Platform aux ​ attributs ​ dans SAP Subscription Billing.

Un exemple de l’étape Planifier l’exportation de l’audience, avec l’emplacement du SAP Commerce Identifiant de mappage en surbrillance, est illustré ci-dessous :

Pour ce faire, sélectionnez chaque segment, puis saisissez le nom de la référence personnalisée à partir de SAP Subscription Billing dans le champ SAP Commerce Mapping ID connecteur de destination. Pour plus d’informations sur la création de références personnalisées, reportez-vous à la section Créer des références personnalisées dans SAP Subscription Billing.

IMPORTANT

N’utilisez pas le libellé de référence personnalisé comme valeur.

Par exemple, si votre audience Experience Platform sélectionnée est sap_audience1 et que vous souhaitez que son statut soit mis à jour dans le SAP_1 de référence personnalisé SAP Subscription Billing, spécifiez cette valeur dans le champ SAP_Commerce ID de mappage.

Un exemple Type de référence de SAP Subscription Billing est illustré ci-dessous :

Un exemple de l’étape Planifier l’exportation de l’audience, avec une audience sélectionnée et son SAP Commerce correspondant Identifiant de mappage mis en surbrillance, est illustré ci-dessous :

Comme indiqué, la valeur du champ ID de mappage doit correspondre exactement à la valeur SAP Subscription Billing Type de référence .

Répétez cette section pour chaque audience Experience Platform activée.

En fonction de l’image ci-dessus dans laquelle vous avez sélectionné deux audiences, le mappage serait le suivant :

Valider l’exportation des données exported-data

Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :

Connectez-vous au compte SAP Subscription Billing, puis accédez à la page Contacts pour vérifier les statuts de l’audience. La liste peut être configurée pour afficher des colonnes pour les références personnalisées et afficher les statuts d’audience correspondants.

Utilisation et gouvernance des données data-usage-governance

Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, lisez la présentation de la gouvernance des données.

Erreurs et résolution des problèmes errors-and-troubleshooting

Reportez-vous à la page de documentation SAP Subscription Billing Types d’erreur pour obtenir une liste des types d’erreur possibles et leurs codes de réponse.

Ressources supplémentaires additional-resources

Retrouvez d’autres informations utiles de la documentation SAP ci-dessous :

Journal des modifications

Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.