SAP Commerce verbinding

SAP Commerce, vroeger gekend als Hybris ​, is een op wolk-gebaseerde e-commerceoplossing voor B2B en B2C ondernemingen en beschikbaar als deel van de portefeuille van de Ervaring van de Klant van SAP. SAP het Factureren van het Abonnement 1} is een product onder de portefeuille en laat volledig beheer van de abonnementslevenscyclus met vereenvoudigde het verkopen en betaling ervaringen door gestandaardiseerde integratie toe.

Dit Adobe Experience Platform ​ bestemming ​ gebruikt SAP Subscription Billing klantenbeheer API ​, om uw klantendetails binnen SAP Commerce van een bestaand publiek van Experience Platform na activering bij te werken.

De instructies om aan uw SAP Commerce instantie voor authentiek te verklaren zijn verder hieronder, in ​ voor authentiek verklaren aan bestemmings ​ sectie.

Gebruiksscenario’s use-cases

Om u beter te helpen begrijpen hoe en wanneer u de SAP Commerce bestemming zou moeten gebruiken, is hier een geval van het steekproefgebruik dat de klanten van Adobe Experience Platform kunnen oplossen door deze bestemming te gebruiken.

SAP Commerce -klanten slaan informatie op over personen of organisaties die met uw bedrijf communiceren. Uw team gebruikt de klanten in SAP Commerce om het Experience Platform-publiek op te bouwen. Na het verzenden van deze soorten publiek naar SAP Commerce wordt hun informatie bijgewerkt en wordt aan elke klant een eigenschap toegewezen met de waarde ervan als de publieksnaam die aangeeft tot welk publiek de klant behoort.

Vereisten prerequisites

Raadpleeg de onderstaande secties voor alle voorwaarden die u in Experience Platform en SAP Commerce moet instellen en voor informatie die u moet verzamelen voordat u met het SAP Commerce -doel kunt werken.

Experience Platform-voorwaarden prerequisites-in-experience-platform

Alvorens gegevens aan de SAP Commerce bestemming te activeren, moet u a ​ schema ​, a ​ dataset ​ hebben, en ​ publiek ​ dat in Experience Platform wordt gecreeerd.

Verwijs naar de documentatie van Experience Platform voor ​ het schemagroep van de Details van het Lidmaatschap van de Publiek ​ als u begeleiding op publieksstatus nodig hebt.

Vereisten voor het doel SAP Commerce prerequisites-destination

Houd rekening met de volgende voorwaarden om gegevens van Experience Platform naar uw SAP Commerce -account te exporteren:

U moet een SAP Subscription Billing -account hebben prerequisites-account

Als u gegevens van Experience Platform naar uw SAP Commerce -account wilt exporteren, hebt u een SAP Subscription Billing -account nodig. Neem contact op met uw accountmanager van SAP als u geen geldige factureringsaccount hebt. Verwijs naar het SAP document van de Configuratie van het Platform ​ voor extra details.

Een servicesleutel genereren prerequisites-service-key

  • Met de servicetoets SAP Commerce hebt u via Experience Platform toegang tot de API van SAP Subscription Billing . Verwijs naar SAP Commerce ​ creeer een Sleutel van de Dienst met identiteitskaart van de Cliënt en Geheime Cliënt ​ om een de dienstsleutel tot stand te brengen. SAP Commerce vereist het volgende:

    • Client-id
    • Clientgeheim
    • URL. Het URL-patroon is als volgt: https://subscriptionbilling.authentication.eu10.hana.ondemand.com. Deze waarde wordt later gebruikt om waarden voor Region en Endpoint op te halen.
Select om een voorbeeld van de de dienstsleutel te zien
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"
}

Aangepaste verwijzingen maken in SAP Subscription Billing prerequisites-custom-reference

Als u de Experience Platform-publieksstatus in SAP Subscription Billing wilt bijwerken, hebt u een aangepast referentieveld nodig voor elk publiek dat in Experience Platform is geselecteerd.

Om de douaneverwijzingen tot stand te brengen, login aan uw SAP Subscription Billing rekening en aan de [Hoofdgegevens en Configuratie] te navigeren > [de pagina van de Verwijzingen van de Douane]. Selecteer vervolgens Create om een nieuwe referentie toe te voegen voor elk publiek dat in Experience Platform is geselecteerd. U zult deze namen van verwijzingsgebieden in de verdere ​ uitvoer van het publiek van het Programma en voorbeeld ​ stap vereisen.

Hieronder ziet u een voorbeeld van het maken van een aangepaste Reference Type in SAP Subscription Billing :
Beeld dat waar toont om een douaneverwijzing in het Factureren van het Abonnement van SAP tot stand te brengen.

Voor extra begeleiding, verwijs naar de SAP Subscription Billing ​ documentatie van douaneverwijzingen ​.

Vereiste referenties verzamelen gather-credentials

Als u SAP Commerce wilt verbinden met Experience Platform, moet u waarden opgeven voor de volgende verbindingseigenschappen:

Credentials
Beschrijving
Client-id
De waarde van clientId in de servicetoets.
Clientgeheim
De waarde van clientSecret in de servicetoets.
Endpoint
De waarde van url in de servicesleutel komt overeen met https://subscriptionbilling.authentication.eu10.hana.ondemand.com .
Regio
De locatie van uw datacenter. Het gebied is aanwezig in de url en heeft een waarde vergelijkbaar met eu10 of us10 . Als de waarde url bijvoorbeeld https://eu10.revenue.cloud.sap/api is, hebt u eu10 nodig.

Guardrails guardrails

API verzoeken aan SAP Cloud Management service zijn onderworpen aan ​ Grenswaarden van het Tarief ​. Wanneer de snelheidslimiet wordt overschreden, krijgt u een HTTP 429 Too Many Requests antwoordstatuscode.

Ondersteunde identiteiten supported-identities

SAP Commerce ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Leer meer over ​ identiteiten ​.

Doelidentiteit
Beschrijving
Overwegingen
customerNumberSAP
Een klant-id van de individuele of zakelijke klant die al in uw SAP Commerce -account aanwezig is.
Verplicht

Ondersteunde doelgroepen supported-audiences

In deze sectie worden alle soorten publiek beschreven die u naar deze bestemming kunt exporteren.

Deze bestemming steunt de activering van alle die publiek door de Dienst van de Segmentatie van Experience Platform ​ wordt geproduceerd ​.

Deze bestemming ondersteunt ook de activering van het publiek dat in de onderstaande tabel wordt beschreven.

Type publiek
Ondersteund
Beschrijving
Segmentation Service
Het publiek produceerde door de Dienst van de Segmentatie van Experience Platform 🔗.
Aangepaste uploads
Het publiek ​ ingevoerde ​ in Experience Platform van Csv- dossiers.

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een publiek samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam) volgens uw veldtoewijzing.
  • Voor elk geselecteerd publiek in Experience Platform wordt het bijbehorende SAP Commerce extra kenmerk bijgewerkt met de publieksstatus van Experience Platform.
Exportfrequentie
Streaming
  • Streaming doelen zijn "altijd aan" API-verbindingen. Wanneer een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over ​ het stromen bestemmingen ​.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u de Manage Destinations ​ toegangsbeheertoestemming ​ nodig. Lees het ​ overzicht van de toegangscontrole ​ of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het ​ leerprogramma van de bestemmingsconfiguratie ​ worden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Zoek in Destinations > Catalog naar SAP Commerce . U kunt de locatie ook in de categorie eCommerce vinden.

Verifiëren voor bestemming authenticate

Vul de vereiste velden hieronder in. Verwijs naar ​ een de dienstsleutel ​ sectie voor om het even welke begeleiding produceren.

Veld
Beschrijving
Client ID
De waarde van clientId in de servicetoets.
Client secret
De waarde van clientSecret in de servicetoets.
Endpoint
De waarde van url in de servicesleutel komt overeen met https://subscriptionbilling.authentication.eu10.hana.ondemand.com .
Region
De locatie van uw datacenter. Het gebied is aanwezig in de url en heeft een waarde vergelijkbaar met eu10 of us10 . Als de waarde url bijvoorbeeld https://eu10.revenue.cloud.sap/api is, hebt u eu10 nodig.

Selecteer Connect to destination als u wilt verifiëren bij het doel.
Beeld van Experience Platform UI die tonen hoe te aan de bestemming voor authentiek te verklaren.

Als de opgegeven gegevens geldig zijn, geeft de gebruikersinterface de status Connected weer met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.
Beeld van Experience Platform UI die de bestemmingsdetails tonen die na authentificatie moeten worden gevuld.

  • Name: Een naam waarmee u dit doel in de toekomst herkent.
  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
  • Type of Customer: Selecteer of Individueel of Collectief afhankelijk van de entiteiten binnen uw publiek. Het SAP Subscription Billing ​ schema ​ schakelt de verplichte gebieden afhankelijk van deze selectie die aan het customerType attribuut in kaart wordt gebracht. Als de selectie Collectief is, dan zullen de verplichte die afbeeldingen als firstName en lastName voor een individuele klant worden vereist worden genegeerd en company verplicht en vice versa.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij ​ het intekenen aan bestemmingsalarm gebruikend UI ​.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT

Lees ​ activeer profielen en publiek aan het stromen publiek uitvoerbestemmingen ​ voor instructies bij het activeren van publiek aan deze bestemming.

Kenmerken en identiteiten toewijzen map

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de SAP Commerce -bestemming wilt verzenden, moet u de stap voor veldtoewijzing doorlopen. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Experience Platform-account en de overeenkomstige equivalenten van de doelbestemming. Voer de onderstaande stappen uit om uw XDM-velden correct toe te wijzen aan de SAP Commerce -doelvelden:

Wijs de customerNumberSAP identiteit toe

De identiteit van customerNumberSAP is een verplichte toewijzing voor dit doel. Voer de onderstaande stappen uit om deze toe te wijzen:

  1. Selecteer Add new mapping in de stap Mapping . U ziet nu een nieuwe toewijzingsrij op het scherm.
    {het schermschot van 0} Experience Platform UI met toegevoegde nieuwe benadrukte toewijzingsknoop.
  2. Kies in het Select source field -venster de Select identity namespace en selecteer customerNumberSAP .
    {het schermschot van 0} Experience Platform UI die e-mail als bronattribuut selecteert om als identiteit in kaart te brengen.
  3. Kies in het Select target field -venster de Select identity namespace en selecteer de customerNumber -identiteit.
    {het schermschot van 0} Experience Platform UI die e-mail als doelattribuut selecteert om als identiteit in kaart te brengen.
Source-veld
Doelveld
Verplicht
IdentityMap: customerNumberSAP
Identity: customerNumber
Ja

Hieronder ziet u een voorbeeld met de identiteitstoewijzing:
Beeld van Experience Platform UI die een voorbeeld van de identiteitstoewijzing van customerNumber toont.

Toewijzingskenmerken

Herhaal de onderstaande stappen om andere kenmerken toe te voegen die u tussen het XDM-profielschema en uw SAP Subscription Billing -account wilt bijwerken:

  1. Selecteer Add new mapping in de stap Mapping . U ziet nu een nieuwe toewijzingsrij op het scherm.
    {het schermschot van 0} Experience Platform UI met toegevoegde nieuwe benadrukte toewijzingsknoop.
  2. Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk.
    het schermschot van Experience Platform UI die Achternaam als bronattribuut selecteren.
  3. In het Select target field venster, kies Select custom attributes categorie en typ de naam van het SAP Subscription Billing attribuut van de lijst van klant ​ schema ​ attributen.
    {het schermschot van 0} Experience Platform UI waar lastName als doelattribuut wordt bepaald.
IMPORTANT
Doelveldnamen zijn hoofdlettergevoelig en moeten overeenkomen met namen van SAP Subscription Billing -kenmerken. De enige uitzondering hiervoor is country waar u countryCode moet gebruiken. SAP Subscription Billing ondersteunt alpha-2 (ISO 3166)-landcodes. De waarde is hoofdlettergevoelig en moet tussen 0 en 3 tekens lang zijn. Zorg er dus voor dat u de gedefinieerde waarden exact opgeeft, anders treden er fouten op: The country code {} does not exist of size must be between 0 and 3 .

Kenmerken toewijzen mandatory voor het geselecteerde klanttype

De verplichte kenmerktoewijzingen zijn afhankelijk van de Type of Customer die u hebt geselecteerd. Selecteer een van de volgende opties om de verplichte kenmerken toe te wijzen:

Individuele klant
table 0-row-3 1-row-3 2-row-3
Source-veld Doelveld Verplicht
xdm: person.lastName Attribute: lastName Ja
xdm: workAddress.countryCode Attribute: countryCode Ja
Collectieve klant
table 0-row-3 1-row-3 2-row-3
Source-veld Doelveld Verplicht
xdm: b2b.companyName Attribute: company Ja
xdm: workAddress.countryCode Attribute: countryCode Ja

Extra kenmerken toewijzen

U kunt om het even welke extra afbeeldingen tussen uw XDM profielschema en SAP Subscription Billing ​ schema ​ attributen voor een klant zoals hieronder getoond dan toevoegen:

Individuele klant
table 0-row-3 1-row-3 2-row-3 3-row-3
Source-veld Doelveld Verplicht
xdm: person.name.firstName Attribute: firstName Nee
xdm: workAddress.street1 Attribute: street Nee
xdm: workAddress.city Attribute: city Nee

Een voorbeeld met zowel verplichte als optionele kenmerktoewijzingen waarbij de klant een individu is, wordt hieronder weergegeven:
Beeld van Experience Platform UI die een voorbeeld met zowel verplichte als facultatieve attributenafbeeldingen toont waar de klant een individu is.

Collectieve klant
table 0-row-3 1-row-3 2-row-3
Source-veld Doelveld Verplicht
xdm: workAddress.street1 Attribute: street Nee
xdm: workAddress.city Attribute: city Nee

Een voorbeeld met zowel verplichte als optionele kenmerktoewijzingen waarbij de klant een onderneming is, wordt hieronder weergegeven:
Beeld van Experience Platform UI die een voorbeeld met zowel verplichte als facultatieve attributenafbeeldingen toont waar de klant een collectief is.

Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next .

Het publiek van het programma uitvoeren en voorbeeld schedule-segment-export-example

Wanneer het uitvoeren van de ​ stap van de de publieksuitvoer van het Programma ​, moet u het publiek van Experience Platform aan de ​ attributen ​ in kaart brengen SAP Subscription Billing.

Hieronder ziet u een voorbeeld van de stap die het publiek van het venster Planning uitvoert en de locatie van de SAP Commerce Mapping ID gemarkeerd is:
Beeld van Experience Platform die de uitvoer van het planningspubliek met Bebevolkt Mapping IDs tonen.

Hiervoor selecteert u elk segment en voert u vervolgens de naam in van de aangepaste verwijzing uit SAP Subscription Billing in het veld voor de SAP Commerce doelconnector Mapping ID . Voor begeleiding bij het creëren van douaneverwijzingen, verwijs naar ​ creeer douaneverwijzingen in SAP Subscription Billing sectie.

IMPORTANT
Gebruik het aangepaste referentielabel niet als waarde.
Het beeld erop wijst dat u niet de waarde van het douanelabel van de verwijzing voor afbeelding zou moeten gebruiken.

Als uw geselecteerde Experience Platform-publiek bijvoorbeeld sap_audience1 is en u wilt dat de status wordt bijgewerkt naar de SAP Subscription Billing aangepaste referentie SAP_1 , geeft u deze waarde op in het veld SAP_Commerce Mapping ID .

Hieronder ziet u een voorbeeld Reference Type van SAP Subscription Billing :
Beeld dat waar toont om een douaneverwijzing in het Factureren van het Abonnement van SAP tot stand te brengen.

Hieronder ziet u een voorbeeld van de stap die het publiek van het venster Planning uitvoert, met een geselecteerd publiek en de bijbehorende SAP Commerce Mapping ID gemarkeerd:
Beeld van Experience Platform die de uitvoer van het planningspubliek met Bebevolkt Mapping IDs tonen.

Zoals u ziet, moet de waarde in het veld Mapping ID exact overeenkomen met de waarde SAP Subscription Billing Reference Type .

Herhaal deze sectie voor elk geactiveerd Experience Platform-publiek.

Op basis van de bovenstaande afbeelding waarin u twee soorten publiek hebt geselecteerd, wordt de afbeelding als volgt toegewezen:

SAP Commerce publieksnaam
SAP Subscription Billing Reference Type
SAP Commerce Mapping ID value
sap_publiek1
SAP_1
SAP_1
SAP-publiek2
SAP_2
SAP_2

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

Meld u aan bij de SAP Subscription Billing -account en navigeer naar de Contacts -pagina om de status van het publiek te controleren. De lijst kan worden gevormd om kolommen voor de douaneverwijzingen te tonen en de overeenkomstige publieksstatus te tonen.
Beeld van het Factureren van het Abonnement van SAP die de pagina van het klantenoverzicht met kolomkopballen tonen die de publieksnaam en de statistieken van het celpubliek tonen

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het ​ overzicht van het Beleid van Gegevens ​.

Fouten en problemen oplossen errors-and-troubleshooting

Verwijs naar de SAP Subscription Billing de documentatiepagina van de Types van Fout ​ voor een lijst van mogelijke foutentypes en hun antwoordcodes.

Aanvullende bronnen additional-resources

Hieronder vindt u aanvullende nuttige informatie uit de documentatie van SAP :

Changelog

Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.

Wijzigingen weergeven
table 0-row-3 1-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
Januari 2024 Eerste release Oorspronkelijke doelversie en documentatie publiceren.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6