AIを使用して英語から翻訳されました
この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
カスタムエラーテンプレートを使用すると、ブラウズしたウェブページに存在するエラーメッセージを収集し、Error Analysis内で分析することができます。
これらの手順は、Contentsquare Tag Configuratorの記事と併せて使用してください。この中には、前提条件やスニペットの作成に関する詳細が含まれています。
一般的に使用される目的
- 画面上のメッセージを収集します。例えば：
- フォーム入力に関連するエラーメッセージ
- 「在庫切れ」メッセージの追跡などのEコマースの摩擦
- テキスト検索の代替手段を提供します（テキスト検索は、マスク解除やセッションリプレイサンプリングに依存しているため）
使用方法
カスタムエラーテンプレートを選択したら、以下の手順を使用してこの選択したテンプレートと選択したトリガーを構成します。
ステップ1：入力フィールドを完了する
- メッセージ：エラーの説明。ここでは、固定値（例：フォーム検証エラー）のために自分の選択した固定文字列（テキスト）を入力するか、次のトリガーのいずれかを使用している場合 - 要素のクリックまたはタップ、要素の存在、要素の挿入、要素の表示、またはマウスオーバー - ターゲット要素のテキストをイベント名フィールドに渡すために、${element.textContent}式を使用できます。固定文字列と要素のテキストを連結して組み合わせることもできます。例えば、フォーム検証エラー：${element.textContent}
-
属性（オプション）：ここでは、エラーの種類や言語など、カスタムエラーの特定の属性を追加して情報を収集できます。
- 属性値は手動のテキスト（文字列）であるか、要素の属性を取得するために活用できます。例えば、${element.className}や${window.utag.data.error}
各値のカスタムエラーを生成する
各在庫管理単位のカスタムエラーを収集したいですか？この特定のユースケースのために属性を追加するには、カスタムエラーグルーピングに関するガイドに従ってください。
ステップ2：トリガーを選択する
トリガーを選択し、スニペットを発火させる条件を定義します。
利用可能なトリガー
テンプレートとトリガーのガイドライン
キャッチオールルール
カスタムエラーテンプレートに対して以下のキャッチオールルールを適用できます：
[class*='error'i],[class*='warning'i],[class*='alert'i],[class*='danger'i]
メッセージの内容をキャプチャするために（個人データが公開されていない場合）：
${element.textContent}
トリガー要素を特定する
どの要素をトリガーとして使用するかを特定するには、キャプチャしたいエラーを含むページの動作を調査します。エラーテキストを保持する要素は、ページが最初に読み込まれたときに存在しますか？もしそうであれば、要素の挿入または要素の表示トリガーを使用できます。
一方、ページが最初に読み込まれたときにすでに存在しているが隠れている場合は、要素の表示トリガーを使用する必要があります。
要素の挿入と要素の表示トリガーの両方は、各要素/インスタンスでトリガーを発火させるか、ページビューごとに1回だけ発火させるかを選択できます。単一の要素（支払い失敗エラーなど）でトリガーを発火させたい場合は、ページビューごとに1回だけ発火するように制限できます。ただし、複数のエラー（同じCSTCスニペットと同じCSSセレクターを使用して、エラーのあるすべてのフィールドのメッセージをキャプチャする場合など）をキャプチャしたい場合は、ページビューごとに複数回発火させる必要があります。
式：${element.textContent}
${element.textContent} を使用する際は、あまりにも広範囲なCSSセレクターを使用して、キャプチャしたいテキスト以外の他のテキストを含まないように注意してください。
キー/バリューのペアでエラーを分類する
エラーメッセージのテキストを収集することに加えて、各エラーを分類するために最大5つのキー/バリューのペアを割り当てることができます。キーとバリューはそれぞれ最大30文字までです。例えば、type : validation。
属性の変更と要素の存在
要素の存在トリガーは、属性の変更（クラスの変更など）を検出しません。
自然なページロード時に要素が存在するか、DOMへの変更を通じて追加された要素の中に存在するかのみを検出します。つまり、エラー要素がページロード時にすでに存在し、表示される前に、クラスの変更を通じてのみ表示される場合、要素の存在トリガーはそれを検出できません。たとえあなたのセレクタがエラーが表示された後に新しく追加されたクラスに特化していてもです。