メタデータとデータマッピング

メタデータとは、アカウントの種類、サブスクリプション収益、ユーザーの役割など、Pendoに送信する訪問者やアカウントに関する情報です。メタデータは、アナリティクス、セグメンテーション、パーソナライズされたアプリ内エクスペリエンスを強化します。

Pendoのメタデータには以下の2つの重要なコンポーネントがあります。

• データ型は、テキスト、数値、ブール値、日付、リストなど、メタデータフィールドに含まれる値の種類を定義します。

• メタデータマッピングは、特定のメタデータフィールドをPendoが認識する標準化された概念（メール、収益、アカウントタイプなど）に結び付けます。マッピングにより、アカウントのホバーカードなど、プラットフォーム全体でデータを一貫して解釈できます。

［設定（Settings）］>［メタデータ（Metadata）］にアクセスするには、サブスクリプション管理者である必要があります。

メタデータ

メタデータページでは、Pendoに送信するフィールド名と、それらのフィールドに割り当てられたデータ型を確認できます。これらのフィールドはフィールドテーブルに表示され、Pendo全体でアナリティクス、セグメント、ガイドターゲティングに使用されます。

詳細については、「訪問者とアカウントのメタデータ設定」をご参照ください。

ヒント：Pendoに送信するメタデータフィールドの数に制限はありませんが、選択的に行うことをお勧めします。フィールドを減らすことで、検索パフォーマンス、読み込み時間、全体的なデータガバナンスが向上します。

使用可能なデータ型

Pendoでは6つのデータ型が使用可能です。インストールスクリプトを使って送信するデータ（一般的には「スニペット」と呼ばれます）は、データを割り当てるデータ型の形式と一致している必要があります。このセクションでは、各データ型の概要と、その型に対応するデータの例を示しています。

テキスト

テキストは、メールアドレスなど、単純なテキスト文字列として表現されるべきフィールドに使用されます。

visitor:{{
 id:62343,
 email:'john@doe.com',

注：メタデータの文字列の値は1500文字未満にすることをお勧めします。

ブーリアン

ブールフィールドは、訪問者が管理者ユーザーであるかどうかなど、trueまたはfalseの値に使用されます。

visitor:{{
  id:62343,
  isAdmin: true,

数値型（整数）

整数フィールドは、訪問者が持つダッシュボードの数など、小数点のない整数です。

visitor:{{
 id:62343,
 dashboardCount: 3,

数値型（小数）

浮動小数点フィールドは、使用されているストレージのパーセンテージなど、小数点を含めることができる数値です。

visitor:{{
 id:62343,
 percentStorageUsed: .776,

日付

日付フィールドは、サブスクリプション開始日などの日付を記録するために使用されるタイムスタンプです。

visitor:{{
 id:62343,
 subscriptionStart: "2006-01-02T15:04:05.999-05:00",

日付はサポートされている形式で渡す必要があります。サポートされている日付形式の詳細については、「訪問者とアカウントのメタデータ設定」を参照してください。サポートされている日付形式のリストについては、「Engage APIドキュメント」を参照してください。

リスト

リストフィールドは、ユーザーの役割など、単一のメタデータフィールドに複数の値を格納します。

 visitor:{{
 id:62343,
 roles: ['admin', 'end-user', 'super-user'],

注：リストデータ型はエージェントメタデータでのみ使用可能です。

データ型のセグメントルール

各データ型は、メタデータフィールドの値に基づいてセグメントを作成するために使用できる特定のセグメンテーションルールをサポートしています。たとえば、日付フィールドには日付に関連するセグメント化ルール（前/後）を設定することができ、数値フィールドには数値に関連するルール（等しい/等しくない）を設定することができます。

「含む」の動作はデータ型によって異なることに注意することが重要です。

• テキストフィールドでは、"contains" は部分一致を検索します。例：「従業員を含む」というルールは、「Pendoの従業員」や「プロダクト担当従業員」など、「従業員」という単語を含むすべてのメタデータ値と一致します。
• リストフィールドの場合、「含む」には完全一致が必要です。例：「従業員を含む」というルールでは、「従業員」という値のみが抽出されます。「Pendoの従業員」と「プロダクト担当従業員」などは抽出されません。

メタデータマッピング

メタデータマッピングを使用すると、既存のメタデータフィールドをPendoが認識する標準化された概念に接続できます。これらのマッピングにより、アカウントのコンテキストが一目でわかるホバーカードのように、アカウントと訪問者の重要な情報がプラットフォーム全体で一貫して表示されるようになります。

Pendoは、訪問者レベルとアカウントレベルのメタデータのマッピングを提供します。

• 訪問者レベルのマッピング
  • メールアドレス
• アカウントレベルのマッピング
  • 表示名（Display name）
  • 収益
  • currency
  • ウェブサイト
  • アカウントタイプ（潜在顧客、顧客、チャーン）

注：メタデータフィールドをマッピングに割り当てるには、［フィールド］テーブルにそのフィールドがすでに存在している必要があります。