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 voorRegionenEndpointop te halen.
| code language-json |
|---|
|
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 :
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:
clientId in de servicetoets.clientSecret in de servicetoets.url in de servicesleutel komt overeen met https://subscriptionbilling.authentication.eu10.hana.ondemand.com .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 .
customerNumberSAPOndersteunde 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 en frequentie exporteren export-type-frequency
Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.
- 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.
- 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
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.
clientId in de servicetoets.clientSecret in de servicetoets.url in de servicesleutel komt overeen met https://subscriptionbilling.authentication.eu10.hana.ondemand.com .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.
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.
- 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
customerTypeattribuut in kaart wordt gebracht. Als de selectie Collectief is, dan zullen de verplichte die afbeeldingen alsfirstNameenlastNamevoor een individuele klant worden vereist worden genegeerd encompanyverplicht 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
- Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingen nodig. Lees het overzicht van de toegangscontrole of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
- Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemming nodig.
{width="100" modal="regular"}
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:
- 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.
- 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.
- 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.
IdentityMap: customerNumberSAPIdentity: customerNumberHieronder ziet u een voorbeeld met de identiteitstoewijzing:
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:
- 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.
- Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk.
- 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.
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:
| 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 |
| 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:
| 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:
| 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:
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:
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.
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 :
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:
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_1SAP_1SAP_2SAP_2Gegevens 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.
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.
| table 0-row-3 1-row-3 layout-auto | ||
|---|---|---|
| Releasedatum | Type bijwerken | Beschrijving |
| Januari 2024 | Eerste release | Oorspronkelijke doelversie en documentatie publiceren. |