ベータ版
ソースのテストと送信
メモセルフサービスソース（ストリーミング 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 | Experience Platform API への呼び出しの認証に使用される一意の ID。 サー x-api-key スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。 | c8d9a2f5c1e03789bd22e8efdd1bdc1b |
x-gw-ims-org-id | 製品およびサービスを所有またはライセンスし、そのメンバーへのアクセスを許可できる法人組織。 x-gw-ims-org-id ーザー情報の取得方法については、Developer Console の設定および Postman に関するチュートリアルを参照してください。 | ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg |
authorizationToken | Experience Platform API を呼び出すために必要な認証トークン。 サー authorizationToken スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。 | Bearer authorizationToken |
schemaId | ソースデータをExperience Platformで使用するには、必要に応じてターゲットスキーマを作成してソースデータを構造化する必要があります。 ターゲット XDM スキーマの作成手順について詳しくは、 API を使用したスキーマの作成に関するチュートリアルを参照してください。 | 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 | ターゲットデータセットの作成手順について詳しくは、 API を使用したデータセットの作成に関するチュートリアルを参照してください。 | 5f3c3cedb2805c194ff0b69a |
mappings | マッピングセットを使用すると、ソーススキーマ内のデータと宛先スキーマのデータとのマッピング方法を定義できます。マッピングの作成方法に関する詳細な手順については、API を使用したマッピングセットの作成に関するチュートリアルを参照してください。 | [{"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 | マッピングセットに対応する一意の ID。 | bf5286a9c1ad4266baca76ba3adc9366 |
connectionSpecId | ソースに対応する接続仕様 ID。 これは、 新しい接続仕様の作成後に生成した ID です。 | 2e8580db-6489-4726-96de-e33f5f60295f |
flowSpecificationId | GenericStreamingAEP のフロー仕様 ID。 固定値です。 | e77fde5a-22a8-11ed-861d-0242ac120002 |
targetConnectionSpecId | 取り込まれたデータが取り込まれたデータレイクのターゲット接続 ID。 固定値です。 | c604ff05-7f1a-43c0-8e18-33bf874cb11c |
verifyWatTimeInSecond | フロー実行の完了を確認するときに従う、指定された時間間隔です。 | 40 |
startTime | データフローに指定された開始時間。 開始時間は UNIX 時間でフォーマットする必要があります。 | 1597784298 |
環境変数をすべて指定したら、Postman インターフェイスを使用してコレクションの実行を開始できます。 Postman インターフェイスで、Sources SSSs Verification Collection の横にある省略記号（…）を選択し、「コレクションを実行」を選択します。
Runner インターフェイスが表示され、データフローの実行順序を設定できます。 「SSS 検証コレクションを実行」を選択して、コレクションを実行します。
メモ
UI を使用したソースのテスト
UI でソースをテストするには、Experience Platform UI で組織のサンドボックスのソースカタログに移動します。 ここから、新しいソースが ストリーミング カテゴリの下に表示されます。
サンドボックスで新しいソースを使用できるようになったら、ソースワークフローに従って機能をテストする必要があります。 開始するには、「設定」を選択します。
データを追加手順が表示されます。ソースがデータをストリーミングできるかどうかをテストするには、インターフェイスの左側を使用して サンプル JSON データをアップロードします。 データがアップロードされると、インターフェイスの右側が更新され、データのファイル階層のプレビューが表示されます。 「次へ」を選択して次に進みます。
データフロー詳細ページでは、既存のデータセットと新しいデータセットのどちらを使用するかを選択できます。このプロセスの間に、プロファイルに取り込むデータを設定し、 エラー診断 や 部分取り込み などの設定を有効にすることもできます。
テストするには、「新しいデータセット」を選択し、出力データセット名を入力します。 この手順では、データセットにさらに情報を追加するためのオプションの説明を入力することもできます。 次に、「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。スキーマを選択したら、データフローの名前と説明を指定します。
終了したら、「次へ」を選択します。
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
Experience Platformは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイド」を参照してください
ソースデータが正常にマッピングされたら、「次へ」を選択します。
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続：アカウント名、ソースのタイプ、および使用しているストリーミングクラウドストレージソースに固有のその他の情報を表示します。
- データセットの割り当てとフィールドのマッピング：データフローに使用するターゲットデータセットとスキーマを表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
最後に、データフローのストリーミングエンドポイントを取得します。 このエンドポイントは、Webhook をサブスクライブするために使用され、ストリーミングソースがExperience Platformと通信できるようになります。 ストリーミングエンドポイントを取得するには、作成したデータフローの データフローアクティビティ ページに移動し、 プロパティ パネルの下部からエンドポイントをコピーします。
