英語からAIを使用して翻訳されました
この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
Experience Monitoringには、APIエラーや管理されていないJSエラーをキャプチャするツールがあります。例えば、予期しない技術的エラーです。
ただし、ユーザーにメッセージが表示される原因となる他の多くのエラー（いくつかは予期されるもの）があります。例えば、「おっと、この商品は在庫切れです」や「これは有効な郵便番号ではありません」。
Custom Errorsを使用すると、ユーザーの体験中に発生する処理されたエラーメッセージを収集し、ビジネスへの影響に基づいてランク付けすることができるため、どの修正を優先すべきかをよりよく理解できます。
Custom Errorsとは
Custom Errorsは、ユーザーの画面に表示される任意のテキストを収集します。例えば、バナーやポップアップ、またはユーザーアクションに基づくフォームフィールド内のテキストメッセージです。
フォーム検証エラーの例：
Custom Errorsを使用して、ユーザーには見えないエラーを収集することもできます。
Custom Errorsには、以下の情報が含まれます：
| エラー情報 | 詳細 |
| 取得したテキストメッセージ | （例：申し訳ありませんが、アカウントを再活性化できませんでした） |
| イベントのタイムスタンプ | |
| オプション属性 | エラーを特定するのに役立つ情報（タイプ、重大度） |
Custom Errorsを収集する方法
ステップ1：Custom error収集を有効にする
まず、Custom Errorsが収集されていることを確認する必要があります。これは、Experience Monitoring SettingsでAdminユーザーによって行う必要があります。
ステップ2：Custom error収集を定義する
Custom Errorsの収集を定義する方法は2つあります：
- Contentsquare Tag Configurator（CSTC）のCustom Errorテンプレートを使用する
- 専用タグコマンドを直接ウェブサイトのコードに使用する
各値のためのカスタムエラーを生成する
各在庫管理単位のカスタムエラーを収集したいですか？この特定のユースケースのために属性を追加するには、Custom Error Groupingに関するガイドに従ってください。
カスタムエラーの例と命名のベストプラクティス
カスタムエラーの潜在的な例と推奨される命名規則を、ユースケースごとに実装するためにご覧ください。
カスタムエラーを簡単にフィルタリングし、優先順位を付けるために、エラーメッセージを特定するために属性を使用するガイドを使用することを強くお勧めします。
| テキスト文字列の例 | エラータイプ（強く推奨） | 追加のオプション属性（値の実際の名前） |
| 一般的なタイプと例 |
キー： formValidation formSubmitFail textInfo textError caughtError httpError timeout slowRequest 実装例： {type: formValidation}
|
キー： critical high medium low ---------------------------------- キー： english french hebrew chinese ---------------------------------- キー： 推奨値： 404 500 実行に失敗しました ReferenceError SyntaxError TypeError URIError EvalError InternalError |
フォームの完了
| メッセージ文字列 | エラータイプ（推奨） | 追加のオプション属性の例（値の名前） |
| フォーム送信失敗 |
キー: type {type: formSubmitFail}
|
キー: language 値: english {language: english}
|
| オプションを選択してください |
キー: type {type: formValidation}
|
キー: language {language: english}
|
| 無効なエントリ番号 |
キー: type {type: formValidation}
|
キー: language {language: english}
|
| フォームフィールドが欠落しているエラー |
キー: type {type: formValidation}
|
キー: language {language: english}
|
| フォーム完了のタイムアウト |
キー: type {type: timeout}
|
キー: language {language: english}
|
| このフィールドは空白のままにできません |
キー: type {type: formValidation}
|
キー: language {language: english}
|
検索結果
| メッセージ文字列 | エラータイプ（推奨） | 追加のオプション属性（値の実際の名前） |
| 検索結果がありません |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| 特定のキーワード検索で結果が見つかりませんでした |
キー: type {type: textInfo}
|
キー: language {language: english}
|
商品ページ（PDP）
| メッセージ文字列 | エラータイプ（推奨） | 追加のオプション属性（値の実際の名前） |
| 商品はもはや利用できません |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| サイズを選択してください |
キー: type {type: textInfo}
|
キー: language 値: english {language: english}
|
| アイテムをカートに追加できませんでした |
キー: type {type: textError}
|
キー: language 値: english {language: english}
|
| カート内のアイテム数を超えました |
キー: type {type: textInfo}
|
キー: language 値: english {language: english}
|
チェックアウト
| メッセージ文字列 | エラータイプ（推奨） | 追加のオプション属性（値の実際の名前） |
| 支払い失敗 |
キー: type {type: textError}
|
キー: language {language: english},
{severity: critical}
|
| このカードのセキュリティコードを確認してください |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| アイテムをカートに追加できませんでした |
キー: type {type: textError}
|
キー: language {language: english}
|
| カート内のアイテム数が超過しました |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| プロモコードが機能しませんでした |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| 郵便番号/電話番号の形式が不正です |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| バウチャーコードエラー |
キー: type {type: textError}
|
キー: language {language: english}
|
|
この構成はこの日付範囲ではもはや利用できません |
キー: type {type: textInfo}
|
キー: language {language: english}
|
|
この時点で転送を完了できませんでした |
キー: type {type: textError}
|
キー: language {language: english}
|
|
カートにアイテムがありません |
キー: type {type: textInfo}
|
キー: language {language: english}
|
ログイン
| メッセージ文字列 | エラータイプ（推奨） | 追加のオプション属性（値の実際の名前） |
| パスワードエラー |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| ログイン失敗 |
キー: type {type: textError}
|
キー: language {language: english}
|
| すでにアカウントをお持ちです |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| ボットでないことを確認してください |
キー: type {type: textInfo}
|
キー: language {language: english}
|
その他
| メッセージ文字列 | エラータイプ（推奨） | 追加のオプション属性（値の実際の名前） |
| 何かがうまくいかなかったようです |
キー: type {type: textError}
|
キー: language {language: english}
|
| 404ページ/行き止まりページ*
*この種のエラーは、ページビュー（Journey Analysisで確認可能）とカスタムエラー（Error Analysisで影響を確認）の両方で監視できます。 |
キー: type {type: httpError}
|
キー: language {language: english}
---------------------------------- キー: errorStatus {errorStatus: 404}
|
| ファイルから重要な情報が欠けています |
キー: type {type: textInfo}
|
キー: language {language: english}
|
| 広告ブロックを追跡 |
キー: type {type: caughtError}
|
キー: language 値: english {language: english}
|
| ビデオが利用できない/読み込まれていない |
キー: type {type: textError}
|
キー: language 値: english {language: english}
|
| この場所の周りに店舗がありません |
キー: type {type: textInfo}
|
キー: language 値: english {language: english}
|
| 利用できない基盤API/サービスに依存するサービス |
キー: type {type: textError}
|
キー: language 値: english {language: english}
|
よくある質問
カスタムエラーは遡って収集できますか？
いいえ、カスタムエラーは遡って収集できません。
カスタムエラーを設定する際に属性を追加する必要がありますか？
属性はオプションですが、エラーを分類できるように属性を指定することを強くお勧めします。