Integración del SDK de Adobe Experience Platform Mobile con Commerce

IMPORTANT
El SDK de Adobe Experience Platform Mobile para iOS es compatible con iOS 11 o posterior.

La integración del SDK de Adobe Experience Platform Mobile con la aplicación móvil de Commerce permite a los comerciantes enviar datos de evento de Commerce al perímetro del Experience Platform.

Cuando los datos de evento de Commerce están disponibles en el perímetro, otras aplicaciones de Adobe Experience Cloud pueden acceder a ellos. Por ejemplo, puede usar los datos para crear audiencias en Real-Time CDP y luego usar esas audiencias para personalizar su aplicación móvil de Commerce.

Configuración

Para empezar a utilizar el SDK de Adobe Experience Platform Mobile con Commerce, instale y configure el SDK en el Experience Platform. A continuación, finalice la configuración en Commerce.

Experience Platform

  1. Obtenga información acerca de las funcionalidades de la aplicación móvil al revisar el tutorial de Adobe Experience Cloud en aplicaciones móviles.

  2. Instalar y configurar el SDK en el Experience Platform.

    note note
    NOTE
    El esquema que cree y configure en el Experience Platform es el mismo que utiliza en el código de la aplicación en la aplicación móvil de Commerce.

Commerce

Una vez completada la configuración del SDK para Experience Platform, añada la configuración del SDK a Commerce.

  1. Para enviar datos de evento de Commerce al Experience Platform mediante el SDK, debe proporcionar un esquema XDM en el código de la aplicación. Este esquema debe coincidir con el esquema configured para el SDK en el Experience Platform.

    El siguiente ejemplo muestra cómo realizar un seguimiento del evento web.webpagedetails.pageViews y establecer identityMap mediante el campo de correo electrónico.

    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. Conéctese al entorno de Commerce Cloud.

    En la configuración de compilación del proyecto, agregue la dirección URL al extremo de Commerce GraphQL. Por ejemplo:

    • Depuración: http://debug.commerce.site.cloud/graphql/
    • Versión: http://release.commerce.cloud/graphql/
  3. Para recuperar datos de los extremos de Commerce GraphQL, genere primero los archivos y directorios necesarios en su proyecto mediante Apollo Code Generator.

    1. Desde el directorio de tu proyecto, instala Apollo iOS.

    2. Inicializar la CLI de Apollo Codegen.

      Esto crea un archivo de apollo-codegen-configuration.json.

    3. Genere los archivos y directorios GraphQL necesarios en su proyecto reemplazando el contenido del archivo apollo-codegen-configuration.json por el siguiente:

      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. Recuperar el esquema de Commerce GraphQL.

      Asegúrese de que la ruta de acceso es al archivo ./apollo-codegen-config.json, que contiene la referencia al esquema de Commerce GraphQL.

    5. Generar el código fuente.

      Asegúrese de que la ruta de acceso es al archivo ./apollo-codegen-config.json, que contiene la información de configuración para generar los archivos y directorios necesarios.

    6. En la carpeta GraphQLGenerated recién creada, agregue o edite tipos de GraphQL. Por ejemplo, puede agregar un tipo DynamicBlocks.graphql con el siguiente contenido:

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

    Ya ha integrado el SDK de Adobe Experience Platform Mobile con su aplicación móvil de Commerce. Los datos de eventos fluyen desde la aplicación al perímetro del Experience Platform.

Cómo distinguir los eventos de Commerce generados desde aplicaciones móviles

Todos los eventos contienen un campo llamado channel. El campo channel contiene channel._id y channel._type, que para una tienda de Luma tienen valores de área de nombres de "https://ns.adobe.com/xdm/channels/web" y "https://ns.adobe.com/xdm/channel-types/web" respectivamente. Sin embargo, para una tienda móvil, los valores de área de nombres son "https://ns.adobe.com/xdm/channels/mobile-app" y "https://ns.adobe.com/xdm/channel-types/mobile" respectivamente.

Pasos siguientes

Para obtener información sobre cómo recuperar audiencias de Real-Time CDP desde la aplicación móvil de Commerce con el fin de informar las reglas de precios del carro de compras, los bloques dinámicos y las reglas de productos relacionadas, consulta Audience Activation.

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