De Adobe Experience Platform Mobile SDK integreren met Commerce

IMPORTANT
De Adobe Experience Platform Mobile SDK voor iOS ondersteunt iOS 11 of hoger.

Het integreren van Adobe Experience Platform Mobiele SDKmet de mobiele app van Commerce staat verkopers toe om de gebeurtenisgegevens van Commerce 🔗 naar de rand van het Experience Platform te verzenden.

Wanneer Commerce-gebeurtenisgegevens aan de rand beschikbaar zijn, kunnen deze door andere Adobe Experience Cloud-toepassingen worden geopend. Bijvoorbeeld, kunt u de gegevens gebruiken om publiek in Real-Time CDP toen te bouwen die publiekgebruiken om uw mobiele app van Commerce te personaliseren.

Configuratie

Installeer en configureer de SDK in het Experience Platform om de Adobe Experience Platform Mobile SDK met Commerce te gaan gebruiken. Voltooi vervolgens de configuratie in Commerce.

Experience Platform

  1. Leer over mobiele toepassingsmogelijkheden door Adobe Experience Cloud in mobiele apps te herzien leerprogramma.

  2. installeer en vormSDK in Experience Platform.

    note note
    NOTE
    Het schema dat u maakt en configureert in het Experience Platform is hetzelfde schema als dat u gebruikt in de toepassingscode in uw mobiele Commerce-app.

Commerce

Nadat u de SDK-configuratie voor het Experience-platform hebt voltooid, voegt u de SDK-configuratie toe aan Commerce.

  1. Als u Commerce-gebeurtenisgegevens naar het Experience Platform wilt verzenden via de SDK, moet u een XDM-schema opgeven in de toepassingscode. Dit schema moet het schema aanpassen datvoor SDK in het Experience Platform wordt gevormd.

    In het volgende voorbeeld ziet u hoe u de gebeurtenis web.webpagedetails.pageViews bijhoudt en de gebeurtenis identityMap instelt met behulp van het e-mailveld.

    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. Maak verbinding met de omgeving van de Commerce Cloud.

    In de bouwstijlmontages van uw project, voeg URL aan het eindpunt van Commerce GraphQL toe. Bijvoorbeeld:

    • Zuiver: http://zuivert.commercesite.cloud/graphql/
    • Versie: http://versie.commercesite.cloud/graphql/
  3. Om gegevens van de eindpunten van Commerce GraphQL terug te winnen, produceer eerst de noodzakelijke dossiers en de folders in uw project gebruikend de Generator van de Code van Apollo.

    1. Van uw projectfolder, installeertApollo iOS.

    2. initialiseertde Codegen CLI van Apollo.

      Hiermee maakt u een apollo-codegen-configuration.json -bestand.

    3. Genereer de benodigde GraphQL-bestanden en -mappen in uw project door de inhoud van het apollo-codegen-configuration.json -bestand te vervangen door:

      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. Vetchhet schema van GraphQL van Commerce.

      Zorg ervoor dat het pad naar het ./apollo-codegen-config.json -bestand is, dat de verwijzing naar het Commerce GraphQL-schema bevat.

    5. produceerde broncode.

      Zorg ervoor dat het pad naar het ./apollo-codegen-config.json -bestand is, dat de configuratiegegevens bevat om de benodigde bestanden en mappen te genereren.

    6. Binnen de pas gecreëerde GraphQLGenerated omslag, voeg of geef de types van GraphQL toe uit. U kunt bijvoorbeeld een DynamicBlocks.graphql -type met de volgende inhoud toevoegen:

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

    U hebt de Adobe Experience Platform Mobile SDK nu geïntegreerd met uw mobiele Commerce-app. Gebeurtenisgegevens lopen van uw app naar de rand van het Experience Platform.

Commerce-gebeurtenissen die zijn gegenereerd vanuit mobiele toepassingen onderscheiden

Alle gebeurtenissenbevatten een geroepen gebied channel. Het veld channel bevat channel._id en channel._type , die voor een Luma-storefront naamruimtewaarden "https://ns.adobe.com/xdm/channels/web" en "https://ns.adobe.com/xdm/channel-types/web" hebben. Voor een mobiele winkel zijn de naamruimtewaarden echter respectievelijk "https://ns.adobe.com/xdm/channels/mobile-app" en "https://ns.adobe.com/xdm/channel-types/mobile" .

Volgende stappen

Om te leren hoe te om het publiek van Real-Time CDP van uw mobiele app van Commerce terug te winnen om de regels van de kartprijs, dynamische blokken, en verwante productregels te informeren, zie Audience Activation.

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