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