予期しないデータからスキーマを保護

スキーマ設定は、Amplitudeがスキーマに違反するデータをどのように処理するかを制御します。 スキーマ違反は、計画していなかったイベントや予期しない型のプロパティ値など、Amplitudeがスキーマで定義されていないデータを受信した場合に発生します。計画外のイベントタイプ、計画外のイベントまたはユーザープロパティ、および計画外のプロパティ値という3種類のスキーマ違反に対して、応答を設定します。各タイプについて、Amplitudeはデータを予期しないものとマークして取り込むか、または拒否します。

スキーマ設定は、取得時にスキーマに違反するデータをAmplitudeにマークまたは拒否させたい場合に使用します。 Amplitudeがデータを取得する方法を変更することなく、イベントストリームに無効なイベント、欠落しているイベント、または古いイベントがないかどうかをモニターするには、代わりに観察を使用してください。Amplitudeデータに移動し、設定 > スキーマ設定に移動してスキーマ設定を確認してください。

計画外のイベントタイプ

Amplitudeは、お客様のスキーマに含まれていないイベントや、お客様が以前に計画していなかったイベントを受信することがあります。 これは計画外のイベントタイプです。 Amplitudeは以下の方法で応答するように設定できます。

• 予期せぬイベントとしてマーク：Amplitudeはイベントを取り込み、警告をトリガーし、指定された購読者に通知を送信します。ドロップダウン内のイベントのカテゴリは、承認するまで「予期しない」です。
• 拒否: Amplitudeはイベントを拒否し、指定された加入者に通知を送信します。 Amplitudeはイベントやそのプロパティを保存しません。

計画外のイベントまたはユーザープロパティ

Amplitudeは、スキーマに含まれていない、または事前に計画されていなかったイベントやユーザープロパティを検出すると、計画外のイベントまたはユーザープロパティとみなします。Amplitudeは以下の方法で応答するように設定できます：

• 予期しないとマーク: Amplitudeはプロパティを取り込み、警告をトリガーし、指定された購読者に通知を送信します。
• 拒否: Amplitudeはプロパティを拒否し、指定された購読者に通知を送信します。Amplitudeはイベントを保存しますが、プロパティは保存しません。

計画外のイベントまたはユーザープロパティ値

Amplitudeは、スキーマの一部ではないイベントプロパティ値を受信した場合、または以前に計画していなかったイベントプロパティ値を受信した場合、その値を計画外のプロパティ値とみなします。 たとえば、イベントプロパティ値は文字列として到着しますが、スキーマは数値を期待していました。Amplitudeは、次の方法で計画外のプロパティ値に対応するように設定できます。

• 予期しないとマーク: Amplitudeはプロパティを取り込み、警告をトリガーし、指定された購読者に通知を送信します。
• 拒否: Amplitudeはプロパティを拒否し、警告をトリガーし、指定された購読者に通知を送信します。Amplitudeはイベントを保存しますが、プロパティは保存しません。

Amplitudeがイベントデータを拒否し、それを取り込みたい場合は、新しいイベントまたはプロパティを計画して、イベントまたはプロパティをスキーマに追加してください。

検証エラーを表示

スキーマを初期化し、予想されるイベントとイベントプロパティを定義した後、スキーマはAmplitudeに送られるライブデータを検証できます。 予期しないイベントやプロパティに対する警告をトリガーするようにスキーマを設定した場合、Amplitudeは検証エラーパネルにエラーを記録します。

検証エラーを表示するには、Amplitudeデータに移動し、設定 > スキーマ設定 > 検証エラーに移動します。過去24時間以内に発生したエラーはすべて、イベントやプロパティを承認または拒否したかどうかにかかわらず、このページに表示されます。検証ページにエラーが表示されない場合、過去 24 時間に違反が発生していません。 これは、すべての違反を修正したことを意味するものではなく、Amplitudeがその期間内に違反に遭遇していないことを意味するだけです。

購読 を選択して、検証エラーに対する電子メールアラートを設定します。

登録者を管理

スキーマ違反が発生した場合に電子メール通知を受信するよう特定のユーザーを指定できます。 スキーマオプションの右上にある購読者の管理を選択してください。