Integrar o SDK do Adobe Experience Platform Mobile ao Commerce

Saiba mais sobre os recursos do aplicativo móvel consultando o tutorial sobre Adobe Experience Cloud em aplicativos móveis.

Instalar e configurar o SDK no Experience Platform.

Para enviar dados do evento do Commerce para o Experience Platform pelo SDK, você deve fornecer um esquema XDM no código do aplicativo. Este esquema deve corresponder ao esquema configurado para o SDK no Experience Platform.

O exemplo a seguir mostra como rastrear o evento web.webpagedetails.pageViews e definir o identityMap usando o campo de email.

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)

Conecte-se ao ambiente de Commerce Cloud.

Nas configurações de build do seu projeto, adicione o URL ao endpoint do Commerce GraphQL. Tais como:

• Depuração: http://debug.commerce.cloud/graphql/
• Versão: http://release.commerce.cloud/graphql/

Para recuperar dados dos pontos de extremidade do Commerce GraphQL, gere primeiro os arquivos e diretórios necessários em seu projeto usando o Gerador de código Apollo.

1. No diretório do projeto, instale o Apollo iOS.

2. Inicialize a CLI do Codegen Apollo.

   Isso cria um arquivo apollo-codegen-configuration.json.

3. Gere os arquivos e diretórios necessários do GraphQL em seu projeto substituindo o conteúdo do arquivo apollo-codegen-configuration.json pelo seguinte:

   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. Buscar o esquema do Commerce GraphQL.

   Verifique se o caminho é para o arquivo ./apollo-codegen-config.json, que contém a referência ao esquema do Commerce GraphQL.

5. Gerar o código-fonte.

   Verifique se o caminho é para o arquivo ./apollo-codegen-config.json, que contém as informações de configuração para gerar os arquivos e diretórios necessários.

6. Na pasta GraphQLGenerated recém-criada, adicione ou edite tipos de GraphQL. Por exemplo, você pode adicionar um tipo DynamicBlocks.graphql com o seguinte conteúdo:

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

Agora você integrou o Adobe Experience Platform Mobile SDK ao seu aplicativo móvel Commerce. Os dados do evento fluem do seu aplicativo para a borda do Experience Platform.