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

ソースのテストと送信

セルフサービスソース（ストリーミングSDK）を使用してAdobe Experience Platformに新しいソースを統合する最後の手順は、新しいソースをテストして送信することです。 接続仕様を完了し、ストリーミングフロー仕様を更新したら、APIまたはUIを介してソースの機能のテストを開始できます。 問題が解決した場合は、Adobe担当者に連絡して新しいソースを送信できます。

次のドキュメントでは、Flow Service APIを使用してソースをテストおよびデバッグする手順について説明します。

はじめに

APIを使用したソースのテスト

APIを使用してソースをテストするには、ソースに関連する適切な環境変数を指定しながら、Postmanで​ セルフサービスソース検証コレクションと環境を実行する必要があります。

テストを開始するには、まずPostmanにコレクションと環境を設定する必要があります。 次に、テストする接続仕様IDを指定します。

すべての環境変数を指定したら、Postman インターフェイスを使用してコレクションの実行を開始できます。 Postman インターフェイスで、省略記号（…）を選択します Sources SSSs Verification Collectionの横にある「コレクションを実行」を選択します。

Runner インターフェイスが表示され、データフローの実行順序を設定できます。 「SSS検証コレクションを実行」を選択して、コレクションを実行します。

UIを使用したソースのテスト

UIでソースをテストするには、Experience Platform UIで組織のサンドボックスのソースカタログに移動します。 ここから、新しいソースが​ストリーミング カテゴリの下に表示されます。

サンドボックスで新しいソースが利用可能になった状態で、ソースワークフローに従って機能をテストする必要があります。 開始するには、設定​を選択します。

「​ データを追加」ステップが表示されます。 ソースがデータをストリーミングできるかどうかをテストするには、インターフェイスの左側を使用して、​ サンプル JSON データ ​をアップロードします。 データがアップロードされると、インターフェイスの右側がデータのファイル階層のプレビューに更新されます。 続行するには、次へ​を選択してください。

​ データフローの詳細 ページでは、既存のデータセットを使用するか、新しいデータセットを使用するかを選択できます。 このプロセスでは、プロファイルに取り込むデータを設定し、​ エラー診断や部分取り込みなどの設定を有効にすることもできます。

テストの場合は、新しいデータセット​を選択し、出力データセット名を指定します。 この手順では、オプションで説明を指定して、データセットに詳細情報を追加することもできます。 次に、詳細検索 オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。 スキーマを選択したら、データフローの名前と説明を指定します。

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

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

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

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

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

データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。

最後に、データフローのストリーミングエンドポイントを取得する必要があります。 このエンドポイントは、Webhookの購読に使用され、ストリーミングソースがExperience Platformと通信できるようになります。 ストリーミングエンドポイントを取得するには、作成したデータフローの​ データフローアクティビティ ​ ページに移動し、​ プロパティ ​ パネルの下部からエンドポイントをコピーします。

ソースの送信

ソースがワークフロー全体を完了できたら、次にExperience Platform担当者に連絡し、他のAdobe組織との統合のためにソースを送信します。