Mobile SDK を介したデータの取り込み
このクイックスタートガイドでは、Adobe Experience Platform Mobile SDK とEdge Networkを使用して、モバイルアプリのトラッキングデータをAdobe Experience Platformに直接取り込む方法について説明します。 次に、そのデータをCustomer Journey Analyticsで使用します。
これには、次の手順を実行する必要があります。
-
Adobe Experience Platform で スキーマとデータセットを設定 し、収集するデータのモデル（スキーマ）と、実際にデータ（データセット）を収集する場所を定義します。
-
データストリームの設定：収集したデータを Adobe Experience Platform で設定したデータセットにルーティングするように Adobe Experience Platform Edge Network を設定します。
-
タグを使用：モバイルアプリケーションのデータに対してルールやデータ要素を簡単に設定できます。 次に、データが Adobe Experience Platform Edge Network 上に設定されたデータストリームに送信されることを確認します。
-
デプロイと検証 を行います。タグの開発を繰り返し実行し、すべての検証が完了したら、実稼動環境で公開できる環境を構築します。
-
Customer Journey Analytics で、接続を設定 します。この接続には、（少なくとも）Adobe Experience Platform データセットを含める必要があります。
-
Customer Journey Analytics で データ表示を設定 し、Analysis Workspace で使用する指標とディメンションを定義します。
-
Customer Journey Analytics で プロジェクトを設定 して、レポートとビジュアライゼーションを作成します。
スキーマとデータセットの設定
データを Adobe Experience Platform に取り込むには、まず収集するデータを定義する必要があります。ダウンストリームの機能で認識し、処理するには、Adobe Experience Platform に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。エクスペリエンスデータモデル（XDM）は、スキーマの形式で構造を提供する標準フレームワークです。
スキーマを定義したら、1 つ以上のデータセットを使用して、データの収集を保存および管理します。データセットは、スキーマ（列）とフィールド（行）を含んだデータのコレクション（通常はテーブル）のストレージおよび管理用の構成体です。
Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。
スキーマの設定
モバイルアプリを使用して、プロファイルからの最小限のデータ（シーン名、ID など）を追跡する場合。
まず、このデータをモデル化するスキーマを定義する必要があります。
スキーマを設定するには：
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。
-
スキーマを作成 を選択します。
. -
スキーマ作成ウィザードの「クラスを選択」手順で、次の操作を行います。
-
エクスペリエンスイベント を選択します。
note info INFO エクスペリエンスイベントスキーマは、プロファイルの 動作 をモデル化するために使用します（シーン名、買い物かごに追加するプッシュボタンなど）。 個々のプロファイルスキーマは、プロファイル_属性_（名前、メール、性別など）のモデル化に使用されます。 -
「次へ」を選択します。
-
-
スキーマを作成 ウィザードの 名前とレビューの手順 で、次の操作を行います。
-
スキーマの スキーマ表示名 と（オプション） 説明 を入力します。
-
「完了」を選択します。
-
-
「スキーマ例の構造」タブで、次の操作を行います。
-
「フィールドグループ」で「+ 追加」を選択します。
フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。
-
フィールドグループを追加 ダイアログで、リストから AEP Mobile SDK ExperienceEvent フィールドグループを選択します。
「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールド（
application > nameなど）のプレビューを表示できます。
「戻る」を選択してプレビューを閉じます。
-
「フィールドグループを追加」を選択します。
-
-
構造パネルで、スキーマ名の隣にある「+」をクリックします。
-
「 フィールドプロパティ 」パネルで、 フィールド名 に
identificationと入力し、表示名 に ID と入力し、 タイプ で オブジェクト を選択し、 フィールドグループ で ExperienceEvent Core v2.1 を選択します。note note NOTE そのフィールドグループが使用できない場合は、ID フィールドを含む別のフィールドグループを探します。 または 新しいフィールドグループを作成して 新しい ID フィールドを追加（ ecid、crmIdなど、必要なその他）をフィールドグループに追加し、その新しいフィールドグループを選択します。
ID オブジェクトは、スキーマに ID 機能を追加します。 その場合は、Experience CloudID とメールアドレスを使用して、モバイルアプリを使用してプロファイルを識別します。 人物の ID を追跡するために使用できる属性は他にも多数あります（顧客 ID、ロイヤルティ ID など）。
「適用」を選択して、このオブジェクトをスキーマに追加します。
-
先ほど追加した ID オブジェクトで「ecid」フィールドをクリックし、右パネルの ID 名前空間リストから ID、プライマリ ID および ECID を選択します。
Experience Cloud ID を、Adobe Experience Platform Identity Service が同じ ECID を持つプロファイルの動作を組み合わせる（ステッチする）ために使用するプライマリ ID として指定します。
「適用」を選択します。ecid 属性にフィンガープリントアイコンが表示されます。
-
先ほど追加した ID オブジェクトで「メール」フィールドをクリックし、フィールドプロパティパネルのID 名前空間リストから ID と メール を選択します。
メールアドレスを、Adobe Experience Platform Identity Service がプロファイルの動作を組み合わせる（ステッチする）ために使用するもう一つの ID として指定します。
「適用」を選択します。メール属性にフィンガープリントアイコンが表示されます。
「保存」を選択します。
-
スキーマの名前を表示しているスキーマのルート要素を選択してから、プロファイル スイッチをクリックします。
プロファイルのスキーマを有効にするよう求められます。有効にすると、このスキーマに基づくデータセットにデータが取り込まれたときに、そのデータをリアルタイム顧客プロファイルと結合します。
詳しくは、リアルタイム顧客プロファイルで使用するスキーマを有効にするを参照してください。
note important IMPORTANT プロファイルで有効にしたスキーマを保存すると、そのスキーマはプロファイルで無効にできなくなります。 
-
「保存」を選択してスキーマを保存します。
モバイルアプリケーションから取得できるデータをモデル化する、最小限のスキーマを作成しました。 このスキーマを使用することで、Experience Cloud ID とメールアドレスを使用してプロファイルを識別できます。プロファイルのスキーマを有効にすることで、モバイルアプリケーションから取り込んだデータをリアルタイム顧客プロファイルへと確実に追加できます。
行動データの横にある、モバイルアプリケーションからプロファイル属性データ（ニュースレターを購読したプロファイルの詳細など）を取り込むこともできます。
プロファイルデータを取得するには、次を実行します。
-
XDM Individual Profile クラスに基づいてスキーマを作成します。
-
Profile Core v2 フィールドグループをスキーマに追加します。
-
Profile Core v2 フィールドグループに基づいて ID オブジェクトを追加します。
-
Experience Cloud ID をプライマリ識別子、メールを識別子として定義します。
-
プロファイルでスキーマを有効にする
フィールドグループと個々のフィールドをスキーマに追加、またはスキーマから削除する方法について詳しくは、UI でのスキーマの作成と編集を参照してください。
データセットの設定
スキーマを使用して、データモデルを定義しました。次に、データセットを使用して、そのデータを保存および管理する構成を定義する必要があります。
データセットを設定するには：
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「データセット」を選択します。
-
「データセットを作成」を選択します。
-
「スキーマからデータセットを作成」をクリックします。
-
作成したスキーマを選択し、「次へ」を選択します。
-
データセットに名前を付け、（オプション）説明を入力します。
-
「完了」を選択します。
-
「プロファイル」スイッチを選択します。
プロファイルのデータセットを有効にするよう求められます。有効にすると、データセットは、取り込んだデータを使用してリアルタイム顧客プロファイルを強化します。
note important IMPORTANT プロファイルのデータセットを有効にできるのは、データセットが準拠するスキーマがプロファイルに対しても有効になっている場合のみです。 
データセットの表示、プレビュー、作成、削除の方法について詳しくは、データセット UI ガイドを参照してください。リアルタイム顧客プロファイルのデータセットを有効にする方法について説明します。
データストリームの設定
データストリームは、Adobe Experience Platform Web および Mobile SDK を実装する際のサーバーサイド設定を表します。Adobe Experience Platform SDK を使用してデータを収集する際、データはAdobe Experience Platform Edge Network に送信されます。データの転送先となるサービスを決定するデータストリームです。
設定では、モバイルアプリから収集したデータをAdobe Experience Platformのデータセットに送信する必要があります。
データストリームを設定するには：
-
Adobe Experience Platform UI の左パネルで、「データ収集」から「データストリーム」を選択します。
-
新しいデータストリーム を選択します。
-
データストリームに名前を付けて説明します。イベントスキーマリストからスキーマを選択します。
-
「保存」を選択します。
-
「サービスを追加」を選択します。
-
サービスを追加画面で、次の操作を行います。
-
サービスリストから Adobe Experience Platform を選択します。
-
「有効」が選択されていることを確認します。
-
イベントデータセットリストからお使いのデータセットを選択します。
-
その他の設定はそのままにし、「保存」を選択してデータストリームを保存します。
-
これで、モバイルアプリから収集したデータをAdobe Experience Platformでデータセットに転送するように、データストリームが設定されました。
データストリームの設定方法と機密データの処理方法について詳しくは、データストリームの概要を参照してください。
タグの使用
データを収集するためのコードをサイトに実装するには、Adobe Experience Platformのタグ機能を使用します。 このタグ管理ソリューションを使用すると、他のタグ要件と共にコードをデプロイできます。タグは、Adobe Experience Platform Mobile SDK 拡張機能を使用して、Adobe Experience Platformとのシームレスな統合を提供します。
タグを作成する
-
Adobe Experience Platform UI の左パネルの「データ収集」で、「タグ」を選択します。
-
「新しいプロパティ」を選択します。
タグに名前を付け、「モバイル」を選択します。 「保存」を選択して続行します。
タグの設定
タグを作成したら、適切な拡張機能を使用してタグを設定し、サイトを追跡して Adobe Experience Platform にデータを送信する方法に応じて、データ要素とルールを設定する必要があります。
を設定するには、 タグのプロパティ のリストから、新しく作成したタグを選択します。
拡張機能
Adobe Platform Edge Network拡張機能をタグに追加して、（データストリーム経由で）Adobe Experience Platformにデータを送信できるようにします。
Adobe Experience Platform Mobile SDK 拡張機能を作成および設定するには：
-
左パネルで 拡張機能 を選択します。 Mobile Core 拡張機能とプロファイル拡張機能は既に使用可能です。
-
上部のバーで「カタログ」をクリックします。
-
Adobe Experience Platform Edge Network 拡張機能を検索またはスクロールし、右側のパネルで「インストール」を選択してインストールします。
-
サンドボックスと、以前に作成した実稼動環境、（オプション）ステージング環境および開発環境用のデータストリームを選択します。
-
Domain configuration の下に Edge Networkドメイン を入力します。 通常、
<organizationName>.data.adobedc.netを使用します。 -
「保存」を選択します。
詳しくは Adobe Experience Platform Edge Network拡張機能の設定を参照してください。
また、カタログから次の追加拡張機能も設定する必要があります。
- ID。
- AEP Assurance。
- 同意。
拡張機能とその設定について詳しくは、Experience Platform 用モバイルアプリチュートリアルの タグプロパティの設定を参照してください。
データ要素
データ要素は、データディクショナリ（またはデータマップ）の構築ブロックです。データ要素を使用して、マーケティングおよび広告テクノロジー全体でデータを収集、整理、配信します。タグで、モバイルアプリのデータやイベントから読み取り、Adobe Experience Platformにデータを配信するために使用できるデータ要素を設定します。
例えば、モバイルアプリから通信事業者名を収集するとします。
通信事業者名データ要素を定義するには：
-
左パネルで「データ要素」を選択します。
-
「データ要素を追加」を選択します。
-
データ要素を作成ダイアログで、次の手順を実行します。
-
データ要素に名前を付けます（例：
Carrier Name）。 -
拡張機能 リストから Mobile Core を選択します。
-
データ要素タイプ リストから 通信事業者名 を選択します。
-
「保存」を選択します。
-
必要な数のデータ要素を作成し、それらをルールで使用できます。
ルール
Adobe Experience Platform のタグは、ルールベースのシステムに従います。ユーザーの操作と関する各種データを参照します。ルールで設定された条件が満たされると、ルールは、特定した拡張機能、スクリプトまたはクライアント側コードをトリガーします。ルールを使用し、XDM オブジェクトなどのデータを、Adobe Experience Platform Edge Network拡張機能を使用してAdobe Experience Platformに送信できます。
例えば、モバイルアプリが使用された場合（フォアグラウンドで）や、使用されなかった（バックグラウンドにプッシュされた）場合にイベントデータを送信するとします。
ルールを定義するには：
-
左パネルで「ルール」を選択します。
-
「新規ルールを作成」を選択します。
-
ルールを作成ダイアログで、次の手順を実行します。
-
ルールに名前を付けます（例：
Application Status）。 -
「イベント」の下の「+ 追加」を選択します。
-
イベント設定ダイアログで、次の手順を実行します。
-
拡張機能 リストから Mobile Core を選択します。
-
イベントタイプ リストから フォアグラウンド を選択します。
-
「変更を保持」を選択します。
-
-
モバイルコア – 前景 の横にある「![ プラス ]」をクリックします。
-
拡張機能 リストから Mobile Core を選択します。
-
イベントタイプ リストから 背景 を選択します。
-
「変更を保持」を選択します。
-
-
ACTIONS の下の「
-
「拡張機能 」リストから 0}Adobe Experience PlatformEdge Network を選択します。
-
アクションタイプ リストから Edge Networkにイベントを転送 を選択します。
-
「変更を保持」を選択します。
-
-
ルールは次のようになります。
-
「保存」を選択します。
-
上記は、アプリケーションステータスを含む XDM データをAdobe Edge Network とAdobe Experience Platformに送信するルールを定義する例に過ぎません。
タグ内で様々な方法でルールを使用して、（データ要素を使用して）変数を操作できます。
詳しくは、ルールを参照してください。
タグを作成して公開する
データ要素とルールを定義したら、タグを作成して公開する必要があります。ライブラリビルドを作成する場合は、そのビルドを環境に割り当てる必要があります。ビルドの拡張機能、ルール、およびデータ要素がコンパイルされ、割り当てられた環境に配置されます。各環境は、割り当てられたビルドをサイトに統合できる、一意の埋め込みコードを提供します。
タグを構築して公開するには、次の手順に従います。
-
左パネルから「公開フロー」をクリックします。
-
作業ライブラリを選択／ライブラリを追加… を選択します。
-
ライブラリを作成ダイアログで、次の手順を実行します。
-
ライブラリに名前を付けます。
-
環境リストから「開発（開発）」を選択します。
-
「+ 変更されたリソースをすべて追加」を選択します。
-
「開発用に保存およびビルド」を選択します。
タグが保存され、開発環境用に作成されます。 緑のドットは、開発環境でタグが正常に作成されたことを示します。
-
-
… を選択してライブラリを再構築するか、ライブラリをステージング環境または実稼動環境に移動することができます。
Adobe Experience Platform タグは、Adobe Experience Platform Edge Networkのデプロイメントに対応する必要がある、シンプルな公開ワークフローから複雑な公開ワークフローをサポートします。
詳しくは、公開の概要を参照してください。
タグコードの取得
最後に、追跡するモバイルアプリ内でタグを使用する必要があります。
モバイルアプリを設定し、アプリでタグを使用する方法を説明するコード手順を取得するには：
-
左パネルで「環境」を選択します。
-
環境のリストから、正しいインストール
モバイルインストール手順 ダイアログで、適切なプラットフォーム（iOS、Android）を選択します。 次に、モバイルアプリの設定と初期化に使用する関連コードスニペットの横にある「コピー
-
「閉じる」を選択します。
開発環境用のコードの代わりに、Adobe Experience Platform Mobile SDK をデプロイするプロセスの場所に基づいて、別の環境（ステージング、実稼動）を選択することもできます。
詳しくは、環境を参照してください。
デプロイと検証
これで、モバイルアプリ内にコードをデプロイできます。 デプロイすると、モバイルアプリがAdobe Experience Platformへのデータ収集を開始します。
実装を検証し、必要に応じて修正したら、タグの公開ワークフロー機能を使用して、ステージング環境と実稼動環境にデプロイします。
詳しくは、 モバイルアプリでのAdobe Experience Cloudの実装チュートリアルを参照してください。
接続の設定
Adobe Experience Platform データを Customer Journey Analytics で使用するには、接続（スキーマ、データセット、ワークフローの設定によって生成されたデータを含む）を作成します。
接続を使用すれば、Adobe Experience Platform のデータセットをワークスペースに統合できます。これらのデータセットに関するレポートを作成するには、まずAdobe Experience PlatformとWorkspaceのデータセット間で接続を確立する必要があります。
接続を作成するには：
-
Customer Journey Analytics UI で、「接続」をクリックします。
-
「新しい接続を作成」を選択します。
-
名称未設定の接続画面で、次の手順を実行します。
「接続設定」で接続に名前を付けて説明します。
データ設定のサンドボックスリストから適切なサンドボックスを選択し、毎日のイベントの平均数リストから日次イベントの数を選択します。
「データセットを追加」を選択します。
「データセットを追加」の「データセットを選択」手順で、次の操作を行います。
-
以前に作成したデータセットや、接続に含める他の関連データセット（例：Adobe Journey Optimizerのプッシュトラッキングエクスペリエンスイベントデータやプッシュプロファイルデータ）を選択します
-
「次へ」を選択します。
「データセットを追加」の「データセット設定」手順で、次の操作を行います。
-
各データセットに対して、次の手順を行います。
-
Adobe Experience Platform のデータセットスキーマで定義されている使用可能な ID からユーザー ID を選択します。
-
データソースタイプリストから正しいデータソースを選択します。「その他」を指定している場合は、データソースの説明を追加します。
-
必要に応じて すべての新しいデータを読み込み および データセットの既存データのバックフィル を選択します。
-
-
「データセットを追加」を選択します。
「保存」を選択します。
-
接続を作成および管理する方法、およびデータセットを選択して組み合わせる方法について詳しくは、接続の概要を参照してください。
データ表示の設定
データ表示は、Customer Journey Analytics に特有のコンテナで、接続からデータを解釈する方法を決定できます。Analysis Workspace で使用可能なすべてのディメンションと指標、およびこれらのディメンションと指標からデータを取得する列を指定します。データ表示は、Analysis Workspace でレポートの準備を行う際に定義します。
データ表示を作成するには：
-
Customer Journey Analytics UI の上部ナビゲーションで、「データ表示」をクリックします。
-
「新しいデータ表示を作成」を選択します。
-
設定手順で、次の操作を行います。
接続リストで接続を選択します。
接続に名前を付け、（オプションで）説明します。
「保存して続行」を選択します。
-
コンポーネント手順で、次の操作を行います。
指標またはディメンションコンポーネントボックスに含めるスキーマフィールドや標準コンポーネントを追加します。
「保存して続行」を選択します。
-
設定手順で、次の操作を行います。
設定をそのままにし、「保存して終了」を選択します。
データ表示の作成および編集方法、データ表示で使用できるコンポーネント、フィルターおよびセッションの設定の使用方法について詳しくは、データ表示の概要を参照してください。
プロジェクトの設定
Analysis Workspace は、データに基づき、分析をすばやく構築してインサイトを共有できる、柔軟なブラウザーツールです。ワークスペースプロジェクトでは、データコンポーネント、テーブル、およびビジュアライゼーションを組み合わせて、分析を作成し、組織内の任意のユーザーと共有できます。
プロジェクトを作成するには：
-
Customer Journey Analytics UI で、「プロジェクト」をクリックします。
-
左側のナビゲーションの「プロジェクト」を選択します。
-
「プロジェクトを作成」を選択します。
「空のプロジェクト」を選択します。
-
リストからデータ表示を選択します。
-
最初のレポートを作成するには、 パネル の フリーフォームテーブル でディメンションと指標のドラッグ&ドロップを開始します。 例えば、
Eventsを指標、Push Titleをディメンションにドラッグし、Event Typeごとに分類して、モバイルアプリのプッシュ通知の概要と通知に何が起こったかを取得します。
コンポーネント、ビジュアライゼーション、パネルを使用してプロジェクトを作成し、分析を構築する方法について詳しくは、Analysis Workspace の概要を参照してください。