Integrar o SDK do Adobe Experience Platform Mobile ao Commerce

IMPORTANT
O SDK do Adobe Experience Platform Mobile para iOS é compatível com o iOS 11 ou posterior.

Integrando o Adobe Experience Platform Mobile SDK com o aplicativo móvel Commerce permite que os comerciantes enviem dados do evento para a borda do Experience Platform.

Quando os dados do evento do Commerce estiverem disponíveis na borda, eles poderão ser acessados por outros aplicativos da Adobe Experience Cloud. Por exemplo, você pode usar os dados para criar públicos no Real-Time CDP e usar esses públicos para personalizar seu aplicativo móvel do Commerce.

Configuração

Para começar a usar o Adobe Experience Platform Mobile SDK com o Commerce, instale e configure o SDK no Experience Platform. Em seguida, finalize sua configuração no Commerce.

Experience Platform

  1. Saiba mais sobre os recursos do aplicativo móvel revisando o Tutorial do Adobe Experience Cloud em aplicativos para dispositivos móveis.

  2. Instalar e configurar o SDK no Experience Platform.

    note note
    NOTE
    O esquema criado e configurado no Experience Platform é o mesmo esquema usado no código do aplicativo no aplicativo móvel do Commerce.

Commerce

Após concluir a configuração do SDK para a Experience Platform, adicione a configuração do SDK ao Commerce.

  1. Para enviar dados do evento do Commerce para o Experience Platform por meio do 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 web.webpagedetails.pageViews e defina o identityMap usando o campo email.

    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)
    
  2. Conecte-se ao ambiente de Commerce Cloud.

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

    • Depuração: http://depurar.commercesite.cloud/graphql/
    • Versão: http://versão.commercesite.cloud/graphql/
  3. Para recuperar dados dos endpoints do Commerce GraphQL, primeiro gere os arquivos e diretórios necessários em seu projeto usando o Gerador de código Apollo.

    1. No diretório do projeto, instalar Apollo iOS.

    2. Inicializar a CLI do Codegen da Apollo.

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

    3. Gere os arquivos e diretórios necessários do GraphQL em seu projeto substituindo o conteúdo do apollo-codegen-configuration.json arquivo com o 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 schema Commerce GraphQL.

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

    5. Gerar o código-fonte.

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

    6. Dentro do recém-criado GraphQLGenerated pasta, adicione ou edite tipos de GraphQL. Por exemplo, é possível adicionar um DynamicBlocks.graphql digite 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 do Commerce. Os dados do evento fluem do seu aplicativo para a borda do Experience Platform.

Como distinguir eventos de comércio gerados de aplicativos móveis

Todos events contém um campo chamado channel. A variável channel o campo contém channel._id e channel._type que para uma loja Luma tem valores de namespace de "https://ns.adobe.com/xdm/channels/web" e "https://ns.adobe.com/xdm/channel-types/web" respectivamente. No entanto, para uma loja de dispositivos móveis, os valores de namespace são "https://ns.adobe.com/xdm/channels/mobile-app" e "https://ns.adobe.com/xdm/channel-types/mobile" respectivamente.

Próximas etapas

Para saber como recuperar públicos-alvo da Real-Time CDP no aplicativo móvel do Commerce para informar regras de preço de carrinho, blocos dinâmicos e regras de produto relacionadas, consulte Audience Activation.

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840