[ベータ版]{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 をサポートできるソースが必要です。 この節では、YOURSOURCE を 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
337b99bb-92fb-42ae-b6b7-c7042161d089