ベータ版
ソースのテストと送信
作成対象:
- 開発者
セルフサービスソース(ストリーミング SDK)を使用して新しいソースをAdobe Experience Platformに統合する最後の手順は、新しいソースをテストして送信することです。 接続仕様を完了し、ストリーミングフロー仕様を更新したら、API または UI を使用してソースの機能のテストを開始できます。 成功したら、Adobe担当者に連絡して、新しいソースを送信できます。
次のドキュメントでは、Flow Service API を使用してソースをテストおよびデバッグする手順を説明します。
はじめに
- Experience Platform API を正常に呼び出す方法について詳しくは、Experience Platform API の概要を参照してください。
- Experience Platform API の資格情報の生成方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。
- Experience Platform API の Postman の設定方法について詳しくは、Developer Console との設定 Postman に関するチュートリアルを参照してください。
- テストとデバッグプロセスに役立つように、 セルフサービスソースの検証コレクションと環境をこちらからダウンロードし以下の手順に従ってください。
API を使用したソースのテスト
API を使用してソースをテストするには、ソースに関連する適切な環境変数を指定しながら、Postman で セルフサービスソース検証コレクションおよび環境を実行する必要があります。
テストを開始するには、まず Postman でコレクションと環境を設定する必要があります。 次に、テストする接続仕様 ID を指定します。
flowSpecificationId
と targetConnectionSpecId
は固定値です。x-api-key
x-api-key
スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
ーザー情報の取得方法については、Developer Console の設定および Postman に関するチュートリアルを参照してください。ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。Bearer authorizationToken
schemaId
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
schemaId
と共に返される meta:altId
。_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
5f3c3cedb2805c194ff0b69a
mappings
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
bf5286a9c1ad4266baca76ba3adc9366
flowSpecificationId
GenericStreamingAEP
のフロー仕様 ID。 固定値です。e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
40
startTime
1597784298
環境変数をすべて指定したら、Postman インターフェイスを使用してコレクションの実行を開始できます。 Postman インターフェイスで、Sources SSSs Verification Collection の横にある省略記号(…)を選択し、「コレクションを実行」を選択します。
Runner インターフェイスが表示され、データフローの実行順序を設定できます。 「SSS 検証コレクションを実行」を選択して、コレクションを実行します。
UI を使用したソースのテスト
UI でソースをテストするには、Experience Platform UI で組織のサンドボックスのソースカタログに移動します。 ここから、新しいソースが ストリーミング カテゴリの下に表示されます。
サンドボックスで新しいソースを使用できるようになったら、ソースワークフローに従って機能をテストする必要があります。 開始するには、「設定」を選択します。
データを追加手順が表示されます。ソースがデータをストリーミングできるかどうかをテストするには、インターフェイスの左側を使用して サンプル JSON データをアップロードします。 データがアップロードされると、インターフェイスの右側が更新され、データのファイル階層のプレビューが表示されます。 「次へ」を選択して次に進みます。
データフロー詳細ページでは、既存のデータセットと新しいデータセットのどちらを使用するかを選択できます。このプロセスの間に、プロファイルに取り込むデータを設定し、 エラー診断 や 部分取り込み などの設定を有効にすることもできます。
テストするには、「新しいデータセット」を選択し、出力データセット名を入力します。 この手順では、データセットにさらに情報を追加するためのオプションの説明を入力することもできます。 次に、「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。スキーマを選択したら、データフローの名前と説明を指定します。
終了したら、「次へ」を選択します。
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
Experience Platformは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイド」を参照してください
ソースデータが正常にマッピングされたら、「次へ」を選択します。
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続:アカウント名、ソースのタイプ、および使用しているストリーミングクラウドストレージソースに固有のその他の情報を表示します。
- データセットの割り当てとフィールドのマッピング:データフローに使用するターゲットデータセットとスキーマを表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
最後に、データフローのストリーミングエンドポイントを取得します。 このエンドポイントは、Webhook をサブスクライブするために使用され、ストリーミングソースがExperience Platformと通信できるようになります。 ストリーミングエンドポイントを取得するには、作成したデータフローの データフローアクティビティ ページに移動し、 プロパティ パネルの下部からエンドポイントをコピーします。
ソースの送信
ソースがワークフロー全体を完了できるようになったら、Adobe担当者に連絡し、他のExperience Platform組織と統合するためにソースを送信します。