ベータ版
UI での Pendo ソース接続データフローおよびの作成
作成対象:
- 開発者
このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して Pendo ソース接続とデータフローを作成する手順について説明します。
はじめに
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
前提条件
次の節では、Pendo ソース接続を作成する前に完了すべき前提条件について説明します。
Pendo のソーススキーマを定義するサンプル JSON
Pendo ソース接続を作成する前に、ソーススキーマを指定する必要があります。 以下の JSON を使用できます。
{
"accountId": "58f79ee324d3f",
"timestamp": 1673372516,
"visitorId": "test@test.com",
"uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
"properties": {
"guideProperties": {
"name": "Guide Conversion Test"
}
}
}
詳しくは、Pendo Webhook に関するガイドを参照してください。
Pendo 用のExperience Platform スキーマの作成
また、ソースに使用するExperience Platform スキーマを最初に作成する必要があります。 スキーマの作成方法に関する包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。
Pendo アカウントを接続
Experience Platformの UI で、左側のナビゲーションから Sources を選択し、Sources ワークスペースにアクセスして、Experience Platformで使用可能なソースのカタログを表示します。
カテゴリ メニューを使用して、カテゴリ別にソースをフィルタリングします。 または、検索バーにソース名を入力して、カタログから特定のソースを検索します。
Analytics カテゴリに移動して、Pendo ソースカードを表示します。 開始するには、「データを追加」を選択します。
データの選択
データを選択 手順が表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが表示されます。
- インターフェイスの左側は、アカウント内で利用可能なデータストリームを表示できるブラウザーです。
- インターフェイスの右側の部分では、JSON ファイルから最大 100 行のデータをプレビューできます。
ファイルをアップロード を選択して、ローカルシステムから JSON ファイルをアップロードします。 または、アップロードする JSON ファイルを ファイルをドラッグ&ドロップ パネルにドラッグ&ドロップすることもできます。
ファイルがアップロードされると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 また、 フィールドを検索 ユーティリティを使用して、スキーマ内から特定の項目にアクセスすることもできます。
終了したら、「次へ」を選択します。
データフローの詳細
データフローの詳細 手順が表示され、既存のデータセットを使用するか、データフローの新しいデータセットを確立するかのオプションと、データフローの名前と説明を入力する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も指定できます。
終了したら、「次へ」を選択します。
マッピング
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
Experience Platformは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイドを参照してください。
以下にリストされているマッピングは必須であり、 レビュー 段階に進む前に設定する必要があります。
uniqueId
ソースデータが正常にマッピングされたら、「次へ」を選択します。
レビュー
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続:ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
ストリーミングエンドポイント 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 の設定
次に、Pendo でアカウントにログインし、Webhook を作成します。 Pendo ユーザーインターフェイスを使用して Webhook を作成する手順については、Pendo Webhook の作成に関するガイドを参照してください。
Webhook が作成されたら、Pendo Webhook の設定ページに移動し、Webhook の URL を URL フィールドに入力します。
次の手順
このチュートリアルでは、Pendo データをExperience Platformに取り込むためのストリーミングデータフローを正常に設定しました。 取り込まれるデータを監視するには、Experience Platform UI を使用したストリーミングデータフローのモニタリングのガイドを参照してください。
その他のリソース
以下の節では、Pendo ソースを使用する際に参照できるその他のリソースを示します。
検証
ソースを正しく設定したことと、メッセージが取り込まれてい Pendo ことを検証するには、次の手順に従います。
- Pendo Reports > Chat History ページをチェックすると、Pendo によってキャプチャされているイベントを識別できます。
- Experience Platform UI で、ソースカタログの Pendo ーザーカードメニューの横にある データフローを表示 を選択します。 次に、「データセットをプレビュー」をクリックして、Pendo 内で設定した Webhook 用に取り込まれたデータを検証します。
エラーとトラブルシューティング
データフローの実行を確認すると、次のエラーメッセージが表示される場合があります。The message can't be validated ... uniqueID:expected minLength:1, actual 0].
このエラーを修正するには、uniqueID マッピングが設定されていることを確認する必要があります。 その他のガイダンスについては、Mmpping の節を参照してください。
詳しくは、Pendo ヘルプセンターを参照してください。