モバイル 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 に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。 Experience Data Model （XDM）は、スキーマの形式で構造を提供する標準フレームワークです。
スキーマを定義したら、1 つ以上のデータセットを使用して、データの収集を保存および管理します。 データセットは、スキーマ（列）とフィールド（行）を含むデータのコレクション（通常はテーブル）のストレージおよび管理構造です。
Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。
スキーマの設定
モバイルアプリを使用してプロファイルから最小限のデータ（シーン名、識別など）を追跡する必要があります。
まず、このデータをモデル化するスキーマを定義する必要があります。
スキーマを設定するには：
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。
-
「スキーマを作成」を選択します。
. -
スキーマを作成ウィザードの「クラスを選択」ステップで、次の操作を行います。
-
「エクスペリエンスイベント」を選択します。
note info INFO エクスペリエンスイベントスキーマを使用すると、プロファイルの_動作_（シーン名、買い物かごに追加するプッシュボタンなど）をモデル化できます。 個々のプロファイルスキーマは、プロファイル_属性_（名前、メール、性別など）のモデル化に使用されます。 -
「次へ」を選択します。
-
-
スキーマを作成ウィザードの名前とレビューの手順で、次の操作を行います。
-
スキーマの スキーマ表示名 と説明（オプション）を入力します。
-
「完了」を選択します。
-
-
「スキーマの例」の「構造」タブで、次の操作を行います。
-
「フィールドグループ」で「+ 追加」を選択します。
フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。
-
フィールドグループを追加 ダイアログで、リストからAEP Mobile SDK ExperienceEvent フィールドグループを選択します。
「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールド（
application > nameなど）のプレビューを表示できます。
「戻る」を選択してプレビューを閉じます。
-
「フィールドグループを追加」を選択します。
-
-
構造パネルで、スキーマ名の隣にある「+」をクリックします。
-
フィールドプロパティ パネルで、
identificationを フィールド名として、識別を表示名として入力し、オブジェクトを タイプ として選択し、ExperienceEvent Core v2.1を フィールドグループ として選択します。note NOTE このフィールドグループが使用できない場合は、ID フィールドを含む別のフィールドグループを検索します。 または、フィールドグループに新しいフィールドグループを作成し、（ ecid、crmIdなど）新しい ID フィールドを追加して、この新しいフィールドグループを選択します。
ID オブジェクトは、スキーマに ID 機能を追加します。 この場合、Experience Cloud IDとメールアドレスを使用して、モバイルアプリを使用してプロファイルを識別する必要があります。 ユーザーの 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とProfileの拡張機能は既に利用可能です。
-
上部のバーで「カタログ」をクリックします。
-
Adobe Experience Platform Edge Network拡張機能を検索またはスクロールし、右側のウィンドウで Install を選択してインストールします。
-
サンドボックスと、以前に作成した本番環境、（オプション）ステージング環境および開発環境用のデータストリームを選択します。
-
Domain configurationの下に Edge Network domain を入力します。 通常は
<organizationName>.data.adobedc.netを使用します。 -
「保存」を選択します。
詳しくは、Adobe Experience Platform Edge Network拡張機能の設定を参照してください。
また、カタログから次の追加の拡張機能を設定することもできます。
- 単一の顧客像：
- AEP Assurance:
- 同意：
拡張機能とその設定について詳しくは、Experience Platform モバイルアプリチュートリアルの タグプロパティの設定を参照してください。
データ要素
データ要素は、データ辞書（またはデータマップ）の構築要素です。 データ要素を使用して、マーケティングおよび広告テクノロジー全体でデータを収集、整理、配信します。 モバイルアプリのデータやイベントから読み取り、データをAdobe Experience Platformに配信するために使用できるデータ要素をタグに設定します。
例えば、モバイルアプリからキャリア名を収集する場合などです。
キャリア名データ要素を定義するには、次の手順に従います。
-
左パネルで「データ要素」を選択します。
-
「データ要素を追加」を選択します。
-
データ要素を作成ダイアログで、次の手順を実行します。
-
データ要素に名前を付けます（例：
Carrier Name）。 -
拡張機能 リストから Mobile Core を選択します。
-
「 データ要素タイプ 」リストから「キャリア名」を選択します。
-
「保存」を選択します。
-
必要な数のデータ要素を作成し、ルールで使用できます。
ルール
Adobe Experience Platform のタグは、ルールベースのシステムに従います。 ユーザーの操作と関する各種データを参照します。 ルールで設定された条件が満たされると、ルールは、特定した拡張機能、スクリプトまたはクライアント側コードをトリガーします。 ルールを使用すると、Adobe Experience Platform Edge Network拡張機能を使用してAdobe Experience Platformにデータ（XDM オブジェクトなど）を送信できます。
例えば、モバイルアプリが使用されている場合（前景）と、モバイルアプリが使用されていない場合（背景にプッシュバックされている場合）に、イベントデータを送信する必要があります。
ルールを定義するには：
-
左パネルで「ルール」を選択します。
-
「新規ルールを作成」を選択します。
-
ルールを作成ダイアログで、次の手順を実行します。
-
ルールに名前を付けます（例：
Application Status）。 -
「イベント」の下の「+ 追加」を選択します。
-
イベント設定ダイアログで、次の手順を実行します。
-
拡張機能 リストから Mobile Core を選択します。
-
イベントタイプ リストから 描画領域 を選択します。
-
「変更を保持」を選択します。
-
-
Mobile Core - Foregroundの横にある
-
拡張機能 リストから Mobile Core を選択します。
-
「 イベントタイプ 」リストから「背景」を選択します。
-
「変更を保持」を選択します。
-
-
アクション の下にある
-
拡張機能 リストから Adobe Experience Platform Edge 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の上部メニューで、Data managementから Connections を選択します（オプション）。
-
「新しい接続を作成」を選択します。
-
名称未設定の接続画面で、次の手順を実行します。
「接続設定」で接続に名前を付けて説明します。
データ設定のサンドボックスリストから適切なサンドボックスを選択し、毎日のイベントの平均数リストから日次イベントの数を選択します。
「データセットを追加」を選択します。
「データセットを追加」の「データセットを選択」手順で、次の操作を行います。
-
以前に作成したデータセットや、接続に含める関連データセット（例：Adobe Journey OptimizerのPush Tracking Experience Events データやPush Profile データ）を選択します
-
「次へ」を選択します。
「データセットを追加」の「データセット設定」手順で、次の操作を行います。
-
各データセットに対して、次の手順を行います。
-
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 の概要を参照してください。