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.

Integración de SDK de Adobe Experience Platform Mobile con la aplicación móvil de Commerce permite a los comerciantes enviar contenido comercial datos de evento hasta el borde 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 utilizar 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 revisando la Tutorial de Adobe Experience Cloud en aplicaciones móviles.

  2. Instalación y configuración el SDK en el Experience Platform.

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

Comercio

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 comercio 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 configurado para el SDK en el Experience Platform.

    El siguiente ejemplo muestra cómo realizar un seguimiento de la variable web.webpagedetails.pageViews y configure el identityMap uso del 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 URL al extremo de Commerce GraphQL. Por ejemplo:

    • Depurar: http://depurar.commerce.cloud/graphql/
    • Versión: http://versión.commerce.cloud/graphql/
  3. Para recuperar datos de los extremos de Commerce GraphQL, genere primero los archivos y directorios necesarios en el proyecto utilizando Generador de códigos Apollo.

    1. Desde el directorio del proyecto, instalar Apolo iOS.

    2. Inicializar la CLI de Apollo Codegen.

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

    3. Genere los archivos y directorios GraphQL necesarios en su proyecto reemplazando el contenido del apollo-codegen-configuration.json archivo con lo 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. Buscar el esquema de Commerce GraphQL.

      Asegúrese de que la ruta es a ./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 es a ./apollo-codegen-config.json , que contiene la información de configuración para generar los archivos y directorios necesarios.

    6. Dentro del recién creado GraphQLGenerated , agregue o edite tipos de GraphQL. Por ejemplo, puede agregar un DynamicBlocks.graphql escriba con el siguiente contenido:

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

    Ahora ha integrado el SDK móvil de Adobe Experience Platform 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 comercio generados a partir de aplicaciones móviles

Todo eventos contiene un campo llamado channel. El channel el campo contiene channel._id y channel._type que para una tienda de Luma tiene 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 de comercio móvil para informar sobre reglas de precios del carro de compras, bloques dinámicos y reglas de productos relacionadas, consulte Audience Activation.

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