Integrieren von Adobe Experience Platform Mobile SDK mit Commerce

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

Durch die Integration von Adobe Experience Platform Mobile SDK mit der Commerce Mobile App können Händler Commerce-Ereignisdaten an den Experience Platform-Edge senden.

Wenn Commerce-Ereignisdaten am Edge verfügbar sind, können andere Adobe Experience Cloud-Programme darauf zugreifen. Sie können die Daten beispielsweise verwenden, um Zielgruppen in Real-Time CDP zu erstellen, und dann diese Zielgruppen verwenden um Ihre Mobile App von Commerce zu personalisieren.

Konfiguration

Installieren und konfigurieren Sie SDK auf der Experience Platform, um mit der Verwendung der Adobe Experience Platform Mobile SDK mit Commerce zu beginnen. Schließen Sie dann Ihre Konfiguration in Commerce ab.

Experience Platform

  1. Erfahren Sie mehr über die Funktionen mobiler Apps durch das Tutorial zu Adobe Experience Cloud in Mobile Apps.

  2. Installieren und Konfigurieren der SDK in Experience Platform.

    note note
    NOTE
    Das Schema, das Sie auf der Experience Platform erstellen und konfigurieren, entspricht dem Schema, das Sie im Anwendungscode in Ihrer Commerce Mobile App verwenden.

Commerce

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

  1. Um Commerce-Ereignisdaten über die SDK an die Experience Platform zu senden, müssen Sie ein XDM-Schema im Anwendungs-Code angeben. Dieses Schema muss mit dem Schema ()SDK auf der Experience Platform übereinstimmen.

    Das folgende Beispiel zeigt, wie Sie das web.webpagedetails.pageViews-Ereignis verfolgen und die identityMap mithilfe des E-Mail-Felds festlegen.

    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. Beispielsweise:

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

    1. Wählen Sie im Projektverzeichnis install Apollo iOS aus.

    2. Initialisieren der 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 apollo-codegen-configuration.json-Datei 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. Abrufen des Commerce GraphQL-Schemas.

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

    5. Generieren des Quell-Codes

      Stellen Sie sicher, dass der Pfad zur ./apollo-codegen-config.json-Datei ist, die die Konfigurationsinformationen zum Generieren der erforderlichen Dateien und Verzeichnisse enthält.

    6. Fügen Sie innerhalb des neu erstellten GraphQLGenerated-Ordners GraphQL-Typen hinzu oder bearbeiten Sie sie. Sie können beispielsweise einen DynamicBlocks.graphql mit folgendem Inhalt hinzufügen:

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

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

So unterscheidet man von Mobile Apps generierte Commerce-Ereignisse

Alle Ereignisse enthalten ein Feld namens channel. Das Feld channel enthält channel._id und channel._type, für die eine Luma-Storefront über Namespace-Werte von "https://ns.adobe.com/xdm/channels/web" bzw. "https://ns.adobe.com/xdm/channel-types/web" verfügt. 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 mit Informationen zu Warenkorbpreisregeln, dynamischen Blöcken und zugehörigen Produktregeln finden Sie unter Audience Activation.

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