Integrieren des Adobe Experience Platform Mobile SDK mit Commerce

IMPORTANT
Das Adobe Experience Platform Mobile SDK für iOS unterstützt iOS 11 oder höher.

Durch die Integration von Adobe Experience Platform Mobile SDK in die mobile Commerce-App können Händler Commerce Ereignisdaten an die Experience Platform senden.

Wenn Commerce-Ereignisdaten am Edge verfügbar sind, können sie von anderen Adobe Experience Cloud-Anwendungen aufgerufen werden. Beispielsweise können Sie die Daten zum Erstellen von Zielgruppen in Real-Time CDP verwenden und diese Zielgruppen zur Personalisierung Ihrer mobilen Commerce-App verwenden.

Konfiguration

Um mit der Verwendung des Adobe Experience Platform Mobile SDK mit Commerce zu beginnen, installieren und konfigurieren Sie das SDK im Experience Platform. Schließen Sie dann die Konfiguration in Commerce ab.

Experience Platform

  1. Informieren Sie sich über die Funktionen mobiler Apps, indem Sie sich das Tutorial Adobe Experience Cloud in mobilen Apps ansehen.

  2. Installieren und konfigurieren Sie das SDK im Experience Platform.

    note note
    NOTE
    Das Schema, das Sie auf der Experience Platform erstellen und konfigurieren, ist dasselbe Schema, das Sie im Anwendungscode Ihrer mobilen Commerce-App verwenden.

Commerce

Nachdem Sie die SDK-Konfiguration für die Experience Platform abgeschlossen haben, fügen Sie die SDK-Konfiguration zu Commerce hinzu.

  1. Um Commerce-Ereignisdaten über das SDK an die Experience Platform zu senden, müssen Sie ein XDM-Schema im Anwendungscode angeben. Dieses Schema muss mit dem Schema configured für das SDK in der Experience Platform übereinstimmen.

    Das folgende Beispiel zeigt, wie das web.webpagedetails.pageViews -Ereignis verfolgt und das identityMap mithilfe des E-Mail-Felds festgelegt wird.

    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. Stellen Sie eine Verbindung zur Commerce Cloud-Umgebung her.

    Fügen Sie in den Build-Einstellungen Ihres Projekts die URL zum Commerce GraphQL-Endpunkt hinzu. Beispiel:

    • Debug: http://debug.commerceSite.cloud/graphql/
    • Release: http://release.commerceSite.cloud/graphql/
  3. Um Daten aus den Commerce GraphQL-Endpunkten abzurufen, generieren Sie zunächst die erforderlichen Dateien und Ordner in Ihrem Projekt mithilfe des Apollo Code Generator.

    1. Installieren Sie im Projektverzeichnis install Apollo iOS.

    2. Initialisieren Sie die Apollo-Codegen-CLI.

      Dadurch wird eine apollo-codegen-configuration.json -Datei erstellt.

    3. Generieren Sie die erforderlichen GraphQL-Dateien und -Ordner in Ihrem Projekt, indem Sie den Inhalt der Datei "apollo-codegen-configuration.json"durch Folgendes ersetzen:

      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. Rufen Siedas Commerce GraphQL-Schema ab.

      Stellen Sie sicher, dass der Pfad zur Datei "./apollo-codegen-config.json" ist, die den Verweis auf das Commerce GraphQL-Schema enthält.

    5. Generieren Sie den Quellcode.

      Stellen Sie sicher, dass der Pfad zur Datei "./apollo-codegen-config.json" ist, die die Konfigurationsinformationen enthält, um die erforderlichen Dateien und Ordner zu generieren.

    6. Fügen Sie im neu erstellten Ordner GraphQLGenerated GraphQL-Typen hinzu oder bearbeiten Sie sie. Sie können beispielsweise den Typ DynamicBlocks.graphql mit folgendem Inhalt hinzufügen:

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

    Sie haben jetzt das Adobe Experience Platform Mobile SDK in Ihre Commerce Mobile App integriert. Ereignisdaten fließen von Ihrer App an die Experience Platform Edge.

So unterscheiden Sie Commerce-Ereignisse, die aus Apps generiert wurden

Alle Ereignisse enthalten ein Feld namens channel. Das Feld channel enthält channel._id und channel._type, die für eine Luma-Storefront Namespace-Werte von "https://ns.adobe.com/xdm/channels/web" bzw. "https://ns.adobe.com/xdm/channel-types/web" aufweisen. Bei einer mobilen Storefront sind die Namespace-Werte jedoch "https://ns.adobe.com/xdm/channels/mobile-app" bzw. "https://ns.adobe.com/xdm/channel-types/mobile".

Nächste Schritte

Informationen zum Abrufen von Real-Time CDP-Zielgruppen aus Ihrer mobilen Commerce-App, um Warenkorbpreisregeln, dynamische Bausteine und zugehörige Produktregeln zu informieren, finden Sie unter Audience Activation.

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