Adobe Experience Platform Mobile SDK とCommerceの統合

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

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

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エッジに送られます。