SAP Commerce-anslutning

SAP Commerce, tidigare Hybris, är en molnbaserad e-handelsplattformslösning för B2B- och B2C-företag och är tillgänglig som en del av SAP:s kundupplevelseportfölj. SAP Prenumerationsfakturering är en produkt som ingår i portföljen och möjliggör en fullständig hantering av prenumerationens livscykel med förenklade försäljnings- och betalningsupplevelser via standardiserade integreringar.

Det här Adobe Experience Platform målet använder SAP Subscription Billing API:t för kundhantering för att uppdatera kundinformationen inom SAP Commerce från en befintlig Experience Platform-målgrupp efter aktiveringen.

Instruktioner för autentisering till din SAP Commerce-instans finns längre ned i avsnittet Autentisera till mål.

Användningsfall use-cases

För att du bättre ska kunna förstå hur och när du ska använda målet SAP Commerce finns det ett exempel på användning som Adobe Experience Platform-kunder kan lösa genom att använda det här målet.

SAP Commerce-kunder lagrar information om personer eller organisationsenheter som interagerar med ditt företag. Ditt team använder de kunder som finns i SAP Commerce för att skapa Experience Platform-målgrupper. När dessa målgrupper har skickats till SAP Commerce uppdateras deras information och varje kund tilldelas en egenskap med dess värde som målgruppsnamn som anger vilken målgrupp kunden tillhör.

Förhandskrav prerequisites

I avsnitten nedan finns information om alla krav som du måste konfigurera i Experience Platform och SAP Commerce. Här finns också information som du måste samla in innan du kan arbeta med målet SAP Commerce.

Krav för Experience Platform prerequisites-in-experience-platform

Innan du aktiverar data till målet SAP Commerce måste du ha ett schema, en datamängd och målgrupper som skapats i Experience Platform.

Se Experience Platform-dokumentationen för schemafältgruppen Information om målgruppsmedlemskap om du behöver vägledning om målgruppsstatus.

Krav för målet SAP Commerce prerequisites-destination

Observera följande krav för att kunna exportera data från Experience Platform till ditt SAP Commerce-konto:

Du måste ha ett SAP Subscription Billing-konto prerequisites-account

Om du vill exportera data från Experience Platform till ditt SAP Commerce-konto måste du ha ett SAP Subscription Billing-konto. Om du inte har ett giltigt faktureringskonto kontaktar du kontohanteraren för SAP. Mer information finns i dokumentet SAP Plattformskonfiguration.

Generera en tjänstnyckel 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"
}

Skapa anpassade referenser i SAP Subscription Billing prerequisites-custom-reference

Om du vill uppdatera Experience Platform målgruppsstatus i SAP Subscription Billing behöver du ett anpassat referensfält för varje målgrupp som valts i Experience Platform.

Om du vill skapa anpassade referenser loggar du in på ditt SAP Subscription Billing-konto och navigerar till sidan [Huvuddata och konfiguration] > [Anpassade referenser]. Välj sedan Create för att lägga till en ny referens för varje målgrupp som valts i Experience Platform. Du behöver dessa referensfältnamn i efterföljande schemaläggning av målgruppsexport och exempel -steg.

Ett exempel på hur du skapar en anpassad Reference Type i SAP Subscription Billing visas nedan:

Mer information finns i dokumentationen för SAP Subscription Billing anpassade referenser.

Samla in nödvändiga inloggningsuppgifter gather-credentials

Om du vill ansluta SAP Commerce till Experience Platform måste du ange värden för följande anslutningsegenskaper:

Guardrails guardrails

API-begäranden till SAP Cloud Management service omfattas av hastighetsbegränsningar. När hastighetsgränsen har överskridits kommer du att stöta på en HTTP 429 Too Many Requests-svarsstatuskod.

Identiteter som stöds supported-identities

SAP Commerce har stöd för uppdatering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målgrupper supported-audiences

I det här avsnittet beskrivs alla målgrupper som du kan exportera till det här målet.

Det här målet stöder aktivering av alla målgrupper som genereras via Experience Platform segmenteringstjänst.

Detta mål stöder även aktivering av målgrupperna som beskrivs i tabellen nedan.

Exportera typ och frekvens export-type-frequency

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Anslut till målet connect

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

Sök efter SAP Commerce inom Destinations > Catalog. Du kan också hitta den under kategorin eCommerce.

Autentisera till mål authenticate

Fyll i de obligatoriska fälten nedan. Mer information finns i avsnittet Skapa en tjänstnyckel.

Om du vill autentisera till målet väljer du Connect to destination.

Om den angivna informationen är giltig visas statusen Connected med en grön bockmarkering. Du kan sedan gå vidare till nästa steg.

Fyll i målinformation destination-details

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.

Aktivera aviseringar enable-alerts

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

Aktivera målgrupper till det här målet activate

Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa attribut och identiteter map

Om du vill skicka målgruppsdata från Adobe Experience Platform till målet SAP Commerce måste du gå igenom fältmappningssteget. Mappningen består av att skapa en länk mellan XDM-schemafälten (Experience Data Model) i ditt Experience Platform-konto och deras motsvarande motsvarigheter från målmålet. Följ stegen nedan för att mappa dina XDM-fält korrekt till målfälten för SAP Commerce:

Mappa customerNumberSAP-identiteten

Identiteten customerNumberSAP är en obligatorisk mappning för det här målet. Följ stegen nedan för att mappa den:

Ett exempel med identitetsmappning visas nedan:

Mappningsattribut

Om du vill lägga till andra attribut som du vill uppdatera mellan XDM-profilschemat och ditt SAP Subscription Billing-konto upprepar du stegen nedan:

Mappa mandatory-attribut för den valda kundtypen

Obligatoriska attributmappningar beror på Type of Customer som du har valt. Om du vill mappa de obligatoriska attributen väljer du något av följande:

Mappa ytterligare attribut

Du kan sedan lägga till ytterligare mappningar mellan XDM-profilschemat och SAP Subscription Billing schema -attributen för en kund enligt nedan:

Välj Next när du är klar med mappningarna för målanslutningen.

Schemalägg målgruppsexport och exempel schedule-segment-export-example

När du utför steget Schemalägg målgruppsexport måste du manuellt mappa Experience Platform-målgrupper till attributen i SAP Subscription Billing.

Ett exempel på exportsteget för schemalagda målgrupper, med platsen för SAP Commerce Mapping ID markerad, visas nedan:

Det gör du genom att markera varje segment och sedan ange namnet på den anpassade referensen från SAP Subscription Billing i fältet SAP Commerce Mapping ID för målkoppling. Mer information om hur du skapar anpassade referenser finns i avsnittet Skapa anpassade referenser i SAP Subscription Billing.

IMPORTANT

Använd inte den anpassade referensetiketten som värde.

Om den valda Experience Platform-målgruppen till exempel är sap_audience1 och du vill att dess status ska uppdateras till den SAP Subscription Billing anpassade referensen SAP_1 anger du det här värdet i fältet SAP_Commerce Mapping ID.

Ett exempel Reference Type från SAP Subscription Billing visas nedan:

Ett exempel på exportsteget för schemalagda målgrupper, med en vald målgrupp och motsvarande SAP Commerce Mapping ID markerat, visas nedan:

Som du kan se ska värdet i fältet Mapping ID exakt matcha värdet SAP Subscription Billing Reference Type .

Upprepa det här avsnittet för varje aktiverad Experience Platform-publik.

Baserat på bilden ovan där du har valt två målgrupper är mappningen följande:

Validera dataexport exported-data

Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:

Logga in på kontot SAP Subscription Billing och navigera sedan till sidan Contacts för att kontrollera målgruppsstatus. Listan kan konfigureras för att visa kolumner för anpassade referenser och visa motsvarande målgruppsstatus.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.

Fel och felsökning errors-and-troubleshooting

På dokumentationssidan SAP Subscription Billing Feltyper finns en lista över möjliga feltyper och deras svarskoder.

Ytterligare resurser additional-resources

Ytterligare användbar information från dokumentationen för SAP finns nedan:

Changelog

I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.