Integrieren von Adobe Experience Platform Mobile SDK mit Commerce

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.

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 die identityMap mithilfe des E-Mail-Felds festlegen.

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.

1. Wählen Sie im Projektverzeichnis install Apollo iOS aus.

2. Initialisieren der Apollo Codegen-CLI.

   Dadurch wird eine apollo-codegen-configuration.json Datei erstellt.

3. 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" } }

4. 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.

5. 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.

6. 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.