Integrera Adobe Experience Platform Mobile SDK med Commerce

IMPORTANT
Adobe Experience Platform Mobile SDK för iOS har stöd för iOS 11 eller senare.

Genom att integrera Adobe Experience Platform Mobile SDK med Commerce mobilapp kan handlare skicka Commerce händelsedata till Experience Platform.

När händelsedata från Commerce finns tillgängliga i kanten kan de nås av andra Adobe Experience Cloud-program. Du kan till exempel använda data för att skapa målgrupper i Real-Time CDP och sedan använda dessa målgrupper för att anpassa din Commerce-mobilapp.

Konfiguration

Om du vill komma igång med att använda Adobe Experience Platform Mobile SDK med Commerce installerar och konfigurerar du SDK i Experience Platform. Slutför sedan konfigurationen i Commerce.

Experience Platform

  1. Läs mer om mobilappsfunktioner i självstudiekursen Adobe Experience Cloud i mobilappar.

  2. Installera och konfigurera SDK i Experience Platform.

    note note
    NOTE
    Schemat som du skapar och konfigurerar i Experience Platform är samma schema som du använder i programkoden i din Commerce-mobilapp.

Commerce

När du har slutfört SDK-konfigurationen för Experience-plattformen lägger du till SDK-konfigurationen i Commerce.

  1. Om du vill skicka händelsedata från Commerce till Experience Platform via SDK måste du ange ett XDM-schema i programkoden. Det här schemat måste matcha schemat konfigurerat för SDK i Experience Platform.

    I följande exempel visas hur du spårar händelsen web.webpagedetails.pageViews och anger identityMap med hjälp av e-postfältet.

    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. Koppla upp dig till Commerce Cloud.

    Lägg till URL:en till slutpunkten för Commerce GraphQL i projektets bygginställningar. Till exempel:

    • Felsök: http://debug.commercialSite.cloud/graphql/
    • Version: http://release.commercialSite.cloud/graphql/
  3. Om du vill hämta data från slutpunkterna för Commerce GraphQL måste du först generera de filer och kataloger som behövs i ditt projekt med Apollo Code Generator.

    1. Installera Apollo iOS från projektkatalogen.

    2. Initiera Apollo Codegen CLI.

      Detta skapar en apollo-codegen-configuration.json-fil.

    3. Generera nödvändiga GraphQL-filer och -kataloger i ditt projekt genom att ersätta innehållet i filen apollo-codegen-configuration.json med följande:

      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. Hämta Commerce GraphQL-schemat.

      Kontrollera att sökvägen är till filen ./apollo-codegen-config.json som innehåller referensen till Commerce GraphQL-schemat.

    5. Generera källkoden.

      Kontrollera att sökvägen är till filen ./apollo-codegen-config.json, som innehåller konfigurationsinformationen för att generera de filer och kataloger som krävs.

    6. Lägg till eller redigera GraphQL-typer i den nyligen skapade GraphQLGenerated -mappen. Du kan till exempel lägga till en DynamicBlocks.graphql-typ med följande innehåll:

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

    Du har nu integrerat Adobe Experience Platform Mobile SDK med din Commerce-mobilapp. Händelsedata flödar från appen till Experience Platform.

Hur man särskiljer Commerce-händelser som genereras från mobilprogram

Alla händelser innehåller fältet channel. Fältet channel innehåller channel._id och channel._type som för en Luma storefront har namnutrymmesvärdena "https://ns.adobe.com/xdm/channels/web" respektive "https://ns.adobe.com/xdm/channel-types/web". I en mobilbutik är namnutrymmesvärdena "https://ns.adobe.com/xdm/channels/mobile-app" respektive "https://ns.adobe.com/xdm/channel-types/mobile".

Nästa steg

Mer information om hur du hämtar Real-Time CDP-målgrupper från din Commerce-mobilapp för att informera om kundvagnsregler, dynamiska block och relaterade produktregler finns i Audience Activation.

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