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

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

最終更新日： 2025年10月14日

トピック：
{"id":"c132d929-fa62-4271-803e-b823be07b914"}

作成対象：

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

NOTE

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

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

はじめに getting-started

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

Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。

前提条件 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のスキーマの例を示すExperience Platform UI。

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

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

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

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

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

データの選択 select-data

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

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

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

ソースワークフローのデータ追加手順。

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

完了したら、次へを選択します。

ソースワークフローのプレビューステップ。

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

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

完了したら、次へを選択します。

ソースワークフローのデータフロー詳細ステップ。

マッピング mapping

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

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

以下に示すマッピングは必須であり、レビュー段階に進む前に設定する必要があります。

ターゲットフィールド

説明

uniqueId

イベントのPendo識別子。

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

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

レビュー review

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

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

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

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

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

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

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

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

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

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

ストリーミングエンドポイントとデータフロー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を入力します。

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

TIP

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

次の手順 next-steps

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