Integrieren von Adobe Experience Platform Mobile SDK mit Commerce
Durch die Integration von Adobe Experience Platform Mobile SDK mit der Commerce Mobile App können Händler Commerce-Ereignisdaten an den Experience Platform-Edge senden.
Wenn Commerce-Ereignisdaten am Edge verfügbar sind, können andere Adobe Experience Cloud-Programme darauf zugreifen. Sie können die Daten beispielsweise verwenden, um Zielgruppen in Real-Time CDP zu erstellen, und dann diese Zielgruppen verwenden um Ihre Mobile App von Commerce zu personalisieren.
Konfiguration
Installieren und konfigurieren Sie SDK auf der Experience Platform, um mit der Verwendung der Adobe Experience Platform Mobile SDK mit Commerce zu beginnen. Schließen Sie dann Ihre Konfiguration in Commerce ab.
Experience Platform
-
Erfahren Sie mehr über die Funktionen mobiler Apps durch das Tutorial zu Adobe Experience Cloud in Mobile Apps.
-
Installieren und Konfigurieren der SDK in Experience Platform.
note note NOTE Das Schema, das Sie auf der Experience Platform erstellen und konfigurieren, entspricht dem Schema, das Sie im Anwendungscode in Ihrer Commerce Mobile App verwenden.
Commerce
Nachdem Sie die SDK-Konfiguration für Experience Platform abgeschlossen haben, fügen Sie die SDK-Konfiguration zu Commerce hinzu.
-
Um Commerce-Ereignisdaten über die SDK an die Experience Platform zu senden, müssen Sie ein XDM-Schema im Anwendungs-Code angeben. Dieses Schema muss mit dem Schema ()SDK auf der Experience Platform übereinstimmen.
Das folgende Beispiel zeigt, wie Sie das
web.webpagedetails.pageViews
-Ereignis verfolgen und dieidentityMap
mithilfe des E-Mail-Felds festlegen.code language-swift let stateName = "luma: content: ios: us: en: home" var xdmData: [String: Any] = [ "eventType": "web.webpagedetails.pageViews", "web": [ "webPageDetails": [ "pageViews": [ "value": 1 ], "name": "Home page" ] ] ] let experienceEvent = ExperienceEvent(xdm: xdmData) Edge.sendEvent(experienceEvent: experienceEvent) // Adobe Experience Platform - Update Identity let emailLabel = "mobileuser@example.com" let identityMap: IdentityMap = IdentityMap() identityMap.add(item: IdentityItem(id: emailLabel), withNamespace: "Email") Identity.updateIdentities(with: identityMap)
-
Stellen Sie eine Verbindung zur Commerce Cloud-Umgebung her.
Fügen Sie in den Build-Einstellungen Ihres Projekts die URL zum Commerce GraphQL-Endpunkt hinzu. Beispielsweise:
- Debug: http://debug.commerceSite.cloud/graphql/
- Version: http://release.commerceSite.cloud/graphql/
-
Um Daten von den Commerce GraphQL-Endpunkten abzurufen, generieren Sie zunächst die erforderlichen Dateien und Ordner in Ihrem Projekt mithilfe des Apollo Code Generator.
-
Wählen Sie im Projektverzeichnis install Apollo iOS aus.
-
Initialisieren der Apollo Codegen-CLI.
Dadurch wird eine
apollo-codegen-configuration.json
Datei erstellt. -
Generieren Sie die erforderlichen GraphQL-Dateien und -Ordner in Ihrem Projekt, indem Sie den Inhalt der
apollo-codegen-configuration.json
-Datei durch Folgendes ersetzen:code language-json { "schemaName" : "MagentoAPI", "input" : { "operationSearchPaths" : [ "**/*.graphql" ], "schemaSearchPaths" : [ "**/*.graphqls" ] }, "output" : { "testMocks" : { "none" : { } }, "schemaTypes" : { "path" : "../MagentoAPI", "moduleType" : { "swiftPackageManager" : { } } }, "operations" : { "inSchemaModule" : { } } }, "schemaDownloadConfiguration": { "downloadMethod": { "introspection": { "endpointURL": "http://magento24.com/graphql/", "httpMethod": { "POST": {} }, "includeDeprecatedInputValues": false, "outputFormat": "SDL" } }, "downloadTimeout": 60, "headers": [], "outputPath": "magento.graphqls" } }
-
Abrufen des Commerce GraphQL-Schemas.
Stellen Sie sicher, dass der Pfad zur
./apollo-codegen-config.json
-Datei lautet, die den Verweis auf das Commerce GraphQL-Schema enthält. -
Generieren des Quell-Codes
Stellen Sie sicher, dass der Pfad zur
./apollo-codegen-config.json
-Datei ist, die die Konfigurationsinformationen zum Generieren der erforderlichen Dateien und Verzeichnisse enthält. -
Fügen Sie innerhalb des neu erstellten GraphQLGenerated-Ordners GraphQL-Typen hinzu oder bearbeiten Sie sie. Sie können beispielsweise einen
DynamicBlocks.graphql
mit folgendem Inhalt hinzufügen:code language-graphql query dynamicBlocks($input: DynamicBlocksFilterInput){ dynamicBlocks(input: $input) { items { content { html } } } }
Sie haben jetzt Adobe Experience Platform Mobile SDK in Ihre Commerce Mobile App integriert. Ereignisdaten fließen von Ihrer App zum Experience Platform-Edge.
-
So unterscheidet man von Mobile Apps generierte Commerce-Ereignisse
Alle Ereignisse enthalten ein Feld namens channel
. Das Feld channel
enthält channel._id
und channel._type
, für die eine Luma-Storefront über Namespace-Werte von "https://ns.adobe.com/xdm/channels/web"
bzw. "https://ns.adobe.com/xdm/channel-types/web"
verfügt. Bei einer mobilen Storefront sind die Namespace-Werte jedoch "https://ns.adobe.com/xdm/channels/mobile-app"
bzw. "https://ns.adobe.com/xdm/channel-types/mobile"
.
Nächste Schritte
Informationen zum Abrufen von Real-Time CDP-Zielgruppen aus Ihrer mobilen Commerce-App mit Informationen zu Warenkorbpreisregeln, dynamischen Blöcken und zugehörigen Produktregeln finden Sie unter Audience Activation.