Pendo ソースはベータ版です。詳しくは、 ソースの概要 ベータラベル付きのソースの使用に関する詳細
このチュートリアルでは、 Pendo Adobe Experience Platformユーザーインターフェイスを使用したソース接続とデータフロー。
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
次の節では、 Pendo ソース接続。
を作成する前に Pendo ソース接続の場合は、ソーススキーマを指定する必要があります。 以下の JSON を使用できます。
{
"accountId": "58f79ee324d3f",
"timestamp": 1673372516,
"visitorId": "test@test.com",
"uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
"properties": {
"guideProperties": {
"name": "Guide Conversion Test"
}
}
}
詳しくは、 Pendo ウェブフックのガイド.
また、最初に、ソースに使用する Platform スキーマを作成する必要があります。 に関するチュートリアルを参照してください。 Platform スキーマの作成 スキーマの作成方法に関する包括的な手順を参照してください。
Platform UI で、「 ソース 左側のナビゲーションから ソース workspace を参照し、Experience Platformで使用可能なソースのカタログを確認します。
以下を使用: カテゴリ メニューを使用して、ソースをカテゴリでフィルタリングできます。 または、検索バーにソース名を入力して、カタログから特定のソースを検索します。
次に移動: Analytics 表示するカテゴリ Pendo ソースカード。 最初に、 データを追加.
この データを選択 の手順が表示され、Platform に取り込むデータを選択するためのインターフェイスが提供されます。
選択 ファイルをアップロード をクリックして、ローカルシステムから JSON ファイルをアップロードします。 または、アップロードする JSON ファイルをにドラッグ&ドロップすることもできます ファイルをドラッグ&ドロップ パネル。
ファイルがアップロードされると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 また、 検索フィールド スキーマ内から特定の項目にアクセスするユーティリティ。
終了したら、「次へ」を選択します。
この データフローの詳細 手順が表示され、既存のデータセットを使用するか、データフローの新しいデータセットを確立するか、およびデータフローの名前と説明を指定する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も指定できます。
終了したら、「次へ」を選択します。
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
Platform は、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対するインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドを使用した包括的な手順については、 データ準備 UI ガイド.
以下に示すマッピングは必須で、 レビュー ステージ。
ターゲットフィールド | 説明 |
---|---|
uniqueId |
この Pendo イベントの識別子。 |
ソースデータが正常にマッピングされたら、「 」を選択します。 次へ.
レビュー手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
ストリーミングデータフローを作成したら、ストリーミングエンドポイント URL を取得できます。 このエンドポイントは、Webhook を購読するために使用され、ストリーミングソースとExperience Platformが通信できます。
Webhook の設定に使用する URL を構築するために Pendo 次を取得する必要があります。
次の手順で データフロー ID および ストリーミングエンドポイント、 データフローアクティビティ 作成したデータフローのページを開き、詳細を プロパティ パネル。
ストリーミングエンドポイントとデータフロー ID を取得したら、次のパターンに基づいて URL を作成します。 {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}
. 例えば、生成される Webhook URL は次のようになります。 https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95
次に、 Pendo ウェブフックを作成します。 を使用して Webhook を作成する手順については、 Pendo ユーザーインターフェイス ( Pendo webhook の作成に関するガイド.
Webhook を作成したら、 Pendo Webhook を開き、Webhook の URL を URL フィールドに入力します。
様々なイベントカテゴリを購読して、送信するイベントの種類を Pendo インスタンスから Platform へ 各イベントについて詳しくは、 Pendo ドキュメント.
このチュートリアルに従うことで、 Pendo データをExperience Platformに送信します。 取り込まれるデータを監視するには、 Platform UI を使用したストリーミングデータフローの監視.
以下の節では、 Pendo ソース。
ソースとが正しく設定されていることを検証するには、以下を実行します。 Pendo メッセージを取り込むには、次の手順に従います。
データフローの実行をチェックする際に、次のエラーメッセージが表示される場合があります。 The message can't be validated ... uniqueID:expected minLength:1, actual 0].
このエラーを修正するには、 uniqueID マッピングが設定されました。 追加のガイダンスについては、 マッピング 」セクションに入力します。
詳しくは、 Pendo ヘルプセンター.