SAP Commerce-Verbindung

SAP Commerce, früher bekannt als Hybris, ist eine Cloud-basierte E-Commerce-Plattform-Lösung für B2B- und B2C-Unternehmen und steht als Teil des SAP Customer Experience Portfolios zur Verfügung. SAP Subscription Billing ist ein Produkt aus dem Portfolio und ermöglicht durch standardisierte Integrationen ein vollständiges Abonnement-Lifecycle-Management mit vereinfachten Verkaufs- und Zahlungserlebnissen.

Dieses Adobe Experience Platform Ziel verwendet die SAP Subscription Billing Customer Management API, um Ihre Kundendaten innerhalb von SAP Commerce aus einer bestehenden Experience Platform-Zielgruppe nach der Aktivierung zu aktualisieren.

Anweisungen zur Authentifizierung bei Ihrer SAP Commerce-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.

Anwendungsfälle use-cases

Damit Sie besser verstehen können, wie und wann Sie das SAP Commerce-Ziel verwenden sollten, finden Sie hier ein Anwendungsbeispiel, das für Kundinnen und Kunden von Adobe Experience Platform mit diesem Ziel geeignet ist.

SAP Commerce Kunden speichern Informationen über Einzelpersonen oder Organisationseinheiten, die mit Ihrem Unternehmen interagieren. Ihr Team verwendet die in SAP Commerce vorhandenen Kunden, um die Experience Platform-Zielgruppen zu erstellen. Nachdem diese Zielgruppen an SAP Commerce gesendet wurden, werden ihre Informationen aktualisiert und jedem Kunden wird eine Eigenschaft mit dem Wert als Zielgruppenname zugewiesen, der angibt, zu welcher Zielgruppe der Kunde gehört.

Voraussetzungen prerequisites

In den folgenden Abschnitten finden Sie alle Voraussetzungen, die Sie in Experience Platform und SAP Commerce einrichten müssen, sowie Informationen, die Sie vor der Arbeit mit dem SAP Commerce-Ziel sammeln müssen.

Voraussetzungen für Experience Platform prerequisites-in-experience-platform

Bevor Sie Daten für das SAP Commerce-Ziel aktivieren, müssen Sie ein Schema, einen Datensatz und Audiences in Experience Platform erstellt haben.

Weitere Informationen finden Sie in der Experience PlatformDokumentation für die Schemafeldgruppe „Details zur Zielgruppenzugehörigkeit , wenn Sie Anleitungen zu Zielgruppenstatus benötigen.

Voraussetzungen für das SAP Commerce Ziel prerequisites-destination

Beachten Sie die folgenden Voraussetzungen, um Daten aus Experience Platform in Ihr SAP Commerce-Konto zu exportieren:

Sie müssen über ein SAP Subscription Billing Konto verfügen prerequisites-account

Um Daten aus Experience Platform in Ihr SAP Commerce-Konto zu exportieren, benötigen Sie ein SAP Subscription Billing. Wenn Sie kein gültiges Abrechnungskonto haben, wenden Sie sich an Ihren SAP Account Manager. Weitere Informationen finden Sie SAP Dokument ​Platform-Konfiguration“.

Generieren eines Service-Schlüssels 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"
}

Erstellen benutzerdefinierter Verweise in SAP Subscription Billing prerequisites-custom-reference

Um den Experience Platform-Zielgruppenstatus in SAP Subscription Billing zu aktualisieren, benötigen Sie ein benutzerdefiniertes Referenzfeld für jede in Experience Platform ausgewählte Zielgruppe.

Um die benutzerdefinierten Verweise zu erstellen, melden Sie sich bei Ihrem SAP Subscription Billing-Konto an und navigieren Sie zur [Stammdaten und Konfiguration] > [Benutzerdefinierte Verweise]. Wählen Sie als Nächstes Create aus, um für jede in Experience Platform ausgewählte Zielgruppe eine neue Referenz hinzuzufügen. Sie benötigen diese Referenzfeldnamen im nachfolgenden Schritt Planen des Zielgruppenexports und Beispiel.

Nachfolgend finden Sie ein Beispiel für das Erstellen eines benutzerdefinierten Reference Type in SAP Subscription Billing:

Weitere Anleitungen finden Sie in der Dokumentation SAP Subscription Billing Benutzerdefinierte ​).

Sammeln erforderlicher Anmeldedaten gather-credentials

Um SAP Commerce mit Experience Platform zu verbinden, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben:

Leitlinien guardrails

API-Anfragen an den SAP Cloud Management service unterliegen Ratenbeschränkungen. Wenn das Ratenlimit überschritten wird, wird der Status-Code einer HTTP 429 Too Many Requests Antwort angezeigt.

Unterstützte Identitäten supported-identities

SAP Commerce unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.

Unterstützte Zielgruppen supported-audiences

In diesem Abschnitt werden alle Zielgruppen beschrieben, die Sie an dieses Ziel exportieren können.

Dieses Ziel unterstützt die Aktivierung aller durch die Experience Platform generierten Zielgruppen über den Segmentierungsdienst.

Dieses Ziel unterstützt auch die Aktivierung der in der folgenden Tabelle beschriebenen Zielgruppen.

Exporttyp und -häufigkeit export-type-frequency

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Herstellen einer Verbindung mit dem Ziel connect

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.

Suchen Sie in Destinations > Catalog nach SAP Commerce. Alternativ können Sie es unter der Kategorie eCommerce finden.

Beim Ziel authentifizieren authenticate

Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden ​ im Abschnitt ​ eines Dienstschlüssels .

Um sich beim Ziel zu authentifizieren, wählen Sie Connect to destination aus.

Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche einen Connected mit einem grünen Häkchen an. Sie können dann mit dem nächsten Schritt fortfahren.

Ausfüllen der Zieldetails destination-details

Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.

Aktivieren von Warnhinweisen enable-alerts

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.

Wenn Sie mit dem Eingeben der Details für Ihre Zielverbindung fertig sind, wählen Sie Next aus.

Aktivieren von Zielgruppen für dieses Ziel activate

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.

Zuordnen von Attributen und Identitäten map

Um Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an das SAP Commerce Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Experience Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen. Gehen Sie wie folgt vor, um Ihre XDM-Felder den SAP Commerce-Zielfeldern korrekt zuzuordnen:

customerNumberSAP Identität zuordnen

Die customerNumberSAP Identität ist eine obligatorische Zuordnung für dieses Ziel. Gehen Sie wie folgt vor, um sie zuzuordnen:

Nachfolgend finden Sie ein Beispiel mit der Identitätszuordnung:

Zuordnungsattribute

Um weitere Attribute hinzuzufügen, die Sie zwischen Ihrem XDM-Profilschema und Ihrem SAP Subscription Billing-Konto aktualisieren möchten, wiederholen Sie die folgenden Schritte:

Dem ausgewählten Kundentyp mandatory Attribute zuordnen

Obligatorische Attributzuordnungen hängen von der ausgewählten Type of Customer ab. Um die obligatorischen Attribute zuzuordnen, wählen Sie aus den folgenden Optionen aus:

Zuordnen zusätzlicher Attribute

Anschließend können Sie wie unten dargestellt zusätzliche Zuordnungen zwischen Ihrem XDM-Profilschema und den SAP Subscription Billingschema-Attributen für einen Kunden hinzufügen:

Wenn Sie mit dem Eingeben der Zuordnungen für Ihre Zielverbindung fertig sind, wählen Sie Next aus.

Planen des Zielgruppenexports und Beispiel schedule-segment-export-example

Bei der Durchführung des Schritts Planen des ​-Exports) müssen Sie Experience Platform-Zielgruppen manuell den Attributen in SAP Subscription Billing zuordnen.

Ein Beispiel für den Schritt Zielgruppenexport planen mit hervorgehobener Position des SAP Commerce Mapping ID wird unten angezeigt:

Wählen Sie dazu jedes Segment aus und geben Sie dann den Namen der benutzerdefinierten Referenz aus SAP Subscription Billing in das Feld SAP Commerce Mapping ID-Ziel-Connector ein. Anleitungen zum Erstellen benutzerdefinierter Verweise finden Sie im Abschnitt Erstellen benutzerdefinierter Verweise in SAP Subscription Billing.

IMPORTANT

Verwenden Sie nicht die benutzerdefinierte Referenzbeschriftung als Wert.
​>

Wenn Ihre ausgewählte Experience Platform-Zielgruppe beispielsweise sap_audience1 ist und Sie möchten, dass ihr Status in der SAP Subscription Billing Benutzerdefinierter Verweis SAP_1 aktualisiert wird, geben Sie diesen Wert im Feld SAP_Commerce Mapping ID an.

Nachfolgend finden Sie ein Beispiel Reference Type von SAP Subscription Billing:

Ein Beispiel für den Schritt „Zielgruppenexport planen“, bei dem eine Zielgruppe ausgewählt und die entsprechende SAP Commerce hervorgehoben Mapping ID, finden Sie unten:

Wie gezeigt, sollte der Wert im Feld Mapping ID genau mit dem SAP Subscription Billing Reference Type übereinstimmen.

Wiederholen Sie diesen Abschnitt für jede aktivierte Experience Platform-Zielgruppe.

Basierend auf der Abbildung oben, in der Sie zwei Zielgruppen ausgewählt haben, würde die Zuordnung wie folgt aussehen:

Überprüfen des Datenexports exported-data

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

Melden Sie sich beim SAP Subscription Billing-Konto an und navigieren Sie dann zur Seite Contacts , um den Status der Zielgruppe zu überprüfen. Die Liste kann so konfiguriert werden, dass Spalten für die benutzerdefinierten Verweise und die entsprechenden Zielgruppenstatus angezeigt werden.

Datennutzung und -Governance data-usage-governance

Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance – Übersicht.

Fehler und Fehlerbehebung errors-and-troubleshooting

Auf der Dokumentationsseite SAP Subscription Billing Fehlertypen finden Sie eine Liste der möglichen Fehlertypen und ihrer Antwort-Codes.

Weitere Ressourcen additional-resources

Weitere nützliche Informationen aus der SAP Dokumentation finden Sie unten:

Änderungsprotokoll

In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.