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

UI での Pendo ソース接続データフローおよびの作成

NOTE
Pendo ソースはベータ版です。ベータラベル付きソースの使用について詳しくは、 ソースの概要を参照してください。

このチュートリアルでは、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 用の Platform スキーマの作成 create-platform-schema

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

Pendo のスキーマの例を示す Platform UI。

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

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

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

Analytics カテゴリに移動して、Pendo ソースカードを表示します。 開始するには、「データを追加」を選択します。

Pendo カードを含む Platform UI ソースカタログ

データの選択 select-data

データを選択 手順が表示され、Platform に取り込むデータを選択するためのインターフェイスが表示されます。

  • インターフェイスの左側は、アカウント内で利用可能なデータストリームを表示できるブラウザーです。
  • インターフェイスの右側の部分では、JSON ファイルから最大 100 行のデータをプレビューできます。

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

ソースワークフローのデータを追加ステップ

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

終了したら、「次へ」を選択します。

ソースワークフローのプレビュー手順

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

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

終了したら、「次へ」を選択します。

ソースワークフローのデータフローの詳細手順。

マッピング mapping

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

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

以下にリストされているマッピングは必須であり、​ レビュー ​ 段階に進む前に設定する必要があります。

ターゲットフィールド
説明
uniqueId
イベントの Pendo 識別子。

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

ソースワークフローのマッピングステップ

レビュー review

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

  • 接続:ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
  • データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。

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

ソースワークフローのレビュー手順。

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

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

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

  • データフロー ID
  • ストリーミングエンドポイント

データフロー ID および ストリーミングエンドポイント を取得するには、作成したばかりのデータフローの ​ データフローアクティビティ ​ ページに移動し、​ プロパティ ​ パネルの下部から詳細をコピーします。

データフローアクティビティのストリーミングエンドポイント。

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

Pendo での Webhook の設定 set-up-webhook

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

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

Webhook エンドポイントフィールドを示す Pendo UI のスクリーンショット

TIP
様々なイベントカテゴリを購読して、Pendo インスタンスから Platform に送信するイベントの種類を決定できます。 様々なイベントについて詳しくは、Pendo ドキュメントを参照してください。

次の手順 next-steps

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

その他のリソース additional-resources

以下の節では、Pendo ソースを使用する際に参照できるその他のリソースを示します。

検証 validation

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

  • Pendo Reports > Chat History ページをチェックすると、Pendo によってキャプチャされているイベントを識別できます。

チャット履歴を示す Pendo UI のスクリーンショット

  • Platform UI で、ソースカタログの Pendo ーザーカードメニューの横にある データフローを表示 を選択します。 次に、「データセットをプレビュー」をクリックして、Pendo 内で設定した Webhook 用に取り込まれたデータを検証します。

取り込んだイベントを示す Platform UI のスクリーンショット

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

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

エラーを示す Platform UI のスクリーンショット。

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

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

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