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

プロジェクトのビルド設定で、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 ファイルとディレクトリをプロジェクトに生成します。

   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 Edge に送られます。