SAP Commerce-Verbindung

SAP Commerce, früher als Hybris bezeichnet, ist eine Cloud-basierte E-Commerce-Plattform-Lösung für B2B- und B2C-Unternehmen und als Teil des SAP Customer Experience-Portfolios verfügbar. SAP Abonnement-Abrechnung ist ein Produkt im Portfolio und ermöglicht ein vollständiges Abonnementlebenszyklusmanagement mit vereinfachten Verkaufs- und Zahlungserlebnissen durch standardisierte Integrationen.

Dieses Adobe Experience Platform Ziel verwendet die SAP Subscription Billing Kunden-Management-API, um Ihre Kundendetails innerhalb von SAP Commerce von einer bestehenden Experience Platform-Audience 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 unter Experience Platform und SAP Commerce einrichten müssen, sowie Informationen, die Sie vor der Arbeit mit dem SAP Commerce-Ziel erfassen müssen.

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

Bevor Sie Daten für das Ziel SAP Commerce aktivieren, müssen Sie über ein Schema, einen Datensatz und Zielgruppen verfügen, die in Experience Platform erstellt wurden.

Informationen zum Zielgruppenstatus finden Sie in der Experience Platform-Dokumentation für die Schemakonferenz Zielgruppenzugehörigkeitsdetails .

Voraussetzungen für das SAP Commerce-Ziel prerequisites-destination

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

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

Um Daten von Platform in Ihr SAP Commerce -Konto zu exportieren, benötigen Sie ein SAP Subscription Billing -Konto. Wenn Sie kein gültiges Abrechnungskonto haben, wenden Sie sich an Ihren SAP -Kundenbetreuer. Weitere Informationen finden Sie im Dokument SAP Plattformkonfiguration .

Generieren eines Dienstschlü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 Platform ausgewählte Zielgruppe.

Um die benutzerdefinierten Verweise zu erstellen, melden Sie sich bei Ihrem SAP Subscription Billing -Konto an und navigieren Sie zur Seite [Master Data and Configuration] > [Custom References] . Wählen Sie als Nächstes Erstellen aus, um eine neue Referenz für jede in Platform ausgewählte Zielgruppe hinzuzufügen. Sie benötigen diese Referenzfeldnamen im nachfolgenden Schritt Zielgruppenexport planen und Beispiel .

Nachfolgend finden Sie ein Beispiel für die Erstellung eines benutzerdefinierten Verweistyps in SAP Subscription Billing:

Weitere Hinweise finden Sie in der Dokumentation zu SAP Subscription Billing benutzerdefinierten Verweisen .

Sammeln erforderlicher Anmeldeinformationen gather-credentials

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

Leitplanken guardrails

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

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 Ziele > Katalog nach SAP Commerce. Alternativ können Sie sie unter der Kategorie eCommerce finden.

Beim Ziel authentifizieren authenticate

Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden Sie im Abschnitt Einen Dienstschlüssel erstellen .

Um sich beim Ziel zu authentifizieren, wählen Sie Mit Ziel verbinden.

Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche den Status Verbunden 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 alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.

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 korrekt von Adobe Experience Platform an das Ziel SAP Commerce zu senden, müssen Sie den Schritt für die Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Platform-Konto und den jeweiligen Entsprechungen vom Ziel zu erstellen. Gehen Sie wie folgt vor, um Ihre XDM-Felder korrekt den SAP Commerce -Zielfeldern 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:

Zuordnen von Attributen

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:

mandatory Attribute für den ausgewählten Kundentyp zuordnen

Erforderliche Zuordnungen von Attributen hängen vom ausgewählten Typ des Kunden ab. Um die obligatorischen Attribute zuzuordnen, wählen Sie aus den folgenden Optionen aus:

Zuordnen zusätzlicher Attribute

Sie können dann alle weiteren Zuordnungen zwischen Ihrem XDM-Profilschema und den SAP Subscription Billing schema -Attributen für einen Kunden hinzufügen, wie unten dargestellt:

Wenn Sie die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Weiter aus.

Zielgruppenexport und Beispiel planen schedule-segment-export-example

Beim Ausführen des Schritts Zielgruppenexport planen müssen Sie Platform-Zielgruppen den Attributen in SAP Subscription Billing manuell zuordnen.

Ein Beispiel für den Schritt Zielgruppenexport planen , bei dem der Speicherort der SAP Commerce Zuordnungs-ID hervorgehoben ist, ist unten dargestellt:

Wählen Sie dazu jedes Segment aus und geben Sie dann den Namen des benutzerdefinierten Verweises aus SAP Subscription Billing in das Feld SAP Commerce Zuordnungs-ID Ziel-Connector ein. Eine Anleitung 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-Audience beispielsweise "sap_audience1"lautet und ihr Status in den benutzerdefinierten Verweis SAP Subscription Billing SAP_1 aktualisiert werden soll, geben Sie diesen Wert im Feld SAP_Commerce Zuordnungs-ID an.

Nachfolgend finden Sie ein Beispiel für den Referenztyp von SAP Subscription Billing:

Nachfolgend finden Sie ein Beispiel für den Schritt Zielgruppenexport planen , bei dem eine Zielgruppe ausgewählt und die zugehörige SAP Commerce Zuordnungs-ID hervorgehoben ist:

Wie gezeigt, sollte der Wert im Feld Zuordnungs-ID genau mit dem Wert SAP Subscription Billing Referenztyp übereinstimmen.

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

Basierend auf dem oben gezeigten Bild, in dem Sie zwei Zielgruppen ausgewählt haben, würde das Mapping wie folgt aussehen:
| SAP Commerce Zielgruppenname | SAP Subscription Billing Referenztyp | SAP Commerce ID-Wert zuordnen |
| — | — | — |
| sap_audience1 | SAP_1 | SAP_1 |
| SAP Audience2 | SAP_2 | SAP_2 |

Ü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 Konto SAP Subscription Billing an und navigieren Sie dann zur Seite Kontakte , um den Zielgruppenstatus zu überprüfen. Die Liste kann so konfiguriert werden, dass Spalten für die benutzerdefinierten Verweise angezeigt 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

Eine Liste der möglichen Fehlertypen und ihrer Antwortcodes finden Sie auf der Dokumentationsseite SAP Subscription Billing Fehlertypen .

Zusätzliche 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.