[ベータ版]{class="badge informative"}

UIを使用して​YOURSOURCE データをストリーミングするためのソース接続とデータフローを作成します

このテンプレートを使用する際に、斜体のすべての段落(この段落から始まる)を置き換えるか削除します。

最初に、ページ上部のメタデータ(タイトルと説明)を更新します。 このページのUICONTROLのすべてのインスタンスを無視してください。 これは、機械翻訳プロセスが適切にサポートする複数の言語にページを翻訳するのに役立つタグです。 ドキュメントを送信すると、ドキュメントにタグが追加されます。

このチュートリアルでは、Experience Platform ユーザーインターフェイスを使用して​YOURSOURCE ソースコネクタを作成する手順を説明します。

概要

顧客に提供する価値を含め、会社の概要を簡単に説明します。 製品ドキュメントのホームページへのリンクを追加して、詳細をご覧ください。

IMPORTANT
このソースコネクタとドキュメントのページは、YOURSOURCE チームによって作成および管理されています。 お問い合わせやアップデートのリクエストについては、更新にアクセスできるリンクまたはメールアドレスを挿入​で直接連絡してください。

前提条件

Adobe Experience Platform ユーザーインターフェイスでソースの設定を開始する前に、お客様が認識しておく必要がある情報をこのセクションに追加します。 次の程度である可能性があります:

  • 様は許可リストに追加する必要があります
  • 電子メールハッシュの要件
  • お客様の側にあるアカウントの詳細
  • プラットフォームに接続するための認証資格情報の取得方法

必要な資格情報の収集

YOURSOURCE​をExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。

資格情報
説明
資格情報1
ソースの認証資格情報に簡単な説明をここに追加してください
ソースの認証情報の例をここに追加してください
資格情報2
ソースの認証資格情報に簡単な説明をここに追加してください
ソースの認証情報の例をここに追加してください
資格情報3
ソースの認証資格情報に簡単な説明をここに追加してください
ソースの認証情報の例をここに追加してください

これらの資格情報について詳しくは、YOURSOURCE​認証ドキュメントを参照してください。 プラットフォームの認証ドキュメントへのリンクをここに追加してください

YOURSOURCE​をWebhookと統合する

ストリーミング SDKでは、Experience Platformと通信するためにWebhookをサポートできるソースが必要です。 このセクションでは、ソースをWebhookと統合するためにユーザーが実行する必要がある手順を指定する必要があります。

YOURSOURCE アカウントを接続

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

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

ストリーミング カテゴリで、YOURSOURCE​を選択し、データを追加​を選択します。

TIP
以下のスクリーンショットは例です。 ドキュメントを作成するときは、画像を実際のソースのスクリーンショットに置き換えてください。 同じマークアップパターンとカラー、および同じファイル名を使用できます。 スクリーンショットがExperience Platform UI画面全体をキャプチャしていることを確認してください。 スクリーンショットのアップロード方法について詳しくは、​ レビュー用ドキュメントの提出に関するガイドを参照してください。

Experience Platform ソースカタログ ​

データの選択

データを選択​手順が表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが提供されます。

  • インターフェイスの左側の部分は、アカウント内で利用可能なデータストリームを表示できるブラウザーです。
  • インターフェイスの右側では、JSON ファイルから最大100行のデータをプレビューできます。

ファイルをアップロード」を選択して、ローカルシステムからJSON ファイルをアップロードします。 または、アップロードするJSON ファイルを​ ファイルをドラッグ&ドロップ ​ パネルにドラッグ&ドロップすることもできます。

​ ソースワークフローのデータ追加手順。

ファイルをアップロードすると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 検索フィールド ​ ユーティリティを使用して、スキーマ内から特定の項目にアクセスすることもできます。

完了したら、次へ​を選択します。

​ ソースワークフローのプレビューステップ。

データフローの詳細

データフローの詳細 ステップが表示され、既存のデータセットを使用するか、データフロー用に新しいデータセットを確立するオプションと、データフローの名前と説明を入力する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も行うことができます。

完了したら、次へ​を選択します。

​ ソースワークフローのデータフロー詳細ステップ。

マッピング

​ マッピング ​手順が表示され、ソーススキーマのソースフィールドをターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが表示されます。

Experience Platformでは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに関するインテリジェントな推奨事項が提供されます。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。 マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、​ データ準備UI ガイド ​を参照してください。

ソースデータが正常にマッピングされたら、次へ​を選択します。

​ ソースワークフローのマッピングステップ。

レビュー

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

  • 接続:ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
  • データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。

データフローをレビューしたら、終了​をクリックし、データフローの作成に時間を割いてください。

​ ソースワークフローのレビュー手順。

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

ストリーミングデータフローを作成したら、ストリーミングエンドポイント URLを取得できるようになりました。 このエンドポイントは、Webhookの購読に使用され、ストリーミングソースがExperience Platformと通信できるようになります。

ストリーミングエンドポイントを取得するには、作成したデータフローの​ データフローアクティビティ ​ ページに移動し、​ プロパティ ​ パネルの下部からエンドポイントをコピーします。

​ データフローアクティビティのストリーミングエンドポイント。

次の手順

データフローを作成する残りの手順のワークフローはモジュール化されています。 ソースに関して特定のコールアウトを行う場合は、以下の追加リソースの節を参照してください。

このチュートリアルに従うことで、YOURSOURCE アカウントへの接続を確立できます。 次のチュートリアルに進み、​ データフローを設定してExperience Platformにデータを取り込むことができます

その他のリソース

これは、製品ドキュメントやその他の手順、スクリーンショット、ニュアンスに関する詳細なリンクを提供して、お客様が成功するために重要と考えるオプションのセクションです。 このセクションを使用して、ソースのワークフロー全体に関する情報やヒントを追加できます。特に、エンドユーザーが遭遇する可能性のある特定の「問題」がある場合に役立ちます。

recommendation-more-help
experience-platform-help-sources