將Adobe Experience Platform Mobile SDK與Commerce整合

檢閱行動應用程式教學課程🔗中的Adobe Experience Cloud，瞭解行動應用程式功能。

安裝並設定Experience Platform的SDK。

若要透過SDK傳送Commerce事件資料至Experience Platform，您必須在應用程式程式碼中提供XDM結構描述。 此結構描述必須符合Experience Platform中SDK的結構描述已設定。

下列範例說明如何使用電子郵件欄位來追蹤web.webpagedetails.pageViews事件及設定identityMap。

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)

連線至Commerce Cloud環境。

在您的專案建置設定中，新增URL至Commerce GraphQL端點。 例如：

• 偵錯： http://debug.commercesite.cloud/graphql/
• 發行版本： http://release.commercesite.cloud/graphql/

若要從Commerce GraphQL端點擷取資料，請先使用Apollo Code Generator在您的專案中產生必要的檔案和目錄。

1. 從您的專案目錄，安裝 Apollo iOS。

2. 初始化 Apollo Codegen CLI。

   這會建立apollo-codegen-configuration.json檔案。

3. 將apollo-codegen-configuration.json檔案的內容取代為下列內容，以在專案中產生必要的GraphQL檔案和目錄：

   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. 擷取 Commerce GraphQL結構描述。

   確保路徑為./apollo-codegen-config.json檔案，其中包含對Commerce GraphQL結構描述的參考。

5. 產生原始程式碼。

   確定路徑為./apollo-codegen-config.json檔案，其中包含產生必要檔案和目錄的組態資訊。

6. 在新建立的​ GraphQLGenerated ​資料夾中，新增或編輯GraphQL型別。 例如，您可以新增具有以下內容的DynamicBlocks.graphql型別：

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

您現在已將Adobe Experience Platform Mobile SDK與Commerce行動應用程式整合。 事件資料會從您的應用程式傳輸至Experience Platform邊緣。