このドキュメントでは、ウェブサイトに reCAPTCHA Enterprise を統合する際にユーザーが開始したイベントを表すために使用されるアクション名について説明します。
reCAPTCHA Enterprise を統合するときは、grecaptcha.enterprise.execute() の action パラメータでアクション名を指定します。アクション名は、一意で意味があり、ユーザーに固有ではないものを使用することをおすすめします。アクション名では大文字と小文字が区別されません。使用できるのは、英数字、スラッシュ、アンダースコアのみです。ページに適用可能なアクションが複数ある場合は、たとえば cart_view_payment のように、複数のアクション文字列を連結できます。
アクション名を使用すると、reCAPTCHA 指標ページを通じてユーザーがサイトをどのように使用しているかを詳しく把握できます。[reCAPTCHA Metrics] ページでアクション名を照会するときは、小文字のアクション名を使用する必要があります。
次の表に、推奨されるアクション名と対応するイベントの例を示します。 また、推奨されるアクション名を使用すると、reCAPTCHA Enterprise がアクションをページタイプに関連付けることもできるため、アクションの改ざんや複製を試みる攻撃者など、さまざまな形式の攻撃をモニタリングする機能が向上します。
| アクション名 | ユーザーが開始したイベント |
|---|---|
signup |
ウェブサイトに登録します。 |
login |
ウェブサイトへのログイン。 |
password_reset |
パスワード再設定のリクエスト。 |
get_price |
アイテムの価格を取得する。 |
cart_add |
カートにアイテムを追加する。 |
cart_view |
カートの内容を表示する。 |
payment_add |
お支払い情報（カード情報や住所など）を追加または更新する。 |
checkout |
ウェブサイトからチェックアウトします。 |
transaction_confirmed |
トランザクションが処理されたことの確認。 |
play_song |
リストから曲を再生する。 |
次のステップ
- ウェブサイトでのアクション名の使用方法については、以下をご覧ください。