Integrieren des Adobe Experience Platform Mobile SDK mit Commerce
Durch die Integration von Adobe Experience Platform Mobile SDK in die mobile Commerce-App können Händler Commerce Ereignisdaten an die Experience Platform senden.
Wenn Commerce-Ereignisdaten am Edge verfügbar sind, können sie von anderen Adobe Experience Cloud-Anwendungen aufgerufen werden. Beispielsweise können Sie die Daten zum Erstellen von Zielgruppen in Real-Time CDP verwenden und diese Zielgruppen zur Personalisierung Ihrer mobilen Commerce-App verwenden.
Konfiguration
Um mit der Verwendung des Adobe Experience Platform Mobile SDK mit Commerce zu beginnen, installieren und konfigurieren Sie das SDK im Experience Platform. Schließen Sie dann die Konfiguration in Commerce ab.
Experience Platform
-
Informieren Sie sich über die Funktionen mobiler Apps, indem Sie sich das Tutorial Adobe Experience Cloud in mobilen Apps ansehen.
-
Installieren und konfigurieren Sie das SDK im Experience Platform.
note note NOTE Das Schema, das Sie auf der Experience Platform erstellen und konfigurieren, ist dasselbe Schema, das Sie im Anwendungscode Ihrer mobilen Commerce-App verwenden.
Commerce
Nachdem Sie die SDK-Konfiguration für die Experience Platform abgeschlossen haben, fügen Sie die SDK-Konfiguration zu Commerce hinzu.
-
Um Commerce-Ereignisdaten über das SDK an die Experience Platform zu senden, müssen Sie ein XDM-Schema im Anwendungscode angeben. Dieses Schema muss mit dem Schema configured für das SDK in der Experience Platform übereinstimmen.
Das folgende Beispiel zeigt, wie das
web.webpagedetails.pageViews
-Ereignis verfolgt und dasidentityMap
mithilfe des E-Mail-Felds festgelegt wird.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. Beispiel:
- Debug: http://debug.commerceSite.cloud/graphql/
- Release: http://release.commerceSite.cloud/graphql/
-
Um Daten aus den Commerce GraphQL-Endpunkten abzurufen, generieren Sie zunächst die erforderlichen Dateien und Ordner in Ihrem Projekt mithilfe des Apollo Code Generator.
-
Installieren Sie im Projektverzeichnis install Apollo iOS.
-
Initialisieren Sie die 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 Datei "
apollo-codegen-configuration.json
"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" } }
-
Rufen Siedas Commerce GraphQL-Schema ab.
Stellen Sie sicher, dass der Pfad zur Datei "
./apollo-codegen-config.json
" ist, die den Verweis auf das Commerce GraphQL-Schema enthält. -
Generieren Sie den Quellcode.
Stellen Sie sicher, dass der Pfad zur Datei "
./apollo-codegen-config.json
" ist, die die Konfigurationsinformationen enthält, um die erforderlichen Dateien und Ordner zu generieren. -
Fügen Sie im neu erstellten Ordner GraphQLGenerated GraphQL-Typen hinzu oder bearbeiten Sie sie. Sie können beispielsweise den Typ
DynamicBlocks.graphql
mit folgendem Inhalt hinzufügen:code language-graphql query dynamicBlocks($input: DynamicBlocksFilterInput){ dynamicBlocks(input: $input) { items { content { html } } } }
Sie haben jetzt das Adobe Experience Platform Mobile SDK in Ihre Commerce Mobile App integriert. Ereignisdaten fließen von Ihrer App an die Experience Platform Edge.
-
So unterscheiden Sie Commerce-Ereignisse, die aus Apps generiert wurden
Alle Ereignisse enthalten ein Feld namens channel
. Das Feld channel
enthält channel._id
und channel._type
, die für eine Luma-Storefront Namespace-Werte von "https://ns.adobe.com/xdm/channels/web"
bzw. "https://ns.adobe.com/xdm/channel-types/web"
aufweisen. 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, um Warenkorbpreisregeln, dynamische Bausteine und zugehörige Produktregeln zu informieren, finden Sie unter Audience Activation.