Adobe Experience Platform Mobile SDKとCommerceの統合

モバイルアプリの機能について詳しくは、 モバイルアプリでのAdobe Experience Cloud チュートリアルを参照してください。

Experience PlatformのSDKを インストールして設定します。

NOTE

Experience Platformで作成および設定するスキーマは、Commerce モバイルアプリのアプリケーションコードで使用するスキーマと同じです。

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環境に接続します。

プロジェクトのビルド設定で、Commerce GraphQL エンドポイントへの URL を追加します。 例：

• デバッグ：http://debug.commercesite.cloud/graphql/
• リリース：http://release.commercesite.cloud/graphql/

Commerce GraphQL エンドポイントからデータを取得するには、まず Apollo コードジェネレーターを使用して、プロジェクトに必要なファイルとディレクトリを生成します。

1. プロジェクトディレクトリから、install Apollo iOSをインストールします。

2. 初期化Apollo Codegen CLI。

   これにより、apollo-codegen-configuration.json ファイルが作成されます。

3. apollo-codegen-configuration.json ファイルの内容を次のように置き換えて、必要なGraphQL ファイルとディレクトリをプロジェクトに生成します。

   {
   "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 タイプを追加できます。

   query dynamicBlocks($input: DynamicBlocksFilterInput){
       dynamicBlocks(input: $input)
       {
           items {
               content {
                   html
               }
           }
       }
   }
   

これで、Adobe Experience Platform Mobile SDKがCommerce モバイルアプリと統合されました。 イベントデータは、アプリからExperience Platform Edge に送られます。