Connexion SAP Commerce

SAP Commerce, anciennement connu sous le nom de 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 Facturation d’abonnement est un produit appartenant au 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.

Ceci Adobe Experience Platform destination utilise la variable SAP Subscription Billing API de gestion des clients, pour mettre à jour les détails de votre client dans SAP Commerce 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 Les clients 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 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 les informations que vous devez rassembler avant de travailler avec la variable SAP Commerce destination.

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

Avant d’activer des données dans SAP Commerce destination, vous devez avoir une schema, un dataset, et audiences créé dans Experience Platform.

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

Conditions préalables pour l’ SAP Commerce destination prerequisites-destination

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

Vous devez disposer d’un SAP Subscription Billing account prerequisites-account

Pour exporter des données de Platform vers votre SAP Commerce , vous devez disposer d’un SAP Subscription Billing compte . Si vous ne disposez pas d’un compte de facturation valide, contactez votre SAP gestionnaire de compte. Voir SAP Configuration de la plateforme pour plus de détails.

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

  • La variable SAP Commerce la clé de service vous permet d’accéder à la SAP Subscription Billing API via Experience Platform. Voir SAP Commerce créer une clé de service avec un identifiant client et un secret client ; pour créer une clé de service. 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.
code language-json
{
    "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 des références personnalisées, connectez-vous à SAP Subscription Billing et accédez au [Données et configuration du Principal] > [Références personnalisées] page. Ensuite, sélectionnez 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 dans les Planification de l’export d’audience et exemple étape .

Exemple de création d’une Type de référence dans SAP Subscription Billing est illustré ci-dessous :
Image indiquant où créer une référence personnalisée dans la facturation des abonnements SAP.

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

Collecter les informations d’identification requises gather-credentials

Pour se connecter SAP Commerce pour 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 à partir de la clé de service.
Secret client
La valeur de clientSecret à partir de la clé de service.
Point d’entrée
La valeur de url à partir de la clé de service, la variable https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Région
Emplacement de votre centre de données. La région est présente dans la variable url et a une valeur similaire à eu10 ou us10. Par exemple, si la variable url is https://eu10.revenue.cloud.sap/api besoin eu10.

Mécanismes de sécurisation guardrails

Demandes d’API à la fonction SAP Cloud Management service sont soumises à Limites de taux. Lorsque la limite de taux est dépassée, un événement HTTP 429 Too Many Requests code d’état de réponse .

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.

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

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 d’audience
Description
Segmentation Service
Chargements personnalisés

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.

É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 électronique, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • Pour chaque audience sélectionnée dans Platform, la valeur SAP Commerce un attribut supplémentaire 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 connect

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.

Within Destinations > Catalogue, recherchez SAP Commerce. Vous pouvez également la localiser sous le eCommerce catégorie.

S’authentifier auprès de la destination authenticate

Renseignez les champs obligatoires ci-dessous. Voir Générer une clé de service pour obtenir des conseils.

Champ
Description
Identifiant du client
La valeur de clientId à partir de la clé de service.
Client secret
La valeur de clientSecret à partir de la clé de service.
Point d’entrée
La valeur de url à partir de la clé de service, la variable https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Zone géographique
Emplacement de votre centre de données. La région est présente dans la variable url et a une valeur similaire à eu10 ou us10. Par exemple, si la variable url is https://eu10.revenue.cloud.sap/api besoin 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 sur 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.
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 selon les entités de votre audience. La variable SAP Subscription Billing schema bascule les champs obligatoires en fonction de cette sélection mappée à la propriété customerType attribut. Si la sélection est Entreprise, puis les mappages obligatoires comme firstName et lastName requis pour un client individuel sera ignoré et company devient obligatoire et inversement.

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

IMPORTANT

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 le SAP Commerce destination, 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 à SAP Commerce pour les champs de destination, procédez comme suit :

Faites correspondre la variable customerNumberSAP identité

La variable customerNumberSAP l’identité 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 mis en surbrillance.
  2. Dans le Sélectionner le champ source , choisissez la Sélectionner un espace de noms d’identité et sélectionnez customerNumberSAP.
    Copie d’écran de l’interface utilisateur de Platform sélectionnant email comme attribut source à mapper en tant qu’identité.
  3. Dans le Sélectionner le champ cible , choisissez la Sélectionner un espace de noms d’identité et sélectionnez la variable customerNumber identité.
    Copie d’écran de l’interface utilisateur de Platform 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 à mettre à jour entre votre schéma de profil XDM et votre 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 mis en surbrillance.
  2. Dans le Sélectionner le champ source , choisissez la Sélectionner des attributs et sélectionnez l’attribut XDM.
    Capture d’écran de l’interface utilisateur de Platform sélectionnant Nom comme attribut source.
  3. Dans le Sélectionner le champ cible fenêtre, choisissez Sélectionner des attributs personnalisés et saisissez le nom du champ SAP Subscription Billing de la liste des clients schema attributs.
    Capture 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 à la variable SAP Subscription Billing noms d’attributs. La seule exception à cette règle est : country où vous devez utiliser countryCode au lieu de . 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 valeur définie, sinon vous risquez de rencontrer des erreurs : The country code {} does not exist ou size must be between 0 and 3.

Carte mandatory attributs pour le type de client sélectionné

Les mappages d’attributs obligatoires dépendent de Type de client que vous aviez choisi. Pour mapper les attributs obligatoires, sélectionnez dans l’une des options suivantes :

Client individuel
table 0-row-3 1-row-3 2-row-3
Champ source Champ cible Obligatoire
xdm: person.lastName Attribute: lastName Oui
xdm: workAddress.countryCode Attribute: countryCode Oui
Client d’entreprise
table 0-row-3 1-row-3 2-row-3
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 le SAP Subscription Billing schema attributs pour un client, comme illustré ci-dessous :

Client individuel
table 0-row-3 1-row-3 2-row-3 3-row-3
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 d’entreprise
table 0-row-3 1-row-3 2-row-3
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 schedule-segment-export-example

Lors de l’exécution du Planification de l’exportation des audiences , vous devez mapper manuellement les audiences de Platform à la variable Attributs in SAP Subscription Billing.

Exemple de l’étape Planifier l’exportation de l’audience , avec l’emplacement du SAP Commerce ID de mappage mise en surbrillance, est illustré ci-dessous :
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 depuis SAP Subscription Billing dans le SAP Commerce ID de mappage champ connecteur de destination . Pour plus d’informations sur la création de références personnalisées, reportez-vous au 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 vous souhaitez que son état soit mis à jour dans le SAP Subscription Billing référence personnalisée SAP_1, indiquez cette valeur dans la variable SAP_Commerce ID de mappage champ .

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 des abonnements SAP.

Exemple de l’étape Planifier l’export de l’audience , avec une audience sélectionnée et son SAP Commerce ID de mappage mise 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é dans la variable ID de mappage doit correspondre exactement au champ SAP Subscription Billing Type de référence value .

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 ID de mappage value | | — | — | — | | 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 SAP Subscription Billing , puis accédez à la Contacts pour vérifier les états de l’audience. 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 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

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

Ressources supplémentaires additional-resources

Informations utiles supplémentaires de la section SAP la documentation est la suivante :

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
table 0-row-3 1-row-3 layout-auto
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