DocumentationExperience PlatformGuide des destinations

Connexion SAP Commerce

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :
  • Destinations

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice

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

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

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

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

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

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

  • La clé de service SAP Commerce vous permet d’accéder à l’API SAP Subscription Billing via Experience Platform. Pour créer une clé de service, reportez-vous à la section SAP Commerce Création d’une clé de service avec l’ID client et le secret client. SAP Commerce requiert ce qui suit :

    • Identifiant client
    • Secret client
    • URL. Le modèle d’URL est le suivant : https://subscriptionbilling.authentication.eu10.hana.ondemand.com. Cette valeur sera utilisée ultérieurement pour obtenir des valeurs pour Region et Endpoint.
Sélectionnez cette option pour afficher un exemple de clé de service.
{
    "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

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 :
Image indiquant où créer une référence personnalisée dans la facturation d’abonnements SAP.

Pour plus d'informations, reportez-vous à la documentation SAP Subscription Billing référence personnalisée .

Collecter les informations d’identification requises

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

Informations d’identification
Description
Identifiant client
La valeur de clientId de la clé de service.
Secret client
La valeur de clientSecret de la clé de service.
Point d’entrée
La valeur de url de la clé de service est similaire à https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Région
Emplacement de votre centre de données. La région est présente dans le url et a une valeur similaire à eu10 ou us10. Par exemple, si url est https://eu10.revenue.cloud.sap/api, vous avez besoin de eu10.

Mécanismes de sécurisation

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

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.

Identité cible
Description
Considérations
customerNumberSAP
Identifiant client de l’individu ou de l’entreprise déjà présent dans votre compte SAP Commerce.
Obligatoire

Audiences prises en charge

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 d’audience
Pris en charge
Description
Segmentation Service
✓
Audiences générées par l’Experience Platform Segmentation Service.
Chargements personnalisés
✓
Audiences importées dans Experience Platform à partir de fichiers CSV.

Type et fréquence d’exportation

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

Élément
Type
Notes
Type d’exportation
Basé sur les profils
  • Vous exportez tous les membres d’une audience, ainsi que les champs de schéma souhaités (par exemple : adresse email, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • Pour chaque audience sélectionnée dans Platform, l’attribut supplémentaire SAP Commerce correspondant est mis à jour avec son état d’audience de Platform.
Fréquence des exportations
Diffusion en continu
  • Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Lorsqu’un profil est mis à jour en Experience Platform en fonction de l’évaluation de l’audience, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.

Se connecter à la destination

IMPORTANT
Pour vous connecter à la destination, vous devez disposer de l’autorisation de contrôle d’accès Gérer les destinations. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

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

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

Champ
Description
Identifiant du client
La valeur de clientId de la clé de service.
Secret client
La valeur de clientSecret de la clé de service.
Point d’entrée
La valeur de url de la clé de service est similaire à https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Région
Emplacement de votre centre de données. La région est présente dans le url et a une valeur similaire à eu10 ou us10. Par exemple, si url est https://eu10.revenue.cloud.sap/api, vous avez besoin de eu10.

Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.
Image de l’interface utilisateur de Platform montrant comment s’authentifier à 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

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.
Image de l’interface utilisateur de Platform montrant les détails de destination à remplir après l’authentification.

  • Nom  : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
  • Description  : une description qui vous aidera à identifier cette destination à l’avenir.
  • Type de client : sélectionnez Individuel ou Entreprise en fonction des entités de votre audience. Le SAP Subscription Billing schéma change les champs obligatoires en fonction de cette sélection mappée à l’attribut customerType. Si la sélection est Corporate, les mappages obligatoires tels que firstName et lastName requis pour un client individuel seront ignorés et company deviendra obligatoire et inversement.

Activer les alertes

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

IMPORTANT

  • Pour activer les données, vous avez besoin des ​, Activer les destinations, ​ ​et ​ ​ autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.

  • Pour exporter des identités, vous avez besoin de l'autorisation Afficher le graphique d'identités 🔗.

    Sélectionnez l’espace de noms d’identité en surbrillance dans le workflow pour activer les audiences vers les destinations.

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

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 :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Vous pouvez désormais voir une nouvelle ligne de mappage sur l’écran.
    Copie d’écran de l’interface utilisateur de Platform avec ajout d’un nouveau bouton de mappage surligné.
  2. Dans la fenêtre Sélectionner le champ source, choisissez l’ espace de noms d’identité sélectionné et sélectionnez customerNumberSAP.
    Copie d’écran de l’interface utilisateur de Platform en sélectionnant email comme attribut source à mapper comme identité.
  3. Dans la fenêtre Sélectionner le champ cible , choisissez l’ espace de noms d’identité sélectionné et sélectionnez l’ customerNumber identité.
    Copie d’écran de l’interface utilisateur de Platform en sélectionnant email comme attribut cible à mapper en tant qu’identité.
Champ source
Champ cible
Obligatoire
IdentityMap: customerNumberSAP
Identity: customerNumber
Oui

Un exemple de mappage d’identité est illustré ci-dessous :
Image de l’interface utilisateur de Platform montrant un exemple de mappage d’identité customerNumber.

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 :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Vous pouvez désormais voir une nouvelle ligne de mappage sur l’écran.
    Copie d’écran de l’interface utilisateur de Platform avec ajout d’un nouveau bouton de mappage surligné.
  2. Dans la fenêtre Sélectionner le champ source , choisissez la catégorie Sélectionner les attributs et sélectionnez l’attribut XDM.
    Copie d’écran de l’interface utilisateur de Platform en sélectionnant Nom comme attribut source.
  3. Dans la fenêtre Sélectionner le champ cible, sélectionnez la catégorie Sélectionner des attributs personnalisés et saisissez le nom de l’attribut SAP Subscription Billing dans la liste des attributs schema du client.
    Copie d’écran de l’interface utilisateur de Platform où lastName est défini comme attribut cible.
IMPORTANT
Les noms des champs cibles sont sensibles à la casse et doivent correspondre aux noms des attributs SAP Subscription Billing. La seule exception à cette règle est country où vous devez utiliser countryCode à la place. SAP Subscription Billing prend en charge les codes pays alpha-2 (ISO 3166). La valeur est sensible à la casse et doit être comprise entre 0 et 3 caractères. Veillez donc à fournir exactement la même valeur définie sinon vous risquez de rencontrer des erreurs : The country code {} does not exist ou size must be between 0 and 3.

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 :

Client individuel
Champ source
Champ cible
Obligatoire
xdm: person.lastName
Attribute: lastName
Oui
xdm: workAddress.countryCode
Attribute: countryCode
Oui
Client de l’entreprise
Champ source
Champ cible
Obligatoire
xdm: b2b.companyName
Attribute: company
Oui
xdm: workAddress.countryCode
Attribute: countryCode
Oui

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 :

Client individuel
Champ source
Champ cible
Obligatoire
xdm: person.name.firstName
Attribute: firstName
Non
xdm: workAddress.street1
Attribute: street
Non
xdm: workAddress.city
Attribute: city
Non

Voici un exemple avec des mappages d’attributs obligatoires et facultatifs où le client est un individu :
Image de l’interface utilisateur de Platform montrant un exemple avec des mappages d’attributs obligatoires et facultatifs où le client est un individu.

Client de l’entreprise
Champ source
Champ cible
Obligatoire
xdm: workAddress.street1
Attribute: street
Non
xdm: workAddress.city
Attribute: city
Non

Voici un exemple avec des mappages d’attributs obligatoires et facultatifs où le client est une entreprise :
Image de l’interface utilisateur de Platform montrant un exemple avec des mappages d’attributs obligatoires et facultatifs où le client est une entreprise.

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

Planification de l’export d’audience et exemple

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 :
Image de Platform montrant l’exportation de l’audience de planification avec les identifiants de mappage renseignés.

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.
Image indiquant que vous ne devez pas utiliser la valeur d’étiquette de référence personnalisée pour le mappage.

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 :
Image indiquant où créer une référence personnalisée dans la facturation d’abonnements SAP.

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 :
Image de Platform montrant l’exportation de l’audience de planification avec les identifiants de mappage renseignés.

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
Valeur SAP Commerce ID de mappage
sap_audience1
SAP_1
SAP_1
SAP Audience2
SAP_2
SAP_2

Valider l’exportation des données

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.
Image de la facturation des abonnements SAP montrant la page d’aperçu du client avec des en-têtes de colonne indiquant le nom de l’audience et les états de l’audience des cellules

Utilisation et gouvernance des données

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

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

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

  • Facturation d’abonnement SAP intégrée

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.

Afficher le journal des modifications
Mois de publication
Type de mise à jour
Description
Janvier 2024
Version initiale
Version initiale de la destination et publication de la documentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6