[ベータ版]{class="badge informative"}
UIを使用してYOURSOURCE データをストリーミングするためのソース接続とデータフローを作成します
このテンプレートを使用する際に、斜体のすべての段落(この段落から始まる)を置き換えるか削除します。
最初に、ページ上部のメタデータ(タイトルと説明)を更新します。 このページのUICONTROLのすべてのインスタンスを無視してください。 これは、機械翻訳プロセスが適切にサポートする複数の言語にページを翻訳するのに役立つタグです。 ドキュメントを送信すると、ドキュメントにタグが追加されます。
このチュートリアルでは、Experience Platform ユーザーインターフェイスを使用してYOURSOURCE ソースコネクタを作成する手順を説明します。
概要
顧客に提供する価値を含め、会社の概要を簡単に説明します。 製品ドキュメントのホームページへのリンクを追加して、詳細をご覧ください。
前提条件
Adobe Experience Platform ユーザーインターフェイスでソースの設定を開始する前に、お客様が認識しておく必要がある情報をこのセクションに追加します。 次の程度である可能性があります:
- 様は許可リストに追加する必要があります
- 電子メールハッシュの要件
- お客様の側にあるアカウントの詳細
- プラットフォームに接続するための認証資格情報の取得方法
必要な資格情報の収集
YOURSOURCEをExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。
これらの資格情報について詳しくは、YOURSOURCE認証ドキュメントを参照してください。 プラットフォームの認証ドキュメントへのリンクをここに追加してください。
YOURSOURCEをWebhookと統合する
ストリーミング SDKでは、Experience Platformと通信するためにWebhookをサポートできるソースが必要です。 このセクションでは、ソースをWebhookと統合するためにユーザーが実行する必要がある手順を指定する必要があります。
YOURSOURCE アカウントを接続
Experience Platform UIで、左側のナビゲーションバーから「ソース」を選択して、 ソース ワークスペースにアクセスします。 カタログ 画面には、アカウントを作成するための様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。 または、使用する特定のソースを検索オプションを使用して探すこともできます。
ストリーミング カテゴリで、YOURSOURCEを選択し、データを追加を選択します。
データの選択
データを選択手順が表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが提供されます。
- インターフェイスの左側の部分は、アカウント内で利用可能なデータストリームを表示できるブラウザーです。
- インターフェイスの右側では、JSON ファイルから最大100行のデータをプレビューできます。
「ファイルをアップロード」を選択して、ローカルシステムからJSON ファイルをアップロードします。 または、アップロードするJSON ファイルを ファイルをドラッグ&ドロップ パネルにドラッグ&ドロップすることもできます。
ファイルをアップロードすると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 検索フィールド ユーティリティを使用して、スキーマ内から特定の項目にアクセスすることもできます。
完了したら、次へを選択します。
データフローの詳細
データフローの詳細 ステップが表示され、既存のデータセットを使用するか、データフロー用に新しいデータセットを確立するオプションと、データフローの名前と説明を入力する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も行うことができます。
完了したら、次へを選択します。
マッピング
マッピング 手順が表示され、ソーススキーマのソースフィールドをターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが表示されます。
Experience Platformでは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに関するインテリジェントな推奨事項が提供されます。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。 マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備UI ガイド を参照してください。
ソースデータが正常にマッピングされたら、次へを選択します。
レビュー
レビュー手順が表示され、新しいデータフローを作成する前に確認できます。 詳細は、次のカテゴリに分類されます。
- 接続:ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、終了をクリックし、データフローの作成に時間を割いてください。
ストリーミングエンドポイント URLの取得
ストリーミングデータフローを作成したら、ストリーミングエンドポイント URLを取得できるようになりました。 このエンドポイントは、Webhookの購読に使用され、ストリーミングソースがExperience Platformと通信できるようになります。
ストリーミングエンドポイントを取得するには、作成したデータフローの データフローアクティビティ ページに移動し、 プロパティ パネルの下部からエンドポイントをコピーします。
次の手順
データフローを作成する残りの手順のワークフローはモジュール化されています。 ソースに関して特定のコールアウトを行う場合は、以下の追加リソースの節を参照してください。
このチュートリアルに従うことで、YOURSOURCE アカウントへの接続を確立できます。 次のチュートリアルに進み、 データフローを設定してExperience Platformにデータを取り込むことができます。
その他のリソース
これは、製品ドキュメントやその他の手順、スクリーンショット、ニュアンスに関する詳細なリンクを提供して、お客様が成功するために重要と考えるオプションのセクションです。 このセクションを使用して、ソースのワークフロー全体に関する情報やヒントを追加できます。特に、エンドユーザーが遭遇する可能性のある特定の「問題」がある場合に役立ちます。