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