Connexion SAP Commerce

SAP Commerce, anciennement Hybris, est une solution de plateforme de commerce électronique basée sur le cloud pour les entreprises B2B et B2C, disponible dans le cadre du portefeuille d’expérience client SAP. SAP La 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 l’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.

Les clients SAP Commerce stockent des informations sur les individus 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 l’envoi de 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 qui indique à quelle audience le client appartient.

Conditions préalables prerequisites

Reportez-vous aux sections ci-dessous pour connaître les conditions préalables que vous devez configurer dans Experience Platform et SAP Commerce, ainsi que pour obtenir des informations que vous devez rassembler avant de travailler avec la destination SAP Commerce.

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

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

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

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

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

Vous devez avoir un compte SAP Subscription Billing prerequisites-account

Pour exporter des données de 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. Pour plus d’informations, consultez le document SAP Configuration de la plateforme .

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 l’état 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 Platform.

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

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érence personnalisée .

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 demandes d’API envoyées à l’instance SAP Cloud Management service sont soumises aux limites de taux. Lorsque la limite de taux est dépassée, vous rencontrez un code d’état 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 la localiser sous la catégorie eCommerce.

S’authentifier auprès de la destination authenticate

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

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 les 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 Platform et leurs équivalents issus de la destination cible. Pour mapper correctement vos champs XDM aux champs de destination SAP Commerce, procédez comme suit :

Faire correspondre l’identité customerNumberSAP

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

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

Mappage des attributs

Pour ajouter d’autres attributs que vous souhaitez 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 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 dans l’une des options suivantes :

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.

Planification de l’export d’audience et exemple schedule-segment-export-example

Lors de l’étape Planification de l’export d’audience, vous devez mapper manuellement les audiences Platform aux attributs dans SAP Subscription Billing.

Vous trouverez ci-dessous un exemple de l’étape Planifier l’exportation de l’audience , avec l’emplacement de l’ SAP Commerce ID de mappage en surbrillance :

Pour ce faire, sélectionnez chaque segment, puis saisissez le nom de la référence personnalisée de SAP Subscription Billing dans le champ de connecteur de destination SAP Commerce ID de mappage . Pour plus d'informations sur la création de références personnalisées, reportez-vous à la section Création de 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 l’audience Experience Platform sélectionnée est sap_audience1 et que vous souhaitez que son état soit mis à jour dans la référence personnalisée SAP Subscription Billing SAP_1, 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 ID de mappage correspondant 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 Platform activée.

En fonction de l’image affichée ci-dessus, où vous avez sélectionné deux audiences, le mappage serait le suivant :
| SAP Commerce nom de l’audience | SAP Subscription Billing Type de référence | SAP Commerce Valeur de l’ID de mappage |
| — | — | — |
| sap_audience1 | SAP_1 | SAP_1 |
| SAP Audience2 | SAP_2 | SAP_2 |

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 des audiences. La liste peut être configurée pour afficher les colonnes des 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

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

Ressources supplémentaires additional-resources

Vous trouverez ci-dessous d’autres informations utiles à partir de la documentation SAP :

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.