UIでのCRM接続のデータフローの設定

データフローとは、ソースからデータセットPlatformにデータを取得し、取り込むスケジュール済みのタスクです。 このチュートリアルでは、CRMアカウントを使用して新しいデータフローを設定する手順を説明します。

はじめに

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

• Experience Data Model (XDM) システム:顧客体験データを Experience Platform 編成する際に使用される標準化されたフレームワーク。
  • スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
  • スキーマエディタのチュートリアル:スキーマエディターのUIを使用してカスタムスキーマを作成する方法を説明します。
• Real-time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの消費者プロファイルを提供します。

さらに、このチュートリアルでは、CRMアカウントを既に作成済みである必要があります。 UIで異なるCRMコネクタを作成するためのチュートリアルのリストは、ソースコネクタの概要を参照してください。

データの選択

CRMアカウントを作成すると、データの選択​の手順が表示され、ファイル階層を調べるためのインタラクティブなインターフェイスが提供されます。

• インターフェイスの左半分はディレクトリブラウザーで、サーバーのファイルとディレクトリが表示されます。
• インターフェイスの右半分を使用すると、互換性のあるファイルから最大100行のデータをプレビューできます。

ページ上部の「検索」オプションを使用すると、使用するソースデータをすばやく特定できます。

ソースデータを見つけたら、ディレクトリを選択し、「次へ」をクリックします。

データフィールドのXDMスキーマへのマッピング

マッピング​の手順が表示され、ソースデータをPlatformデータセットにマッピングするためのインタラクティブなインターフェイスが提供されます。

取り込む受信データのデータセットを選択します。 既存のデータセットを使用することも、新しいデータセットを作成することもできます。

既存のデータセットを使用する

既存のデータセットにデータを取り込むには、既存のデータセット​を使用を選択し、データセットアイコンをクリックします。

データセットを選択​ダイアログが表示されます。 使用するデータセットを見つけて選択し、続行​をクリックします。

新しいデータセットの使用

データを新しいデータセットに取り込むには、新しいデータセットを作成​を選択し、提供されたフィールドにデータセットの名前と説明を入力します。

検索バー​にスキーマ名を入力して、スキーマフィールドを添付できます。 ドロップダウンアイコンを選択して、既存のスキーマのリストを表示することもできます。 または、「アドバンス検索」を選択して、既存のスキーマの各詳細を含む画面にアクセスすることもできます。

この手順では、Real-time Customer Profileのデータセットを有効にし、エンティティの属性と動作の全体的な表示を作成できます。 すべての有効なデータセットのデータはProfileに含まれ、変更はデータフローの保存時に適用されます。

プロファイルデータセット​ボタンを切り替えて、Profileのターゲットデータセットを有効にします。

スキーマを選択​ダイアログが表示されます。 新しいデータセットに適用するスキーマを選択し、完了​をクリックします。

必要に応じて、フィールドを直接マップするか、マッパー関数を使用してソースデータを変換し、計算値や計算値を抽出することができます。 データマッピングとマッパー関数の詳細については、CSVデータのXDMスキーマフィールドへのマッピングのチュートリアルを参照してください。

プレビューデータ​を選択すると、選択したデータセットから最大100行のサンプルデータのマッピング結果を確認できます。

マッピング結果を検証する際に必要な重要な情報なので、プレビュー時に、ID列が最初のフィールドとして優先付けされます。

ソースデータがマッピングされたら、「閉じる」を選択します。

インジェストのスケジュール設定

スケジュール​の手順が表示され、設定されたマッピングを使用して選択したソースデータを自動的に取り込むように取り込みスケジュールを設定できます。 次の表に、スケジュール設定用の様々な設定可能フィールドの概要を示します。

フィールド	説明
頻度	選択可能な周波数には、Once、Minute、Hour、Day、Weekがあります。
間隔	選択した頻度の間隔を設定する整数。
開始時間	最初の取り込みがいつ行われるかを示すUTCタイムスタンプ。
埋め戻し	最初に取り込まれるデータを決定するboolean値です。 バックフィル​が有効な場合、指定されたパス内の現在のファイルは、最初にスケジュールされた取り込み中にすべて取り込まれます。 バックフィル​が無効な場合は、最初のインジェスト実行から​開始時間​までの間にロードされたファイルのみがインジェストされます。 開始時刻​より前に読み込まれたファイルは取り込まれません。
差分列	タイプ、日付または時間のフィルターされたソーススキーマフィールドセットを含むオプションです。 このフィールドは、新規データと既存データを区別するために使用します。 増分データは、選択した列のタイムスタンプに基づいて取り込まれます。

データフローは、スケジュールに基づいてデータを自動的に取り込むように設計されています。 開始するには、取り込み頻度を選択します。 次に、2つのフローの実行間隔を指定する間隔を設定します。 間隔の値は、0以外の整数で、15以上に設定する必要があります。

取り込みの開始時間を設定するには、開始時間ボックスに表示される日時を調整します。 または、カレンダーアイコンを選択して、開始時間の値を編集することもできます。 開始時刻は、現在のUTC時刻以上にする必要があります。

「Load incremental data by」を選択して、差分列を割り当てます。 このフィールドは、新規データと既存データの区別を示します。

1回のみの取り込みデータフローの設定

1回のみのインジェストを設定するには、頻度ドロップダウン矢印を選択し、「1回」を選択します。

スケジュールに適切な値を指定したら、「次へ」を選択します。

データフローの詳細の指定

Dataflow detail​ステップが表示され、新しいデータフローに名前を付け、簡単な説明を入力できます。

このプロセス中に、部分的な取り込み​と​エラー診断​を有効にすることもできます。 部分的な取り込み​を有効にすると、エラーを含むデータを特定のしきい値まで取り込むことができます。 部分的な取り込み​が有効になったら、エラーしきい値%​ダイヤルをドラッグして、バッチのエラーしきい値を調整します。 または、入力ボックスを選択して手動でしきい値を調整することもできます。 詳しくは、部分的なバッチインジェストの概要を参照してください。

データフローの値を指定し、「次へ」を選択します。

データフローの確認

「レビュー」ステップが表示され、新しいデータフローを作成前に確認できます。 詳細は次のカテゴリに分類されます。

• 接続の詳細:ソースの種類、選択したソースファイルの関連パス、およびそのソースファイル内の列数が表示されます。
• マッピングの詳細:ソースデータが取り込まれるデータセット(データセットに従うスキーマなど)を示します。
• スケジュールの詳細:取り込みスケジュールの有効期間、頻度、間隔を表示します。

データフローを確認したら、「Finish」をクリックし、データフローの作成に時間を割り当てます。

データフローの監視

データフローを作成したら、データフローを介して取り込まれるデータを監視し、取り込み率、成功、エラーに関する情報を確認できます。 データフローの監視方法の詳細については、UI](…/monitor.md)の[監視アカウントとデータフローのチュートリアルを参照してください。

データフローの削除

不要になった、または不適切に作成されたデータフローは、Dataflows​ワークスペースにある​Delete​関数を使用して削除できます。 データフローの削除方法の詳細については、UI](…/delete.md)での[データフローの削除に関するチュートリアルを参照してください。

次の手順

このチュートリアルに従うと、データフローを正しく作成してCRMからデータを取り込み、監視データセットに関する洞察を得ることができます。 データフローの作成について詳しくは、以下のビデオを参照して学習を補うことができます。 さらに、受信データは、Real-time Customer ProfileやData Science Workspaceなどの下流のPlatformサービスで使用できるようになりました。 詳しくは、次のドキュメントを参照してください。

• リアルタイム顧客プロファイルの概要
• Data Science ワークスペースの概要

付録

以下の節では、ソースコネクタを使用する場合の追加情報について説明します。

データフローの無効化

データフローが作成されると、そのデータはすぐにアクティブになり、指定されたスケジュールに従ってデータを取り込みます。 アクティブなデータフローは、次の手順に従っていつでも無効にできます。

認証​画面で、無効にするデータフローに関連付けられている接続の名前を選択します。

ソースアクティビティ​ページが表示されます。 リストからアクティブなデータフローを選択し、画面の右側に​Properties​列を開きます。この列には​Enabled​トグルボタンが含まれています。 切り替えボタンをクリックして、データフローを無効にします。 同じ切り替えを使用して、データフローを無効にした後で再び有効にできます。

Profile母集団の受信データをアクティブ化

ソースコネクタからの受信データは、Real-time Customer Profileデータを豊かにし、埋め込むために使用できます。 Real-time Customer Profileデータの入力について詳しくは、プロファイルの母集団のチュートリアルを参照してください。