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

Pendo ソース接続データフローを作成し、UIで

このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用してPendo ソース接続とデータフローを作成する手順を説明します。

はじめに getting-started

このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

前提条件 prerequisites

次の節では、Pendo ソース接続を作成する前に完了する前提条件について説明します。

Pendoのソーススキーマを定義するサンプル JSON prerequisites-json-schema

Pendo ソース接続を作成する前に、ソーススキーマを指定する必要があります。 以下のJSONを使用できます。

{
  "accountId": "58f79ee324d3f",
  "timestamp": 1673372516,
  "visitorId": "test@test.com",
  "uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
  "properties": {
    "guideProperties": {
  "name": "Guide Conversion Test"
  }
}
}

詳しくは、Pendo webhook ガイド ​を参照してください。

PendoのExperience Platform スキーマを作成 create-platform-schema

また、まず、ソースに使用するExperience Platform スキーマを作成する必要があります。 スキーマの作成方法の包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。

Pendo アカウントを接続 connect-account

Experience Platform UIで、左側のナビゲーションから「Sources」を選択してSources ワークスペースにアクセスし、Experience Platformで使用可能なソースカタログを表示します。

Categories メニューを使用して、カテゴリ別にソースをフィルタリングします。 または、検索バーにソース名を入力して、カタログから特定のソースを検索します。

Analytics カテゴリに移動して、Pendo ソースカードを確認します。 開始するには、Add data​を選択します。

データの選択 select-data

Select data ステップが表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが提供されます。

ローカルシステムからJSON ファイルをアップロードするには、Upload files​を選択します。 または、アップロードするJSON ファイルをDrag and drop files パネルにドラッグ&ドロップすることもできます。

ファイルをアップロードすると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 Search field ユーティリティを使用して、スキーマ内から特定の項目にアクセスすることもできます。

終了したら「Next」を選択します。

データフローの詳細 dataflow-detail

データフローの詳細 ステップが表示され、既存のデータセットを使用するか、データフロー用に新しいデータセットを確立するオプションと、データフローの名前と説明を入力する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も行うことができます。

終了したら「Next」を選択します。

マッピング mapping

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

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

以下に示すマッピングは必須であり、Review ステージに進む前に設定する必要があります。

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

レビュー review

Review ステップが表示され、新しいデータフローを作成する前に確認できます。 詳細は、次のカテゴリに分類されます。

データフローをレビューしたら、Finish​を選択し、データフローの作成に時間を割いてください。

ストリーミングエンドポイント URLの取得 get-streaming-endpoint-url

ストリーミングデータフローを作成したら、ストリーミングエンドポイント URLを取得できるようになりました。 このエンドポイントは、Webhookの購読に使用され、ストリーミングソースがExperience Platformと通信できるようになります。

PendoでWebhookの設定に使用するURLを作成するには、次の情報を取得する必要があります。

Dataflow ID​と​ Streaming endpoint ​を取得するには、作成したばかりのデータフローのDataflow activity ページに移動し、Properties パネルの下部から詳細をコピーします。

ストリーミングエンドポイントとデータフローIDを取得したら、次のパターンに基づいてURLを作成します：{STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}。 例えば、構築されたWebhook URLは次のようになります。https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95

PendoでWebhookを設定 set-up-webhook

次に、Pendoにアカウントにログインし、Webhookを作成します。 Pendo ユーザーインターフェイスを使用してWebhookを作成する手順については、Pendo Webhookの作成に関するガイド ​を参照してください。

Webhookを作成したら、Pendo Webhookの設定ページに移動し、URL フィールドにWebhook URLを入力します。

次の手順 next-steps

このチュートリアルに従うことで、Pendo データをExperience Platformに取り込むためのストリーミングデータフローが正常に設定されました。 取り込まれるデータを監視するには、Experience Platform UIを使用したストリーミングデータフローの監視に関するガイドを参照してください。

その他のリソース additional-resources

以下の節では、Pendo ソースを使用する際に参照できる追加のリソースについて説明します。

検証 validation

ソースを正しく設定し、Pendo個のメッセージを取り込んでいることを検証するには、次の手順に従います。

チャット履歴を示す

取り込まれたイベントを示す

エラーとトラブルシューティング errors-and-troubleshooting

データフロー実行を確認する際に、次のエラーメッセージが表示される場合があります：The message can't be validated ... uniqueID:expected minLength:1, actual 0].

エラーを示す

このエラーを修正するには、uniqueID マッピングが設定されていることを確認する必要があります。 追加のガイダンスについては、​ マッピング ​の節を参照してください。

詳細については、Pendo ヘルプセンターを参照してください。