この記事では、Pendoがデフォルトでアナリティクス用に収集するHTML属性と、デフォルトのデータ収集を変更する方法をまとめています。
HTML属性
HTML属性は、フォーム入力値や画像のURLなど、HTML要素に関する追加情報を提供するものです。一般的なHTML属性には、src
、href
、class
、id
などがあります。これらの属性の内容は、CSSセレクターを使用してウェブサイトの特定の要素を識別し、スタイルを設定するために使用できます。Pendoはこれらのセレクターによって、フィーチャーのクリックを識別し、ガイドをターゲティングします。このため、CSSセレクターは静的かつ一意で、安定的である必要があります。
デフォルトで収集されるイベント
アナリティクスに使用するクリックイベントやフォーカスイベントについて、Pendoはデフォルトで特定の属性やプロパティを収集します。
<div>
、<p>
、<a>
、<span>
、<button>
などのクリックされた要素の種類<a>
、<span>
、<div>
などの要素内のテキスト- 要素の
id
またはclass
- 要素の他の属性(存在する場合)
title
、href
、tabindex
など <button>
については、value
(ボタンのテキスト)およびname
を収集。<img>
については、src
およびalt
を収集。<select>
については、type
およびselectedIndex
を収集。<textarea>
および<input>
については、name
を収集。
プライバシー保護の観点から、ユーザーが入力したテキストを<input>
や<textarea>
のフィールド内で収集することはありません。デフォルトでは、読み込みイベントでドキュメントの<title>
も除外されますが、[ページタイトルを収集(Collect Page Titles)]の設定を使用してアプリケーションレベルでこれを有効にすることは可能です。[設定(Settings)]に移動し、[アプリケーション(Applications)]タブを開き、リストから適切なアプリケーションを選択して、 [ページタイトルを収集(Collect Page Titles)]を選択します。
クリックされた要素のすべての親要素について同じデータを収集し、HTML階層(またはドキュメントオブジェクトモデル:DOM)を経て、<body>
タグまでのデータを収集します。
カスタムHTML属性を追加することで、クリックイベントとフォーカスイベントでPendoが収集するデータを調整できます。
innerText
を含め、ページ上のテキストを一切収集しないようにPendoエージェントを設定することもできますが、その場合、フィーチャーのタグ付けが難しくなる可能性があります。カスタムHTML属性
すでに収集されているデフォルトの属性に加えて、Pendo用のカスタムHTML属性を追加してイベントの生データを記録することができます。これには、デフォルトでは収集されない訪問者、アカウント、イベントに関する特定の情報など、アナリティクスや自動化のテストに使用するカスタム属性も含めることが可能です。
注:カスタム属性はPendoのアナリティクスのみに影響します。Pendoガイドにおける要素のターゲティングは、DOM全体を読み込み、ガイドのターゲティングに使用するために識別されるカスタム属性には依存しません。
以下の例では、フィーチャーのタグ付けのためにデフォルトで使える属性は、class="block-list"
だけです。このクラスは、ページやアプリをとおして固有のものではない可能性があり、ある固有のフィーチャーを切り分ける必要がある場合には、十分に特定できないかもしれません。
<a class="block-list" target="_blank" data-id="1.0-Nav-Home.Dashboard">
上記の例ではdata-id
という追加の属性が含まれています。この属性には、コンテンツの特定に役立つ要素が含まれています。具体的には、この<a>
タグのdata-id
の値が1.0-Nav-Home.Dashboard
であるという点です。
PendoにカスタムHTML属性を追加して、この情報を追跡することができます。
カスタムHTML属性を追加する
- Adoptの左下にある[設定]を開きます。
- [アプリケーション]タブを開きます。
- リストからアプリケーションを選択します。
- [カスタムHTML(Custom HTML)]属性で、追加する属性を入力し、[+属性を追加(+ Add Attribute)]を選択します。
カスタムHTML属性を例にとると、data-id
属性の収集を開始する場合、data-
で始まり、ワイルドカード(*
)のルールを含むすべての属性(data-*
)を追跡します。つまり、data-
で始まるすべての属性が記録されます。もしくは、data-id
の特定の属性をターゲットにすることもできます。
Pendoは、設定で新しいカスタム属性を保存してから15~30分後に、イベントの生データで属性の収集を開始します。ルールでカスタム属性がタグ付けされたフィーチャーは、カスタム属性が追加された時点よりも前に遡って分析することはできません。Pendoは、お客様がカスタム属性を特定するまで、イベントの生データでカスタム属性を収集しません。