Integrare l’SDK di Adobe Experience Platform Mobile con Commerce

Scopri le funzionalità delle app mobili consultando l'esercitazione Adobe Experience Cloud nelle app per dispositivi mobili.

Installa e configura l'SDK in Experience Platform.

Per inviare i dati dell’evento Commerce all’Experience Platform tramite l’SDK, devi fornire uno schema XDM nel codice dell’applicazione. Questo schema deve corrispondere allo schema configurato per l'SDK nell'Experience Platform.

Nell'esempio seguente viene illustrato come tenere traccia dell'evento web.webpagedetails.pageViews e impostare identityMap utilizzando il campo e-mail.

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)

Connettersi all'ambiente Commerce Cloud.

Nelle impostazioni di build del progetto, aggiungi l’URL all’endpoint Commerce GraphQL. Ad esempio:

• Debug: http://debug.commerce.cloud/graphql/
• Versione: http://release.commerce.cloud/graphql/

Per recuperare i dati dagli endpoint Commerce GraphQL, genera innanzitutto i file e le directory necessari nel progetto utilizzando il generatore di codice Apollo.

1. Dalla directory del progetto, installa Apollo iOS.

2. Inizializzare l'interfaccia CLI del Codegen Apollo.

   Verrà creato un file apollo-codegen-configuration.json.

3. Generare i file e le directory GraphQL necessari nel progetto sostituendo il contenuto del file apollo-codegen-configuration.json con quanto segue:

   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. Recupera lo schema Commerce GraphQL.

   Verificare che il percorso sia del file ./apollo-codegen-config.json, che contiene il riferimento allo schema Commerce GraphQL.

5. Generare il codice sorgente.

   Verificare che il percorso sia del file ./apollo-codegen-config.json, che contiene le informazioni di configurazione per generare i file e le directory necessari.

6. Nella cartella GraphQLGenerated appena creata, aggiungi o modifica i tipi di GraphQL. Ad esempio, è possibile aggiungere un tipo DynamicBlocks.graphql con il seguente contenuto:

   code language-graphql
   query dynamicBlocks($input: DynamicBlocksFilterInput){ dynamicBlocks(input: $input) { items { content { html } } } }

Ora hai integrato l’SDK di Adobe Experience Platform Mobile con la tua app mobile Commerce. I dati dell’evento fluiscono dall’app all’edge dell’Experience Platform.