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
-
Mit dem Dienstschlüssel SAP Commerce können Sie über Experience Platform auf die SAP Subscription Billing -API zugreifen. Informationen zum Erstellen eines Dienstschlüssels finden Sie unter SAP Commerce Erstellen eines Dienstschlüssels mit Client-ID und Client-Geheimnis . SAP Commerce erfordert Folgendes:
- Client-ID
- Client-Geheimnis
- URL. Das URL-Muster lautet wie folgt:
https://subscriptionbilling.authentication.eu10.hana.ondemand.com
. Dieser Wert wird später verwendet, um Werte fürRegion
undEndpoint
zu erhalten.
code language-json |
---|
|
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:
clientId
aus dem Dienstschlüssel.clientSecret
aus dem Dienstschlüssel.url
aus dem Dienstschlüssel ist ähnlich wie https://subscriptionbilling.authentication.eu10.hana.ondemand.com
.url
vorhanden und hat einen Wert ähnlich dem Wert eu10
oder us10
. Wenn der url
beispielsweise https://eu10.revenue.cloud.sap/api
ist, benötigen Sie eu10
.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.
customerNumberSAP
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.
- Sie exportieren alle Mitglieder einer Zielgruppe zusammen mit den gewünschten Schemafeldern (z. B. E-Mail-Adresse, Telefonnummer, Nachname) gemäß Ihrer Feldzuordnung.
- Für jede ausgewählte Zielgruppe in Platform wird das entsprechende zusätzliche Attribut SAP Commerce mit dem Zielgruppenstatus von Platform aktualisiert.
- Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Wenn ein Profil auf der Grundlage einer Zielgruppenbewertung im Experience Platform aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.
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 .
clientId
aus dem Dienstschlüssel.clientSecret
aus dem Dienstschlüssel.url
aus dem Dienstschlüssel ist ähnlich wie https://subscriptionbilling.authentication.eu10.hana.ondemand.com
.url
vorhanden und hat einen Wert ähnlich dem Wert eu10
oder us10
. Wenn der url
beispielsweise https://eu10.revenue.cloud.sap/api
ist, benötigen Sie eu10
.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.
- Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
- Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
- Typ des Kunden: Wählen Sie je nach den Entitäten in Ihrer Audience entweder Individuell oder Unternehmen aus. Das SAP Subscription Billing schema schaltet die erforderlichen Felder abhängig von dieser Auswahl um, die dem Attribut
customerType
zugeordnet ist. Wenn die Auswahl Unternehmen ist, werden die obligatorischen Zuordnungen wiefirstName
undlastName
ignoriert, die für einen einzelnen Kunden erforderlich sind, undcompany
wird obligatorisch und umgekehrt.
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
- Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
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:
- Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird jetzt eine neue Zuordnungszeile angezeigt.
- Wählen Sie im Fenster Quellfeld auswählen den Namen Identitäts-Namespace auswählen und danach
customerNumberSAP
aus.
- Wählen Sie im Fenster Zielfeld auswählen den Namen Identitäts-Namespace auswählen und wählen Sie die Identität
customerNumber
aus.
IdentityMap: customerNumberSAP
Identity: customerNumber
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:
- Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird jetzt eine neue Zuordnungszeile angezeigt.
- Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und danach das XDM-Attribut aus.
- Wählen Sie im Fenster Zielfeld auswählen die Kategorie Benutzerdefinierte Attribute auswählen und geben Sie den Namen des Attributs SAP Subscription Billing aus der Liste der Kundenattribute schema ein.
country
, wo Sie stattdessen countryCode
verwenden sollten. SAP Subscription Billing unterstützt Alpha-2 (ISO 3166)-Ländercodes. Beim Wert wird zwischen 0 und 3 Zeichen unterschieden. Stellen Sie daher sicher, dass Sie genau so angeben, wie Sie es definieren, da sonst Fehler auftreten würden: The country code {} does not exist
oder size must be between 0 and 3
.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:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Quellfeld | Zielfeld | Obligatorisch |
xdm: person.lastName |
Attribute: lastName |
Ja |
xdm: workAddress.countryCode |
Attribute: countryCode |
Ja |
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Quellfeld | Zielfeld | Obligatorisch |
xdm: b2b.companyName |
Attribute: company |
Ja |
xdm: workAddress.countryCode |
Attribute: countryCode |
Ja |
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:
table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
---|---|---|
Quellfeld | Zielfeld | Obligatorisch |
xdm: person.name.firstName |
Attribute: firstName |
Nein |
xdm: workAddress.street1 |
Attribute: street |
Nein |
xdm: workAddress.city |
Attribute: city |
Nein |
Nachfolgend finden Sie ein Beispiel mit obligatorischen und optionalen Attributzuordnungen, bei denen der Kunde eine Person ist:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
Quellfeld | Zielfeld | Obligatorisch |
xdm: workAddress.street1 |
Attribute: street |
Nein |
xdm: workAddress.city |
Attribute: city |
Nein |
Nachfolgend finden Sie ein Beispiel mit obligatorischen und optionalen Attributzuordnungen, bei denen der Kunde ein Unternehmen ist:
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 .
![Bild, das angibt, dass Sie den benutzerdefinierten Referenzbeschriftungswert nicht für die Zuordnung verwenden sollten.](./media_1e8ab7aa5d6d02ba2078cebf94a546a4da1b68d4b.png?width=750&format=png&optimize=medium)
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.
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
Veröffentlichungsmonat | Art der Aktualisierung | Beschreibung |
Januar 2024 | Erstmalige Veröffentlichung | Erste Zielversion und Veröffentlichung der Dokumentation. |