ソースの送信

セルフサービスソース(Batch SDK)を使用して新しいソースをAdobe Experience Platformに統合する最後の手順は、検証のためにソースをテストすることです。 成功したら、Adobe担当者に連絡して、新しいソースを送信できます。

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

はじめに

ソースのテスト

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

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

authSpecName を指定

接続仕様 ID を入力したら、ベース接続に使用する authSpecName を指定する必要があります。 選択に応じて、OAuth 2 Refresh Code または Basic Authentication のいずれかになります。 authSpecName を指定したら、必要な資格情報を環境に含める必要があります。 例えば、authSpecNameOAuth 2 Refresh Code として指定する場合は、OAuth 2 に必要な資格情報(hostaccessToken)を指定する必要があります。

sourceSpec を指定

認証仕様パラメータを追加した状態で、次にソース仕様から必要なプロパティを追加する必要があります。 必要なプロパティは、sourceSpec.spec.properties にあります。 以下の MailChimp Members の例では、必須プロパティは listId のみです。これは listId と、Postman 環境に対応する ID 値を意味します。

"spec": {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "description": "Define user input parameters to fetch resource values.",
  "properties": {
    "listId": {
      "type": "string",
      "description": "listId for which members need to fetch."
    }
  }
}

認証およびソース仕様パラメーターを指定したら、残りの環境変数の設定を開始できます。参照については、次の表を参照してください。

NOTE
以下に示すサンプル変数はすべて、更新が必要なプレースホルダー値です。ただし、flowSpecificationIdtargetConnectionSpecId は固定値です。
パラメーター
説明
x-api-key
Experience PlatformAPI への呼び出しの認証に使用される一意の 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 PlatformAPI を呼び出すために必要な認証トークン。 サー authorizationToken スの取得方法について詳しくは、Experience Platform API の認証とアクセスに関するチュートリアルを参照してください。
Bearer authorizationToken
schemaId
ソースデータを 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
RestStorageToAEP のフロー仕様 ID。 固定値です
6499120c-0b15-42dc-936e-847ea3c24d72
targetConnectionSpecId
取り込まれたデータが取り込まれたデータレイクのターゲット接続 ID。 固定値です
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
フロー実行の完了を確認するときに従う、指定された時間間隔です。
40
startTime
データフローに指定された開始時間。 開始時間は UNIX 時間でフォーマットする必要があります。
1597784298

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

ランナー

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

NOTE
Platform UI でソース監視ダッシュボードを使用する場合は、実行順序チェックリストから フローを削除 を無効にできます。 ただし、テストが完了したら、テストフローが削除されていることを確認する必要があります。

run-collection

ソースの送信

ソースがワークフロー全体を完了できるようになったら、Adobe担当者に連絡し、統合のためにソースを送信します。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089