の作成 HTTP API UI を使用したストリーミング接続

Last update: Tue Nov 14 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
ソース

作成対象：

開発者

このチュートリアルでは、ソースワークスペース。

はじめに

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

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

ストリーミング接続の作成

Platform の UI で、左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。

の下 ストリーミング カテゴリ、選択 HTTP API 次に、「 データを追加.

カタログ

The HTTP API アカウントに接続 ページが表示されます。このページでは、新しい資格情報または既存の資格情報を使用できます。

既存のアカウント

既存のアカウントを使用するには、新しいデータフローを作成する HTTP API アカウントを選択し、「」を選択します次へをクリックして続行します。

既存のアカウント

新しいアカウント

新しいアカウントを作成する場合は、「新しいアカウント」を選択します。表示される入力フォームで、アカウント名とオプションの説明を入力します。また、次の設定プロパティを指定するオプションも取得されます。

認証: このプロパティは、ストリーミング接続で認証を必要とするかどうかを決定します。認証を実行すると、データは信頼できるソースから収集されます。個人を特定できる情報 (PII) を扱う場合は、このプロパティをオンにする必要があります。デフォルトでは、このプロパティはオフになっています。
XDM 互換: このプロパティは、このストリーミング接続が XDM スキーマと互換性のあるイベントを送信するかどうかを示します。デフォルトでは、このプロパティはオフになっています。

終了したら、「」を選択します。 ソースに接続 次に、「次へをクリックして続行します。

新規アカウント

データの選択

HTTP API 接続を作成した後、 データを選択 の手順が表示され、データをアップロードおよびプレビューするためのインターフェイスが提供されます。

選択 ファイルをアップロード をクリックしてデータをアップロードします。または、ファイルをドラッグ&ドロップ」セクションに表示されます。

add-data

データのアップロード時に、インターフェイスの右側を使用して、ファイル階層をプレビューできます。「次へ」を選択して次に進みます。

preview-sample-data

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

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

The HTTP API ソースは、JSON ファイルの取り込みをサポートしています。 JSON ファイルが XDM に対する苦情としてマークされている場合、手動設定は必要ありません。そうでない場合は、マッピングを明示的に設定する必要があります。

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

新しいデータセットの作成

新しいデータセットを作成するには、「 新しいデータセット. 表示されるフォームで、名前、説明（オプション）、およびデータセットのターゲットスキーマを指定します。次を選択した場合、 Profileが有効なスキーマの場合は、データセットを Profile-enabled。

new-dataset

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

既存のデータセットを使用するには、「」を選択します。 既存のデータセット. 表示されるフォームで、使用するデータセットを選択します。データセットを選択したら、データセットを次のいずれかにするかを選択できます Profile-enabled。

existing-dataset

標準フィールドをマッピング

必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドを使用した包括的な手順については、データ準備 UI ガイド.

新しいソースフィールドを追加するには、「 新しいマッピングを追加.

add-new-mapping

新しいソースフィールドとターゲットフィールドの組み合わせが表示されます。新しいソースフィールドを追加するには、ソースフィールドを選択入力バー。

select-source-field

The 属性を選択パネルを使用すると、ファイル階層を参照し、特定のソースフィールドを選択してターゲット XDM フィールドにマッピングできます。マッピングするソースフィールドを選択したら、選択をクリックして続行します。

select-attributes

ソースフィールドを選択して、マッピング先の適切なターゲット XDM フィールドを識別できるようになりました。ターゲットフィールドセクションの下のスキーマアイコンを選択します。

select-target-field

The ソースフィールドをターゲットフィールドにマッピングウィンドウが表示され、ターゲットデータセットのスキーマを調べるためのインターフェイスが提供されます。ソースフィールドに一致するターゲットフィールドを選択し、「」を選択します。選択をクリックして続行します。

map-to-target-field

ソースフィールドがすべて適切なターゲット XDM フィールドにマッピングされたら、「」を選択します。次へ

data-prep-complete

データフローの詳細

The データフローの詳細 手順が表示されます。このページでは、名前とオプションの説明を入力して、作成したデータフローの詳細を指定できます。

データフローの詳細を指定したら、「」を選択します。次へ.

dataflow-detail

レビュー

The レビュー 手順が表示され、作成前にデータフローの詳細を確認できます。詳細は、次のカテゴリ内にグループ化されます。

接続：アカウント名、ソースプラットフォームおよびソース名が表示されます。
データセットの割り当てとフィールドのマッピング：ターゲットデータセットと、データセットが準拠するスキーマを表示します。

詳細が正しいことを確認したら、「」を選択します。完了.

レビュー

ストリーミングエンドポイント URL の取得

接続が作成され、ソースの詳細ページが表示されます。このページには、以前に実行したデータフロー、ID、ストリーミングエンドポイント URL を含む、新しく作成した接続の詳細が表示されます。

endpoint

次の手順

このチュートリアルに従って、ストリーミング HTTP 接続を作成し、ストリーミングエンドポイントを使用して様々な方法でアクセスできるようにしました Data Ingestion API API でストリーミング接続を作成する手順については、ストリーミング接続の作成に関するチュートリアルを参照してください。

データを Platform にストリーミングする方法については、次のチュートリアルをお読みください：時系列データのストリーミングまたはストリーミングレコードデータ.

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089