UI を使用した HTTP API ストリーミング接続の作成
このチュートリアルでは、 ソース ワークスペースを使用してストリーミングソース接続を作成する手順を説明します。
はじめに
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
ストリーミング接続の作成
Platform の UI で、左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
ストリーミング カテゴリで、「HTTP API」を選択し、次に「データを追加」を選択します。
HTTP API アカウントを接続 ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント
既存のアカウントを使用するには、新しいデータフローの作成に使用する HTTP API アカウントを選択し、「次へ」を選択して続行します。
新しいアカウント
新しいアカウントを作成する場合は、「新しいアカウント」を選択します。表示される入力フォームで、アカウント名と説明（オプション）を入力します。 また、次の設定プロパティを指定するオプションも利用できます。
- Authentication: このプロパティは、ストリーミング接続で認証が必要かどうかを決定します。 認証を実行すると、データは信頼できるソースから収集されます。個人情報（PII）を扱う場合は、このプロパティをオンにする必要があります。 デフォルトでは、このプロパティはオフになっています。
- XDM 互換 : このプロパティは、このストリーミング接続が XDM スキーマと互換性のあるイベントを送信するかどうかを示します。 デフォルトでは、このプロパティはオフになっています。
終了したら ソースに接続 を選択し、「次へ を選択して続行します。
データの選択
HTTP API 接続を作成すると、データを選択 手順が表示され、データをアップロードおよびプレビューするためのインターフェイスが表示されます。
ファイルをアップロード を選択して、データをアップロードします。 または、データをインターフェイスの ファイルをドラッグ&ドロップ セクションにドラッグ&ドロップすることもできます。
データをアップロードした状態で、インターフェイスの右側を使用してファイル階層をプレビューできます。 「次へ」を選択して次に進みます。
XDM スキーマへのデータフィールドのマッピング
マッピング 手順が表示され、ソースデータを Platform データセットにマッピングするためのインターフェイスが表示されます。
HTTP API ソースは JSON ファイルの取り込みをサポートしています。 JSON ファイルが XDM 準拠としてマークされている場合、手動設定は必要ありません。 そうでない場合、マッピングを明示的に設定する必要があります。
取り込むインバウンドデータのデータセットを選択します。既存のデータセットを使用することも、新しいデータセットを作成することもできます。
新しいデータセットの作成
新しいデータセットを作成するには、「新しいデータセット」を選択します。 表示されるフォームで、データセットの名前、説明（オプション）、ターゲットスキーマを入力します。 Profile 対応スキーマを選択した場合、データセットも Profile 対応にする必要があるかどうかを選択できます。
既存のデータセットを使用する
既存のデータセットを使用するには、「既存のデータセット」を選択します。 表示されるフォームで、使用するデータセットを選択します。 データセットを選択したら、データセットを Profile 有効にする必要があるかどうかを選択できます。
標準フィールドをマッピング
必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイドを参照してください。
新しいソースフィールドを追加するには、「新しいマッピングを追加」を選択します。
新しいソースフィールドとターゲットフィールドのペアが表示されます。 新しいソースフィールドを追加するには、「ソースフィールドを選択 入力バーの横にある矢印アイコンを選択し す。
属性を選択 パネルを使用すると、ファイル階層を調べ、ターゲット XDM フィールドにマッピングする特定のソースフィールドを選択できます。 マッピングするソースフィールドを選択したら、「選択 をクリックして続行します。
ソースフィールドを選択した状態で、マッピング先の適切なターゲット XDM フィールドを特定できるようになりました。 「ターゲットフィールド」セクションでスキーマアイコンを選択します。
ソースフィールドをターゲットフィールドにマッピング ウィンドウが開き、ターゲットデータセットのスキーマを調べるためのインターフェイスが表示されます。 ソースフィールドに一致するターゲットフィールドを選択し、「選択 をクリックして続行します。
ソースフィールドがすべて適切なターゲット XDM フィールドにマッピングされたら、「次へ を選択します
データフローの詳細
データフロー詳細 手順が表示されます。 このページでは、名前とオプションの説明を指定して、作成したデータフローの詳細を指定できます。
データフローの詳細を入力したら、「次へ」を選択します。
レビュー
レビュー 手順が表示され、データフローを作成する前に詳細をレビューできます。 詳細は、次のカテゴリ内でグループ化されます。
- 接続：アカウント名、ソースプラットフォーム、ソース名が表示されます。
- データセットの割り当てとフィールドのマッピング：ターゲットデータセットと、そのデータセットが準拠するスキーマを表示します。
詳細が正しいことを確認したら、「終了」を選択します。
ストリーミングエンドポイント URL を取得
接続が作成されると、ソースの詳細ページが表示されます。 このページには、以前に実行したデータフロー、ID、ストリーミングエンドポイント URL など、新しく作成した接続の詳細が表示されます。
次の手順
このチュートリアルでは、ストリーミング HTTP 接続を作成し、ストリーミングエンドポイントを使用して様々な Data Ingestion API にアクセスできるようになりました。 API でストリーミング接続を作成する手順については、ストリーミング接続の作成に関するチュートリアルを参照してください。
データを Platform にストリーミングする方法については、 時系列データのストリーミングまたは レコードデータのストリーミングに関するチュートリアルを参照してください。